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