***********************************************************
  *                                                         *
  *                   INSTALLATION MANUAL                   *
  *                                                         *
  *                           for                           *
  *                                                         *
  *  ZCPR3 -- Z80 Command Processor Replacement, Version 3  *
  *                                                         *
  ***********************************************************


                              by

                         Richard Conn



                      Installation Manual
                         11 June 1984






                       ZCPR3 Version 3.0

              Copyright (c) 1984 by Richard Conn
                      All Rights Reserved



    Th堠 ZCPR�� System��� includin� it� utilitie� an䠠 it� �
documentatio� files�� i� copyright�� 1984�� b� Richar� Conn�  Th� �
appendi� list� al� file� covere� b� thi� copyright.



    CP/� i� � registere� trademar� o� Digita� Research.
    WordStar is a registered trademark of Micropro.

pa �.pn 1
he    ZCPR3 -- An Enhanced Z80-Based Replacement for the CP/M CCP
fo Installation Manual                                Page #



1. O V E R V I E W   o f   Z C P R 3   I N S T A L L A T I O N 



1.1. Introduction

    Installatio� o� ZCPR�� i� a� involve� process�� an� th� �
installe� mus� hav� � workin� knowledg� o� th� following:

         1� 808� an� Z8� assembl� languag� programming
         2) CP/M 2.2
         3) the CP/M SYSGEN procedure


    Ther� ar� thre� part� o� th� syste� whic� mus� b� create� o� �
initialize� durin� th� installatio� process:

         1�� th� Operatin� System� o� SYSGEΠ image�� whic� i� �
presen� o� th� syste� track� fo� mos� computer� an� include� � �
dis� boot�� th� ZCPR� Comman� Processor� th� CP/� 2.� BDOS� an� � �
modifie� BIOS

         2�� th� ZCPR� Syste� Segments�� whic� ar� independen� �
file� tha� ma� b� loade� fro� dis� int� th� appropriat� place� i� �
memor� b� th� ZCPR� utilit� name� LDR.COM

         3� th� variou� ZCPR� utilities� eac� o� whic� ha� t� b� �
provide� wit� th� addres� o� th� ZCPR� Environmen� Descriptor

    Th� ZCPR� Syste� i� tie� togethe� b� th� ZCPR�� Environmen� �
Descriptor�� whic� i� � se� o� buffer� tha� passe� informatio� �
betwee� al� element� o� � ZCPR� System��  Th� ZCPR�� Environmen� �
Descripto� contain� informatio� suc� a� th� addresse� o� th� �
Syste� Segments�� th� addresse� o� severa� buffer� whic� ar� �
significan� t� ZCPR3� dat� o� wha� ZCPR� resource� ar� available� �
an� informatio� abou� th� physica� attribute� o� som� o� th� �
input/outpu� device� connecte� t� th� syste� (suc� a� th� numbe� �
o� column� an� line� o� th� CR� screen).


1.1.1. Operating System Memory Images

    Th� installe� mus� buil� � prope� SYSGE� Memor� Imag� o� th� �
targe� ZCPR� Syste� (th� targe� operatin� system� i� th� syste� �
bein� built� a� oppose� t� th� hos� operatin� system� whic� i� th� �
syste� use� t� buil� th� targe� system)��  I� buildin� th� targe� �
system�� th� ZCPR� Comman� Processo� mus� b� assemble� an� � BIO� �
containin� � modifie� Col� Boo� routin� mus� b� prepared.

pa �1.1.2. System Segments

    Th� installe� mus� selec� an� assembl� th� variou� ZCPR� �
Syste� Segment� t� b� use� i� conjunctio� wit� th� targe� ZCPR� �
System��  � Syste� Segment� i� � fil� whic� i� loade� int� � fixe� �
locatio� i� memor� b� th� LDR.CO� ZCPR�� utility��  Eac� Syste� �
Segmen� stay� memory-residen� unti� � ne�� Syste� Segmen� i� �
loade� ove� it��  Dependin� o� th� command� issued�� th� ZCPR� �
Comman� Processo� o� � ZCPR� utilit� ma� cal� upo� � loade� �
Syste� Segmen� t� perfor� � functio� o� provid� information.

    Al� Syste� Segment� mus� b� initialize� b� th� Col� Boo� �
