RomWBW/Source/Images/d_nzcom/ReadMe.txt

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