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