mirror of
https://github.com/wwarthen/RomWBW.git
synced 2026-02-06 14:11:48 -06:00
f162081ec1
- ZMP was crashing in most scenarios. This was corrected. - Minor adjustments to ZMP usage - Added ZMP documentation
310 lines
15 KiB
Plaintext
310 lines
15 KiB
Plaintext
===== ZSDOS Disk for RomWBW =====
|
|
|
|
This disk is one of several ready-to-run disks provided with
|
|
RomWBW. It contains a customized version of ZSDOS 1.1 for RomWBW.
|
|
The disk is bootable as is (the operating system image is already
|
|
embedded in the system tracks) and can be launched from the RomWBW
|
|
Loader prompt.
|
|
|
|
The remainder of this document describes the usage and contents of
|
|
this disk. It is highly recommended that you review the "RomWBW
|
|
User Guide.pdf" document found in the Doc directory of the
|
|
RomWBW Distribution.
|
|
|
|
ZSDOS is a replacement for the BDOS portion of the CP/M 2.2 operating
|
|
system. Since it does not include it's own command processor, the
|
|
the ZCPR D&J Command Processor has been included.
|
|
|
|
The primary documentation for ZSDOS and ZCPR 1 are contained in the Doc/CPM
|
|
directory of the RomWBW distribution. The specific files are "ZSDOS
|
|
Manual.pdf", "ZCPR Manual.pdf", and "ZCPR-DJ.doc". This document is a
|
|
supplement to the primary documentation.
|
|
|
|
The starting point for the disk content was the final public release of
|
|
ZSDOS which is generally available on the Internet. Overall, the
|
|
following steps were performed:
|
|
|
|
1. System installation and integration with RomWBW.
|
|
2. Update files to newer versions, as available.
|
|
3. Configure applications for RomWBW (clock drivers, terminal emulation,
|
|
etc.)
|
|
4. Add selected CP/M 2 applications (listed below).
|
|
5. Add selected RomWBW supplemental applications (listed below).
|
|
6. Add some useful general purpose applications (listed below).
|
|
|
|
Note that ZSDOS can be built as either ZSDOS or ZDDOS. It is the same
|
|
source file, but an equate determines which variation you want to
|
|
build. Basically, ZSDOS has more features. ZDDOS has less features, but
|
|
includes the date stamping code built-in. The ZSDOS Manual provides
|
|
more information. I have chosen to use ZSDOS to pick up the maximum
|
|
number of features. Date stamping is still available, but must be
|
|
loaded as an RSX.
|
|
|
|
The source allows you to compile the OS code as either v1.1 or v1.2 via
|
|
an equate. Version 1.2 was never distributed and contains only a few
|
|
minor fixes. Unfortunately, the use of v1.2 would make it incompatible
|
|
with many support modules and overlays due to their reliance on
|
|
hard-coded address assumptions. This is probably why it was never
|
|
distributed. I encountered this myself with the date stamping code --
|
|
it won't work with v1.2 because it does a version check. For now, I have
|
|
chosen to use v1.1 to maximize compatibility (seems to be what everyone
|
|
is doing). Ultimately, I may go back and try to rebuild everything in
|
|
the distribution to bring it all up to v1.2. That is for the future
|
|
though.
|
|
|
|
== Usage ==
|
|
|
|
- All installation steps needed to run ZSDOS have already been
|
|
performed. It is not necessary to perform any of the steps in
|
|
the "Installing ZSDOS" section of the ZSDOS Manual unless you
|
|
want to modify the installation.
|
|
- ZSDOS has a concept of fast relog of drives. This means that after
|
|
a warm start, it avoids the overhead of relogging all the disk
|
|
drives. There are times when this causes issues. After using tools
|
|
like CLRDIR or MAP, you may need to run "RELOG" to get the drive
|
|
properly recognized by ZSDOS.
|
|
- ZSVSTAMP from the original distribution is included, but requires a
|
|
ZCPR 3.X command processor. The RomWBW ZSDOS disk image uses ZCPR 1.0
|
|
(intentionally, to reduce space usage) and ZSVSTAMP will just abort
|
|
in this case. It will work fine if you implement NZCOM. ZSVSTAMP is
|
|
included solely to facilitate usage if/when you install NZCOM.
|
|
- FILEDATE only works with DateStamper style date stamping. If you
|
|
run it on a drive that is not initialized for DateStamper, it will
|
|
complain "FILEDATE, !!!TIME&.DAT missing". This is normal and just
|
|
means that you have not initialized that drive for DateStamper (using
|
|
PUTDS).
|
|
- ZXD will handle either DateStamper or P2DOS type date stamping.
|
|
However, it MUST be configured appropriately. As distributed, it will
|
|
look for DateStamper date stamps. Use ZCNFG to reconfigure it for
|
|
P2DOS date stamps if that is what you are using.
|
|
- Many of the tools can be configured (using either ZCNFG or
|
|
DSCONFIG). The configuration process modifies the actual application
|
|
file itself. This will fail if you try to modify one that is on the
|
|
ROM disk because it will not be able to update the image.
|
|
- DATSWEEP can be configured using DSCONFIG. However, DSCONFIG itself
|
|
needs to be configured first for proper terminal emulation by using
|
|
SETTERM. So, run SETTERM on DSCONFIG before using DSCONFIG to
|
|
configure DATSWEEP!
|
|
- After using PUTDS to initialize a directory for ZDS date stamping,
|
|
I am finding that it is necessary to run RELOG before the stamping
|
|
routines will actually start working.
|
|
- Generic CP/M PIP and ZSDOS path searching do not mix well if you
|
|
use PIP to copy to or from a directory in the ZSDOS search path. Best
|
|
to use COPY from the ZSDOS distribution.
|
|
- PUTBG.COM and BGPATCH.HEX are included, but note that they are for
|
|
use with BackGrounder II software which is not included. Refer to
|
|
the ZSDOS Manual for information on implementing BackGrounder II if
|
|
desired.
|
|
|
|
== Date Stamping Quick Start ==
|
|
|
|
== Notes ==
|
|
|
|
As I worked through the files in the distribution, it became clear that
|
|
there were problems with the distribution. For example, the .CFG files
|
|
for some apps (like FILEDATE.COM) are not acceptable to ZCNFG.
|
|
Additionally, the STAMPS.DAT file contains code that simply does not
|
|
work. In all of these cases, I found updated or fixed versions of the
|
|
files. However, the point is that I concluded I would need to go
|
|
through the distribution file-by-file and validate everything,
|
|
replacing anything that was not working as it should. See the notes below
|
|
for what I did.
|
|
|
|
The following list details the changes I made as I went along. In all
|
|
cases, my goal was to keep the result as close to the original
|
|
distribution as possible.
|
|
|
|
- CLOCKS.DAT has been updated to include the RomWBW clock driver,
|
|
WBWCLK. I have also added the SIMHCLOK clock driver.
|
|
- STAMPS.DAT has been replaced with an updated version. The update
|
|
was called STAMPS11.DAT and was found on the Walnut Creek CP/M CDROM.
|
|
The original version has a bug that causes RSX (resident system
|
|
extension) mode to fail to load properly.
|
|
- The original LDTIMD.COM and LDTIMP.COM have been replaced with
|
|
LDDS.COM (DateStamper) and LDP2D.COM (P2DOS) respectively. They are
|
|
equivalent but configured to use the RomWBW clock driver. They were
|
|
built exactly the same as the originals: Relative Clock driver w/ RSX
|
|
mode loading.
|
|
- A driver for NZT format time stamping has been added. It is called
|
|
LDNZT.COM.
|
|
- Updated FILEDATE.COM and FILEDATE.CFG from original v1.7 to v2.1.
|
|
The FILEDATE.CFG originally supplied was invalid.
|
|
- Updated FILEATTR to v1.6A. Original FILEATTR.CFG was invalid.
|
|
FILEATTR.CFG was replaced with FA16.CFG. Added associated files
|
|
FA16.DOC, FA16A.FOR, FA16CFG.TXT.
|
|
- Updated COPY.COM to v1.73. Also updated COPY.CFG to the one
|
|
distributed with COPY.COM v1.73. The original COPY.CFG was invalid
|
|
and appeared to be for a much older version of COPY.
|
|
- Configured DATSWEEP.COM and DSCONFIG to use ANSI Standard terminal
|
|
definition using SETTERM.
|
|
|
|
== ZSDOS 1.1 Files ==
|
|
|
|
The following files came from the official ZSDOS distribution. These
|
|
are generally documented in the "ZSDOS Manual.pdf" document in the Doc/CPM
|
|
directory of the RomWBW distribution. Note that some of the files
|
|
included in the ZSDOS distribution are not listed below because they
|
|
have been superseded by more recent versions listed in other sections
|
|
below. For example, ZXD is not listed here, but a more recent version is
|
|
included and documented in the General Purpose Applications section
|
|
below.
|
|
|
|
BGPATCH.HEX - Patches BackGrounder II for ZSDOS 1.1 compatibility
|
|
CLOCKS.DAT - Library of clock drivers
|
|
COPY.CFG - ZCNFG configuration file for COPY
|
|
COPY.COM - Enhanced file copy tool
|
|
COPY.UPD - Document describing updates to COPY program
|
|
DATSWEEP.COM - File management utility w/ date/time stamp awareness
|
|
DSCONFIG.COM - Program to configure DATSWEEP
|
|
FA16.CFG - ZCNFG configuration file for FILEATTR
|
|
FA16.DOC - Documentation for FILEATTR
|
|
FA16A.FOR - Summary of FILEATTR program version 16a
|
|
FA16CFG.TXT - Document describes FILEATTR configuration options
|
|
FILEATTR.COM - Set and/or display file attributes
|
|
FILEDATE.CFG - ZCNFG configuration fie for FILEDATE
|
|
FILEDATE.COM - Date/time stamping aware disk directory utility
|
|
INITDIR.CFG - ZCNFG configuration file for INITDIR
|
|
INITDIR.COM - Prepare disk for P2DOS date/time stamping
|
|
LDDS.COM - Load DateStamper date/time stamping resident extension
|
|
LDNZT.COM - Load NZT date/time stamping resident extension
|
|
LDP2D.COM - Load P2DOS date/time stamping resident extension
|
|
PUTBG.COM - Updated replacement for BackGrounder II PUTBG program
|
|
PUTDS.COM - Prepare disk for DateStamper date/time stamping
|
|
RELOG.COM - Clear fixed disk login vector in ZSDOS (see manual)
|
|
SETTERM.COM - Terminal configuration utility for DATSWEEP & DSCONFIG
|
|
SETUPZST.COM - Creates customized date/time stamping resident extensions
|
|
STAMPS.DAT - Library of available date/time stamping modules for SETUPZST
|
|
TD.CFG - ZCNFG configuration file for TD
|
|
TD.COM - Read and set system real-time clock
|
|
TERMBASE.DAT - Library of terminals used by SETTERM
|
|
TESTCLOK.COM - Test a selected clock driver
|
|
ZCAL.COM - Display a small one-month calendar to the screen
|
|
ZCNFG.COM - Configuration tool for programs with .CFG files
|
|
ZCNFG24.CFG - ZCNFG configuration file for ZCNFG
|
|
ZPATH.COM - Set or display ZSDOS and ZCPR search paths
|
|
ZSCONFIG.COM - Dynamically configure features of ZSDOS operating system
|
|
ZSVSTAMP.COM - Preserves file date/time stamp across modifications
|
|
ZSVSTAMP.DOC - Document describes the use and operation of ZSVSTAMP
|
|
|
|
== CP/M 2.2 Files ==
|
|
|
|
The following files have been included from CP/M 2.2. These files
|
|
provide various functionality that is not really available from the
|
|
ZSDOS applications themselves. For example, the CP/M 2.2 application
|
|
called STAT is useful for modifying the IOBYTE. Most of these
|
|
applications are documented in the "CPM Manual.pdf" document in the Doc/CPM
|
|
directory of the RomWBW distribution.
|
|
|
|
ASM.COM - DRI 8080 assembler producing Intel hex files
|
|
LIB.COM - DRI relocatable object file librarian
|
|
LINK.COM - DRI relocatable object file linker
|
|
LOAD.COM - DRI loader for Intel hex files
|
|
MAC.COM - DRI 8080 macro assembler producing Intel hex files
|
|
RMAC.COM - DRI 8080 macro assembler producing relocatable object files
|
|
STAT.COM - DRI multi-purpose file/disk/device info & configuration tool
|
|
SUBMIT.COM - DRI batch file submission tool
|
|
XSUB.COM - DRI batch file enhancer resident system extension
|
|
|
|
== RomWBW Supplemental Applications ==
|
|
|
|
The following files provide specific functionality enabled by
|
|
RomWBW enhancements. These applications are documented in the
|
|
"RomWBW Applications.pdf" document in the Doc directory of the
|
|
RomWBW Distribution.
|
|
|
|
ASSIGN.COM - Assign,remove,swap drive letters of RomWBW disk slices
|
|
FAT.COM - MS-DOS FAT filesystem tool (list, copy, delete, format, etc.)
|
|
FDU.COM - Test floppy hardware and format floppy disks
|
|
FORMAT.COM - Placeholder application with formatting instructions
|
|
INTTEST.COM - Test RomWBW interrupt processing on your hardware
|
|
MODE.COM - Change serial line characteristics (baud rate, etc.)
|
|
RTC.COM - Test real time clock hardware on your system
|
|
SURVEY.COM - Display system resources summary
|
|
SYSCOPY.COM - Copy system tracks to disks (make bootable)
|
|
SYSGEN.COM - Copy system tracks to disks (DRI version)
|
|
TALK.COM - Route console I/O to & from specified serial port
|
|
TIMER.COM - Test and display system timer ticks
|
|
TUNE.COM - Play .PT2, .PT3, and .MYM audio files on supported hardware
|
|
XM.COM - XModem file transfer application
|
|
ZMP.COM - ZModem communications program (requires dedicated comm port)
|
|
ZMP.DOC - Documentation for ZMP
|
|
ZMP.HLP - Help file for ZMP
|
|
ZMP.CFG - Configuration file for ZMP
|
|
ZMP.FON - Phone book for ZMP
|
|
ZMXFER.OVR - Overlay file for ZMP
|
|
ZMTERM.OVR - Overlay file for ZMP
|
|
ZMINIT.OVR - Overlay file for ZMP
|
|
ZMCONFIG.OVR - Overlay file for ZMP
|
|
|
|
== General Purpose Applications ==
|
|
|
|
The following files are commonly used CP/M applications that
|
|
are generally useful in any CP/M-like system. In general, there is
|
|
no documentation for these applications included with the RomWBW
|
|
distribution. Some provide command line help themselves. Some
|
|
are fairly obvious.
|
|
|
|
CLRDIR.COM - Initializes the directory area of a disk
|
|
COMPARE.COM - Compare content of two files (binary)
|
|
CRUNCH.COM - Compress file(s) using Crunch algorithm
|
|
CRUNCH28.CFG - ZCNFG configuration file for CRUNCH & UNCR
|
|
DDTZ.COM - Z80 debug tool (modified to use RST 6)
|
|
DDTZ.DOC - Documentation for DDTZ
|
|
EX.COM - Batch file processor (alternative to DRI SUBMIT)
|
|
FDISK80.COM - Hard disk partitioning tool (from John Coffman)
|
|
FIND.COM - Search all drives for a file (from Jay Cotton)
|
|
FLASH.COM - Program FLASH chips in-situ (from Will Sowerbutts)
|
|
FLASH.DOC - Documentation for FLASH
|
|
MBASIC.COM - Microsoft BASIC language interpreter
|
|
NULU.COM - Library (.LBR) management tool
|
|
PMARC.COM - Create or add file(s) to .PMA archive
|
|
PMEXT.COM - Extract file(s) from .PMA/.LZH/.LHA archive
|
|
RMXSUB1.COM - Remove XSUB1 RSX from memory (from Lars Nelson)
|
|
SUPERSUB.COM - Enhanced replacement for DRI SUBMIT
|
|
SUPERSUB.DOC - Documentation for SUPERSUB
|
|
TDLBASIC.COM - TDL Zapple 12K BASIC language interpreter
|
|
UNARC.COM - Extract file(s) from .ARC or .ARK archive
|
|
UNARC.DOC - Documentation for UNARC
|
|
UNCR.COM - Decompress Crunched file(s)
|
|
UNZIP.COM - UNZIPZ extracts from all MS-DOS ZIP files (from Lars Nelson)
|
|
UNZIP.DOC - Documentation for UNZIPZ
|
|
XSUB1.COM - Replacement for DRI SUB (from Lars Nelson)
|
|
ZAP.COM - Interactive disk & file utility
|
|
ZDE.COM - Compact WordStar-like editor
|
|
ZDENST.COM - Installation/configuration tool for ZDE
|
|
KERCPM22.COM - Kermit file transfer application
|
|
LBREXT.COM - Extract file from .LBR libraries
|
|
LBREXT36.CFG - ZCNFG configuration file for LBREXT
|
|
ZXD.COM - Enhanced directory lister w/ date/time stamp support
|
|
ZXD.CFG - ZCNFG configuration file for ZXD
|
|
BBCBASIC.COM - BBC BASIC CP/M Version by R.T.Russell
|
|
BBCBASIC.TXT - Help file for BBC BASIC
|
|
GENHEX.COM - Generates an Intel Hex file from the input file
|
|
LS.COM - An alternative file listing to DIR
|
|
LSWEEP.COM - Can extract and view member files of an .LBR archive
|
|
|
|
== Testing Applications (User Area 2) ==
|
|
|
|
User area 2 contains a variety of hardware testing applications.
|
|
These are generally user contributed and have no documentation.
|
|
Additionally, they are frequently not compatible with all RomWBW
|
|
hardware. They are included here as a convenience. If applicable,
|
|
your hardware documentation should refer to them and provide usage
|
|
instructions.
|
|
|
|
== Sample Tune Files (User Area 3) ==
|
|
|
|
User area 3 contains sample audio files that can be played using
|
|
the TUNE application.
|
|
|
|
== CP/NET 1.2 (User Area 4) ==
|
|
|
|
User area 4 contains a full implementation of the CP/NET 1.2
|
|
client provided by Doug Miller. Please read the README.TXT file
|
|
in this user area for more information.
|
|
|
|
N.B., at a minimum, some of the files in this user area must be copied
|
|
to user area 0 for CP/NET to work properly.
|
|
|
|
-- WBW 3:20 PM 8/27/2021
|