Merge pull request #215 from wwarthen/dev

Dev

Source/Doc/ROM_Applications.md

@@ -45,54 +45,33 @@ for testing and programming. It allows programs to be entered,
 memory to be examined, and input/output devices to be read or
 written to.
 
-It's key advantage is that is available at boot up. 
-
-Its key disadvantages are that code cannot be entered in assembly language 
-and there is no ability to save to memory devices.
-
-The available memory are for programming is `0200-EDFFh`.  The following areas are reserved:
-
-Memory Area | Function
-------------|-----------------------------------
-`0000-00FFh`| Jump and restart (RST) vectors
-`0100-01FFh`| HBIOS configuration block
-`FE00-FFFFh`| HBIOS proxy
-
-Commands can be entered at the command prompt `>` 
-Automatic case conversion takes place on command entry and all arguments are expected to be in hex format.
-
-The current memory bank in low memory is displayed before the prompt i.e.:
-
-`8E>`
-
-Refer to the RomWBW Architecture manual for details memory banking.
+It's key advantage is that is available at boot up.
 
 A quick guide to using the Monitor program follows:
 
 ## ? - Displays a summary of available commands.
 
 ```
-Monitor Commands (all values in hex):
-B                    - Boot system
-D xxxx yyyy          - Dump memory from xxxx to yyyy
-F xxxx yyyy zz       - Fill memory from xxxx to yyyy with zz
-H                    - Halt system
-I xxxx               - Input from port xxxx
-K                    - Keyboard echo
-L                    - Load Intel hex data
-M xxxx yyyy zzzz     - Move memory block xxxx-yyyy to zzzz
-O xxxx yy            - Output value yy to port xxxx
-P xxxx               - Program RAM at address xxxx
-R xxxx [[yy] [zzzz]] - Run code at address xxxx
-                       Pass yy and zzzz to register A and BC
-S xx                 - Set bank to xx
-X                    - Exit monitor
+Monitor Commands (all values in hex):`
+B                - Boot system`
+D xxxx yyyy      - Dump memory from xxxx to yyyy`
+F xxxx yyyy zz   - Fill memory from xxxx to yyyy with zz`
+H                - Halt system`
+I xxxx           - Input from port xxxx`
+K                - Keyboard echo`
+L                - Load Intel hex data`
+M xxxx yyyy zzzz - Move memory block xxxx-yyyy to zzzz`
+O xxxx yy        - Output value yy to port xxxx`
+P xxxx           - Program RAM at address xxxx`
+R xxxx           - Run code at address xxxx`
+S xx             - Set bank to xx`
+X                - Exit monitor`
 ```
 
 ## Cold Boot
 
 B - Performs a cold boot of the ROMWBW system. A complete
-re-initialization of the system is performed and the system
+reinitialization of the system is performed and the system
 returns to the Boot Loader prompt.
 
 ## Dump Memory
@@ -181,19 +160,10 @@ Use clip leaded LEDs to confirm the data written.
 ## Program memory location
 
 P xxxx - Program memory location xxxx. This routine will
-allow you to program a hexadecimal into memory starting
+allow you to program a hexidecimal into memory starting
 at location xxxx. Press 'Enter' on a blank line to
 return to the Monitor prompt.
 
-## Run program
-
-R xxxx [[yy] [zzzz]] - Run program at location xxxx. if optional
-arguments yy and zzzz are entered they are loaded into the
-A and BC register respectively. The return address of the
-Monitor is saved on the stack so the program can return
-to the monitor. On return to the monitor, the contents of
-the A, HL, DE and BC registers are displayed.
-
 ## NOTES:
 
 The Monitor allows access to all memory locations. ROM and
@@ -217,4 +187,4 @@ and then run RTC to see the options list.
 
 # Network Boot
 
-# ZModem Flash Update
+# ZModem Flash Update

Source/HBIOS/dbgmon.asm

@@ -472,13 +472,15 @@ PCRLF:
 	LD	C,16			; SET FOR 16 CHARS
 	POP	HL			; GET BACK START
 PCRLF0:
