.fo Section 4 - Library Utilities Page #
4.0 Library Utilities
4.1 Author Credits and Introduction to LU
Thi� documen� applie� t� versio� 1.1� o� LU.COM�� I� als� �
applie� t� Versio� 1.� o� LDIR� b� Richar� Con� an� Versio� 1.� �
o� LRUNڠ b� Richar� Con� (whic� wa� derive� fro� LRUΠ b�� Gar� �
Novosielski).
Copyright (c) 1982 Gary P. Novosielski
All rights reserved.
Permissio� i� hereb� grante� t� cop� an� distribut� thi� �
documen� fo� an� non-commercia� purpose�� An� us� o� thi� �
materia� fo� commercia� advantag� withou� prio� writte� �
consen� o� th� autho� i� prohibited.
ɠ hav� modifie� th� origina� documen� fo� inclusio� i� � �
HELР fil� an� elaborate� o� th� subjec� wit� documentatio� o� �
LRUNZ and LDIRZ.
INTRODUCTION
Librar� Utilit� (LU� i� � progra� t� allo� combinin� o� �
multilpl� file� int� on� large� file�� I� require� CP/� �
versio� 2.� o� highe� t� run� L� run� unde� ZCPR2.
Thi� large� fil� i� divide� int� tw� basi� part� -- th� �
director�� (a� th� fron� o� th� file� an� th� file� o� th� �
library� Th� director� informatio� i� store� i� th� sam� fil� a� �
th� data�� o� membe� files�� Th� amoun� o� spac� t� b� �
allocate� t� th� director� mus� b� specifie� b� th� use� whe� �
� ne� librar� i� created�� bu� ca� b� change� whe� th� fil� i� �
reorganized� Th� siz� o� eac� director� entr� i� 3� bytes� whic� �
mean� eac� fou� director� entrie� tak� u� on� secto� o� th� �
librar� file�� Currentl� onl� 1� byte� o� eac� entr� ar� used� �
wit� 1�� byte� bein� reserve� fo� us� wit� possibl� futur� �
enhancements�� Th� director� itsel� use� on� entr� fo� contro� �
information�� s� th� numbe� o� director� sector� neede� fo� � �
librar� o� � member� i� (� � 1� � 4� rounde� u� t� th� nex� whol� �
number.
Th� use� nee� no� b� concerne� wit� thi� discussio� a� �
director�� siz� i� calculate� b� th� program�� Al� director� �
size� ar� inpu� an� outpu� i� term� o� entries�� eac� entr� �
bein� � potentia� membe� file� Th� progra� adjust� director� siz� �
t� a� integra� numbe� o� sectors.
LRUNڠ i� � smal� progra� whic� allow� runnin� � .CO� �
(objec� code� fil� membe� directl� fro� an�� library�� withou� �
havin� t� extrac� i� t� � separat� dis� file��� I� i� �
specificall�� intende� t� b� use� wit� � defaul� COMMAND.LB� fil� �
under ZCPR2 and can be used as an Extended Command Processor.
�
LDIR� i� � progra� whic� allow� th� use� t� displa� � sorte� �
director� o� th� file� i� � defaul� COMMAND.LB� file�� Simpl� i� �
nature�� LDIRڠ give� th� use� th� abilit� t� selec� group� o� �
file� vi� wil� card� an� displa� � sorte� listin� whic� include� �
individual file sizes.
4.2 Why Use Libraries?
First�� � librar� fil� usuall� take� u� les� spac� tha� th� �
tota� o� th� individua� membe� file� whic� wen� int� it�� Th� �
reaso� fo� thi� i� tha� CP/� allocate� dis� spac� i� fixe� �
block� o� groups�� typicall� 2� byte� each� An� spac� afte� th� �
las� secto� o� � fil� u� t� th� nex� 2� bloc� boundr�� i� �
wasted�� Th� sam� file� i� � librar� us� onl�� th� numbe� o� �
sector� the� actuall� need�� an� thoug� th� librar� itsel� ma� �
hav� � partiall� waste� bloc� a� th� end�� an� require� som� �
spac� fo� director� informatio� a� th� beginning�� th� ne� �
effec� i� usuall� � savin� o� tota� space�� Th� bes� result� �
ar� see� whe� man� smal� file� ar� combine� int� on� library.
Second� � librar� fil� make� mos� efficien� us� o� th� CP/� �
dis� directory�� sinc� i� i� treate� a� onl� on� fil� b�� CP/� �
regardles� o� ho� man� member� i� contains.
Third�� librarie� ca� ai� i� transferrin� package� o� �
softwar� fro� on� syste� t� anothe� usin� XMODEM� Onl� on� fil� �
i� transferred�� eliminatin� th� nee� t� ru� th� XMODE͠ ransfe� �
progra� severa� times�� th� chanc� o� overlookin� � neede� file� �
an� th� problem� o� namin� conflicts�� (suc� a� READ.MРfiles� �
amon� unrelate� packages.
4.3 Why Not Use Libraries?
Ther� ar� som� ver� goo� reason� fo� no� usin� �
libraries�� Fo� on� thing�� file� withi� � librar�� ar� no� �
availabl� t� mos� "normal� programs�� I� � frequentl�� accesse� �
fil� i� place� i� � library�� i� wil� hav� t� b� extracte� fro� �
th� librar� t� it� free-standin� counterpar� befor� i� ca� b� �
use� b�� � program�� (.CO� file� ar� � notabl� exceptio� t� �
this�� becaus� o� th� availabilit� o� th� LRUNڠ command� �
covere� later.)
Librarie� ca� actuall� wast� dis� space� Whe� � dis� fil� �
i� erased�� CP/� return� th� spac� formerl� use� b� th� fil� t� �
th� fre� spac� poo� fo� us� b� ne� files�� Whe� � membe� fil� �
i� delete� fro� � librar�� however�� th� spac� previousl� �
occupie� b�� th� fil� i� no� useable�� Th� librar�� mus� b� �
reorganize� t� mak� thi� spac� availabl� t� CP/M�� Whil� thi� �
i� eas� t� d� wit� th� L� command�� i� i� no� automatic�� an� �
i� th� situatio� i� ignored�� larg� area� o� dis� ca� b� tie� u� �
a� unproductiv� "dea� space".
4.4 How to Use the Library Utility LU
Lՠ ha� tw� basi� method� o� operation�� interactive�� an� �
paramete� driven�� Us� o� th� interactiv� metho� i� probabl� th� �
bes� wa� t� ge� t� kno� th� program�� becaus� th� effec� o� eac� �
actio� ca� b� immediatle� seen.
T� star� a� interactiv� librar� maintenanc� session�� jus� �
typ� Lՠ o� th� comman� lin� wit� n� parameter� afte� it� �
Afte� yo�� ar� familia� wit� th� program�� yo�� ca� specif� �
multipl� paramter� o� th� comman� lin� an� Lՠ wil� wor� wit� �
littl� o� n� intervention�� Inpu� fro� dis� files�� à progra� �
"pipes"�� an� th� XSU� facilit� ar� als� supporte� fo� mor� �
advance� applications.
Al� th� method� mak� us� o� simila� syntax�� Comman� �
inpu� take� tw� forms�� operator� (sometime� calle� tags�� o� �
options� an� operands.
A� operato� i� define� a� an� tw� characte� strin� �
wher� th� firs� characte� i� � minu� sign�� Operator� tel� th� �
progra� wha� t� do� Vali� operator� ar� -a� -d� -e� -l� -o� an� -�
r�� Anythin� els� wit� � simila� for� i� a� operato� too�� bu� a� �
invali� one.
Operand� ar� everythin� else� Normally� operand� ar� fil� �
name� whic� yo� wan� t� ad� to�� delet� from�� o� extrac� fro� � �
librar� file�� o� ar� name� o� librar� file� t� b� opened� The� �
ma� contai� th� character� � o� �� i� whic� cas� the� ar� calle� �
ambiguou� operands� Som� vali� operand� are:
foo.bar b:test.fil z *.* comm?nd
T� refe� t� � fil� name� "-z� th� operan� woul� hav� t� b� �
entere� a� "-z.� wit� th� period�� sinc� otherwis� i� woul� b� �
mistake� a� a� invali� operator.
Wha� actio� i� take� upo� th� fil� depend� upo� whic� �
operato� mos� recentl� precede� it�� I� n� operato� wa� �
entered�� o� a� invali� one� o� on� tha� take� n� operands� th� �
operan� wil� b� ignored.
� Whe� runnin� interactively�� L� prompt� fo� eac� operan� an� �
operator�� on� pe� inpu� line�� Multipl� input� pe� lin� ar� no� �
allowe� usin� th� interactiv� method.
Th� promp� yo�� wil� se� i� th� nam� o� th� curren� �
operato� followe� b� � ">� character�� fo� exampl� "-E>"� �
Thi� indicate� tha� th� -� operato� i� i� effect�� an� i� a� �
operan� i� entere� i� wil� b� interprete� a� th� nam� o� � �
membe� fil� t� b� Extracte� fro� th� library�� Whe� th� �
progra� firs� start� up�� th� promp� i� "-?>� whic� mean� n� �
operato� i� currentl� i� effect�� I� thi� case�� th� onl� �
vali� inpu� i� a� operator� An� operan� wil� b� ignored.
4.5 Summary of Operators
The operators available under LU are:
-A Add Files to Library
-D Delete Files from Library
-E Extract Files from Library
-L List Library
-O Open a Library
-R Reorganize a Library
Thes堠 operator� ar� discusse� i� mor� detai� i� th� �
following frames.
-� ad� file� t� library�� -� cause� th� promp� t� �
chang� t� -A� whic� wil� the� accep� a� operand� th� name� o� �
file� t� b� adde� t� th� ope� library�� (I� n� librar�� nam� �
ha� bee� opene� wit� th� -� operator�� th� defaul� librar� �
LIBRARY.LBҠ i� alway� use� instead.�� Ambiguou� operand� �
matc� al� dis� file� whic� qualif� accordin� t� norma� CP/� �
wild-car� conventions�� excep� thos� wit� � filetyp� o� .LBR� �
Explici� driv� specificatio� o� a� operan� cause� tha� driv� t� �
b� searche� fo� th� file(s� instea� o� th� curren� drive.
-� delet� file� fro� library�� -� cause� th� promp� t� �
chang� t� -D� whic� accept� name� o� file� t� b� delete� fro� �
th� ope� library�� Ambiguou� name� matc� al� membe� file� �
whic� qualify�� Driv� specification� o� operand� ar� ignored� �
sinc� th� librar� member� ar� obviousl� o� whicheve� driv� �
contain� th� ope� library.
-� extrac� file� fro� library�� -� cause� th� promp� t� �
chang� t� -E� whic� accept� name� o� librar� membe� file� t� b� �
extracte� t� norma� free-standin� CP/͠ files�� Ambiguou� �
name� matc� al� membe� file� whic� qualify�� Driv� specificatio� �
o� � membe� nam� cause� th� outpu� fil� t� b� place� o� th� �
specifie� driv� rathe� tha� th� curren� drive�� An�� existin� �
fil� wit� th� sam� nam� wil� b� overwritte� unles� i� i� �
protecte� b� virtu� o� it� Read/Onl� fla� bi� bein� set.
-� lis� curren� librar� map�� -� cause� th� director�� o� �
th� curren� librar� t� b� liste� o� th� console�� Th� membe� �
name� ar� displayed�� alon� wit� thei� index�� o� startin� �
positio� withi� th� library�� an� thei� siz� i� sectors� �
Also�� informatio� i� displaye� abou� th� numbe� o� sector� i� �
th� library� an� ho� muc� space� i� use� o� unuse� (wasted)� �
Informatio� i� als� displaye� abou� th� numbe� o� entrie� i� �
th� directory�� an� ho� man� ar� active�� deleted�� o� fre� fo� �
use�� Thi� help� determin� whethe� th� librar� need� t� b� re-�
organize� t� fre� unuse� spac� an� delete� entries�� Th� �
operato� -� expect� n� operands��� s� afte� th� lis� i� �
displayed�� th� promp� change� bac� t� -?� fo� entr� o� anothe� �
operator.
-� ope� � library�� -� cause� th� promp� t� chang� t� -O� �
whic� accept� th� nam� o� � librar� fil� t� b� opene� fo� us� �
wit� subsequen� operators� I� anothe� librar� i� alread� open� �
i� i� close� first�� I� th� ne� librar� doe� no� exist�� i� i� �
create� wit� a� empt� directory�� Ambiguou� name� ar� no� �
allowed�� Driv� specificatio� i� allowed� Th� fil� typ� ma� b� �
specified�� bu� default� t� .LB� whic� i� strongl� suggeste� a� �
th� fil� typ� fo� al� librar� files.
Yo�� wil� recal� tha� file� o� typ� -� (add�� operator� �
Thi� prevent� librarie� fro� bein� accidentall�� adde� t� �
othe� libraries�� o� t� themselves�� � situatio� no� unlik� �
tryin� t� driv� � truc� u� it� ow� tailpipe�� I� fo� som� �
reaso� yo� wan� t� ad� on� librar� t� another�� b� m� guest� bu� �
yo�� wil� hav� t� specif�� th� nam� withou� �� o� � �
character� whe� addin� it.
-� reorganiz� library�� -� cause� th� currentl�� ope� �
librar� t� b� reorganized� First� th� director� i� sorte� int� �
alphabetica� order� an� the� al� activ� member� ar� copie� t� �
� wor� librar�� whic� i� opene� o� th� curren� drive�� no� �
necessaril� th� driv� containin� th� ol� library� Th� use� ma� �
specif�� � differen� numbe� o� entrie� fo� th� wor� librar�� i� �
i� i� necessar�� t� expan� o� compres� th� directory�� Th� �
director�� wil� alway� b� mad� larg� enoug� t� contai� al� th� �
activ� member� o� th� ol� library�� s� � siz� o� �� ma�� b� �
specifie� t� mak� th� director� a� smal� a� possible�� (Se� �
Specifyin� Director� Size� below.)
Whe� reorganizatio� i� complete�� th� ol� librar�� i� �
delete� an� th� wor� librar� i� rename� t� th� nam� o� th� ol� �
library��� N backu� cop�� i� retained��� Th堠 newl� �
reorganize� librar�� remain� ope� fo� us� wit� subsequen� �
operations.
Wheneve� th� progra� i� promptin� fo� a� operand�� anothe� �
operato� ma�� b� entere� instea� t� chang� th� statu� o� th� �
prompt�� T� en� a� interactiv� session� ente� � blan� lin� a� th� �
prompt.
SPECIFYING DIRECTORY SIZE
Wheneve� a� ol� librar� i� opened�� th� director� siz� i� �
displaye� a� follows:
Old library LIBRARY.LBR has 32 entries, 5 free.
Thi� mean� tha� � mor� member� ma� b� adde� befor� th� �
director�� become� full�� Whe� th� director�� i� full�� -� �
become� a� invali� operator�� an� th� librar�� mus� b� �
reorganize� t� ad� an� mor� members.
Whe� � librar� i� create� fo� th� firs� time�� th� use� i� �
prompte� lik� this:
New library COMMAND.LBR. Allow how many entries?_
An� numbe� fro� � t� 6553� i� valid�� Th� actua� maximu� i� �
determine� b� th� amoun� o� fre� memor� availabl� o� th� syste� �
i� use�� Director�� siz� wil� b� rounde� u� t� th� nex� whol� �
secto� necessar� t� contai� th� numbe� o� entrie� requested� �
Thi� numbe� wil� remai� i� effec� unti� th� librar�� i� �
reorganized� Sinc� th� director� itsel� count� a� a� entry� on� �
entr�� i� adde� t� whateve� i� entere� befor� th� siz� i� �
calculated�� Therefor� jus� ente� th� maximu� numbe� o� membe� �
file� yo� wan� th� librar� t� b� capabl� o� holding.
Th� maximu� numbe� o� membe� file� i� als� constraine� b� �
th� amoun� o� availabl� dis� space�� I� durin� a� ad� �
operatio� th� dis� spac� run� out�� th� nam� i� no� adde� t� th� �
directory� I� � multipl� ad� i� i� progress� du� t� a� ambiguou� �
operand�� th� remainin� qualifyin� file� ar� stil� adde� i� �
possible� I� an� o� the� i� smal� enoug� t� fi� i� th� remainin� �
dis� space�� i� wil� b� added�� I� an� sector� wer� writte� b� �
a� ad� attempt�� an� the� neve� utilized�� the�� remai� a� �
unuse� sectors� an� th� librar� shoul� b� reorganized.
4.6 LU Command Line Forms
Al� o� th� informatio� neede� fo� � maintenanc� ru� ma�� b� �
specifie� o� th� comman� line�� Th� operator� an� operand� ar� �
entered�� separate� b� spaces�� afte� th� Lՠ command�� an� th� �
operation� wil� tak� plac� withou� consol� intervention�� excep� �
i� th� cas� wher� th� director� siz� fo� � ne� librar�� i� �
requested� Th� synta� is:
LU <opr> [<opd> [<opd> ...]] [<opr> [<opd> ...]...
where square brackets indicate optional parameters, and:
<opr> is any operator.
<opd> is any operand.
... indicates that the preceding parameter may occur
several times.
An�� name� occurrin� prio� t� th� firs� operator�� o� �
followin� a� operato� whic� doe� no� expec� operands�� ar� �
ignored.
Advanced Features of LU
Inpu� fro� BD� � "pipes� o� ordinar� sequentia� file� i� �
als� possible�� Th� filenam� i� specifie� o� th� comman� lin� �
precede� b� � "<� characte� an� n� intervenin� blank� Example:
LU <CONSOL.DUP
read� th� content� o� th� fil� CONSOL.DU� an� use� eac� lin� �
o� th� fil� a� i� i� ha� bee� type� a� th� norma� consol� �
b� th� interactiv� method�� I� thi� case� n� operator� o� �
operand� ma�� b� present��� Consol� outpu� ma�� als b� �
redirecte� b� specifyin� a� outpu� fil� o� th� comman� lin� �
afte� th� characte� ">"�� Thi� applie� t� paramete� drive� �
a� wel� a� interactiv� (includin� "piped"� input� Examples:
LU -O SPECIAL -A ZOT.COM >LOGFILE.OUT
woul� ad�
th� fil� zot.co� t� th� librar� special.lb� an� �
writ� th� consol� outpu� t� � fil� calle� logfile.out�� th� �
locatio� o� th� outpu� nam� o� th� lin� doe� no� matte� an� �
excep� fo� turnin� o� redirecte� output�� i� i� ignore� b�� al� �
operators.
LU <BATCH.IN >B:RECORD.DOC
woul� tak� interactiv� command� fro� th� fil� batch.i� an� �
writ� consol� outpu� t� � fil� calle� record.do� o� driv� B.
Normally� consol� fil� outpu� i� als� echoe� o� th� rea� �
console�� excep� whe� inpu� i� als� redirected� a� i� th� las� �
example� T� forc� visibl� consol� outpu� whe� bot� a� inpu� an� �
outpu� fil� ar� used�� th� ">�� characte� precedin� th� �
outpu� fil� nam� ma� b� change� t� � "+� instead:
�
LU +RECORD.DOC <BATCH.IN
woul� hav� th� sam� effec� a� th� previou� example� �
excep� tha� messag� outpu� woul� als� b� visibl� o� th� �
console.
4.7 CAUTIONS
Th� importanc� o� keepin� backu� copie� o� al� dis� �
files�� an� especiall� libraries� canno� b� overemphasized� B� �
usin� librar� files� th� use� i� expose� t� th� dreade� all-the-�
eggs-in-one-baske� syndrome�� Tha� is� i� somethin� happen� t� �
th� librar� file�� particularl� th� directory� i� ma� b� beyon� �
th� capabilitie� o� eve� � CP/� wizar� t� restor� th� membe� �
files� Th� situatio� i� mad� particularl� stick� b� th� fac� tha� �
th� th� director� mus� b� update� i� plac� a� member� ar� adde� �
o� deleted.
Precaution� hav� bee� take� t� minimiz� thi� risk�� Fo� on� �
thing�� th� director� i� rea� int� memor� whe� th� librar� �
i� firs� opened� an� i� onl� writte� bac� i� i� differ� fro� �
th� cop� o� th� dis� whe� th� librar� i� closed� Operation� �
whic� chang� th� director� are�� adds� deletes� an� th� sor� �
operatio� whic� i� don� befor� reorganization�� I� onl� �
extract� (o� LRUNZ� progra� executions�� ar� done��� th� �
director�� i� neve� rewritten�� an� th� .LB� fil� ma�� b� writ� �
protecte� i� desired.
Fo� anothe� thing�� th� entir� empt�� director�� i� �
allocate� an� writte� t� dis� whe� � ne�� librar�� i� firs� �
created�� Thi� insure� tha� ther� wil� alway� b� enoug� spac� o� �
dis� fo� th� numbe� o� director� entrie� requeste� a� th� tim� �
o� creation�� Th� dis� spac� ma� ru� ou� whil� addin� file� �
later� bu� ther� wil� alway� b� enoug� roo� o� dis� t� updat� th� �
director� onc� i� i� successfull� created.
Th� fac� tha� onl� th� memor� cop� o� th� director�� i� �
modifie� unti� th� fil� i� close� ma� com� i� ver� hand� i� yo� �
mistakenl�� delet� � fil� an� recogniz� i� righ� away�� Fo� �
example� suppos� yo� mak� th� mistak� o� typin� *.� afte� th� �
-D� prompt.
Briefly�� you� hear� sinks�� a� th� "Deleting:� messag� i� �
displaye� an� al� th� membe� name� zi� int� oblivion�� Don'� �
panic�� Onl� th� memor� cop� o� th� director� ha� bee� modified� �
Whe� th� -D� promp� returns�� d� no� hi� RETURN�� Instead� �
abor� th� progra� wit� Control-C�� Thi� wil� cance� th� progra� �
withou� updatin� th� directory�� an� th� origina� member� wil� �
stil� b� present.
Her� i� anothe� caution� Sinc� th� entir� director� (bu� �
no� membe� sectors�� mus� fi� i� memor� fo� � librar�� t� b� �
successfull� opened� i� i� possibl� tha� � hug� director� create� �
o� � you� syste� wil� b� to� larg� t� fi� i� memor� i� rea� o� �
anothe� syste� wil� les� memory�� Thi� shoul� no� b� � proble� �
wit� � librar� o� unde� � hundre� entries.
T� giv� yo� a� ide� o� ho� muc� elbowroo� yo� hav� t� wor� �
with�� L� display� th� highes� memor� locatio� use� eac� tim� i� �
terminates�� Thi� wil� var� dependin� o� th� larges� director� �
use� durin� operation�� I� doe� no� includ� th� stack�� whic� �
grow� dow� fro� hig� memory�� an� i� allowe� abou� � thousan� �
byte� o� spac� fo� subroutin� linkage� an� temporar� wor� areas.
4.8 LRUNZ Command
Th� LRUNڠ comman� wa� create� fo� thos� o� u� wh� hav� �
lot� o� comman� file� w� lik� t� kee� o� lin� al� th� time� �
Wha� usuall� happen� i� tha� som� nic� littl� .CO� file� ar� ver� �
smal� programs�� bu� havin� � lo� o� the� o� dis� eat� u� fil� �
spac� a� a� alarmin� rat� du� t� th� fixe� CP/� bloc� size� �
Pu� the� al� int� � librar� calle� COMMAND.LB� usin� LU�� Yo� �
ca� the� ru� an� .CO� fil� directl� fro� th� librar� b� saying:
LRUNZ <followed by normal command line just like always>
LRUN� i� derive� fro� Gary'� LRUN� Stil� basicall� th� sam� �
program�� LRUNڠ add� ZCPR2-specifi� features�� i� particula� th� �
abilit� t� searc� fo� th� LB� fil� alon� th� Externa� Path�� I� �
thi� way�� LRUNڠ ca� b� use� a� a� Extende� Comman� Processor� �
and�� whe� invoked�� wil� searc� fo� COMMAND.LB� (o� such�� alon� �
th� pat� an� extrac� th� CO� fil� fro� th� firs� COMMAND.LBҠ i� �
finds.
LRUNZ can be invoked by command line of the following forms:
LRUNZ // or LRUNZ <-- Print Help
LRUNZ -lbrfile cmdline <-- Run command from lbr
LRUNZ cmdline <-- Run command from
default COMMAND.LBR
The full syntax of LRUNZ is:
LRUNZ [-<lbrfile>] <commember> [<parameters>]
Where:
<lbrfile�� i� th� librar� t� b� searched�� Th� squar� �
bracket� aroun� -<lbrfile� indicat� i� i� optional�� Th� - �
characte� tell� LRUN� tha� wha� follow� i� � librar� name�� I� i� �
no� a� actua� par� o� th� name� Don'� leav� � spac� afte� th� -� �
I� th� firs� paramete� doesn'� begi� wit� - the� th� defaul� �
librar� COMMAND.LB� i� used�� I� � driv� spe� i� given� suc� �
a� B:�� the� onl� tha� driv� i� searche� fo� th� library� I� n� �
driv� spe� i� given� th� curren� driv� i� searche� first� an� i� �
n� librar� o� tha� nam� i� found�� th� A�� driv� i� searche� �
befor� givin� up�� I� � name�� bu� n� typ� i� entered�� .LBҠ i� �
assumed.
<commember�� i� th� nam� o� th� comman� t� b� run�� N� �
driv� spe� i� use� here�� Th� typ� default� t� .CO� an� nee� no� �
b� entered.
<parameters�� i� � th� norma� (possibl� empty�� lis� o� �
parameter� whic� th� .CO� fil� expect� t� fin� o� th� �
comman� lin� whe� i� i� run�� Thi� lis� i� parse� t� th� �
require� fil� contro� block� an� comman� lin� are� befor� �
executio� begins�� s� th� progra� wil� no� b� awar� tha� �
anythin� cut� i� goin� on�� (Thank� t� Ro� Ro� Fowle� fo� �
supplyin� th� cod� whic� make� thi� possible.)
LRUNZ EXAMPLES
LRUNZ ED FOO.BAR
th� fil� ED.CO� i� searche� fo� i� COMMAND.LBҠ o� th� �
curren� drive� o� th� A� drive� I� found� ED.CO� i� loade� fro� �
th� library� an� FOO.BA� i� passe� t� i� a� � parameter.
LRUNZ -C:SPECIAL LU -O COMMAND -A A:*.COM
th� fil� LU.CO͠ i� searche� fo� i� SPECIAL.LB� o� th� � �
drive�� I� found�� LU.CO� i� loaded�� an� th� string� -O� �
COMMAND� -A� an� *.CO� ar� passe� t� i� a� parameters.
LRUNZ - -ZIP
th� fil� -ZIP.CO� i� searche� fo� i� COMMAND.LBҠ o� th� �
curren� drive�� o� th� A� drive� I� found� -ZIP.CO� i� loade� an� �
execute� wit� � blan� paramete� list�� Sinc� -ZIP.CO͠ begin� �
wit� � -�� th� extr� - followe� b� � spac� wa� neede� t� ac� a� � �
place-holde� fo� th� librar� name� Compar� with:
LRUNZ -ZIP
th� librar�� -ZIP.LB� i� looke� for�� bu� nothin� els� �
happens� becaus� n� comman� wa� specified.
LRUNZ
wit� n� parameter� a� all�� cause� � scree� o� hel� �
informatio� t� b� displaye� a� � memor� refresher.
4.9 LDIRZ Command
LDIR� print� � sorte� director� o� th� defaul� librar� file� �
Th� printou� give� th� name� o� th� selecte� file� an� thei� �
sizes�� I� i� sorte� alphabeticall� b� fil� nam� an� type�� Tw� �
option� ar� permitted�� an� the� ar� th� nam� o� th� librar� fil� �
(ca� b� specifie� b� lbrfile�� i� whic� cas� lbrfile.LB� wil� b� �
accessed�� o� b�� � ful� filename.typ� an� th� fil� spe� (wil� �
card� ar� OK)� Form� o� th� LDIR� comman� are:
LDIRZ // <-- Print Help
LDIRZ <-- All Files
LDIRZ -lbrfile fn.t <-- Selected Files from Library
LDIRZ filename.typ <-- Selected Files
4.10 LRUNZ as an Extended Command Processor Under ZCPR2
I� th� reade� ca� recall�� comman� processin� unde� ZCPR� �
follows these steps:
1. ZCPR2 receives a command
2�� ZCPR�� parse� th� command�� determine� i� i� i� � �
ZCPR2-resident command and executes it if it is
3�� I� not�� ZCPR� searche� alon� th� command-searc� �
pat� fo� � CO� fil� whic� ha� th� sam� nam� a� th� command�� i� �
found, it is loaded and executed
4�� I� thi� fails�� ZCPR� ma� eithe� searc� alon� th� �
command-searc� pat� o� g� directl� t� th� roo� o� th� pat� �
lookin� fo� a� Extende� Comman� Processor�� i� found�� i� i� �
loaded�� passe� th� comman� lin� a� th� use� presente� it�� an� �
executed; if not, an error message is given
LRUNڠ i� a� excellen� candidat� fo� a� Extende� Comman� �
Processor�� I� th� comman� t� b� execute� i� TEST.COM�� an� i� �
take� tex� a� a� argument�� the� th� comman� lin� t� execut� �
TEST.COM under ZCPR2 would be:
TEST text
�If� TEST.CO͠ i� i� COMMAND.LB� (o� such)�� th� comman� lin� t� �
execute the same file using LRUNZ would be:
LRUNZ TEST text
Thi� latte� comman� i� simulate� b� ZCPR� whe� i� fail� t� fin� �
th� CO͠ file�� Th� nam� o� th� Extende� Comman� Processo� �
(recommended�� i� CMDRUN�� and�� b� renamin� LRUN� t� CMDRUРo� �
makin� � cop� o� LRUN� a� CMDRUN�� LRUN� become� th� Extende� �
Comman� Processor.
LDIRڠ fit� i� nicel� wit� thi� scheme�� COMMAND.LB� ca� b� �
kep� a� th� ROO� alon� wit� LRUN� an� LDIRZ�� an� LRUNZ�� whe� �
executed��� wil젠 g� t� th� ROOԠ lookin� fo� an䠠 findin� �
COMMAND.LBR�� a� whic� poin� i� extract� th� require� CO͠ file� �
LDIRZ�� whe� executed�� wil� searc� alon� th� pat� fo� th� �
COMMAND.LB� file� and� hopefully� fin� i� a� th� ROO� an� extrac� �
the information (file names) requested by the user.
Bot� LRUN� an� LDIR� ca� b� installe� b� GENIN� an� b� se� �
t� loo� fo� th� sam� COMMAND.LB� fil� a� wel� a� b� tol� wher� �
the path they are to follow is located.
.fo Section 5 - Menu Page #
5.0 Menu
5.1 Overview of MENU
MENՠ i� th� ZCPR� Menu-Oriente� Comman� Preprocessor�� I� �
act� a� � front-en� t� ZCPR2�� providin� � menu-oriente� use� �
interfac� t� ZCPR2�� It� functio� ca� b� represente� b�� th� �
following diagram:
------ ------ ------ ------
|M | |Z | |B | |P |
User | E | | C | | D | | g |
Menu ---->| N |--->| P |--->| O |--->| m |
Command | U| | R| | S| | s|
| | | 2| | | | |
------ ------ ------ ------
Th� "Use� Men� Command� i� � singl� characte� tha� th� use� �
strike� whic� instruct� MEN� t� perfor� � function�� Onc� MEN� �
begin� processin� thi� function�� i� build� � comman� lin� fo� �
ZCPR2�� optionall�� askin� th� use� fo� furthe� inpu� (suc� a� � �
fil� name)�� an� the� passe� th� comman� lin� t� ZCPR�� vi� th� �
Multipl� Comman� Lin� Buffer�� ZCPR� the� run� th� comman� line� �
and, when completed, returns to MENU.
Hence�� i� � nutshell�� MEN� build� comman� line� base� o� �
simpl� inpu� fro� th� user�� Th� use� nee� neve� kno� wha� th� �
actua� comman� lin� is� Th� comman� lin� itsel� i� alway� o� th� �
form:
<command> <optional user input>;MENU <menu options>
A� a� example� � comman� buil� b� MEN� t� ru� XDI� wit� use� �
inpu� fo� � fil� nam� specification�� coul� loo� lik� th� �
following:
XDIR <user input>;MENU
Whe� MEN� i� executed� i� look� fo� th� fil� MENU.CP� i� th� �
curren� directory�� I� i� find� one�� i� load� i� an� begin� �
processing. If it does not find one, it simply exits.
Th� MENU.CPҠ fil� ca� contai� u� t� 25�� menu� t� b� �
processe� b� MENU�� Th� defaul� conditio� fo� MEN� i� t� begi� �
processin� a� th� firs� men�� i� MENU.CPR�� bu� option� ar� �
availabl� t� selec� anothe� menu�� I� particular�� th� Men� �
Option� are:
W - Wait for User to Strike a Key before beginning
nn - Begin Processing at Menu nn
The full MENU command line is structured as follows:
MENU [W][nn]
Option� ar� enclose� i� [� bu� mus� b� place� i� th� orde� �
specified, i.e., W, if present, must be first.
I� th� Wai� Optio� i� used�� i� i� alway� first� Th� numbe� �
follow� Wai� immediately�� an� ther� ar� n� space� betwee� them�
MEN� � <-- Wai� an� Star� a� Firs� Menu
MENU W4 <-- Wait and Start at 4th Menu
MENU 4 <-- Start at 4th Menu
Th� use� an� men� programme� nee� no� b� concerne� wit� thi� �
mos� o� th� time� Menu� shoul� b� se� u� t� star� wit� th� firs� �
men� b� default�� s� tha� onl� th� comman� "MENU� i� necessar� t� �
invok� th� desire� menu�� Th� option� describe� abov� ar� use� �
primaril�� b� MEN� itsel� whe� i� build� th� comman� lin� s� tha� �
th� use� wil� retur� wit� a� optiona� wai� an� t� th� men�� tha� �
h� jus� cam� from�� Hence�� i� th� use� wa� i� th� 4t� menu� �
selecte� th� � comman� (fo� XDIR)�� an� th� Men� Programme� ha� �
se� u� th� XDI� comman� t� wai� o� retur� s� th� use� coul� tak� �
hi� tim� an� loo� a� th� director� display�� the� MENՠ woul� �
appen� th� comman� "MEN� W4� t� th� en� o� th� comman� lin� i� �
builds.
MENՠ itsel� i� � CO� file�� lik� an� othe� progra� unde� �
ZCPR2� Unlik� mos� othe� programs� however� i� generate� comman� �
line� t� b� execute� b� ZCPR� an� append� � MEN� comman� t� th� �
en� o� eac� o� th� comman� line� i� generate� s� tha� ZCPR�� wil� �
return to MENU when finished. In this way a loop is set up:
-->--+->- MENU ->- ZCPR2 ->-+
^ v
| |
+-<- Command Line -<---+
Onl�� MENՠ itsel� ca� terminat� thi� loop�� I� th� MEN� �
programme� wishes�� h� ca� se� u� th� MENU.CP� fil� s� tha� thi� �
loo� wil� neve� b� exited�� o� h� ca� se� u� th� fil� t� allo� �
anyon� t� exi� a� an� tim� o� jus� � specia� perso� wh� know� � �
passwor� t� exi� whe� h� wishe� to�� Ther� i� � lo� o� �
flexibilit�� designe� int� th� system�� an� i� wil� b� discusse� �
later in the section on programming MENU.CPR files.
I� � nutshell�� then�� � MENU.CP� fil� ca� b� se� u� t� �
execut� an� ZCPR� comman� o� sequenc� o� commands�� Th� MENU.CP� �
fil� ca� als� b� se� u� t� no� allo� th� use� t� leav� MENU�� t� �
allo�� hi� t� leav� MEN� a� will�� o� t� allo� hi� t� leav� MEN� �
onl� i� h� know� � password.
Thi� HEL� fil� i� divide� int� tw� basi� parts�� Th� inf� �
section� o� "Usin� MENU� an� "Summar� o� MENՠ Commands�� ar� �
designe� t� b� rea� b� � perso� wantin� t� us� MENՠ bu� no� �
wantin� t� lear� ho� MEN� work� o� ho� t� progra� it�� Thes� �
section� describ� ho� t� mov� fro� on� men� t� another�� ho�� t� �
issu� MENՠ commands�� an� ho� t� leav� MEN� i� th� optio� i� �
presente� t� him.
Th堠 othe� section� o� thi� HELР fil� describ堠 th� �
programmin� aspect� o� MEN� an� ar� intende� t� b� use� a� a� �
onlin� referenc� fo� th� MENՠ programmer�� Th� MENՠ comman� �
programmin� summar�� i� especiall� usefu� i� tha� i� provide� � �
summar�� o� th� command� whic� th� MEN� programme� ma�� issu� t� �
MEN� withi� � MEN
U.CPR.
Using MENU
When you first invoke MENU, one of three things will happen:
1�� �� MENՠ wil� appea� an� b� page� u� t� fil� th�
screen� � comman� promp� wil� appea� a� th� botto�
o� th� menu
2�� � MEN� wil� appea� an� no� b� page� u� t� fil� th�
screen� � comman� promp� wil� appea� a� th� botto�
o� th� menu
3�� � comman� promp� wil� appea� wit� n� men� (thi� i�
called the Expert Mode)
I� a� an� tim� you� Men� Displa� i� garble� o� yo� wan� t� �
se� th� curren� Men� (a� sometime� happen� whe� yo� ar� i� Exper� �
Mode)� jus� strik� th� RETUR� key� Th� RETUR� ke� refreshe� you� �
menu at all times.
Th� promp� whic� appear� a� th� botto� o� you� Men� displa� �
has the following general form:
Command (<CR>=Menu,^C=ZCPR2,*=1st Menu,<=Prev Menu,>=Next Menu) -
A� � mentione� i� th� introduction�� ther� ca� b� u� t� 25� �
menu� i� on� MENU.CP� file�� Th� MEN� comman� promp� varie� t� �
reflec� this� Fo� instance� i� onl� on� Men� wa� presen� an� yo� �
wer� no� give� th� optio� t� abor� ou� o� MEN� t� ZCPR2� the� th� �
Men� Comman� promp� woul� tak� it� simples� form� lookin� like:
Command (<CR>=Menu) -
Yo�� ca� strik� th� RETUR� ke� a� thi� tim� t� refres� th� �
Men�� Displa� o� yo� ca� strik� th� characte� o� � Men�� Option� �
Thes� ar� you� onl� choices�� an� strikin� � characte� whic� i� �
no� th� RETURРke�� o� � men� optio� result� i� th� messag� �
"Invalid Command" being displayed.
I� th� MENU.CP� programme� gav� yo� th� optio� t� exi� t� �
ZCPR� an� ther� i� onl� on� Men� i� th� MENU.CP� file�� the� you� �
comman� lin� wil� loo� lik� this:
Command (<CR>=Menu,^C=ZCPR2) -
Yo�� no� hav� th� additiona� optio� o� abortin� t� ZCPR�� b� �
strikin� Control-� (hol� dow� o� th� Control�� o� CTRL�� ke�� an� �
strik� th� lette� C)�� Thi� wil� retur� yo� t� ZCPR� an� exi� �
MENU�� leavin� yo� wit� th� abilit� t� issu� an� availabl� ZCPR� �
command.
On� brie� not� o� optio� letter� befor� goin� on� I� on� o� �
you� option� i� � lette� i� th� rang� fro� � t� Z�� the� cas� i� �
no� significant�� an� yo�� ca� invok� th� optio� A�� say�� b� �
striking an upper- or lower-case A.
I� ther� i� mor� tha� on� men� i� you� MENU.CPҠ file�� th� �
comman� lin� option� becom� slightl� mor� complex�� bu� the� ar� �
stil� quit� eas� t� follow.
I� th� followin� examples�� � a� assumin� tha� th� optio� t� �
exi� t� ZCPR� i� off� s� th� "^C=ZCPR2� optio� wil� NO� appear.
I� yo� ar� a� th� firs� men� i� th� file�� you� comman� lin� �
wil� loo� lik� th� following:
Command (<CR>=Menu,>=Next Menu) -
T� advanc� t� th� nex� menu�� yo� ca� strik� th� ">� o� th� �
".� character�� O� mos� keyboards�� ">� i� th� shif� o� th� "."� �
s� MEN� allow� yo� t� mov� easil� withou� havin� t� worr�� abou� �
shifting the keyboard all the time.
I� yo� ar� a� th� las� men� i� th� file�� you� comman� lin� �
will look like the following:
Command (<CR>=Menu,*=1st Menu,<=Prev Menu) -
Thi� allow� yo� t� strik� th� "*� characte� t� jum� bac� t� �
th� firs� men� i� you� MENU.CP� file�� I� "<� o� ",� i� stuc� �
("<� i� usuall� th� shif� o� th� ",")�� the� yo� wil� bac� u� on� �
menu to the previous menu in the file.
I� yo�� ar� somewher� i� th� middl� o� th� MENU.CPҠ file� �
you� comman� lin� will� a� on� woul� expect� loo� lik� this:
Command (<CR>=Menu,*=1st Menu,<=Prev Menu,>=Next Menu) -
Again�� "*�� wil� g� directl� t� th� firs� menu�� "<� o� ",� �
wil� g� t� th� previou� menu�� an� ">� o� ".� wil� g� t� th� nex� �
menu. Striking the RETURN key will refresh the menu display.
On� las� optio� yo� hav� unde� MEN� involve� acces� t� � �
Syste� Menu�� Thi� men� i� specia� i� tha� ther� i� onl� on� wa� �
to get to it -- via the "$" command.
Th� Syste� Men� i� intende� t� giv� privelege� user� acces� �
t� specia� command� tha� th� res� o� th� user� can'� run�� I� � �
Syste� Men� i� available�� MEN� wil� respon� t� th� "$�� comman� �
with the prompt:
Pass?
Yo� ar� give� on� chanc� t� typ� i� th� correc� passwor� t� �
ente� th� Syste� Menu�� I� yo� ar� wrong� th� messag� "Pas� Err� �
wil� appea� an� yo� wil� b� returne� t� th� men� yo� cam� from� �
I� yo� ar� correct�� yo� wil� ente� th� Syste� Menu� Physically� �
th� Syste� Men� i� alway� th� las� men� i� th� file�� an� it� �
command prompt is:
Command (<CR>=Menu,*=1st Menu,<=Prev Menu) -
I� yo� ar� a� th� men� jus� befor� th� Syste� Menu�� th� ">� �
wil� no� functio� t� allo� yo� t� ente� it�� eve� th� ther� �
technicall� i� � "Nex� Menu"� Th� ">� optio� i� th� comman� lin� �
wil� no� appear�� A� � state� before�� th� onl� wa� t� ente� � �
System Menu is thru the "$" command.
So� i� summary� movin� abou� withi� MEN� i� quit� easy� "*� �
move� yo� t� th� firs� menu� "<� t� th� previou� menu� ">� t� th� �
nex� menu� an� "$� t� th� Syste� Menu.
5.2 Summary of MENU Commands
The full Menu Command Line looks like the following:
Command (<CR>=Menu,^C=ZCPR2,*=1st Menu,<=Prev Menu,>=Last Menu) -
The Menu Commands are:
Command Function
<CR> Refresh Menu Display (RETURN Key)
^C Exit to ZCPR2 (Control-C)
* Jump to the First Menu
< or , Jump to the Previous Menu
> or . Jump to the Next Menu
$ Jump to the System Menu (Password Required)
other Menu Option or Invalid Command; letters are
automatically capitalized, so a=A
5.3 Programming MENU.CPR Files
Th� MENU.CP� fil� i� simpl� � tex� fil� whic� ma� b� create� �
wit� an� conventiona� CP/͠ editor�� includin� WordStar�� MEN� �
ignore� th� Mos� Significan� Bi� o� al� bytes�� s� editor� lik� �
WordStar� whic� occasionall� se� thi� bit� ca� b� used.
Al� MENU.CPҠ file� hav� th� sam� genera� structure�� Th� �
firs� lin� i� eithe� � globa� optio� lin� o� th� beginnin� o� � �
men�� display�� I� � globa� optio� line�� i� begin� wit� th� �
characte� "-"�� an� thi� characte� i� immediatel�� followe� b� �
globa� optio� characters�� Th� globa� optio� line�� the� look� �
lik� this:
-options
Afte� th� globa� optio� line�� i� any� come� th� firs� menu� �
Each menu is structured as follows:
#options
<Text of Menu Display>
#
menu commands
The following are two sample Menu File structures:
-options #options
#options <Text>
<Text> #
# commands
commands ##
#options
<Text>
#
commands
##
Ther� ar� onl� fiv� optio� characters�� I� usin� them� cas� �
is not significant. These option characters are:
Option Function
C Display Command Line to User
D Display Menu to User
P Page Out Menu Display
X Allow User to Exit to CP/M
Th� � optio� display� th� comman� lin� buil� b� MEN� t� th� �
user�� Thi� optio� i� primaril� intende� fo� debuggin� purposes� �
t� allo� th� programme� t� se� wha� command� ar� bein� built� I� �
i� instructiv� t� th� user� however� an� ma� b� employe� fo� tha� �
purpose as well.
� Th� � optio� display� th� men� t� th� user�� I� th� displa� �
functio� i� no� turne� on�� w� ar� i� Exper� Mode�� an� th� �
command� ar� availabl� withou� � men�� display�� RETURN�� o� �
course, can be used to invoke the display if necessary.
Th� Р optio� page� ou� th� men� displa� i� i� i� invoked� �
I� th� pag� functio� i� engaged�� the� th� MEN� progra� output� �
<CRLF�� combination� unti� 2� line� hav� bee� printe� o� th� �
screen� Thi� i� somewha� mor� attractiv� an� eliminate� ol� tex� �
fro� previou� commands�� allowin� th� use� t� concentrat� o� hi� �
curren� se� o� options�� However�� i� i� annoyin� i� th� use� i� �
accessin� th� system�� say� a� 30� bau� vi� � dia� up� I� i� fo� �
thi� reaso� tha� � gav� th� MEN� programme� th� optio� t� tur� �
this option off.
Finally� th� � optio� enable� th� facilit� whic� permit� th� �
user to type ^C and return to ZCPR2.
Whe� MEN� firs� come� up� al� option� ar� turne� off:
C is OFF -- no command display to user
D is OFF -- no menu display to user
P is OFF -- no menu display paging
X is OFF -- user cannot exit to CP/M
Th� globa� option� line�� which�� i� present�� i� th� firs� �
lin� o� th� file�� turn� o� thes� option� fo� th� cours� o� th� �
session in general. That is, if a global options line like
-DPx
i� use� (not� cas� i� insignificant)�� the� men� display� paging� �
an� exi� t� ZCPR� wil� b� availabl� fo� al� menus�� Th� globa� �
options line affects all menus.
Th� globa� option� line�� then�� turn� o� th� indicate� �
option� fo� al� menu� i� general�� However� th� sam� option� ma� �
b� presente� o� th� firs� lin� o� eac� men� immediatel� afte� th� �
"#�� characte� t� temporaril� complemen� th� curren� optio� fo� �
onl� tha� menu.
I� a� optio� i� NO� include� i� th� globa� option� line�� i� �
i� turne� OF� fo� al� menu� i� general� Th� default� selecte� b� �
usin� th� globa� option� lin� ar� overridde� o� � per-men� basi� �
b� th� loca� men� options.
Example:
-dpx
#x
This menu is displayed and paged, but no
exit to ZCPR2 is permitted
#
commands
#dx
This menu is not displayed and the user may not
exit to ZCPR2.
#
commands
#c
Thi� men� i� displayed� paged� an� th� use� ma�
exit to ZCPR2. Additionally, the MENU-generated
commands are printed to the user.
#
commands
##
So�� an�� optio� tha� ma� appea� o� th� globa� option� lin� �
ma� als� appea� o� th� option� lin� fo� � particula� menu�� Th� �
reverse�� however�� i� no� true�� Th� men� option� lin� support� �
on� additiona� option�� viz�� "$"�� Thi� optio� declare� th� �
following menu to be a System Menu.
I� programmin� � MENU.CP� file�� yo� MUS� plac� th� Syste� �
Men� a� th� las� men� i� th� file� T� d� otherwis� i� flagge� a� �
a� error� Th� followin� illustrate� � MENU.CP� fil� containin� � �
Syste� Menu:
-dp
#
Thi� men� i� displaye� an� paged� bu� th� use� ma�
not exit to ZCPR2.
#
commands
#$x
This is a System Menu, and it is displayed, paged,
and the user may exit to ZCPR2.
##
I� � men�� i� � Syste� Menu�� th� "$�� characte� mus� �
immediatel� follo� th� "#"� I� th� cas� o� th� lette� option� i� �
bot� th� globa� an� loca� cases�� th� orde� i� no� importan� �
("dpx� mean� th� sam� a� "xpd").
GENIN� i� use� t� defin� th� passwor� use� t� ente� � Syste� �
Menu�� Thi� i� th� Privilege� Use� Passwor� i� th� GENINӠ Menu� �
Not� tha� thi� passwor� ca� b� upper- an� lower-case� an� cas� i� �
significant.
�
Thi� informatio� sectio� ha� describe� th� structur� o� th� �
MENU.CP� fil� an� ho� t� se� u� a� man� menu� a� desired�� Wha� �
ha� no� bee� discusse� i� th� natur� o� th� command� followin� �
the menu displays. This is discussed in the next section.
5.4 MENU.CPR Commands
Th� command� i� th� MENU.CP� fil� follo�� ar� relativel� �
simpl� structure� Eac� comman� occupie� onl� on� line� an� blan� �
line� i� th� comman� grou� ar� no� permitted�� Th� comman� lin� �
is structured as follows:
l[o][command]["Prompt]
where:
l is the single character used to invoke the command
note that it may be upper- or lower-case
o is an opening option, which is one of:
:nn -- go to Menu nn
! -- have MENU wait when the command is finished
command is an optional ZCPR2 command; note that if
the option is ":nn", then a command here makes no
sense
"Prompt is a command to MENU to print a prompt and wait
for user input to fill out the command line
Th� ":nn� optio� tell� MEN� t� mov� t� � differen� men�� i� �
the MENU.CPR file. The first menu is number 1. Example:
-dpx
#
1st Menu: A - Goto Menu 2 3 - Goto Menu 3
#
a:2
3:3
#
2nd Menu Command: 3 - Goto Menu 3
#
3:3
#x
3rd Menu Command: 2 - Goto Menu 2
#
2:2
##
I� th� firs� menu� th� use� ma� strike:
"a� o� "A� t� got� Men� 2
"3� t� got� Men� 3
">�� o� ".� t� got� th� nex� men� (Men� 2)
^� t� got� ZCPR2
In the second menu, the user may strike:
"3" to goto Menu 3
"*" or "<" or "," to goto Menu 1
">" or "." to goto Menu 3
^C to goto ZCPR2
In the third menu, the user may strike:
"2" or "<" or "," to goto Menu 2
"*" to goto Menu 1
Th� "!�� optio� place� � "W� i� th� MENՠ comman� lin� �
(remembe� fro� before?)�� Thi� cause� MEN� t� paus� an� as� th� �
use� t� "Strik� An� Key� befor� continuing�� I� thi� way�� i� � �
comman� generate� informatio� t� b� rea� b� th� use� befor� MEN� �
clear� hi� screen�� th� "!� optio� ma� b� use� t� giv� th� use� �
al� th� tim� h� want� t� rea� thi� display.
Th� "Promp� suffi�� cause� MEN� t� accep� � tai� t� th� �
comman� lin� i� i� buildin� s� tha� th� use� ca� inpu� argument� �
for the command. The Prompt is simply text to prompt the user.
Examples:
-dxp
#
A - Run XDIR without Pause or Input
B - Run XDIR and Pause before Returning to MENU
C - Run XDIR, Allow User Input, and Pause before
Returning to MENU
Z - Run Any ZCPR2 Command and Pause before
Returning to MENU
#
z!"Enter Command Line --
axdir
b!xdir
c!xdir "Enter Ambiguous File Name --
##
Not� th� Spac� righ� befor� th� "Promp� form� Thi� spac� i� �
significan� t� kee� th� comman� an� use� inpu� fro� runnin� �
together� W� wan� thi� "ru� together� fo� th� � command.
Yo�� ca� hav� a� man� command� a� th� printabl� ASCI� �
characte� se� (withou� lower-cas� letter� an� th� MENՠ comman� �
characters� wil� allow�� You� text�� however� fo� eac� men� mus� �
b� abl� t� fi� o� � scree� wit� th� comman� promp� a� th� bottom� �
Thi� typicall� mean� tha� th� tex� canno� excee� 2� lines.
MENՠ fit� i� nicel� t� th� ZCPR� Syste� o� programs�� Th� �
informatio� sectio� o� "MENU'� Relationshi� t� th� ZCPR�� System� �
explain� ho� MEN� an� th� othe� ZCPR� program� wor� together.
ɠ hav� no� discusse� erro� message� yo� ca� encounte� unde� �
MEN� i� thi� informatio� section�� Tha� come� late� i� th� Erro� �
Message section.
5.5 MENU Programming Command Summary
Eac� MEN� comman� occupie� onl� on� line� an� blan� line� i� �
th� comman� grou� ar� no� permitted�� Th� comman� lin� i� �
structure� a� follows:
l[o][command]["Prompt]
where:
l is the single character used to invoke the command
note that it may be upper- or lower-case
o is an opening option, which is one of:
:nn -- go to Menu nn
! -- ha
ve MENU wait when the command is finished
command is an optional ZCPR2 command; note that if
the option is ":nn", then a command here makes no
sense
"Prompt is a command to MENU to print a prompt and wait
for user input to fill out the command line
The MENU commands are:
Command Function
:nn Goto Menu nn, where the first menu is Menu 1
! Wait after command line is executed before
processing the menu
"Prompt Prompt the user for input and accept it
Th� followin� ASCI� character� ma� NO� b� use� a� command� �
since they are used elsewhere:
<SPACE> # % , . < > * <DEL>
<Any Char Less than Space>
5.6 MENU's Relationship to the ZCPR2 System
MENU�� lik� mos� o� th� ZCPR� utilities�� interact� wit� th� �
syste� a� � whol� an� canno� b� use� wit� system� othe� tha� �
ZCPR2�� I� particular�� MEN� require� th� ZCPR� Multipl� Comman� �
Lin� Buffe� facilit� t� b� availabl� t� i� an� canno� ru� withou� �
it�� I� chain� t� othe� command� an� t� itsel� thr�� thi� �
facility.
MEN� i� installe� b� GENINS� GENIN� i� use� t� instal� MEN� �
an� se� th� parameter� fo� wher� th� Multipl� Comman� Lin� Buffe� �
i� locate� an� wha� th� passwor� fo� enterin� � Syste� Men� is.
Also�� C� (Chang� Directory� an� STARTU� (or� S� fo� CD� ca� �
com� int� pla� wit� MENU� Whe� C� log� int� t� ne� directory� i� �
look� fo� th� fil� ST.CO� an� execute� i� i� ther� i� one� S� i� �
simpl�� STARTUРrenamed�� an� STARTU� wil� loa� th� Multipl� �
Command Line Buffer with a command line and then terminate.
Fro� th� poin� o� vie� o� MENU�� th� comman� loade� b�� S� �
coul� b� MENU� Th� effec� o� thi� i� t� automaticall� ente� MEN� �
when the user employs CD to enter a given directory.
Hence�� b�� usin� CD�� � use� ca� ente� � director�� an� �
suddenl�� fin� himsel� i� � men� instea� o� a� th� ZCPR�� comman� �
level�� Thi� i� goo� fo� application� wher� � director� i� se� �
asid� fo� � specifi� purpos� an� onl� certai� operation� ar� t� �
b� performe� i� it�� suc� a� catalogin� disk� o� handlin� �
accounts�� Also�� wit� CD'� passwor� facility� i� thi� director� �
i� � Syste� Directory�� th� use� woul� hav� t� giv� � passwor� t� �
enter it.
No�� tha� MEN� i� runnin� fo� th� directory�� � MEN� comman� �
coul� b� anothe� C� t� anothe� directory�� O� i� coul� simpl� b� �
a DU: form. Example:
#dp
A - Enter ZCPR Directory
B - Enter A0:
#
acd zcpr
ba0:
#
Here�� i� � i� issued�� the� C� wil� mov� int� ZCPR�� an� �
execut� ST.CO� i� ther� i� on� there�� I� � i� issued�� th� use� �
i� logge� int� A0:�� MEN� i� th� nex� comman� i� bot� case� �
(comman� line� ar� "C� ZCPR;MENU�� an� "A0:;MENU")�� s� MEN� �
automaticall� reinvoke� an� look� fo� MENU.CPR�� I� i� find� it� �
w� ar� i� anothe� MEN� system� and� i� i� doesn't� w� ar� bac� t� �
ZCPR2 command level.
Unde� th� � option�� i� C� find� ST.COM�� S� wil� overwrit� �
th� res� o� th� comman� line� thereb� throwin� awa� th� nex� MEN� �
command and giving us something totally different to work with.
Unde� th� � option� w� wil� ru� MEN� nex� an� simpl� exi� i� �
a MENU.CPR file is not found.
5.7 MENU Error Messages
I� orde� t� mak� MEN� a� smal� a� possibl� (i� i� unde� 2� �
byte� i� size)�� � hav� reduce� th� erro� message� t� � minimum� �
Instead�� MENՠ provide� � minimu� indicatio� tha� somethin� i� �
wrong and aborts.
Th� progra� MCHEC� i� designe� t� tel� yo� mor� specificall� �
wha� i� wrong� MCHEC� i� � MENU.CP� Synta� Checker� an� i� look� �
fo� al� sort� o� erro� condition� tha� ca� occu� i� � MENU.CP� �
file. MCHECK is discussed in the next information section.
MEN� provide� th� followin� minima� erro� messages:
Message Meaning
Full Memory is Full
Invalid Option User Command is in Error
Pass Err Invalid Password Given
Str Err MENU.CPR File Structure Error
5.8 MCHECK -- MENU.CPR Syntax Checker
MCHECˠ shoul� catc� an� error� mad� i� � MENU.CP� fil� b� � �
programmer�� I� i� no� guaranteed�� bu� ha� bee� teste� quit� �
thoroughly.
MCHECK accepts command lines of the following forms:
MCHECK or MCHECK // <-- Print Internal Help
MCHECK dir:filename <-- Check "filename.CPR"
MCHECK dir:filename.typ <-- Check "filename.typ"
Th� DIR�� prefi�� ma� b� use� wit� th� fil� names�� I� i� �
optional� A� � DIR� prefix� thi� accept� th� DU� for� o� � name� �
directory.
MCHECK gives you the "standard" opening error messages:
Error in Disk or User Number -- Aborting
DIR: form was not acceptable
Error in Opening File -- Aborting
Problem with file
TPA Overflow -- MENU.CPR File is Too Big -- Aborting
It could be too big for MENU also (Full error of
MENU)
I� the� start� processin� th� MENU.CP� fil� i� non� o� thes� �
error� occur�� MCHEC� print� th� lin� numbe� an� erro� messag� �
fo� eac� erro� encountered�� I� als� print� comment� a� i� i� �
running along.
Non-error comments printed by MCHECK include:
** Global Options Detected **
There are global options in the file
** Menu Number nnn
It is beginning the indicated menu
** End of Menu Check **
No Errors Detected -or- nnnnn Errors Detected
Done and Error Count
Fatal Errors which cause MCHECK to stop processing are:
Error -- New Menu Expected, But # NOT Found -- Aborting
Like it says; it gives a line number to help you
find the problem
Error -- Premature EOF Encountered -- Aborting
The file did not end with ##
Non-Fatal Errors for MCHECK (fatal for MENU, tho) are:
Error -- Invalid Option:
Invalid option in global or local option line
Error -- Menu Number Out of Range
A ":nn" option referenced a number out of range
Th� followin� i� � sampl� ru� o� MCHEC� o� � goo� MENU.CP� �
file:
B7>mcheck zcpr:menu.cpr
MCHECK Version 1.1
Line Comment/Error Message
---- ---------------------
1 ** Global Options Detected **
2 ** Menu Number 0
17 ** Menu Number 1
28 ** Menu Number 2
39 ** Menu Number 3
48 ** Menu Number 4
57 ** End of Menu Check **
No Errors Detected
.fo Section 6 - File Compare Utilities Page #
6.0 File Compare Utilities
6.1 File Comparison Utilities Under ZCPR2
Tw� utilitie� ar� provide� wit� ZCPR� t� compar� files� �
Both utilities are simple in form to use. These utilities are:
COMPARE -- Compares two files by reading one, computing its
CRC value, saving its CRC and size, and then
reading the other and seeing if they match
DIFF -- Prints out a difference listing between two files;
different bytes encountered at the same
relative displacements from the beginning of
th� file� ar� printe� i� hexadecimal�
decimal, and ASCII forms
These commands are invoked by the following forms:
COMPARE or COMPARE // <-- Print Help
COMPARE dir:file1.typ,dir:file2.typ M <-- Compare
DIFF or DIFF // <-- Print Help
DIFF dir:file1.typ,dir:file2.typ M <-- Compare
Th� fil� spec� mus� b� unambiguou� o� a� erro� wil� result� �
Th� DIR�� prefi� i� optional�� an� ma� b� � name� director� o� � �
DU: form.
Th� "M� i� optional� and� i� present� select� � Multipl� Ru� �
Mod� i� whic� th� use� i� allowe� t� chang� disk� a� h� desires� �
� COMPAR� o� DIF� i� done�� an� the� th� proces� continue� unti� �
the user aborts it.
6.2 CRC Check Utility Under ZCPR2
Th� CRà Chec� Utilit� distribute� wit� ZCPR� compute� CR� �
value� fo� � lis� o� files�� I� use� th� sam� CRà polynomia� �
employe� b� Keit� Peterse� i� hi� CRC� program�� and�� naturally� �
the values come out the same.
Th� CR� Chec� Utilit� compute� th� CR� value� o� � selecte� �
se� o� file� an� print� ou� th� fil� names�� thei� sizes�� an� �
thei� CR� value� i� hexadecimal� � lis� o� ambiguou� file� name� �
ma�� b� provide� t� CRC�� an� i� als� respond� t� � serie� o� �
options.
The general form of the CRC command is:
CRC dir:afn1,dir:afn2,... ooo...
� I� al� ambiguou� fil� references�� th� DIR�� prefi�� i� �
optional�� Thi� prefi� ma� b� � name� director� o� � DU�� form� �
The options available under CRC are:
C - Comment Output; the user is given an opportunity
to enter comments for each file
D - Disk Output; send output to the disk file CRC.CRC
as well as to the console
I - Inspect and approve file before CRC is computed
P - Printer Output; send output to the printer as
well as to the console
Thes� option� ma� b� combine� i� an� manne� desired�� � CR� �
command of the form "CRC" or "CRC //" prints a help message.
6.3 Examples
B7>compare help:lu.hlp,zcpr:lu.hlp
COMPARE Version 1.4
Source File 1 -- A 16: LU .HLP
Source File 2 -- A 11: LU .HLP
** Files are Identical **
B7>compare help.txt,s100.txt
COMPARE Version 1.4
Source Fie 1 -- B 7: HELP .TXT
Source File 2 -- B 7: S100 .TXT
** Files are Different **
B7>compare help:lu.hlp,c0:
COMPARE Version 1.4
Source File 1 -- A 16: LU .HLP
Source File 2 -- C 0: LU .HLP
LU .HLP File Not Found
B7>compare help:du2.hlp,c0:
COMPARE Version 1.4
Source File 1 -- A 16: DU2 .HLP
Source File 2 -- C 0: DU2 .HLP
** Files are Identical **
B7>compare help:du2.hlp,c0: m
COMPARE Version 1.4
Source File 1 -- A 16: DU2 .HLP
Source File 2 -- C 0: DU2 .HLP
Change Disks if Desired and Type ^C or A to Abort or <RETURN>
to Continue -
Source File 1 -- A 16: DU2 .HLP
Source File 2 -- C 0: DU2 .HLP
** Files are Identical **
COMPARE Version 1.4
Source File 1 -- A 16: DU2 .HLP
Source File 2 -- C 0: DU2 .HLP
Change Disks if Desired and Type ^C or A to Abort or <RETURN>
to Continue -
B7>diff help:du2.hlp,c0:
DIFF Version 1.6
Source File 1 -- A 16: DU2 .HLP
Source File 2 -- C 0: DU2 .HLP
NO Differences Noted in Files
B7>save 1 test.bin
B7>zsid test.bin
ZSID VERS 1.4
NEXT PC END
0200 0100 A2FF
#s100
0100 C3 0
0101 70 1
0102 01 2
0103 FF .
#s1f0
01F0 09 0
01F1 3C 0
01F2 3D 0
01F3 32 .
#^C
B7>save 1 test2.bin
B7>compare test.bin,test2.bin
COMPARE Version 1.4
Source File 1 -- B 7: TEST .BIN
Source File 2 -- B 7: TEST2 .BIN
** Files are Different **
B7>diff test.bin,test2.bin
DIFF Version 1.6
Source File 1 -- B 7: TEST .BIN
Source File 2 -- B 7: TEST2 .BIN
Rel Offset B 7: TEST .BIN B 7: TEST2 .BIN
Hex Dec Hex Dec Asc Hex Dec Asc
0000 0 C3 195 C 00 0 .
0001 1 70 112 p 01 1 .
0002 2 01 1 . 02 2 .
00F0 240 09 9 . 00 0 .
00F1 241 3C 60 < 00 0 .
00F2 242 3D 61 = 00 0 .
B7>crc *.* di
CRC Version 2.0
** File Inspection **
COMPARE .HLP -- Select (Y/N/S=Skip Rest/Q=Quit/other=Y)? Y
CRC .CRC -- Select (Y/N/S=Skip Rest/Q=Quit/other=Y)? N
HELP .TXT -- Select (Y/N/S=Skip Rest/Q=Quit/other=Y)? Y
S100 .TXT -- Select (Y/N/S=Skip Rest/Q=Quit/other=Y)? S
** Inspection Complete **
1 File: COMPARE .HLP -- Size: 4K -- CRC: 9F 8E
2 File: HELP .TXT -- Size: 4K -- CRC: 77 6E
B7>type crc.crc
1 File: COMPARE .HLP -- Size: 4K -- CRC: 9F 8E
2 File: HELP .TXT -- Size: 4K -- CRC: 77 6E
B7>crc *.* icd
CRC Version 2.0
** File Inspection **
COMPARE .HLP -- Select (Y/N/S=Skip Rest/Q=Quit/other=Y)? Y
CRC .CRC -- Select (Y/N/S=Skip Rest/Q=Quit/other=Y)? N
HELP .TXT -- Select (Y/N/S=Skip Rest/Q=Quit/other=Y)? Y
S100 .TXT -- Select (Y/N/S=Skip Rest/Q=Quit/other=Y)? S
** Inspection Complete **
1 File: COMPARE .HLP -- Size: 4K
Comment? Help File for COMPARE and DIFF and CRC
-- CRC: 9F 8E
Comment: Help File for COMPARE and DIFF and CRC
2 File: HELP .TXT -- Size: 4K
Comment? Note on Help Files
-- CRC: 77 6E
Comment: Note on Help Files
B7>type crc.crc
1 File: COMPARE .HLP -- Size: 4K -- CRC: 9F 8E
Comment: Help File for COMPARE and DIFF and CRC
2 File: HELP .TXT -- Size: 4K -- CRC: 77 6E
Comment: Note on Help Files
.fo Section 7 - File Copy Utility Page #
7.0 File Copy Utility
7.1 MCOPY Overview
MCOP٠ i� � fil� cop� progra� designe� fo� us� unde� ZCPR2� �
I� support� man�� feature� relate� specificall�� t� th� ZCPR� �
System and is very intimately tied into the ZCPR2 System.
Th� basi� purpos� o� MCOP� i� t� cop�� file� fro� on� �
director� (disk/use� area� t� anothe� unde� ZCPR2�� I� support� �
th堠 name� director�� form� o� ZCPR2��� an� th� sourc� an� �
destinatio� directorie� ca� b� specifie� i� term� o� name� �
directories or DU: forms or both.
MCOP٠ i� als� intende� t� b� use� fo� backu� purposes�� I� �
ha� th� abilit�� t� repeatedl� cop� � se� o� file� fro� on� �
director�� t� another�� pausin� betwee� successiv� cop� passe� t� �
allo�� th� use� t� chang� disks�� � ke� t� th� us� o� MCOP٠ i� �
genera� i� tha� onc� MCOP� ha� begu� operations�� th� use� nee� �
neve� concer� himsel� wit� War� Bootin� th� syste� afte� changin� �
disks; MCOPY is doing that for him.
I� copyin� � fil� fro� on� director�� t� another�� MCOP� �
performs the following steps:
1� I� log� int� th� sourc� director� an� scan� fo� th� �
files specified by the user
2�� I� log� int� th� destinatio� directory� determine� �
i� � cop� o� th� fil� exist� o� th� destinatio� an� delete� i� i� �
it does
3�� MCOP� copie� th� fil� i� th� sourc� director� int� �
the destination directory
4�� MCOP٠ set� th� attribute� o� th� fil� i� th� �
destinatio� director�� t� b� th� sam� a� thos� i� th� sourc� �
directory
5�� MCOP� optionall� verifie� bot� file� b� mean� o� � �
CRC Check
MCOPY is invoked by one of the following forms:
MCOPY // <-- Print Help
MCOP� <-- Ente� Interactiv� Mode
MCOPY files options <-- Immediately Copy
Th� "MCOP� file� options� for� i� extremel� flexibl� i� it� �
capabilities��� Whe firs� invoked��� MCOP٠ ha� ᠠ defaul� �
destinatio� director� define� (b� GENINS)�� Th� "files� fiel� i� �
� serie� o� fil� assignmen� specifications��� wher� suc� � �
specification is of the form:
dir:=dir:filename.typ or dir:filename.typ
I� th� firs� for� i� encountered�� th� defaul� destinatio� i� �
temporaril�� redefine� t� b� th� director� indicate� o� th� lef� �
o� th� "=� character�� an� al� file� reference� thereafte� unti� �
the next "dir:=dir:filename.typ" form are copied to this default.
To illustrate my point, note the following example:
MCOPY FILE1.*,HELP:FILE2.HLP,TEMP:=TEST.TXT,HI.*
Let'� assum� tha� th� defaul� define� b� GENIN� i� th� director� �
name� BACKUP�� I� thi� case�� file� matchin� FILE1.�� i� th� �
curren� direc
tor� ar� copie� t� BACKUP�� th� fil� FILE2.HLРi� �
director�� HELР i� copie� t� BACKUP�� th� fil� TEST.TXԠ i� th� �
curren� director� i� copie� t� TEMP�� an� th� file� matchin� HI.� �
in the current directory are copied to TEMP.
Onc� � DIR:� i� encountered�� th� defaul� destinatio� i� �
redefined�� Encounterin� � differenc� source�� however� doe� no� �
change what the default source directory is.
7.2 MCOPY Command Line Options
Th� option� portio� o� th� "MCOP� file� options� comman� i� �
a set of none or more of the following characters:
E -- Test for Existence of File on Destination and
User Approves Copy before Copy is Done
I -- User Approves Each File before Copy Begins
M -- Multiple Copy (Repeat) Facility
Q -- Quiet Operation (No Activity Displays)
V -- Verify Facility
GENIN� i� use� t� se� th� defaul� setting� fo� eac� o� thes� �
option� (turnin� the� o� o� off)� an� th� optio� character� serv� �
to toggle the settings from the defaults.
Th� Š optio� (Existenc� Test� look� o� th� destinatio� �
director�� t� se� i� th� fil� i� i� abou� t� cop�� i� alread� �
there� I� the� tell� th� use� o� it� finding� an� ask� hi� i� h� �
want� t� g� ahea� wit� th� copy�� Th� use� ma� elec� t� cop�� o� �
no� cop� a� h� desires.
Th� ɠ optio� (Inspect� display� al� file� whic� matc� th� �
indicate� sourc� file� t� th� user�� allowin� hi� t� selec� whic� �
file� h� want� t� copy�� I� the� copie� th� selecte� files� �
MCOP٠ perform� thi� operatio� fo� eac� se� o� file� i� th� �
command line (separated by commas).
Th� ͠ optio� (Multipl� Copy� pause� befor� startin� th� �
copy�� allowin� th� use� t� abor� th� procedur� o� inser� � dis� �
int� th� source�� th� destination�� o� bot� an� instruc� MCOP� t� �
proceed�� Afte� copyin� al� o� th� indicate� files�� MCOP٠ the� �
pause� again�� allowin� th� use� t� agai� chang� disks�� Thi� �
continues until the user aborts the procedure.
Th� � optio� (Quiet� turn� of� th� MCOP� activit�� display� �
I� norma� operation� MCOP� i� constantl� tellin� th� use� wha� i� �
i� doing�� ɠ fee� tha� thi� i� bette� tha� quietl�� havin� �
problems without the user knowing what is going on.
Th� ֠ optio� (Verify� i� use� t� chec� th� copie� fil� t� �
insur� tha� th� cop� i� good�� Wit� thi� optio� engaged�� MCOP� �
compute� � CR� valu� o� th� sourc� fil� a� i� read� it�� Whe� �
MCOP� ha� complete� th� copy� i� read� th� destinatio� fil� back� �
computin� it� CR� value�� and� whe� complete� i� compare� th� tw� �
CRà values�� tellin� th� use� i� a� erro� i� th� cop�� occurre� �
(i.e., different CRC values resulted).
7.3 MCOPY Interactive Mode
I栠 th� user'� comman� i� simpl�� "MCOPY"��� the th� �
Interactiv� Mod� i� enabled�� I� respons� t� thi� command� MCOP� �
displays the following prompt:
MCOPY Status: EIMQV -- MCOPY Command (? for Help)?
wher� an� o� th� character� i� "EIMQV� ma� b� omitted� Th� EIMQ� �
character� indicat� th� statu� o� th� variou� MCOP٠ options� �
namely:
E indicates that File Existence Test is ON
I indicates that Inspect Mode is ON
M indicates that Multiple Copy is ON
Q indicates that Quiet Mode is ON
V indicates that MCOPY will Verify
Th� MCOP� comman� prompte� fo� i� � singl� character�� cas� �
insignificant�� Yo�� ca� toggl� eac� on� o� thes� option� b� �
simply striking the appropriate letter.
Ther� ar� si� MCOP� Command� t� perfor� variou� functions� �
These commands are:
C - Copy a File or Set of Files
D - Directory Display
F - Compute Amount of Free Space on Disk
L - Log in New Directories
S - Display MCOPY Status
X or ^C - Exit
Th� à comman� (Copy�� allow� yo�� t� specif�� � se� o� �
destinations� sources� an� file� a� yo� coul� a� th� comman� lin� �
level���� Eac蠠� se� i� separate䠠 b���� comma (like� �
"dir:=dir:f1.typ,f2.typ,dir:=dir:f3.typ").
Th� � comman� (Directory� display� � sorte� director� t� th� �
use� o� th� defaul� director� o� on� o� hi� choice�� Name� �
directorie� o� th� DU� for� ma� b� use� t� specif� th� directory� �
Th� defaul� director� i� th� las� destinatio� director� copie� t� �
or selected by the L command.
Th� Ơ comman� compute� th� amoun� o� fre� spac� lef� o� �
disk. The user may select the disk or ride with the default.
Th� � comman� allow� th� use� t� specif� � ne�� destinatio� �
or source directory.
Th堠 Ӡ comman� tell� th� use� th� Statu� o栠 MCOPY� �
particularl�� wha� th� curren� sourc� an� destinatio� directorie� �
are.
X or ^C exits MCOPY to ZCPR2.
7.4 Sample MCOPY Sessions
B7>mcopy help:=mcopy.hlp
MCOPY Version 2.8
Copy B 7: MCOPY .HLP to A 16:
No Original File MCOPY .HLP on Destination
Reading 7K Writing 7K
Copy Complete, Verify Phase --
Reading 7K
Verify Complete
**** MCOPY Compete ****
1 File Copied 0 Copy Errors
B7>mcopy 1:=*.hlp,*.txt i
MCOPY Version 2.8
Copy B 7: ????????.HLP to B 1:
MCOPY .HLP -- Copy (Y/N/Q=Quit and Skip Rest/<CR>=Y)? Y
No Original File MCOPY .HLP on Destination
Reading 7K Writing 7K
Copy Complete, Verify Phase --
Reading 7K
Verify Complete
Copy B 7: ????????.TXT to B 1:
HELP .TXT -- Copy (Y/N/Q=Quit and Skip Rest/<CR>=Y)? Y
S100 .TXT -- Copy (Y/N/Q=Quit and Skip Rest/<CR>=Y)? N
No Orginal File HELP .TXT on Destination
Reading 1K Writing 1K
Copy Complete, Verify Phase --
Reading 1K
Verify Complete
**** MCOPY Complete ****
2 Files Copied 0 Copy Errors
B7>mcopy
MCOPY Version 2.8
MCOPY Status: V -- MCOPY Command (? for Help)? ?
MCOPY Status: E I M Q V
These Status Characters have the following meanings:
E - File Existence Test Mode is ON
I - File Selection Inspect Mode is ON
M - Muliple Copy Function Mode is ON
Q - Quiet Mode is ON
V - Verify Mode is ON
The Status Characters, as commands, toggle their respective modes.
Other valid MCOPY Commands are:
C - Copy a File or Set of Files
D - Directory Display
F - Compute Amount of Free Space on Disk
L - Log in New User/Disks
S - Display MCOPY Status (Cur and Dest User/Disk)
X or ^C - Exit MCOPY
MCOPY Status: V -- MCOPY Command (? for Help)? d
** Directory Display **
File Spec (<CR>=C 0:*.*)? b1:
DEMO .COM 4K DEMO .MAC 4K DEMO .ZEX 4K GENINS .MAC 44K
HELP .TXT 4K MCOPY .HLP 8K TEMPLATE.MAC 12K
** 80K Occupied by Displayed Files, 4048K Remaining on Disk B **
MCOPY Status: V -- MCOPY Command (? for Help)? c
File Spec (<CR>=Abort)? zcpr:=mcopy.hlp
Copy B 7: MCOPY .HLP to A 11:
No Original File MCOPY .HLP on Destination
Reading 7K Writing 7K
Copy Complete, Verify Phase --
Reading 7K
Verify Complete
**** MCOPY Complete ****
1 File Copied 0 Copy Errors
MCOPY Status: V -- MCOPY Command (? for Help)? f
** Free Space Data **
Disk (<CR>=A)?
1328K Bytes Remaining on Disk A
MCOPY Status: V -- MCOPY Command (? for Help)? f
** Free Space Data **
Disk (<CR>=A)? B
4048K Bytes Remaining on Disk B
MCOPY Status: V -- MCOPY Command (? for Help)? x
** MCOPY Exiting **