routin堠 i� th� BIOӠ o� th� targe� ZCPR��� System���  Thi� �
initializatio� consist� o� zeroin� ou� th� firs� � byte� o� eac� �
segment'� memor� buffer�� wher� � depend� upo� th� segmen� bein� �
initialized.

    Th� followin� ar� th� Syste� Segment� whic� ar� supporte� b� �
ZCPR3��  Eac� Syste� Segmen� ha� � distinctiv� fil� type�� an� �
LDR.CO� recognize� thi� an� load� eac� segmen� differently.

Segment File Type        Function of System Segment

    *.ENV               Environment Descriptor, including a TCAP
    *.Z3T               ZCPR3 TCAP Entry

    *.FCP               Flow Command Package

    *.IOP               Input/Output Package

    *.NDR               Named Directory File

    *.RCP               Resident Command Package



    �� package�� a� referre� t� abov� i� � se� o� executabl� �
subroutine� whic� i� divide� int� tw� part� -- th� visibl� �
section�� throug� whic� a� interfac� t� th� routine� i� provided� �
an� th� hidde� section�� whic� contain� th� cod� o� th� routines�  �
Bein� � Syste� Segment�� � packag� ca� b� loade� dynamicall� an� �
tim� durin� � termina� sessio� b� runnin� th� LDR.CO� utility.

         1.1.2.1. Flow Command Packages

         �� Flo�� Comman� Package� i� � packag� whic� implement� �
