CP/M/CPM_CDROM.iso/zsys/simtel20/install/z3ins.sq/Z3INS.SI

Text File | 1985-06-14 | 30.1 KB | 748 lines

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