-	LD	A,(HL)			; GET BYTE
-	AND	060H			; SEE IF A 'DOT'
-	LD	A,(HL)			; O K. TO GET
-	JR	NZ,PDOT			;
-DOT:
-	LD	A,2EH			; LOAD A DOT
+	LD	A,(HL)			; GET BYTE TO PRINT
+	CP	$20			; CONTROL CHAR (UNPRINTABLE)?
+	JR	C,PDOT			; IF SO, PRINT A DOT
+	CP	$7F			; 127 OR MORE (UNPRINTABLE)?
+	JR	NC,PDOT			; IF SO, PRINT A DOT
+	JR	PCHAR			; PRINT ACTUAL CHAR
 PDOT:
+	LD	A,2EH			; OTHERWISE SUBSTITUTE A DOT
+PCHAR:
 	CALL	COUT			; PRINT IT
 	INC	HL			;
 	LD	A,D			;

Source/Images/Build.cmd

@@ -6,9 +6,9 @@ echo Building Floppy Disk Images...
 echo.
 call BuildDisk.cmd cpm22 wbw_fd144 ..\cpm22\cpm_wbw.sys || exit /b
 call BuildDisk.cmd zsdos wbw_fd144 ..\zsdos\zsys_wbw.sys || exit /b
-call BuildDisk.cmd nzcom wbw_fd144 ..\zsdos\zsys_wbw.sys || exit /b
+::call BuildDisk.cmd nzcom wbw_fd144 ..\zsdos\zsys_wbw.sys || exit /b
 call BuildDisk.cmd cpm3 wbw_fd144 ..\cpm3\cpmldr.sys || exit /b
-call BuildDisk.cmd zpm3 wbw_fd144 ..\cpm3\cpmldr.sys || exit /b
+::call BuildDisk.cmd zpm3 wbw_fd144 ..\cpm3\cpmldr.sys || exit /b
 call BuildDisk.cmd ws4 wbw_fd144 || exit /b
 
 echo.

Source/Images/Makefile

@@ -3,8 +3,8 @@
 #
 SYSTEMS = ../CPM22/cpm_wbw.sys ../ZSDOS/zsys_wbw.sys ../CPM3/cpmldr.sys
 
-FDIMGS = fd144_cpm22.img fd144_zsdos.img fd144_nzcom.img \
-	fd144_cpm3.img fd144_zpm3.img fd144_ws4.img
+FDIMGS = fd144_cpm22.img fd144_zsdos.img \
+	fd144_cpm3.img fd144_ws4.img
 HD512IMGS = hd512_cpm22.img hd512_zsdos.img hd512_nzcom.img \
 	hd512_cpm3.img hd512_zpm3.img hd512_ws4.img
 # HDIMGS += hd512_bp.img

Source/Images/d_cpm22.txt

@@ -1,4 +1,8 @@
 #
+# Add the ReadMe document
+#
+d_cpm22/ReadMe.txt 0:
+#
 # Add RomWBW utilities
 #
 #../../Binary/Apps/*.com 0:
@@ -31,6 +35,7 @@
 ../../Binary/Apps/ppidetst.com 2:
 ../../Binary/Apps/ramtest.com 2:
 ../../Binary/Apps/tstdskng.com 2:
