ZCPR2 Resident Commands
The DIR Command
The ERA Command
The REN Command
The TYPE and LIST Commands
The SAVE Command
The GET Command
The GO Command
The JUMP Command
The DU Form for Changing Disk and User
:ZCPR2 Resident Commands

    Lik� th� CP/� 2.� CCP�� ZCPR� contain� som� command� withi� �
itself��  I� contain� al� o� th� CC� command� (excep� USER� whic� �
isn'� neede� anymore�� an� � fe� more�� bu� al� o� th� ZCPR� �
residen� command� ar� differen� wit� logica� extension� t� th� �
CC� commands.

    Th堠 followin� discussio� applie� t th堠 recommende� �
configuratio� o� ZCPR2��  Ther� ar� man� way� t� configur� ZCPR2� �
an� thi� discussio� canno� possibl� cove� al� o� them�� s� ɠ a� �
coverin� th� recommende� configuratio� wher� al� o� th� residen� �
command� ar� enable� wit� al� o� thei� option� turne� on.

    I� th� followin� discussion�� "afn� refer� t� th� CP/� �
ambiguou� fil� nam� for� (containin� "?� and/o� "*�� characters� �
an� "ufn� refer� t� th� CP/� unambiguou� fil� nam� for� (doe� no� �
contai� th� ambiguou� characters).


    Th� DU� prefi� ma� b� use� wheneve� � fil� nam� i� used�  B� �
attachin� thi� prefix�� th� fil� i� identifie� t� resid� i� th� �
indicate� director�� (dis� an� use� area)��  T� revie�� th� DU� �
form��� i� i� � logica� extensio� t� th� D�� prefi�� unde� �
conventional CP/M.  The user number is added, however.

    I� � prefi� o� D�� i� used�� i� refer� t� th� curren� use� �
are� o� th� indicate� disk�  I� � prefi� o� U� i� used� i� refer� �
t� th� indicate� use� are� o� th� curren� disk��  DU:� o� course� �
refers to the indicated user area on the indicated disk.

    Fo� example� i� yo� ar� logge� int� Dis� B� Use� 1� the� th� �
following is true:

         A:MYFILE.TX�  -- refer� t� MYFILE.TX� o� Dis� A� Use� 1
         4:MYFILE.TXT  -- refers to MYFILE.TXT on Disk B, User 4
        A4:MYFILE.TXT  -- refers to MYFILE.TXT on Disk A, User 4
           MYFILE.TXT  -- refers to MYFILE.TXT on Disk B, User 1

:The DIR Command

    Th� DI� comman� i� use� t� displa� th� name� o� th� file� i� �
the current directory.  It has three basic forms --

         Display $DIR File Names       DIR DU:afn
         Display $SYS File Names       DIR DU:afn S
         Display All File Names        DIR DU:afn A

    Assume you are logged into Disk B, User 1.  Examples:

         DIR 4:              <-- Gives all non-System files
                                  on B4
         DIR 4: A            <-- Gives all files on B4
         DIR A4:*.HLP A      <-- Gives all files of type
                                  HLP on A4
         DIR *.* S           <-- Gives all System files on B1

:The ERA Command

    Th� ER� comman� i� use� t� eras� files��  I� i� no� abl� t� �
eras� Read/Onl� files� bu� i� ca� eras� Syste� files�  I� ha� tw� �
basic forms --

         Erase Specified Files         ERA DU:afn
         Erase with Verify             ERA DU:afn V

    ER�� print� th� name� o� th� file� i� erases��  I� yo�� hav� �
selecte� th� Verif� option�� i� als� prompt� yo� befor� i� erase� �
them (or aborts, if you desire).

:The REN Command

    Th� RE� comman� i� use� t� chang� th� nam� o� on� fil� t� �
another��  Again� i� ca� no� chang� th� nam� o� � Read/Onl� file�  ��It has only one basic form --

         Renam� Fil�                   RE� DU:ufn1=ufn�

    Like ERA, REN can "see" System files as well as DIR files.

    I� ufn� alread� exists� RE� wil� as� th� use� i� h� want� t� �
Erase it (with the prompt "Erase ufn1?").

:The TYPE and LIST Commands

    TYPŠ an� LIS� ar� use� t� displa� file� o� th� consol� an� �
printer�� resp�  TYP� page� b� default� stoppin� afte� th� scree� �
is filled.  These two commands have three basic forms --

         Print File on Console         TYPE DU:ufn P
           Without Paging
         Print File on Console         TYPE DU:ufn
           With Paging
         Print File on Printer         LIST DU:ufn

    The file may be either System or DIR.

:The SAVE Command

    Th� SAVŠ comman� i� use� t� sav� th� content� o� th� TP� �
ont� dis� a� � file��  I� accept� tw� arguments��  � numbe� an� � �
fil� name��  Th� fil� nam� ma� b� optionall� followe� b�� th� �
lette� "S� t� indicat� tha� th� numbe� i� th� numbe� o� 128-byt� �
Sector� (Blocks�� t� b� saved�� and�� i� thi� optio� lette� i� �
omitted� th� numbe� i� assume� t� b� th� numbe� o� 256-byt� Page� �
to be saved.  The SAVE command has two basic forms --

         Save Memory into File         SAVE n DU:ufn
         Save Memory into File         SAVE n DU:ufn S
           and Specify Number of
           Blocks

    I� th� number�� n� i� followe� b� th� suffi� "H"� a� i� "FH� �
o� "2DH"�� the� � i� take� t� b� � hexadecima� value��  I� n� �
suffi�� i� given�� � i� assume� t� b� decimal��  Thi� hexadecima� �
optio� eliminate� th� nee� fo� conversio� fro� th� value� �
supplied by debuggers, like DDT.


    I� th� indicate� fil� alread� exists� SAV� wil� as� th� use� �
if he wishes to erase it with the prompt "Erase ufn?".

:The GET Command

    GEԠ i� use� t� loa� � fil� anywher� int� memory��  I� �
require� tw� arguments��  � numbe� (assume� t� b� hexadecimal� o� �
th� 256-byt� pag� i� memor� a� whic� t� star� th� loa� an� th� �
name of the file.

         Load File Into Memory         GET adr DU:ufn

    Not� tha� thi� "adr� i� � pag� number�� s� adr=� refer� t� �
100H, adr=2d refers to 2D00H, etc.

:The GO Command

    Th� G� comman� i� use� t� reexecut� th� las� progra� loade� �
into the TPA without having to reload it.

         Reexecute Last Transient      GO params
           Without Reloading It

    Th� parameter� ar� parse� a� wit� an� transien� command� an� �
th� appropriat� buffer� ar� loade� b� ZCPR2��  A� usual�� ZCPR� �
"calls� th� progra� loade� a� 100� afte� i� ha� finishe� wit� th� �
parsing and buffer loading.

:The JUMP Command

    JUM� i� use� t� branc� t� anywher� i� memory�  I� take� onl� �
on� argument�� whic� i� th� addres� a� whic� t� jump��  Thi� �
addres� ca� b� t� an� byt� i� memor� (i� i� � ful� 16-bi� �
address), and it is assumed to be a hexadecimal number.

         Call Subroutine Anywhere in   JUMP adr
           Memory

:The DU Form for Changing Disk and User

    Th� D� for� standin� alon� i� use� t� lo� int� � differen� �
directory.  There are three basic forms of this command --

         Change Disk                   D:
         Change User                   U:
         Change Disk and User at       DU:
           Same Time