ZCPR3 Resident Commands
DIR       Directory Display
ERA       Erase Files
GET       Load File into Memory
GO        Re-execute Last Transient
JUMP      Branch to Memory Address
NOTE      Comment
REN       Rename File
SAVE      Write Memory Image to Disk
TYPE and LIST Commands
The DU and DIR Forms for Changing Disk and User
:ZCPR3 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� al� o� th� �
command� i� th� ZCPR� Comman� Processo� Replacement��  Th� �
particula� selectio� o� command� availabl� a� an� on� tim� �
i� installation-dependent��  Th� recommende� configuratio� �
wher� al� o� th� residen� command� ar� enable� wit� al� o� �
thei� option� turne� o� i� covere� here.

    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�� o� DIR�� prefixe� 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� conventiona� CP/M��  Th� �
use� numbe� i� added� however�  Th� DIR� for� i� � mnemonic� �
lik� PASCAL�� whic� i� relate� t� � dis� an� use� are� b� a� �
associatio� i� th� Name� Directory.

    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�� refer� t� th� indicate� use� are� o� th� �
indicate� disk.


    Fo� example� i� th� use� i� logge� int� Dis� B� Use� 1� �
the� th� followin� i� 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� th� curren� directory�  I� ha� thre� basi� form� --

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

    Assum� th� use� i� logge� int� Dis� B�� Use� 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� basi� form� --

         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� the� (o� aborts� i� yo� desire).

: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� nam� o� th� file.

         Load File Into Memory         GET adr DU:ufn

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

:The GO Command
�     Th� GϠ comman� i� use� t� reexecut� th� las� progra� �
loade� int� th� TP� withou� havin� t� reloa� 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�� ZCPR3�  �
A� usual�� ZCPR� "calls� th� progra� loade� a� 100� afte� i� �
ha� finishe� wit� th� parsin� an� buffe� 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)� an� i� i� assume� t� b� � hexadecima� number.

         Call Subroutine Anywhere in   JUMP adr
           Memory

:The NOTE Command

    NOTŠ i� use� t� expres� comments��  �� lin� beginnin� �
wit� � semicolo� (;� i� � comment�� an� � comman� whos� ver� �
i� NOT� (ther� ma� b� man� command� o� on� line�� separate� �
by semicolons) is a comment.

         Comment        NOTE anytext

: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�  I� ha� onl� on� basi� for� --

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

    Lik� ERA�� RE� ca� "see� Syste� file� a� wel� a� DI� �
files.

    I� ufn�� alread� exists�� RE� wil� as� th� use� i� h� �
want� t� Eras� i� (wit� th� promp� "Eras� ufn1?").

: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� t� b� saved��  Th� SAV� comman� �
ha� tw� basi� form� --
�          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� supplie� b� debuggers� lik� DDT.

    I� th� indicate� fil� alread� exists� SAV� wil� as� th� �
use� i� h� wishe� t� eras� i� wit� th� promp� "Eras� ufn?".

: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� i� filled��  Thes� tw� command� hav� thre� basi� �
form� --

         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 DU and DIR Forms for Changing Disk and User

    Th� Dՠ for� standin� alon� i� use� t� lo� int� � �
differen� directory��  Ther� ar� thre� basi� form� o� thi� �
comman� --

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


    Th� DIҠ for� standin� alon� ma� als� b� use� t� lo� �
into a different directory.  The format is:

         DIR:
like
         TEXT:

    Name� directorie� hav� password� associate� wit� them� �
s� i� an� DIR� director� referenc� ha� � non-blan� password� �
th� use� wil� b� prompte� fo� th� password��  Th� director� �
referenc� wil� b� rese� t� hi� curren� director�� i� th� �
password is invalid.


    Th� DU�� for� ma� b� disable� unde� ZCPR3�� an� thi� �
leave� onl� th� DIR�� form��  Usin� th� DIR� form� director� �
access can be controlled:

         1. only disk/user areas named can be referenced

         2. password protection is provided