home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 09 Application Software / WS.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  7.7 KB  |  196 lines
  1.  WS DOS 4.1                                                 by Sid Davis
  2. (WSoft) 
  3. WS DOS 4.1 is the latest version of the program WS DOS which I originally
  4. made
  5. in 1992. It's purpose is to give you the oppurtunity to use the faster burst-
  6. mode capability of 128-mode when loading 64 programs, and to be there waiting
  7. for you when you are ready to use it again. After the program is loaded from
  8. disk, it is copied into the bank 1 of the 128, where under normal
  9. circumstances,it can't be disturbed. If you spend most of your computing time
  10. in 64-mode, you
  11. will be glad to know that you wont have to re-load WS DOS again to load
  12. another
  13. program. Simply hit the reset button and it's there again, in 40 or 80
  14. columns.
  15.  When I originally made the first version, I had quite an interest in CP/M. I
  16. decided that I would mimic this sort of atmosphere in WS DOS. Also, I had
  17. just
  18. purchased a RamLink, and was kind of used to the DOS commands there too. This
  19. is the reason for the name WS DOS (turn the W upside down), and the DOSWEDGE-
  20. style commands. I hope you enjoy using it as much as I did making it. Anyway,
  21. on to the documentation.
  22.  
  23. The following is a list of command characters used by WS DOS, followed by a
  24. short description of each.
  25.  
  26. Command chararacters are:
  27.  
  28. CHARACTER                 FUNCTION
  29.             
  30. @                         disk commands and error-fetching
  31. ^ (arrow UP)              LOAD and RUN a 64 program
  32. /                         LOAD/LIST a file
  33. $                         show directory
  34. ?                         find the address-mark of a file
  35. *                         copy a file to the opposite drive (8 or 9)
  36. #                         device toggle
  37. %                         edit/display autoboot filenames
  38. !                         retrieve autoboot data from disk
  39. _ (arrow LEFT)            save current autoboot data to disk
  40.  
  41. HELP                      displays a short help screen
  42. ------------------------------------------------------------------------------
  43. --Descriptions:
  44.  
  45.  
  46. (@)  If entered alone, this command will attempt to check the error status of
  47.      the disk drive currently being used. If you follow this character with a
  48.      normal disk command (like "@s:test"), that works too. I have made WS DOS
  49.      to check what kind of disk-command you are entering. If you try to enter
  50.      a SCRATCH or NEW command ("s:?" or "n:?"), the program will react with
  51.      "are you sure", to give you time to be certian about what you want to
  52. do.
  53.  
  54.  
  55. (arrow UP)
  56.     This command, followed by the name of the file you wish to RUN, will load
  57.     your file in fast C128 "burst" mode (if you are using a 1571,1581,CMD HD,
  58.     or CMD FD 2000/4000 disk-drive. If you have a Ramlink, you wont need WS
  59. DOS
  60.     anyway). After the program is loaded, the faster 2MHZ is turned on and
  61. the
  62.     screen blanks while the program is transfered to $0801 (2049 decimal),
  63. the
  64.     default basic area of the 64. Then the RUN routine is executed, starting
  65.     the program immediately.
  66.  
  67.  
  68. (/)  This character functions exactly the same as the BOOT (arrow UP)
  69. function,
  70.      but does not RUN the program. If you keep your finger on the CONTROL key
  71.      during the load, you can LIST the program after the loading is done, and
  72.      C64 mode has activated itself.
  73.  
  74.  
  75. ($)  Will display the directory of the current disk drive. Pattern-matching
  76. is
  77.      fully supported, all you need to do is enter the pattern-string right 
  78.      after the command character.
  79.  
  80.  
  81. (#)  Switches WS DOS to read from either device 8 or 9. Simply enter the
  82. device
  83.      number after the character. Example- "#9" to switch to device 9.
  84.  
  85.  
  86. (*)  Followed by a filename of a file (which must be present on the current
  87.      drive), this function will copy a file to the opposite disk drive. 
  88.  
  89.  
  90. (%)  If you don't like to enter DOS commands all the time, and like things
  91.      a little more automatic, you can use this character to match 10 keys
  92.      of the 128 (keys 0-9) with a filename on the disk. Everytime WS DOS is
  93.      activated (or reactivated) it will look onto drive 8 for a filename of
  94.      "%". If it is present, your file-data for that disk is loaded into 
  95.      memory. At this time the keyboard is checked. If you are pressing a 
  96.      number key (0 to 9), the program immediately jumps to the BOOT routine,
  97.      which in turn loads the file, goes to 64-mode and starts the program.
  98.        If you enter the "%" character alone, all the program does is LIST
  99.      the edited filenames you have edited. If no data is in memory to be
  100.      displayed, NO DATA appears to inform you of that. To use the autobooter,
  101.      you must first edit a "%" file onto your disk. To edit a key, follow the
  102.      character with the key to be edited (0-9), a colon (:), and the
  103. filename.
  104.      Example: To edit key 1 enter
  105.      %1:yourfilename
  106.      and press return. The next command will save your edited autoboot-key
  107. data
  108.       *note*  ... You only need 2 blocks of space to save the "%" file to
  109. disk.
  110.  
  111.  
  112. (!)  Enter this character alone to load autoboot data (file "%") from the
  113. disk.
  114.  
  115.  
  116.  (arrow left) 
  117.     ...Will save the "%" file to disk, which is described above. For some
  118. reason    I am not aware of, you must enter the command "@i" before saving
  119. with this
  120.     command, else you will (often) get a "FILE EXISTS" error from the drive.
  121.  
  122.  
  123. (?)  Many files on any given disk are often data files, character sets, sub-
  124.      routines for another program, etc. It's not a good idea to use the BOOT
  125.      function on these (duh). But what if yer not sure? By entering this
  126. command     (followed by a filename), the oppurtunity is given to you to
  127. examine the
  128.      load-address of a file, which consists of the first two bytes. On a C64,
  129.      this address is normally 2049 ($0801). Most C64 programs which load and 
  130.      run have 2049 as an address-mark, since this is the normal starting
  131. point
  132.      of BASIC. However (as Jim Butterfield pointed out to me), a BASIC
  133. program
  134.      can also be from a VIC-20, a PLUS-4 or whatever. This address-mark can 
  135.      give you a good clue as to whether your BOOT will be a successful one. 
  136.      If you get the message:
  137.      $0801  2049 ok
  138.      ... Well, you say pretty safely that that program will load and run on a
  139.      C64. Otherwise, it's left up to you to know the BASIC start of another
  140.      machine, in case you have a favorite file from one of those. All of the
  141.      neccesary preparations are taken before the program is started in C64-
  142.      mode, like the re-linking of the basic lines, so if you are booting an
  143.      old PET program, go ahead (it should work).
  144.  
  145.     
  146. ------------------------------------------------------------------------------
  147. --Keys:
  148.    ...The following keys are pre-defined in WS DOS:
  149.  
  150.  
  151. F1 key:      displays the directory from the current disk drive.
  152. F3 key:      displays the error status of the current disk drive.
  153. F5 key:      toggles to device number 8
  154. F9 key:      toggles to device number 9
  155.  
  156. HELP key:    displays a short HELP screen for reference purposes. You can
  157. also
  158.              read the HELP screen by entering "help" at the DOS prompt.
  159.  
  160.  
  161.  
  162.      Well that was about it! If anyone is interested in the prog, I do
  163. upgrade
  164.      it from time to time. Actually I've already made the 4.2 version, but
  165. there     are a few bugs, and I have little time (excuses excuses). E-mail me
  166. at
  167.      102541,420 and let me know how I can make it better. I wrote all the
  168. code
  169.      for WS DOS myself but decided to spread it on the electronic airwaves
  170.      for free. Copy it, spread it, post it but don't SELL it.
  171.                        
  172.                                   Later
  173.                                          Sid Davis (102541,420)
  174.                                          alias WOHNZIMMERSOFT (WS)
  175.                      ...that means Livingroomsoft...
  176.  
  177.                     
  178.          
  179.          
  180.     
  181.     
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.               
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.