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