home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.barnyard.co.uk
/
2015.02.ftp.barnyard.co.uk.tar
/
ftp.barnyard.co.uk
/
cpm
/
walnut-creek-CDROM
/
BEEHIVE
/
OS
/
SUPRDOS2.ARC
/
SUPRBDOS.DOC
< prev
next >
Wrap
Text File
|
1990-09-21
|
10KB
|
252 lines
SUPRDOS2 User's Guide
SUPRBDOS Release 2, 10/11/86
The following files should be in your distribution package:
READ.ME- overview of SUPERBDOS features
SUPRBDOS.DOC -user's guide and installation instructions
DOS.AZM-
DOS1.MAC- source to SUPERBDOS
DOS2.MAC
INSTALL.COM -program to assist you in installing SUPRBDOS
INSTALL.PAS -Turbo Pascal source to INSTALL.
Z80MR.COM- public domain Z80 assembler used in installation of
SUPRBDOS
Z80MR.DOC
EX.COM - enhanced submit utility used in installation
PUBLIC.COM-utility for handling public files
PUBLIC.DOC
PUBLIC.SRC
UNCR20.COM- file uncruncher
SEMI-AUTOMATIC INSTALLATION
1. Extract all files from SUPRBDOS.LBR onto a blank disk in drive B.
Extract all files from Z80MR.LBR onto the same disk. Delete Z80MR.LBR.
Uncrunch all type *.?Z? files by typing UNCR20 *.?Z?
2. Copy SYSGEN.COM and DDT.COM from your CP/M disk to your SUPRBDOS disk.
3. Create a disk file containing your CP/M or ZCPR3 system image. Do
this by running sysgen as follows:
A>sysgen
SYSGEN VER 2.2
SOURCE DRIVE NAME (OR RETURN TO SKIP)a
SOURCE ON A, THEN TYPE RETURN<ret>
FUNCTION COMPLETE
DESTINATION DRIVE NAME (OR RETURN TO REBOOT)<ret>
A>SAVE x CPM.BIN
x is size of your CP/M system in 256-byte "pages". If you are not
sure what this number is, try 50.
4. Run INSTALL. If all goes well, the program will end by telling you to
"TYPE EX GO to continue SUPRBDOS installation." If INSTALL aborts
saying 'Can't locate bdos', read the manual installation section.
If INSTALL asks you to try again, do as it says.
5. Type EX GO.
6. You now have a copy of SUPRBDOS in a file called DOS.BIN.
Install it on a few test disks by typing
B>sysgen dos.bin
SYSGEN 2.2
DESTINATION DRIVE (RETURN TO REBOOT)a
DESTINATION ON A, THEN TYPE RETURN<ret>
FUNCTION COMPLETE
7. Warm boot your system with SUPRBDOS in A. If it boots correctly,
continue testing by copying files, running programs, until you are
satisfied that it works. Try this: Warm boot with SUPRBDOS, PIP, and
a test file in A. Change the disk in B without hitting Control-C. PIP
the test file to B. No "Bdos Err on B: R/O"!
If your system hangs or goes completely nuts upon warm booting with
SUPRBDOS, repeat the installation again. If the problem recurs,
please write and tell me about it. Include as much information as
possible. Otherwise, see your local CP/M expert (alas, a vanishing
breed).
MANUAL INSTALLATION
Automatic installation should work on most systems with standard CP/M 2.2.
If you have a non-standard CP/M, proceed with caution; SUPRBDOS might not
work with your CP/M.
The steps involved are :
1) Find the location of the bdos in your computer's memory. This number
ends in a 6. Subtract 6 from this number and call the result BdosMemAddr.
2) Find the location of the bdos in your CP/M system image file. Do
DDT CPM.BIN and type 'D' repeatedly to scroll through the contents of
CPM.BIN. Somewhere, there should be the word 'Bdos', followed by
the text of the various bdos error messages. If you can't find these,
your CPM.BIN file is screwed up, or you have a non-standard CPM.
When you find the word 'Bdos', not the most recent address ending
with a 00 or 80. Call this number the BdosFileAddr.
3) Compute the Offset (hex arithmetic) as follows:
Offset := $10000 + BdosFileAddr - BdosMemAddr.
4) Overlay the old bdos with SUPRBDOS.
B>ddt cpm.bin
DDT VERS 2.2
NEXT PC
a b (DDT prints these numbers)
icpm.bin (you type this)
r (you type this)
f<BdosFileAddr> <BdosFileAddr+$0E00> 0 (clear out old bdos)
idos.hex (you type this)
r<offset> (type "R" followed immediately by the offset you calculated
^C (exit DDT)
B>
Now, do SAVE x DOS.BIN, where x is the same number you used in
saving CPM.BIN.
5) SYSGEN DOS.BIN to write SUPRBDOS onto your disks.
USAGE
-----Changing Disks Without Control-C
SUPRBDOS should work just like your old BDOS, quietly and out of your way.
It has some additional features which make it much nicer than your old BDOS.
For example, let's say you're writing the "Great American Novel" with
WordStar. It's late, you've written all day, and you want to move on to
other things. You hit ^K^D to save your work, and WordStar burps:
**Disk Full. Press <ESC>**
With your old BDOS, if you switched disks, you'd get
Bdos Err on A: R/O
and you'd say bye-bye to Chapter 5 unless you had a text recovery program.
With SUPRBDOS, move to the beginning of file using ^R, not ^Q^R, and mark the
beginning of a block. Move to the end of file using ^C, not ^Q^C, and mark
the end of block. Hit ^K^W to write the block to disk. Enter a filename on a
drive not containing your novel (probably your WordStar disk). Remove the
disk from that drive, and insert a blank disk. Hit return, and your work will
be saved to a new disk. Finally, replace the old disk. Try this with your
old BDOS, and you'd be quite sorry.
SUPRBDOS's "Control-C-less" operation is not limited to Wordstar. You may
change disks at any time, with any program, with one exception. IF A FILE IS
OPEN FOR WRITING, DO NOT CHANGE DISKS UNTIL THE FILE IS PROPERLY CLOSED. IF
YOU DO, YOU WILL TRASH YOUR DISKS! This is why, in the example above, we
changed the disk containing WordStar, not the disk containing the novel. No
files were open for writing on the Wordstar disk, so it was ok to change it.
The novel file was open, so its disk could not be changed.
-----Public Files
If you use user areas, you'll love this. Public files are files which are
accessible from all user areas. Normally, if Wordstar was in A7: and
your text files in A8:, you could not edit your files with Wordstar. If
Wordstar and its overlays were made public files, you could be logged into
A8:, B6:, or any other user area and still run Wordstar.
Public files are invisible to the use of wildcards, so you may not copy them
with PIP *.*. They must be specified by name. Public files are also
read-only, so they may not be erased.
To make a file PUBLIC, run the PUBLIC program which is included with SUPRBDOS.
Ex: A>public ws.com
To restore a file to normal (make it private),
A>public ws.com x <---the X makes the file private.
----Error Messages
SUPRBDOS may produce the following error messages:
Disk Error on A : error message
Function xx ; File = FILE.TYP
where the error message may be
Read error
Write error
Non existent drive
Read-Only (this happens only if disk was set to r/o with bdos function 28,
not when disks are changed.)
File is Read-only
The BDOS function number and the file involved (if applicable) are given, so a
full message may be:
Disk Error on A: Write error
Function 22 ; File = CHAPTER.5
In this case, there was a write-error trying to create file CHAPTER.5.
-----Advanced Features
SUPRBDOS has optional time-stamping capabilities built in. To use these, you
must have a real time clock and a bios routine which access the clock. You
must edit DOS.Z80 and set DOTIME to TRUE and reinstall SUPRBDOS. You must
also "initialize the directory for time stamps", according to the author of
P2DOS, from which SUPERBDOS is derived. How this is done is not explained.
Maybe an adventurous soul out there will find a way.
SUPRBDOS can be installed so that functions 13 and 37 allow the free
interchange of single and double sided disks. On many machines, such
as the Kaypro IV, changes between single and double sided disks are
recognized only at warm boots. Obviously, this is a limitation on the
switching of disks without Control-C. If your machine is one of these
and if you have the source to your bios, you can remove this limitation.
Add code to your bios cold boot routine to initialize a jump to the
routine which decides if the computer is looking at a single or double
sided disk. Suppose this routine is DISKINIT. Change your cold boot
routine to look like
CHKTYP EQU 04BH
CBOOT: Blah
Blah
Blah
LD HL,CHKTYP
LD A,0C3H ;initialize a jump
LD (CHKTYP),A
LD HL,DISKINIT ;to DISKINIT
LD (CHKTYP+1),HL
Blah
Blah
JP CCP ;pass control to CCP
This code puts a JP DISKINT instruction at 04BH. Edit DOS.Z80, setting
the RESDSK conditional to TRUE. Set SETDSK equal to CHKTYP. Re-assemble
SUPRBDOS. Now, functions 13 and 37 will identify new disks by calling
CHKTYP, which in term "calls" DISKINIT.
This feature is extremely useful to have when using disk cataloging programs,
the file utility NSWP207, the library manager NULU 1.5, and many others
with which expect disk changes and call functions 13 and 37 to change
disks.
***************************************
Legal Stuff
To my knowledge, all components of the SUPRBDOS.LBR are public domain
for non-commerical use only. SUPRBDOS is a modification of P2DOS, by
H.A.J. Ten Brugge from the Netherlands, and therefore is subject to the
same restrictions as P2DOS. Z80MR and the PUBLIC files are public domain.
INSTALL is a program written by moi, and is also public domain.
I assume no liability for the use of or the consequences of the use of
SUPRBDOS.
***************************************
Questions and comments can be directed to
Benjamin Ho
626 Emerson St.
Evanston, IL 60201
SUPRBDOS was developed on a Kaypro IV.
rected to