th� ZCPR� flo� commands��  Thes� command� ar� IF�� ELSE� F� (sam� �
a� ENDIF)�� an� XI� (exi� al� IFs)�� an� thei� functio� i� t� �
contro� th� flo� o� comman� executio� b� settin� th� Flo�� State� �
t� TRU� o� FALSE��  I� th� Flo� Stat� i� TRUE�� al� command� ar� �
allowe� t� execute�� i� th� Flo� Stat� i� FALSE�� onl�� Flo� �
Command� (IF, ELSE, FI, and XIF� ar� allowe� t� run.

pa �          A� exampl� o� � comman� sequenc� containin� flo� �
commands is:

              IF EXIST MYFILE.TXT
                   TYPE MYFILE.TXT
              ELSE
                   ECHO MYFILE.TXT DOES NOT EXIST
              FI


         1.1.2.2. Input/Output Packages

         A� Input/Outpu� Package� i� � packag� whic� contain� � �
se� o� input/outpu� drivers�  Th� I/� Packag� i� use� b� th� BIO� �
t� provid� th� low-leve� devic� driver� whic� suppor� consol� �
input/output�� lis� output�� punc� output�� an� reade� input�  A� �
I/Ϡ Packag� ca� suppor� man�� mor� console�� list�� punch�� an� �
reade� device� tha� th� standar� CP/� I/� byte�� an� i� add� th� �
flexibilit�� o� bein� � package�� whic� ca� b� replace� wit� � �
differen� packag� dynamicall� b� runnin� th� LDR.CO� utility.


         1.1.2.3. Resident Command Packages

         �� Residen� Comman� Package� i� � collectio� o� memory-�
residen� command� whic� ca� b� use� t� supplemen� th� command� �
residen� withi� th� ZCPR� Comman� Processo� itsel� (th� ZCPR3-�
Residen� Commands)�  Thes� command� replac� � numbe� o� CO� file� �
b� on� *.RC� file�� and� bein� memory-resident� the� ar� execute� �
ver�� quickl� withou� an� additiona� dis� accesse� takin� place�  �
Whe� th� use� issue� � command�� th� curren� RC� i� checke� fo� � �
matc� o� th� comman� befor� � dis� acces� i� performe� t� searc� �
fo� � matchin� CO� file��  Se� th� sectio� o� "Comman� Searc� �
Hierarchy� fo� mor� details.


         1.1.2.4. Environment Descriptor and Z3TCAP

         Th� ZCPR� Environmen� Descriptor� i� � dat� fil� whic� �
contain� informatio� o� severa� attribute� o� th� ZCPR�� System�  �
Additionally�� th� Environmen� Descripto� contain� � ZCPR�� TCA� �
(Termina� Capabilities)� entr� whic� describe� variou� attribute� �
o� th� consol� CRT�� suc� a� th� sequenc� o� character� t� caus� �
it� scree� t� clea� o� t� positio� it� cursor.


         1.1.2.5. ZCPR3 Named Directories

         Th� ZCPR� Name� Directory� fil� contain� dat� relatin� � �
mnemonic�� suc� a� PASCA� o� ROBERT� wit� � Dis� an� Use� Are� (� �
logica� directory)�  Unde� ZCPR3� Name� Directorie� an� Disk/Use� �
(DU� form� ca� b� use� t� refe� t� logica� directories:

              DIR A15:            DIR ROOT:
pa �
1.1.3. Utilities

    T� b� use� effectivel� a� � par� o� � ZCPR�� System�� al� �
ZCPR�� utilitie� mus� b� initialize� t� contai� eithe� (1�� � �
pointe� t� th� ZCPR� Environmen� Descripto� i� suc� � descripto� �
i� availabl� a� � Syste� Segmen� o� (2� th� ZCPR�� Environmen� �
Descripto� itself.

    Th堠 ZCPR�� utilit�� Z3INS.CO͠ i� use� t� perfor� thi� �
initialization�  Z3INS.CO� wil� instal� � grou� o� utilitie� wit� �
th� require� informatio� ver� quickl� an� mak� thi� proces� �
relativel�� painless��  Z3INS.CO͠ itsel� doe� no� nee� t� b� �
installed but can be for consistency sake.

    O� al� th� ZCPR� utilitie� (ove� 70� whic� ar� containe� �
withi� th� ZCPR� System�� onl� one�� ZEX�� canno� b� installe� b� �
Z3INS�  ZE� ha� t� b� assemble� i� orde� t� b� installed.


1.1.4. Other Basic Concepts

    1.1.4.1. Command Search Hierarchy

    Wheneve� � comman� i� issued�� th� ZCPR� Comman� Processo� �
perform� � serie� o� step� i� determinin� ho� th� comman� i� t� �
b� performed��  Thes� step� ar� calle� th� ZCPR� Comman� Searc� �
Hierarchy.

    Unde� CP/� 2.2�� wheneve� � comman� wa� issue� th� Consol� �
Command Processor (CCP) would perform these steps:

         1�� Pars� th� comman� nam� an� chec� t� se� i� i� i� � �
residen� comman� withi� th� CC� (lik� DI� o� ERA)�� i� resident� �
execut� i� (allowin� th� built-i� comman� cod� t� pars� th� �
comman� lin� th� res� o� th� way)

         2�� Pars� th� res� o� th� comman� line�� stor� variou� �
part� o� th� comman� lin� i� variou� buffers�� an� loo� o� th� �
currentl�� logged-i� dis� (o� som� othe� dis� i� th� comman� wa� �
o� th� for� "d:command"� fo� � fil� name� "command.COM"�� i� �
found� execut� it� els� giv� erro� message

    The ZCPR3 Command Search Hierarchy is as follows:

         1� Pars� th� comman� line� storin� variou� part� o� th� �
comman� lin� i� variou� buffer� (simila� t� th� CP/͠ 2.� �
convention)

         2� I� th� flo� comman� packag� featur� i� enabled� pas� �
th� comman� nam� t� th� flo� comman� package�� i� th� packag� �
respond� i� th� affirmative�� allo� th� flo� comman� packag� t� �
execut� th� comman� an� resum� wit� th� nex� comman� line

�          3� I� th� flo� comman� featur� i� enabled� chec� t� se� �
i� th� flo� stat� i� TRU� (n� I� i� i� effec� o� th� curren� I� �
i� TRUE)� i� not� ski� furthe� comman� processin� an� resum� wit� �
the next command line

         4�� I� th� residen� comman� packag� featur� i� enabled� �
pas� th� comman� nam� t� th� residen� comman� package�� i� th� �
packag� respond� i� th� affirmative�� allo� th� residen� comman� �
packag� t� execut� th� comman� an� resum� wit� th� nex� comman� �
line

         5��  Chec� t� se� i� th� comman� i� residen� withi� th� �
ZCPR� Comman� Processo� itself� i� so� invok� th� cod� t� execut� �
the command and resume with the next command line

         6�� Searc� alon� th� Comman� Searc� Pat� fo� � fil� �
named "command.COM"; if found, load it and execute it

         7�� I� th� Extende� Comman� Processo� (ECP� featur� i� �
enabled, locate the ECP; if found, load it and execute it

         8�� I� ZCPR� Message� ar� enabled�� chec� t� se� i� a� �
Error Handler is installed; if so, load it and execute it

         9. Print a "command not found" error message

    1.1.4.2. Command Search Path

    Th� Comman� Searc� Path�� i� � buffe� whic� contain� a� �
expressio� (i� th� for� o� byt� pairs�� o� th� sequenc� o� �
directorie� t� examin� whe� th� ZCPR� Comman� Processo� searche� �
fo� � CO� file��  I� i� recommende� tha� thi� buffe� b� place� �
externa� t� th� ZCPR�� Comman� Processo� (b� enable� a� a� �
Externa� Path� s� tha� th� ZCPR� utilitie� ma� readil� acces� an� �
modify it.

    Th� element� o� � Comman� Searc� Pat� ar� byt� pairs��  Th� �
firs� byt� indicate� wha� dis� t� loo� on�� an� th� secon� byt� �
indicate� wha� use� area��  Th� valu� o� th� firs� byt� ma� b� i� �
th� rang� fro� � t� 1� t� indicat� disk� 'A� t� 'P'� o� thi� byt� �
ma� b� th� characte� '$� t� indicat� th� curren� disk�  Th� valu� �
o� th� secon� byt� ma� b� i� th� rang� fro� � t� 3� t� indicat� �
use� area� � t� 31�� o� thi� byt� ma� b� th� characte� '$�� t� �
indicat� th� curren� use� area��  Curren� Disk� an� Curren� Use� �
Area�� refe� t� th� dis� an� use� are� whic� wer� logge� int� a� �
th� tim� th� comman� wa� execute� b� th� ZCPR� Comman� Processor�  �
�� valu� o� �� fo� th� firs� byt� o� � byt� pai� i� use� t� �
indicate the end of the Command Search Path.

    The following is a sample Command Search Path expression:

         DB   '$',0     ; Current disk, user area 0
         DB   1,'$'     ; Disk A, current user area
         DB   1,15      ; Disk A, User Area 15
         DB   0         ; End of Path �
1.2. SYSGEN Memory Images

    Th� SYSGE� memor� image� o� � conventiona� CP/� syste� an� � �
ZCPR3-base� syste� ar� presente� below�  Th� actua� addresse� ma� �
var� fro� syste� t� system�� an� th� installe� shoul� b� awar� o� �
wha� thes� addresse� ar� fo� th� specifi� targe� system.


Address        CP/M Image               ZCPR3 Image

              ---------------------    ----------------------
              | BIOS              |    | BIOS with Modified |
              |                   |    |   Cold Boot *      |
BDOS+0E00H-->  ---------------------    ----------------------
              | BDOS              |    | BDOS (No Change)   |
CCP +0800H-->  ---------------------    ----------------------
              | CP/M 2.2 CCP      |    | ZCPR3 *            |
BOOT+0080H-->  ---------------------    ----------------------
              | BOOT              |    | BOOT               |
BASE+xxxxH-->  ---------------------    ----------------------
              | Dead Space/SYSGEN |    | Dead Space/SYSGEN  |
BASE= 100H-->  ---------------------    ----------------------


           FIG 1-1: CP/M and ZCPR3-based SYSGEN Memory Images


    Installatio� require� � modifie� BIO� imag� an� � ZCPR3 �
imag� t� b� place� ove� th� origina� CP/� 2.�� BIOӠ an� CC� �
images��  Th� res� o� th� syste� ca� sta� th� same��  Thos� ne� �
image� ar� marke� wit� a� asteris� (*� above.

    Typical address values are indicated below:


                        SYSGEN Image             SYSGEN Image
Value                    Conventional CP/M        Morrow CP/M
xxxxH                         800H                   ~ 980H
BOOT  = BASE + xxxxH          900H                    1080H
ZCPR3 = BOOT + 80H            980H                    1100H
BDOS  = ZCPR3 + 800H         1180H                    1900H
BIOS  = BDOS + 0E00H         1F80H                    2700H
End of Operating System      ????H                    2DFFH

                 FIG 1-2: SYSGEN Memory Image Addresses

pa �
1.3. System Segments

    Installatio� o� th� ZCPR� Syste� Segment� involve� selectin� �
th� feature� o� th� segment� an� the� assemblin� eac� segmen� i� �
turn��  I� i� recommende� tha� th� MAà assemble� o� Digita� �
Research be used to perform these assemblies.

    Th� ZCPR� Environmen� Descripto� (*.EN� file� i� create� b� �
assemblin� th� fil� SYSENV.ASM��  Durin� thi� process�� th� file� �
Z3BASE.LI  an� SYSENV.LI� ar� rea� i� an� use� b� th� assembler�  �
Z3BASE.LI  define� th� memor� configuratio� o� th� syste� an� �
make� u� mos� o� th� environmen� descripto� information�  �
SYSENV.LI� contain� additiona� detail� o� th� system.

    Th� ZCPR�� TCA� file� (*.Z3T� ar� create� b�� runnin� th� �
TCSELEC� o� TCMAK� programs��  TCSELEC� allow� th� use� t� selec� �
hi� termina� fro� � lis� o� pre-define� terminals�� whil� TCMAK� �
allow� th� use� t� defin� th� attribute� o� hi� termina� �
directly��  TCMAK� i� fo� user� whos� termina� doe� no� appea� i� �
th� standar� Z3TCAP.TC� file.

    Flo�� Comman� Package� (*.FCP� ar� create� b�� assemblin� �
SYSFCP.ASM��  Durin� thi� process�� th� file� Z3BASE.LI  an� �
SYSFCP.LI  ar� rea� i� an� use�
b� th� assembler��  SYSFCP.LI� �
define� th� feature� supporte� b� th� Flo� Comman� Packag� bein� �
created.

    Input/Outpu� Package� (*.IOP�� ar� create� b�� assemblin� �
SYSIOP.ASM��  Durin� thi� process� th� fil� Z3BASE.LI� i� rea� i� �
an� use� b� th� assembler��  Al� feature� o� th� I/� Packag� ar� �
hard-coded into the source of the package.

    Residen� Comman� Package� (*.RCP� ar� create� b� assemblin� �
SYSRCP.ASM��  Durin� thi� process�� th� file� Z3BASE.LI  an� �
SYSRCP.LI  ar� rea� i� an� use� b�� th� assembler��  SYSRCP.LI� �
define� th� feature� supporte� b� th� Residen� Comman� Packag� �
being created.

    Name� Director�� File� (*.NDR� ar� create� i� on� o� tw� �
ways��  (1�� b� assemblin� th� fil� SYSNDR.AS� o� (2� b�� runnin� �
th� MKDIR.CO͠ ZCPR�� utility��  MKDIR.CO� allow� th� use� t� �
dynamicall�� edi� an� creat� ne� name� director� structure� whil� �
online.


1.4. Utilities

    Th� installatio� o� mos� o� th� ZCPR�� utilitie� involve� �
settin� u� � fil� containin� th� name� o� th� utilitie� t� b� �
installe䠠 an� runnin� th� Z3INS.CO͠ ZCPR�� utilit�� o a� �
Environmen� Descripto� an� thi� file��  Z3IN� wil� instal� eac� �
utilit� name� i� th� fil� wit� th� informatio� i� need� fro� th� �
Environmen� Descriptor.
�     Onl�� on� ZCPR� utilit� canno� b� installe� i� thi� wa�� -- �
ZEX��  Du� t� th� natur� o� ZE� an� th� wa� i� interact� wit� th� �
system�� installatio� o� ZE� require� a� involve� sequenc� o� �
assemblie� an� othe� operations��  Thi� sequenc� i� describe� i� �
detai� i� th� ZEX.ZE� comman� file�� and�� onc� ZEؠ ha� bee� �
installe� th� firs� time� th� installatio� o� ne� version� o� ZE� �
ca� b� don� automaticall� b� runnin� th� ZEX.ZE� comman� fil� b� �
the previous version of ZEX (issuing the command "ZEX ZEX").



pa �
1.5. Installation Steps

    Th� installatio� proces� fo� ZCPR� involve� thes� steps:

         1) Selecting the features desired for the target ZCPR3
              System

         2) Planning the memory structure of the target ZCPR3
              System (the file Z3BASE.LIB is created)

         3) Modifying the Cold Boot routine in the BIOS of the
              target ZCPR3 System to initialize the selected
              features which require initialization

         4) Enabling the desired features in the ZCPR3 Command
              Processor (the file Z3HDR.LIB is created)

         5) Overlaying the CCP with ZCPR3 and the old BIOS with
              the new BIOS in the SYSGEN Image

         6) Placing the new SYSGEN Image onto the Operating
              System tracks of the disk

         7� Selectin� th� option� fo� th� desire� Syste�
              Segments and creating the System Segments

         8) Installing the desired ZCPR3 utilities

pa �
1.6. Operational ZCPR3 System
    Thi� sectio� show� a� operationa� ZCPR� System�� describin� �
it� memor� image� Syste� Segments� an� utilities.

1.6.1. Memory Image

    Thi� memor�� imag� show� th� memor� structur� o� � ZCPR� �
Syste� whic� include� al� o� th� majo� features.

Address
FFFF     ----------------------------------------------
         |    ROM Area (System Dependent)             | 2K
F800     ----------------------------------------------
         |    ZCPR3 External Stack                    |\
F7D0     ---------------------------------------------- \
         |    ZCPR3 Command Line Buffer               |  \
F700     ----------------------------------------------   \
         |    ZCPR3 Memory-Based Named Directory (S)  |    |
F600     ----------------------------------------------    |
         |    ZCPR3 External File Control Block       |
F5D0     ----------------------------------------------  1K
         |    ZCPR3 Message Buffers                   |
F580     ----------------------------------------------    |
         |    ZCPR3 Shell Stack                       |    |
F500     ----------------------------------------------   /
         |    ZCPR3               |      Z3TCAP (S)   |  /
F480     |         Environment    --------------------- /
         |              Descriptor (S)                |/
F400     ----------------------------------------------
         |    ZCPR3 Flow Command Package (S)          |  0.5K
F200     ----------------------------------------------
         |    ZCPR3 Input/Output Package (S)          |  1.5K
EC00     ----------------------------------------------
         |    ZCPR3 Resident Command Package (S)      |  2K
E400     ----------------------------------------------
         |    ZCPR3 BIOS with Modified Cold Boot      |
         |         Routine to Initialize All Elements |  3.5K
         |         of the ZCPR3 System Above          |
D600     ----------------------------------------------
         |    CP/M BDOS                               |  3.5K
C800     ----------------------------------------------
         |    ZCPR3 Command Processor                 |  2K
C000     ----------------------------------------------
         |    Transient                               |
         |         Program                            | ~48K
         |              Area                          |
 100     ----------------------------------------------
         �    CP/� an� ZCPR� Buffer�                  |25� bytes
   0     ----------------------------------------------
            FIG 1-3: ZCPR3 System Memory Image (Z3BASE1.LIB)

Notes� (1� Al� Area� Abov� E400� ar� initialize� b� th� Col� Boo�
              Routin� i� th� BIOS
      (2� Thos� Area� marke� wit� (S� ar� ZCPR� Syste� Segments �
1.6.2. System Segments

Z3BASE1.LIB���     Th� Syste� Segment� use� i� thi� syste� �
Z3BASE2.LIB���ar� provide� i� th� distributio� file� o� �
Z3HDR1.LIB����ZCPR3�  Th� ZCPR� Syste� show� her� i� define� �
Z3HDR2.LIB����b�� th� fil� Z3BASE1.LIB�� an� � muc� smalle� �
��������������syste� whic� doe� no� includ� th� Residen� �
��������������Comman� Package�� Input/Outpu� Package�� an� �
��������������Flo�� Comman� Packag� feature� (onl�� 1ˠ o� �
��������������additiona젠� overhead���� i󠠠 define䠠� i� �
��������������Z3BASE2.LIB��  Associate� wit� eac� o� th� tw� �
��������������Z3BASEn.LI  file� i� � Z3HDRn.LI� fil� whic� �
��������������define� th� feature� o� th� ZCPR�� Comman� �
��������������Processor.

SYSENV.ASM����      Th� Environmen� Descripto� i� create� b� �
SYSENV.LIB����assemblin� SYSENV.ASM� whic� uses  Z3BASE1.LI� �
��������������(rename� t� Z3BASE.LIB� an� SYSENV.LI� durin� �
��������������th� assembl� process.

SYSFCP.ASM����      Ther� ar� tw� Flo� Comman� Package� use� �
SYSFCP1.LIB���i� conjunctio� wit� thi� system�� an� the� ar� �
SYSFCP2.LIB���define䠠 b��� th堠 file� SYSFCP1.LI � an� �
��������������SYSFCP2.LIB�  SYSFCP1.LI� define� a� FC� whic� �
��������������i� self-containe� an� execute� withou� usin� �
��������������an� externa� files��  SYSFCP2.LI� execute� th� �
��������������ELSE/FI/XIƠ command� withi� itself�� bu� i� �
��������������execute� IƠ b� loadin� th� fil� IF.CO͠ fro� �
��������������th� ROO� director� an� transferrin� contro� t� �
��������������it���  Thi� eliminate� th� restrictio o� �
��������������capabilitie� o� th� IƠ comman� whic� i� �
��������������impose� b� th� smal� siz� o� th� FCP.

SYSIOP.ASM����      Th堠 Input/Outpu� Packag堠 use䠠 i� �
��������������conjunctio� wit� thi� syste� i� containe� i� �
��������������th� fil� SYSIOP.ASM.

SYSRCP.ASM����      Ther� ar� fou� RCP� use� i� conjunctio� �
SYSRCP1.LIB���wit� thi� system�� an� the� ar� define� b� th� �
SYSRCP2.LIB���fou� SYSRCPn.LI� file� (� i� betwee� � an� 4)�  �
SYSRCP3.LIB���Eac� RC� contain� � differen� se� o� command� �
SYSRCP4.LIB���wit� � differen� se� o� option� enable� fo� �
��������������the included commands.


pa �
1.6.3. Utilities

    Ove� 7�� utilitie� ar� associate� wit� th� ZCPR�� System�  �
Eac� utilit�� use� feature� o� th� syste� a� i� requires� �
includin� name� director�� references�� acces� t� th� variou� �
syste� segments�� acces� t� th� TCA� facility�� an� acces� t� al� �
o� th� dat� element� i� th� ZCPR� Environmen� Descripto� tha� i� �
needs�  Th� ZCPR� Environmen� Descripto� i� th� singl� sourc� fo� �
al� informatio� tha� � ZCPR� utilit� need� abou� th� syste� i� i� �
running in.

    Consequently��� al젠 ZCPR��� utilitie� acces� th堠 ZCPR� �
Environmen� Descripto� i� on� o� tw� ways��  (1� the� contai� � �
pointe� t� th� descripto� o� (2� the�� contai� th� descripto� �
itself��  Th� Z3INS.CO͠ utilit�� i� use� t� instal� th� ZCPR� �
utilitie� wit� th� addres� o� th� Environmen� Descripto� o� th� �
descripto� itself��  Clas� � utilitie� ar� thos� wh� contai� � �
pointe� t� a� environmen� descriptor�� an� Clas� �� utilitie� �
contain the descriptor itself.

    Supportin� th� Environmen� Descripto� i� � globa� memor� �
buffe� i� th� recommende� wa� t� implemen� � ZCPR� System��  Thi� �
buy� th� syste� tw� distinc� advantages:

         1��  Eac� utilit�� need� onl� �� additiona� byte� o� �
overhea� (th� pointe� t� th� Environmen� Descriptor� rathe� tha� �
th� descripto� itsel� (whic� occupie� 25� bytes).

         2��  Change� ca� b� mad� t� th� syste� dynamicall� �
withou� havin� t� modif� anythin� othe� tha� th� Environmen� �
Descriptor.

    Th� ZCPR� utilitie� ar� muc� smalle� an� faste� tha� thei� �
ZCPR� ancestors��  Fo� � complet� listin� o� al� ZCPR�� utilitie� �
supplied with the distribution, see the appropriate section.


1.7. Software Required for Installation

1.7.1. Commercial Software

    ZCPR3 i� t� b� installe� o� � workin� CP/� 2.� system��  Th� �
commercial software required to do this installation is:

         1) A working CP/M 2.2 System
         2) Source to the BIOS of the target CP/M 2.2 System or
              an overlay patch for the Cold Boot Routine
         3) the MAC assembler of Digital Research
         4) a debugger, like DDT, for the overlay process
         5) a disk utility, like SYSGEN, to be used to place the
              operating system image onto the OS tracks on disk

    I� th� use� desire� t� edi� an� reassembl� th� utilities� �
th� Microsof� M8� an� L8� assemble� an� linke� ar� als� required. �
1.7.2. System Segment Software

    Th� softwar� supplie� wit� ZCPR� whic� i� require� fo� �
installatio� is:

Name of File   Function

ZCPR3.ASM      Source to the ZCPR3 Command Processor
Z3HDR.LIB      Configuration File read in by ZCPR3.ASM to
                   tailor the ZCPR3 Command Processor
Z3BASE.LIB     Definition of the Memory Map of the ZCPR3
                   System to be created

SYSENV.ASM     ZCPR3 System Environment Descriptor
SYSENV.LIB     Header for ZCPR3 System Environment Descriptor

SYSFCP.ASM     ZCPR3 Flow Command Package source
SYSFCP.LIB     Configuration File read in by SYSFCP.ASM to
                   tailor the ZCPR3 Flow Command Package
                   (this file may be derived from one of the
                    SYSFCPn.LIB files below)

SYSIOP.ASM     ZCPR3 Input/Output Package source

SYSNDR.ASM     ZCPR3 Named Directory Definition File source
SYSNDR.LIB     Header for ZCPR3 Named Directory Definition

SYSRCP.ASM     ZCPR3 Resident Command Package source
SYSRCP.LIB     Header for ZCPR3 Resident Command Package
                   (this file may be derived from one of the
                    SYSRCPn.LIB files below)

1.7.3. Other Useful Files

Name of File   Function

Z3LOC.COM      Utility to locate a CP/M CCP

Z3BASE1.LIB    Sample ZCPR3 BASE files (Z3BASE.LIB)
Z3BASE2.LIB

Z3HDR1.LIB     Sample ZCPR3 HDR files (Z3HDR.LIB)
Z3HDR2.LIB

SYSFCP1.LIB    Sample ZCPR3 Flow Command Package headers
SYSFCP2.LIB

SYSRCP1.LIB    Sample ZCPR3 Resident Command Package headers
SYSRCP2.LIB
SYSRCP3.LIB
SYSRCP4.LIB


pa �
1.7.4. Files Required for Installing ZEX

    I� th� ZE� Comman� Fil� Processo� i� t� b� installe� t� b� �
use� unde� th� targe� ZCPR� system�� th� followin� file� ar� �
required.

Name of File   Function

ZEX.ASM        Source to ZEX

ZEX.ZEX        ZEX Command File used to assemble new versions
                   of ZEX once the first version is running

RELS.UTL       SID/ZSID Utility File (not supplied with ZCPR3)


1.7.5. Required Distribution Files

    Th� followin� file� ar� require� fo� th� installatio� o� � �
complete ZCPR3 System.

Name of File        Name of File        Name of File

SYSENV.ASM          SYSFCP1.LIB         Z3BASE.LIB
SYSFCP.ASM          SYSFCP2.LIB         Z3BASE1.LIB
SYSIOP.ASM          SYSNDR.LIB          Z3BASE2.LIB
SYSNDR.ASM          SYSRCP1.LIB         Z3HDR.LIB

SYSRCP.ASM          SYSRCP2.LIB         Z3HDR1.LIB
ZCPR3.ASM           SYSRCP3.LIB         Z3HDR2.LIB
SYSENV.LIB          SYSRCP4.LIB         ZEX.ASM


1.7.6. Useful Distribution Files

    Th� followin� file� ar� useful�� bu� no� required�� fo� th� �
installation of a ZCPR3 System.

Name of File        Name of File        Name of File

Z3LOC.COM           Z3INS.COM           ZEX.ZEX



pa �
1.8. Required Hardware

1.8.1. Hardware Required for Installation

    Th� hardwar� requirement� fo� th� installatio� o� ZCPR3 ar� �
as follows:

         CP/M 2.2 - based system (or ZCPR3 - based system)
         8080 or Z80 microprocessor
         32K bytes of memory
         110K bytes of disk space for source, BAK, and HEX files
         computer terminal

1.8.2. Hardware Required for Running ZCPR3

    The hardware requirements for running ZCPR3 are:

         ZCPR3 - based system
         Z80 microprocessor
         48K bytes of memory
         110K bytes per disk (recommended minimum)
         computer terminal


pa �.fi B:Z3INS1.SI
pa �.fi B:Z3INS2.SI
pa �.fi B:Z3INS3.SI
pa �.fi B:Z3INS4.SI
pa �.fi B:Z3INS5.SI
pa �.fi B:Z3INS6.SI
pa �.fi B:Z3INS7.SI
pa �.fi B:Z3INS8.SI
pa �.FI B:Z3INS.IDX