+Test/*.* 2:
 #
 # Add Tune sample files
 #

Source/Images/d_cpm22/ReadMe.txt

@@ -0,0 +1,162 @@
+===== CP/M-80 2.2 Disk for RomWBW =====
+
+This disk is one of several ready-to-run disks provided with RomWBW.  
+It contains a vanilla distribution of DRI's CP/M-80 2.2 adapted 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
+Getting Started.pdf" document found in the Doc directory of the
+RomWBW Distribution.
+
+== Usage ==
+
+  - All installation steps needed to run CP/M 2.2 have already been
+    performed.  It is not necessary to perform the steps in the
+    Alteration section of the CPM Manual.
+  - The MOVCPM application referred to in the manual is not needed
+    with RomWBW and is not included.
+  - The manual refers to the use of SYSGEN to install a copy of CP/M 2.2
+    on the boot tracks of a disk to make it bootable.  Under RomWBW, it
+    is recommended that you use SYSCOPY instead.  SYSGEN is included,
+    but SYSCOPY is more flexible.  The use of SYSCOPY is documented in
+    the RomWBW Applications document.
+
+== Notes ==
+
+  - SUBMIT.COM has been patched per the official DRI patch list such
+    that the submit file will always be placed on the A: drive which
+    ensures it will be run properly even if your default drive is not
+    currently A:.
+  - DDT, DDTZ, and ZSID have been patched to use RST 6 instead of the
+    original RST 7 vector for single step debugging.  This is mandatory
+    for a Z80 CPU which uses RST 7 for hardware interrupts.
+  - CP/M 2.2 was not distributed with a help system.  Douglas Miller
+    has adapted the CP/M 3 help system for CP/M 2.2 and is included.
+    The HELP.HLP data file must be found on the current default drive
+    and user area when HELP.COM is run.
+
+== CP/M 2.2 Files ==
+
+The following CP/M 2.2 files were distributed by DRI with the operating
+system or as supplemental add-on programs.  They are documented in the
+"CP/M Manual.pdf" document in the Doc directory of the Rom WBW
+distribution.  MAC, RMAC, ZSID are supplemental programs from DRI
+with separate standalone documentation which is not included in the
+RomWBW package (but easily found on the Internet via Google search).
+
+ASM.COM - DRI 8080 assembler producing Intel hex files
+DDT.COM - DRI 8080 debugger
+DUMP.COM - Tool to dump a file in hex
+ED.COM - DRI line editor
+HELP.COM - HELP display program (derived from CP/M 3 HELP.COM)
+HELP.HLP - HELP data file
+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
+PIP.COM - DRI file transfer (Peripheral Interchange Program)
+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
+ZSID.COM - DRI enhanced debugger for Z80 CPU
+
+== 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
+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
+
+== Testing Applications (User Area 2) ==
+
+User area 2 contains a variety of hardware testing applications.
+These are generally user contributed and have no documentation.
+
+N.B., these applications 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

Source/Images/d_nzcom.txt

@@ -1,4 +1,25 @@
 #
+# Add the ReadMe document
+#
+d_nzcom/ReadMe.txt 0:
+#
+# Include selected CP/M 2.2 files
+#
+d_cpm22/u0/ASM.COM 0:
+d_cpm22/u0/LIB.COM 0:
+d_cpm22/u0/LINK.COM 0:
+d_cpm22/u0/LOAD.COM 0:
+d_cpm22/u0/MAC.COM 0:
+#d_cpm22/u0/PIP.COM 0: ???
+d_cpm22/u0/RMAC.COM 0:
+d_cpm22/u0/STAT.COM 0:
+d_cpm22/u0/SUBMIT.COM 0:
+d_cpm22/u0/XSUB.COM 0:
+#
+# Include ZSDOS files
+#
+d_zsdos/u0/*.* 0:
+#
 # Add RomWBW utilities
 #
 #../../Binary/Apps/*.com 0:
@@ -31,15 +52,16 @@
 ../../Binary/Apps/ppidetst.com 2:
 ../../Binary/Apps/ramtest.com 2:
 ../../Binary/Apps/tstdskng.com 2:
-##
-## Add Tune sample files
-##
-#../../Binary/Apps/Tunes/*.pt? 3:
-#../../Binary/Apps/Tunes/*.mym 3:
-##
-## Add CPNET client files
-##
-#cpnet12/*.* 4:
+Test/*.* 2:
+#
+# Add Tune sample files
+#
+../../Binary/Apps/Tunes/*.pt? 3:
+../../Binary/Apps/Tunes/*.mym 3:
+#
+# Add CPNET client files
+#
+cpnet12/*.* 4:
 #
 # Add OS images
 #
@@ -55,3 +77,7 @@ Common/Z/u15/*.* 0:
 Common/Z3/u10/*.* 0:
 Common/Z3/u14/*.* 0:
 Common/Z3/u15/*.* 0:
+#
+# Temporary!!!
+#
+SIMH/*.* 15:

Source/Images/d_nzcom/ReadMe.txt

@@ -0,0 +1,316 @@
+===== NZCOM Disk for RomWBW =====
+
+This disk is one of several ready-to-run disks provided with
+RomWBW.  It contains NZ-COM, which is an implementation of the
+Z-System.  You may also see NZ-COM referred to as ZCPR 3.4.  This is
+a powerful replacement for CP/M 2.2 w/ full backward compatibility.
+
+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.  See the Usage and Notes sections below for more
+information on how NZ-COM is loaded.
+
+The remainder of this document describes the usage and contents of
+this disk.  It is highly recommended that you review the "RomWBW
+Getting Started.pdf" document found in the Doc directory of the
+RomWBW Distribution.
+
+The primary documentation for NZ-COM is the "NZCOM Users Manual.pdf" 
+document  contained in the Doc directory of the RomWBW distribution.  
+This document is a supplement to the primary documentation.  Additionally,
+please review the file called RELEASE.NOT on this disk which contains
+a variety of updates regarding the NZ-COM distribuition.
+
+The starting point for the disk content was the final official release of
+NZ-COM which is generally available on the Internet.  A minimal
+system generation was done just sufficient to get NZ-COM to run under
+RomWBW.  NZ-COM is extremely configurable and far more powerful than
+DRI CP/M.  It is almost mandatory that you read the NZ-COM manual to
+use the system effectively.
+
+== Usage ==
+
+NZCOM is not designed to load directly from the boot tracks of a
+disk.  Instead, it expects to be loaded from an already running
+OS.  This disk has been configured to boot using ZSDOS with a
+PROFILE.SUB command file that automatically loads NZCOM.  So, NZCOM
+will load completely without any intervention, but you may notice
+that ZSDOS loads first, then ZSDOS loads NZCOM.  This is normal.
+
+There is no DIR command.  Use SDZ or ZXD instead.
+
+*** TODO: Date stamping ***
+
+== Notes ==
+
+NZCOM is distributed in an unconfigured state.  The following was
+done to create a minimal ready-to-run setup for RomWBW:
+
+  - Ran MKZCM and saved default configuration to NZCOM.ZCM and
+    NZCOM.ENV.
+  - Extract VT100 TCAP from Z3TCAP.LBR and saved it as TCAP.Z3T.
+  - Created PROFILE.SUB to launch NZCOM at startup.
+  - Created empty STARTZCM.COM.
+  - TCSELECT.COM was removed because a later version is provided
+    from the Z3 files.
+  - Z3LOC.COM and LBREXT.COM were removed because more recent
+    versions are provided from Common files.
+  - Replaced ZRDOS with ZSDOS in NZCOM.LBR.  The standalone
+    ZRDOS.ZRL and ZSDOS.ZRL files were saved.
+
+The following additional customizations were also performed:
+
+  - The following files from the original distribution were removed
+    because newer versions are included:
+    
+    - COPY.COM
+    - CRUNCH.COM
+    - LBREXT.COM
+    - TCSELECT.COM
+    - UNCRUNCH.COM
+    - Z3LOC.COM
+    - ZCNFG.COM
+
+== NZCOM Files ==
+
+The following files came from the official NZCOM distribution.  These 
+are generally documented in the "NZCOM Users Manual.pdf" document in 
+the Doc directory of the RomWBW distribution.  Note that some of the 
+files included in the NZ-COM distribution are not listed below because 
+they have been superseded by more recent versions listed in other 
+sections below.  For example, TCSELECT is not listed here, but a more 
+recent version is included and documented in the General Purpose 
+Applications section below.
+
+!(C)1988 - Original copyright (since placed in public domain)
+!NZ-COM - Software marker directory entry (empty file)
+!VERS--1.2H - Version marker directory entry (empty file)
+ALIAS.CMD - Sample alias definitions for use with ARUNZ
+ARUNZ.COM - Alias-RUN-forZ-System command alias execution
+BGZRDS19.LBR - ???
+CLEDINST.COM - Configure RCP-resident command line editor
+CLEDSAVE.COM - Save RCP-resident command line editor history
+CONFIG.LBR - Various configuration files for use with ZCNFG
+CPSET.COM - Displays/defines CRT/PRT characteristics
+DOCFILES.LBR - Documentation and help files collected into an LBR file
+EDITNDR.COM - Edit named directory register in memory
+FCP.LBR - Library of alternative FCP modules
+FF.COM - File finder utility
+HELP.COM - (HELPC14) is an improved version of the help utility
+HLPFILES.LBR - Various app help files for use with LBRHELP
+IF.COM - Extended flow control tester
+JETLDR.COM - Z-System package loader
+LBRHELP.COM - Help file viewer for use with help file libraries (.LBR)
+LDIR.COM - Directory lister for libraries (.LBR)
+LPUT.COM - Puts file(s) into a library (.LBR)
+LSH-HELP.COM - Display LSH help when LSH is running
+LSH.COM - Command history shell and command line editor
+LSH.WZ - User manual for LSH
+LSHINST.COM - LSH configuration editor
+LX.COM - Execute programs directly from a library (.LBR)
+MKZCM.COM - Create/update NZ-COM load environment
+NAME.COM - Quickly add or remove a name for a single directory
+NZ-DBASE.INF - dBase II application note regarding SUBMIT files
+NZBLITZ.COM - Rapid coldboot of complete NZ-COM system image
+NZBLTZ14.CFG - ZCNFG configuration file for NZBLITZ
+NZBLTZ14.HZP - Help file for NZBLITZ
+NZCOM.COM - Loads and launches NZ-COM system
+NZCOM.ENV - Z-System environment descriptor
+NZCOM.LBR - Library containing NZ-COM system modules
+NZCOM.ZCM - NZ-COM environment descriptor (alternate format)
+NZCPR.LBR - Library of alternative ZCPR modules
+PATH.COM - Set/display command search path
+PROFILE.SUB - Command file to auto-start NZ-COM at system boot
+PUBLIC.COM - Specify ZRDOS public directories/user areas
+PWD.COM - Displays DU and Directory Names with paging
+RCP.LBR - Library of alternative RCP modules
+RELEASE.NOT - Update information on NZ-COM
+SAINST.COM - Install/configure SALIAS
+SALIAS.COM - Screen oriented alias editor
+SAVENDR.COM - Writes the named directory register to disk
+SDZ.COM - Enhanced directory lister
+SHOW.COM - Display Z-System configuration information
+STARTZCM.COM - Commands to execute after NZ-COM is launched
+SUB.COM - Enhanced version of SUBMIT
+TCJ.INF - Description of included articles from The Computer Journal
+TCJ*.WZ - Selected articles from The Computer Journal
+TY3ERA.COM - Type 3 erase command
+TY3REN.COM - Type 3 rename command
+TY4ERA.COM - Type 4 erase command
+TY4REN.COM - Type 4 rename command
+TY4SAVE.COM - Type 4 save command
+TY4SP.COM - Type 4 disk space command
+VIEW.COM - Quad directional file viewer
+XTCAP.COM - Interactive Extended TCAP Installer
+Z3TCAP.TCP - Database of terminal descriptors
+ZERR.COM - Z34 Error Handler
+ZEX.COM - Powerful command line processor
+ZF-DIM.COM - Point-and-shoot user interface for dim-video terminals
+ZF-REV.COM - Point-and-shoot user interface for reverse-video terminals
+ZFILEB38.LZT - Brief listing of Z-System support programs
+ZFILER.CMD - Macro script file for ZFILER
+ZHELPERS.LZT - List of volunteers who will help installing Z-System
+ZLT.COM - File lister with support for compressed files
+ZNODES66.LZT - List of Z-Node remote access systems
+ZRDOS.ZRL - Relocatable version of ZRDOS BDOS module
+ZSDOS.ZRL - Relocatable version of ZSDOS 1.1 BDOS module
+ZSYSTEM.IZF - Information on Z-System and related products
+
+== 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
+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
+
+== ZSDOS Files ==
+
+The following files came from the official ZSDOS distribution.  These
+are generally documented in the "ZSDOS Manual.pdf" document in the Doc
+directory of the RomWBW distribution.  These files are relevant under
+NZ-COM because ZSDOS is a part of the NZ-COM system.
+
+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
+
+== 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
+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
+
+== 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

Source/Images/d_nzcom/u0/PROFILE.SUB

@@ -0,0 +1,2 @@
+NZCOM NZCOM.ZCM TCAP.Z3T
+

Source/Images/d_zpm3.txt

@@ -43,22 +43,22 @@
 ../../Binary/Apps/zminit.ovr 15:
 ../../Binary/Apps/zmconfig.ovr 15:
 #
-#../../Binary/Apps/i2clcd.com 2:
-#../../Binary/Apps/i2cscan.com 2:
-#../../Binary/Apps/rtcds7.com 2:
-#../../Binary/Apps/rtchb.com 2:
-#../../Binary/Apps/ppidetst.com 2:
-#../../Binary/Apps/ramtest.com 2:
-#../../Binary/Apps/tstdskng.com 2:
-##
-## Add Tune sample files
-##
-#../../Binary/Apps/Tunes/*.pt? 3:
-#../../Binary/Apps/Tunes/*.mym 3:
-##
-## Add CPNET client files
-##
-#cpnet3/*.* 4:
+../../Binary/Apps/i2clcd.com 2:
+../../Binary/Apps/i2cscan.com 2:
+../../Binary/Apps/rtcds7.com 2:
+../../Binary/Apps/rtchb.com 2:
+../../Binary/Apps/ppidetst.com 2:
+../../Binary/Apps/ramtest.com 2:
+../../Binary/Apps/tstdskng.com 2:
+#
+# Add Tune sample files
+#
+../../Binary/Apps/Tunes/*.pt? 3:
+../../Binary/Apps/Tunes/*.mym 3:
+#
+# Add CPNET client files
+#
+cpnet3/*.* 4:
 #
 # Add Common Applications
 #

Source/Images/d_zsdos.txt

@@ -1,4 +1,8 @@
 #
+# Add the ReadMe document
+#
+d_zsdos/ReadMe.txt 0:
+#
 # Include selected CP/M 2.2 files
 #
 d_cpm22/u0/ASM.COM 0:
@@ -6,6 +10,7 @@ d_cpm22/u0/LIB.COM 0:
 d_cpm22/u0/LINK.COM 0:
 d_cpm22/u0/LOAD.COM 0:
 d_cpm22/u0/MAC.COM 0:
+#d_cpm22/u0/PIP.COM 0: ???
 d_cpm22/u0/RMAC.COM 0:
 d_cpm22/u0/STAT.COM 0:
 d_cpm22/u0/SUBMIT.COM 0:
@@ -43,6 +48,7 @@ d_cpm22/u0/XSUB.COM 0:
 ../../Binary/Apps/ppidetst.com 2:
 ../../Binary/Apps/ramtest.com 2:
 ../../Binary/Apps/tstdskng.com 2:
+Test/*.* 2:
 #
 # Add Tune sample files
 #

Source/Images/d_zsdos/u0/ROMWBW.TXT → Source/Images/d_zsdos/ReadMe.txt

@@ -6,7 +6,7 @@ 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 contents and usage of
+The remainder of this document describes the usage and contents of
 this disk.  It is highly recommended that you review the "RomWBW
 Getting Started.pdf" document found in the Doc directory of the
 RomWBW Distribution.
@@ -52,47 +52,7 @@ 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.
 
-== Construction 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.
-
-== Usage Notes ==
+== Usage ==
 
   - All installation steps needed to run ZSDOS have already been
     performed.  It is not necessary to perform any of the steps in
@@ -136,6 +96,47 @@ distribution as possible.
     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 ==
 
@@ -180,13 +181,6 @@ 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
-ZMP.COM - ZModem communications program (requires dedicated comm port)
-ZMP.DOC - Documentation for ZMP
-ZMP.HLP - Help file 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
 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
@@ -232,6 +226,13 @@ 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
+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 ==
 
@@ -272,10 +273,10 @@ 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 stamping support
+ZXD.COM - Enhanced directory lister w/ date/time stamp support
 ZXD.CFG - ZCNFG configuration file for ZXD
 
-== Testing Applications ==
+== Testing Applications (User Area 2) ==
 
 User area 2 contains a variety of hardware testing applications.
 These are generally user contributed and have no documentation.
@@ -284,15 +285,18 @@ hardware.  They are included here as a convenience.  If applicable,
 your hardware documentation should refer to them and provide usage
 instructions.
 
-== Sample Tune Files ==
+== 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 ==
+== 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.
 
--- WBW 5:46 PM 8/19/2021
+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

Source/ver.inc

@@ -2,4 +2,4 @@
 #DEFINE	RMN	1
 #DEFINE	RUP	1
 #DEFINE	RTP	03
-#DEFINE BIOSVER	"3.1.1-pre.110"
+#DEFINE BIOSVER	"3.1.1-pre.111"

Source/ver.lib

@@ -3,5 +3,5 @@ rmn	equ	1
 rup	equ	1
 rtp	equ	0
 biosver	macro
-	db	"3.1.1-pre.110"
+	db	"3.1.1-pre.111"
 	endm