Note ZCPR3 Utilities
CLEANDIR Physical Directory Cleanup
CMD Input Command Line
MU Memory Utility RCP
SHSET Define Shell Sequence
:Note ZCPR3 Utilities
Thi� se� o� ZCPR� utilitie� ar� general-purpos� i� �
natur� an� hav� bee� provide� wit� th� ZCPR�� Phas� � �
release� Al� utilitie� excep� th� RC� ca� b� installe� o� � �
targe� ZCPR� Syste� b� runnin� Z3INS.
:CLEANDIR Physical Directory Cleanup
Command: CLEANDIR 1.0
Syntax:
CLEANDIR dir: o
or
CLEANDIR o
Function:
CLEANDI� "cleans� � physica� dis� directory�� I� load� �
th� director�� o� th� targe� dis� int� memory�� sort� i� �
alphabeticall�� withi� eac� use� are� (ascendin� orde� b� �
default)�� an� write� i� ou� t� dis� wit� E� fil� o� unuse� �
director� entries.
� DIR�� prefi� i� allowed�� bu� onl� th� dis� referenc� �
i� meaningful�� s� i� "CLEANDI� ROOT:� i� issue� wher� ROOT� �
is A15:, then disk A is cleaned.
Options:
D - sort user areas and files in Descending Order
Comments:
CLEANDIR'� sor� o� th� dis� director� buy� th� use� �
several advantages:
1�� Utilitie� whic� sor� th� dis� director�� afte� �
loadin� it�� lik� XDIR�� ru� faste� sinc� th� director�� i� �
already sorted.
2�� Th� possibilit� o� recoverin� file� b�� th� �
UNERAS� comman� i� increase� i� CLEANDI� ha� bee� ru� o� th� �
director� recentl� befor� th� file� wer� erased�� Not� tha� �
an�� erase� file� absolutel� canno� b� recovere� b�� UNERAS� �
i� CLEANDIҠ wa� ru� betwee� th� tim� the� wer� erase� an� �
UNERASE was executed.
3�� Us� o� DU2/DU� t� loo� a� th� director�� i� �
facilitated if the directory is already sorted by CLEANDIR.
Selected Error Messages:
Self-Explanatory
Examples of Use:
CLEANDIR
-- clean current disk in ascending order
CLEANDIR A: D
-- clean disk A in descending order
CLEANDIR TEXT:
-- clean the disk which the directory named TEXT
is defined for in ascending order
CLEANDIR D
-- clean current disk in descending order
:CMD Input Command Line
Command: CMD 1.0
Syntax:
CMD cmd1;cmd2;...
or
CMD or CMD;cmd2;...
Function:
I� CM� ha� a� argument�� i� build� � ne� comman� lin� �
whic� begin� wit� thi� argumen� an� proceed� wit� th� res� �
o� th� comman� line� Fo� example� th� firs� form:
CMD cmd1;cmd2;...
is translated into:
cmd1;cmd2;...
Thi� i� goo� becaus� source� suc� a� MENU�� VMENU� �
an� VFILEҠ ca� ente� th� "cmd1� variabl� fro� th� use� �
selection manually.
I� CM� ha� n� argument� th� use� i� prompte� fo� input� �
an� thi� inpu� i� inserte� int� th� comman� strea� a� th� �
poin� o� th� CM� command� Thi� i� muc� mor� useful� suc� a� �
whe� SHSEԠ i� use� t� defin� � shel� sequence�� an� thi� �
sequenc� i� t� b� exite� a� som� time�� Fo� example�� th� �
second form:
CMD;cmd2;...
is translated into:
mycmd;cmd2;...
if the user typed in "mycmd" in response to the prompt.
CM� set� th� erro� messag� wheneve� i� runs�� ERRO� i� �
turned on if no line was input to CMD.
Options: None
Comments:
CMĠ wa� buil� fo� us� specificall�� wit� th� SHSE� �
command�� alth� i� ma� fin� othe� applications� Th� proble� �
tha� CM� addresse� i� th� cas� wher� th� mai� progra� i� th� �
shel� sequenc� know� nothin� abou� shells� an� i� i� desire� �
to leave the sequence sometime. CMD provides this out.
Fo� instance�� i� MU� i� t� b� use� a� th� mai� shell� �
then:
SHSET MU3;CMD
wil� ru� MU3�� allo� th� use� t� d� wha� h� wants�� an� the� �
reenter MU3. If the user entered the command
SHCTRL POP
th� shel� stac� woul� b� poppe� an� th� "MU3;CMD� loo� woul� �
be broken.
Additionally�� CM� set� th� ERRO� messag� o� ZCPR3�� s� �
tha� program� o� dow� th� lin� ca� determin� i� inpu� wa� �
mad� whe� CM� wa� run�� I� th� use� simpl� strike� � RETUR� �
i� respons� t� th� CM� prompt� a� erro� i� indicated� Test� �
ca� late� b� made� lik� I� ERROR� t� chec� thi� an� mak� th� �
command flow change depending on the outcome.
Selected Error Messages:
None - self-explanatory
Examples of Use:
See above
:MU Memory Utility RCP
Command: MU RCP 1.0A
Syntax:
MU <-- invoke MU at 100H
or MU address <-- invoke MU at indicated address
Function:
M� i� identica� t� MU� i� function�� wit� th� exceptio� �
tha� th� Ƞ comman� (Hexadecima� Calculator��� i� no� �
supported�� Th� differenc� betwee� M� an� MU� i� tha� M� �
execute� a� a� RC� an� MU� execute� a� � transient�� A� a� �
RCP�� Mՠ allow� th� use� t� examin� th� TP� withou� concer� �
fo� sid� effects�� s� debuggin� transient� i� simplifie� b� �
thi� command�� I� i� th� onl� mai� comman� i� th� DEBUG.RC� �
provided in the ZCPR3 release.
Options: None
Comments:
M� ma� b� invoke� a� � Shel� b� th� SHSE� command� Th� �
à comman� ca� b� use� fro� withi� M� t� execut� an� desire� �
comman� line�� includin� th� "SHCTR� POP� comman� whic� pop� �
Mՠ fro� th� Shel� Stack�� terminatin� it� operatio� a� � �
Shell.
Selected Error Messages: None
Examples of Use:
MU <-- run MU
MU 0F400 <-- run MU but position at 0F400H
:SHSET Define Shell Sequence
Command: SHSET 1.0
Syntax:
SHSET cmd1;cmd2;...
Function:
SHSEԠ define� th� command� whic� follo�� i� a� th� �
comman� sequenc� t� b� place� o� th� to� o� th� shel� stack� �
I� place� thi� sequenc� there�� Consequently� onc� SHSE� i� �
execute� o� � sequenc� o� commands�� thes� command� wil� b� �
cycle� thr�� tim� an� tim� agai� unti� th� shel� stac� i� �
cleared or popped.
Options:
None
Comments:
SHSEԠ provide� a� eas� mechanis� t� mak� an�� comman� �
sequenc� int� � shell�� Consequently�� non-ZCPR� programs� �
lik� MBASIC�� DBAS� II�� WOR� STAR�� an� other� ca� becom� �
shells under ZCPR3.
Car� shoul� b� take� wit� SHSE� i� allowin� th� shel� �
t� b� exite� i� i� i� s� desired�� Th� utilit�� CMĠ i� �
sometimes useful for this.
Selected Error Messages:
None - self-explanatory
Examples of Use:
SHSET MBASIC;CMD
-- define the sequence MBASIC;CMD to be a shell
SHSET WS
-- define Word Star to be a shell