===== 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