6. S T E P 8 : U T I L I T Y I N S T A L L A T I O N

6. S T E P 8 : U T I L I T Y I N S T A L L A T I O N

6.1. The Z3INS Utility

Th� Z3INӠ utilit� i� designe� t� mak� th� ZCPR�� utilit� �
installatio� proces� simple�� Al� file� t� b� installe� mus� b� �
i� th� curren� director� whe� Z3IN� i� executed�� *.EN֠ fil� �
fo� th� targe� syste� an� a� installatio� fil� (*.INS� containin� �
th� name� o� th� program� t� b� installe� mus� als� b� i� th� �
curren� directory.

Z3IN� read� i� a� Environmen� Descripto� fil� (*.ENV� an� a� �
Installatio� Fil� (*.INS)�� I� the� look� fo� line� i� th� fil� �
containin� fil� name� (on� nam� pe� line� an� load� th� indicate� �
files�� tryin� t� instal� the� wit� th� Environmen� Descripto� �
information.

Z3INS is invoked by a command line of the following form:

Z3INS mysys.ENV myinstal.INS

�� ZCPR�� Installatio� Fil� i� � tex� fil� containin� tw� �
type� o� lines�� commen� line�� whic� begin� wit� � semicolo� �
(;)�� an� � lin� containin� a� unambiguou� fil� nam� (leadin� �
space� ar� no� significant)�� whic� i� � fil� t� b� installed� �
Fo� example:

; This is an installation file for my new utilities
; UTIL1.COM and UTIL2.COM are going to be installed --
util1.com
util2.com
; UTIL3 is really neat
util3.com

FIG 6-1: Sample Z3INS Installation File

Cas� i� no� significant�� Leadin� space� o� eac� lin� �
are ignored. Any file name MUST be unambiguous.

The next section shows the execution of a *.INS file.

pa �
6.2. Sample Session

B1:ASM>z3ins sys.env zcpr3.ins
Z3INS Version 1.0
;
; Installation Begins --
;

<< Detail Left Out >>

;
; Set 1
;
** Installing File ALIAS .COM
** Installing File CD .COM
** Installing File CMDRUN .COM
** Installing File COMMENT .COM
** Installing File CPSEL .COM
** Installing File CRC .COM
** Installing File DEV .COM
** Installing File DEVICE .COM
** Installing File DIFF .COM
** Installing File DIR .COM
** Installing File ECHO .COM
** Installing File ERASE .COM
;
; Set 2: Error Handlers
;
** Installing File ERROR1 .COM
** Installing File ERROR2 .COM
** Installing File ERROR3 .COM
** Installing File ERROR4 .COM
** Installing File ERRORX .COM
** Installing File SHOW .COM

<< Detail Left Out >>

;
; NOTE does not install because it is so small and really does
; not need to know about ZCPR3
;
;note.com
;
; Set 9: Z3INS
;
** Installing File Z3INS .COM
;
; End of ZCPR3 Installation
;
** Installation Complete **

FIG 6-2: Sample Run of Z3INS
pa �6.3. Assembling Distribution Files

Th� followin� file� requir� thei� specialize� comman� file� �
i� orde� t� b� assembled�� I� th� installe� i� installin� th� �
syste� fo� th� firs� tim� an� wishe� t� assembl� thes� utilities� �
h� ma� hav� t� follo� th� step� outline� i� th� comman� file� i� �
order to perform the assemblies.

Utility Command File Required
ALIAS.COM ALIAS.ZEX
ZEX.COM ZEX.ZEX

Th� followin� file� i� th� Phas� ɠ distributio ar� �
assemble� b�� th� comman� line� (assumin� tha� Z3LIB.RE̠ an� �
SYSLIB.RE� ar� i� th� curren� directory and that $1 is the file):

M80 =$1
L80 $1,Z3LIB/S,SYSLIB/S,$1/N,/U,/E
Files:
CD CMDRUN COMMENT CPSEL
CRC DEV DEVICE DIFF
DIR ECHO ERASE ERROR1
ERROR3 ERROR4 ERRORX FINDF
GOTO HELPCK IF IFSTAT
LDR MCOPY MENUCK MKDIR
NOTE PAGE PATH PROTECT
PWD QUIET RECORD REG
RENAME SAK SETFILE SH
SHCTRL SHDEFINE SHFILE SHVAR
SUB TCCHECK TCMAKE TCSELECT
UNERASE WHEEL XD XDIR
Z3INS Z3LOC

Th� followin� file� i� th� Phas� ɠ distributio ar� �
assemble䠠 b�� th� comman� line� (assumin� tha� VLIB.REL� �
Z3LIB.REL� an� SYSLIB.RE� ar� i� th� curren� directory):

M80 =$1
L80 $1,VLIB/S,Z3LIB/S,SYSLIB/S,$1/N,/U,/E
Files:
ERROR2 HELP MENU SHOW

Th� followin� file� i� th� Phas� ɠ distributio ar� �
assemble� b�� th� comman� line� (assumin� tha� Z3LIB.RE̠ an� �
SYSLIB.RE̠ ar� i� th� curren� directory� i� th� TIM� optio� i� �
enabled:

M80 =$1
L80 $1,TIMELIB/S,Z3LIB/S,SYSLIB/S,$1/N,/U,/E
Files:
HELPPR PRINT

File� distribute� i� Phas� Iɠ wil� b� provide䠠 wit� �
associate� documentatio� o� thei� assembl� procedures.