home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / suprbdos.lbr / SUPRBDOS.DZC / SUPRBDOS.DOC
Encoding:
Text File  |  1993-10-25  |  8.6 KB  |  229 lines
  1.             SUPRBDOS User's Guide
  2.     
  3. The following files should be in your distribution package:
  4.     READ.ME- overview of SUPERBDOS features
  5.     SUPRBDOS.DOC -user's guide and installation instructions
  6.  
  7.     DOS.Z80- 
  8.     DOS1.MAC- source to SUPERBDOS
  9.     DOS2.MAC
  10.     FINDOFF.COM -program to assist you in installing SUPRBDOS
  11.  
  12.     ZASM.LBR- public domain Z80 assembler used in installation of
  13.           SUPRBDOS
  14.     PUBLIC.COM-utility for handling public files
  15.     PUBLIC.DOC
  16.     PUBLIC.SRC
  17.     UNCR12.COM- file uncruncher
  18.  
  19. INSTALLATION
  20.  
  21. If you have a '83 model Kaypro II or IV, you're in luck.  You can skip this
  22. installation if you get the file KPSPRDOS.LBR.  There you will find a ready
  23. made system based on K83ZCPR3.  If you have another machine with a standard
  24. CP/M system, your work is only a little harder.
  25.  
  26. 1.  Extract all files from ZASM.LBR onto your SUPRBDOS disk.
  27.  
  28. 2.  Copy SYSGEN.COM and DDT.COM from your CP/M disk to your SUPRBDOS disk.
  29.  
  30. 3.  Create a disk file containing your CP/M or ZCPR3 system image.  Do
  31.     this by running sysgen as follows: 
  32.  
  33.       A>sysgen
  34.       SYSGEN VER 2.2
  35.       SOURCE DRIVE NAME (OR RETURN TO SKIP)a
  36.       SOURCE ON A, THEN TYPE RETURN<ret>
  37.       FUNCTION COMPLETE
  38.       DESTINATION DRIVE NAME (OR RETURN TO REBOOT)<ret>
  39.  
  40.       A>SAVE x CPM.BIN
  41.  
  42.     x is size of your CP/M system in 256-byte "pages".  If you are not 
  43.     sure what this number is, try 50.
  44.  
  45. 4.  Run FINDOFF.  If all goes well, the program will tell you
  46.       "Your bdos memory address is y" and
  47.       "Your bdos is located at z in file CPM.BIN"
  48.       "Your offset is w". 
  49.     Write down y, z, and w.
  50.  
  51. 5.  Assemble SUPRBDOS by running ZASM DOS.AAZ HEX=<bdos memory address>
  52.     For example, if your bdos memory address from FINDOFF is $D400, 
  53.     you type
  54.     ZASM DOS.AAZ HEX=0D400  (do not type '$', '<' or '>')
  55.     The assembly will take several minutes.  You should have a file
  56.     DOS.HEX (about 10K or so) when the assembly is finished.
  57.  
  58. 6.  Overlay the old BDOS with SUPRBDOS.  
  59.       
  60.     A>ddt cpm.bin
  61.     DDT VERS 2.2
  62.     NEXT PC
  63.     a b     (DDT prints these numbers)
  64.     icpm.bin (you type this)
  65.     r        (you type this)
  66.     idos.hex (you type this)
  67.     r<offset> (type "R" followed immediately by the offset given by 
  68.            FINDOFF)
  69.         ^C        (exit DDT)
  70.     A>
  71.     
  72.      Now, do SAVE x SUPRBDOS.BIN, where x is the same number you used in
  73.      saving CPM.BIN.
  74.      
  75. 7.  You now have a copy of SUPRBDOS.  Install it on a few test disks by doing
  76.        A>sysgen suprbdos.bin
  77.     SYSGEN 2.2
  78.     DESTINATION DRIVE (RETURN TO REBOOT)a
  79.     DESTINATION ON A, THEN TYPE RETURN<ret>
  80.     FUNCTION COMPLETE
  81.         
  82. 8.  Warm boot your system with a SUPRBDOS disk in A.  If it boots correctly,
  83.     continue testing by copying files, running programs, until you are
  84.     satisfied that it works.  Try this: Warm boot with SUPRBDOS, PIP, and
  85.     a test file in A.  Change the disk in B without hitting Control-C.  PIP
  86.     the test file to B.  No "Bdos Err on B: R/O"!
  87.  
  88.     If your system hangs or goes completely nuts upon warm booting with
  89.     SUPRBDOS, repeat the installation again.  If the problem recurs, most
  90.     likely your offset is incorrect.  If your offset came from FINDOFF, 
  91.     please write and tell me about it.  Include as much information as
  92.     possible.  Otherwise, see your local CP/M expert (a vanishing breed, 
  93.     but some are still around).
  94.  
  95.  
  96. USAGE
  97.  
  98. -----Changing Disks Without Control-C
  99.  
  100. SUPRBDOS should work just like your old BDOS, quietly and out of your way.
  101. It has some additional features which make it much nicer than your old BDOS.
  102.  
  103. For example, let's say you're writing the "Great American Novel" with
  104. WordStar.  It's late, you've written all day, and you want to move on to
  105. other things.  You hit ^K^D to save your work, and WordStar burps:
  106.         **Disk Full.  Press <ESC>**
  107.  
  108. With your old BDOS, if you switched disks, you'd get 
  109.         Bdos Err on A: R/O
  110. and you'd say bye-bye to Chapter 5 unless you had a text recovery program.
  111.  
  112. With SUPRBDOS, move to the beginning of file using ^R, not ^Q^R, and mark the
  113. beginning of a block.  Move to the end of file using ^C, not ^Q^C, and mark
  114. the end of block.  Hit ^K^W to write the block to disk.  Enter a filename on a
  115. drive not containing your novel (probably your WordStar disk).  Remove the
  116. disk from that drive, and insert a blank disk.  Hit return, and your work will
  117. be saved to a new disk.  Finally, replace the old disk.  Try this with your
  118. old BDOS, and you'd be quite sorry.
  119.  
  120. SUPRBDOS's "Control-C-less" operation is not limited to Wordstar.  You may
  121. change disks at any time, with any program, with one exception.  IF A FILE IS
  122. OPEN FOR WRITING, DO NOT CHANGE DISKS UNTIL THE FILE IS PROPERLY CLOSED.  IF
  123. YOU DO, YOU WILL TRASH YOUR DISKS!  This is why, in the example above, we
  124. changed the disk containing WordStar, not the disk containing the novel. No
  125. files were open for writing on the Wordstar disk, so it was ok to change it. 
  126. The novel file was open, so its disk could not be changed.  
  127.  
  128. -----Public Files
  129.  
  130. If you use user areas, you'll love this.  Public files are files which are
  131. accessible from all user areas.  Normally, if Wordstar was in A7: and 
  132. your text files in A8:, you could not edit your files with Wordstar.  If
  133. Wordstar and its overlays were made public files, you could be logged into
  134. A8:, B6:, or any other user area and still run Wordstar.  
  135.  
  136. Public files are invisible to the use of wildcards, so you may not copy them
  137. with PIP *.*. They must be specified by name.  Public files are also
  138. read-only, so they may not be erased. 
  139.  
  140. To make a file PUBLIC, run the PUBLIC program which is included with SUPRBDOS.
  141.  
  142. Ex: A>public ws.com
  143.  
  144. To restore a file to normal (make it private), 
  145.     A>public ws.com x  <---the X makes the file private.
  146.  
  147. ----Error Messages
  148.  
  149. SUPRBDOS may produce the following error messages:
  150.  
  151.     Disk Error on A: Read error
  152.     Disk Error on A: Write error
  153.     Disk Error on T: Non-existent drive
  154.     Disk Error on A: Read-Only  (this happens only if disk was set to r/o
  155.                           with function 28, not when disks are
  156.                          changed)
  157.     Disk Error on A: File is Read Only
  158.  
  159. The BDOS function and the file involved (if applicable) are included, so a
  160. full message may be:
  161.  
  162.     Disk Error on A: Write error
  163.     Function 22 ; File = CHAPTER.5
  164.  
  165. In this case, there was a write-error trying to create file CHAPTER.5.  
  166.  
  167. -----Advanced Features
  168.  
  169. SUPRBDOS has optional time-stamping capabilities built in.  To use these, you
  170. must have a real time clock and a bios routine which access the clock.  You 
  171. must edit DOS.Z80 and set DOTIME to TRUE and reinstall SUPRBDOS.  You must
  172. also "initialize the directory for time stamps", according to the author of
  173. P2DOS, from which SUPERBDOS is derived.  How this is done is not explained.
  174. Maybe an adventurous soul out there will find a way.
  175.  
  176. SUPRBDOS can be installed so that functions 13 and 37 allow the free
  177. interchange of single and double sided disks.  On many machines, such
  178. as the Kaypro IV, changes between single and double sided disks are
  179. recognized only at warm boots.  Obviously, this is a limitation on the
  180. switching of disks without Control-C.  If your machine is one of these 
  181. and if you have the source to your bios, you can remove this limitation.
  182. Add code to your bios cold boot routine to initialize a jump to the
  183. routine which decides if the computer is looking at a single or double
  184. sided disk.  Suppose this routine is DISKINIT.  Change your cold boot
  185. routine to look like
  186.  
  187. CHKTYP     EQU    04BH
  188.  
  189. CBOOT: Blah 
  190.        Blah
  191.        Blah
  192.        LD    HL,CHKTYP
  193.        LD    A,0C3H        ;initialize a jump
  194.        LD    (CHKTYP),A
  195.        LD    HL,DISKINIT    ;to DISKINIT
  196.        LD    (CHKTYP+1),HL    
  197.        Blah
  198.        Blah
  199.        JP    CCP        ;pass control to CCP
  200.  
  201. This code puts a JP DISKINT instruction at 04BH.  Edit DOS.Z80, setting
  202. the RESDSK conditional to TRUE.  Set SETDSK equal to CHKTYP.  Re-assemble
  203. SUPRBDOS.  Now, functions 13 and 37 will identify new disks by calling
  204. CHKTYP, which in term "calls" DISKINIT.
  205.  
  206. This feature is extremely useful to have when using disk cataloging programs,
  207. the file utility NSWP207, the library manager NULU 1.5, and many others 
  208. with which expect disk changes and call functions 13 and 37 to change
  209. disks.
  210.  
  211. Questions and comments can be directed to
  212.     Benjamin Ho
  213.     626 Emerson St.
  214.     Evanston, IL 60201
  215.  
  216. ***************************************
  217. Legal Stuff
  218.  
  219. To my knowledge, all components of the SUPRBDOS system are public domain
  220. for non-commerical use only.  SUPRBDOS is a modification of P2DOS, by
  221. H.A.J. Ten Brugge from the Netherlands, and therefore is subject to the
  222. same restrictions as P2DOS.  
  223.  
  224.  
  225.  
  226.  
  227.  of P2DOS, by
  228. H.A.J. Ten Brugge from the Netherlands, and therefore is subject to the
  229. same restrictions a