;

              Named Directories Under ZCPR3

                       -- Basics --
             1 - The Named Directory Concept
             2 - Memory-Based Named Directories


                      -- Commands --
                    M - MKDIR
                    U - Using MKDIR
                    P - PWD
                    C - CD

:1
         Overview of the Named Directory Concept

    Th堠 Name䠠 Director�� Concep� unde� ZCPR�� i� a� �
associatio� o� � mnemoni� nam� wit� � logica� directory� �
whic� i� � dis� an� use� area�  Wit� thi� facility� th� use� �
i� permitte� t� refe� t� an� director� b� � mnemoni� name� �
an� thi� greatl� improve� th� use� interfac� ove� havin� t� �
remembe� dis� letter� an� numbers.

    Fo� instance� a� environmen� ca� b� se� u� i� whic� th� �
followin� nam� assignment� ar� made:

         A15: = ROOT         A0:  = BASE
         B0:  = BBASE        B1:  = JEFF
         B2:  = ROBERT       B3:  = LINDA

    Wit� th� name� director� facilit� enabled�� th� ZCPR� �
utilitie� ca� refe� t� thes� directorie� b� eithe� th� DU� �
for� (dis� an� use� number� o� b� th� name:

         XDIR ROOT:  is the same as  XDIR A15:

    Mos� o� th� ZCPR� utilitie� recogniz� name� directorie� �
i� th� facilit� i� enabled�� and�� sinc� thes� utilitie� �
functio� t� provid� interface� betwee� th� directories� the� �
creat堠 ᠠ goo� workin� environmen� fo� us堠 o栠 th� �
conventiona� CP/� utilitie� a� well��  I� othe� words�� th� �
ZCPR�� utilitie� whic� ca� dea� wit� name� directorie� ar� �
th� onl�� utilitie� wit� whic� on� shoul� cros� director� �
boundarie� i� � ZCPR� syste� an� conventiona� utilities� �
lik� a� edito� o� a� assembler�� shoul� b� use� i� onl� on� �
director�� an� dea� wit� file� i� th� curren� director�� an� �
o� driv� � i� th� sam� use� numbe� (A� i� th� vernacular).

    Man�� ZCPR�� tool� ar� provide� t� ac� a� � bridg� �
betwee� directories� an� the� wer� create� wit� thi� purpos� �
i� mind��  Commonly-use� function� ha� t� b� mad� availabl� �
t� th� ZCPR� use� t� provid� thi� bridge�� suc� function� �
include:


         o File
              Copying
              Renaming
              Erasing
              Unerasing
              Protecting
              Typing to Console
              Printing to Printer
              Search

         o Directory Display



    Fo� instance� t� edi� � fil� i� th� ZCP� director� wit� �
Wor� Master�� cop� th� fil� int� � workin� director�� whic� �
ha� th� WM.HL� fil� i� A�� i� th� sam� use� are� an� edi� �
there�  The� cop� i� bac� whe� done:

         B1>mcopy b1:=zcpr:file.txt
              ...
         B1>wm file.txt
              ...
         B1>mcopy zcpr:=file.txt


    Man�� commercia� programs�� lik� Wor� Maste� an� Wor� �
Star�� ar� alread� programme� t� loo� o� A�� i� the� d� no� �
fin� th� overla� the� nee� i� th� curren� directory��  Wor� �
Master�� fo� instance�� ha� � WM.HL� fil� whic� provide� �
onlin� documentation� an� b� workin� o� driv� B� i� th� sam� �
use� tha� � WM.HL� fil� exist� o� A:�� i� � use� ask� fo� �
Help� Wor� Maste� wil� fin� it.

    Name� Directorie� ca� provid� � mor� human-oriente� �
workin� environment��  Th� use� nee� n� longe� remembe� tha� �
hi� command� ar� i� director� A15�� -- h� nee� onl� remembe� �
tha� ROOԠ contain� hi� commands�� HEL� contain� hi� hel� �
files�� ROBERԠ i� hi� nam� an� tha� i� wher� h� place� th� �
file� h� i� workin� on�� BDS� i� wher� hi� à compile� is� �
etc.


    Name� Directorie� ar� supporte� b� th� ZCPR� utilitie� �
an� b�� ZCPR� itself��  Thre� utilitie� ar� specificall� �
designe� t� dea� wit� Name� Directories� an� th� res� o� th� �
utilitie� ca� acces� Name� Directorie� manipulate� b�� th� �
thes� thre� an� us� them.

    Th� thre� ZCPR� utilitie� whic� dea� directl�� wit� �
Name� Directorie� are:

         MKDIR -- create a Named Directory

         PWD   -- print Working Directory and all
                   Named Directories

         CD    -- log into a Named Directory

:M

Command:  MKDIR 3.0

Syntax:

    MKDIR               <-- enter utility
or
    MKDIR dir:ufn       <-- enter utility and load NDR file

Function:

    MKDIҠ i� use� t� creat� Name� Director�� Files�� whic� �
ar� file� o� dis� whic� contai� th� mnemoni� name� an� th� �
disk/use� area� the�� ar� associate� with��  MKDIҠ i� a� �
editor��  I� provide� � scratc� are� i� whic� th� use� ca� �
se� u� � name� directory�� revie� it�� edi� it� an� mak� an� �
change� h� wishes��  Whe� satisfied�� th� use� ca� writ� i� �
ou� t� dis� a� � fil� o� abor� an� thro� i� away.


Options:
    None

Comments:
    See Text under "Using MKDIR"

Selected Error Messages:
    Self-Explanatory

Examples of Use:
    See Text under "Using MKDIR"

:U
                       Using MKDIR
                                                              Cmd Summary
    Onc� th� use� i� i� MKDIR� h� i� prompte� with:

         MKDIR Command (? for Help)?

an� h� ma� issu� th� followin� single-characte� command� �
(strikin� RETUR� i� no� necessary):

   C -- Change Directory (Add, Rename, or Delete Entries)
   I -- Initialize Directory
   P -- Print Directory
   R -- Read in a Directory File
   S -- Status of MKDIR Environment
   W -- Write out a Directory File
   X -- Exit
   ? -- Print Help Message

    N� file� ar� affecte� unti� th� use� tell� MKDIҠ t� �
writ� th� Director� Fil� o� disk.

                                                              Cmd: C
    Th� à comman� (Chang� Directory� i� use� t� edi� th� �
content� o� th� scratc� environmen� withi� MKDIR��  Onc� �
invoked� th� use� i� prompte� with

         Directory Entry (?<RETURN> for Help)?

    Th� use� i� i� a� inpu� lin� edito� now�� s� al� �
command� mus� b� terminate� b� strikin� th� RETURΠ ke� �
befor� the�� tak� effect��  Thi� i� th� BDOӠ inpu� lin� �
editor� an� strikin� ^� wil� abor� t� ZCPR3.

    Th� use� ma� typ� � followe� b� strikin� RETUR� t� fin� �
ou� wha� hi� option� ar� (built-i� help).

                                                              Cmd: C
    Unde� th� � comman� (Chang� Directory)�� th� use� ca� �
perfor� th� followin� functions:

   . Add a Named Directory Entry to the Directory
   . Rename a Named Directory Entry in the Directory
   . Delete a Named Directory Entry from the Directory
   . Print the Directory
   . Print a Help Message
   . Exit to MKDIR Command Level

    I� orde� t� ad� o� renam� � Name� Director� Entry�� th� �
use� type� th� "DU:dirname� form�  I� eithe� th� Dis� (D� o� �
Use� (U�� ar� omitted�� curren� dis� an� use� ar� assumed�  �
Th� "dirname�� i� th� mnemoni� nam� associate� wit� th� �
directory�� u� t� � character� long��  I� � nam� ha� bee� �
associate� wit� th� indicate� dis� an� use� already�� MKDI� �
wil� renam� i� t� th� ne� nam� an� tel� yo� tha� i� i� doin� �
s� an� wha� th� ol� nam� was��  I� � nam� ha� no� alread� �
bee� associate� wit� th� indicate� dis� an� user� MKDI� wil� �
ad� thi� entr� t� th� directory.
                                                              Cmd: C
    I� orde� t� delet� � Name� Director� Entry�� th� use� �
type� onl�� th� "DU:� form��  I� � nam� ha� alread�� bee� �
associate� wit� thi� dis� an� user� the� i� wil� b� deleted�  �
I� n� nam� ha� bee� associated�� th� use� wil� b� s� �
informed.

    T� prin� th� curren� director� fo� review�� th� use� �
nee� onl� strik� th� RETUR� key��  T� exit�� th� use� enter� �
a� � (uppe� o� lowe� case� followe� b� strikin� th� RETUR� �
key.

                                                              Passwords
    Whe� � director� i� created� MKDI� prompt� th� use� fo� �
� password��  �� passwor� ma�� b� u� t� �� alphanumeri� �
character� lon� (MKDI� capitalizae� al� alphabetics)�� an� �
differen� password� ma� b� associate� wit� eac� directory�  �
I� � passwor� i� lef� blank�� th� director�� i� freel� �
accessible.

    An�� referenc� t� � name� director� (DIR�� form� b� th� �
use� i� � ZCPR� comman� lin� wil� caus� ZCPR� t� promp� th� �
use� fo� � passwor� i� on� i� assigne� t� th� reference� �
directory��  Th� use� ha� on� chanc� t� ente� th� correc� �
password�� and�� i� incorrect�� ZCPR�� set� th� director� �
referenc� t� th� user'� currentl� logged-i� director�� an� �
proceeds with the rest of the command line.

                                                              Cmd: C
    Example:

         Assume the following directory:

              A15:ROOT       A10:SYS        A0:BASE
              B0:DEVBASE     B1:WORK1       B2:WORK2

         If the user wishes to delete WORK1, he types

              B1:

         If the user wishes to rename WORK2 to WORK12, he types

              B2:WORK12

         If the user wishes to add WORK3 as B3:, he types

              B3:WORK3

    I� al� cases�� lower-cas� character� ar� converte� t� �
upper-case.
                                                              Cmd: I
    Th� � comman� i� use� t� initializ� th� directory�  Th� �
use� i� aske� i� h� i� sur� h� want� t� d� this�� and�� i� �
Yes�� MKDI� clear� th� scratc� directory��  � emphasiz� tha� �
onl��� th� memory-base� scratc� director�� o� MKDIҠ� i� �
effected�� an� MKDIҠ affect� dis� file� onl� wit� th� � �
(Writ� Directory� command.
                                                              Cmd: P
    � i� use� t� Prin� th� Directory�  Asid� fro� th� name� �
assigne� s� far� th� use� i� tol� ho� man� entrie� hav� bee� �
define� s� fa� an� ho� man� ar� ye� t� b� defined.

                                                              Cmds: R,W
    Th� � Comman� i� use� t� rea� i� � Director� Fil� an� � �
i� use� t� writ� i� out��  Whe� MKDI� i� firs� invoked�� i� �
th� comman� i� simpl� "MKDIR"�� the� th� defaul� director� �
fil� i� define� t� b� NAMES.DIR��  I� th� comman� i� "MKDI� �
dir:filename.typ"��� the� th� defaul� director�� fil� i� �
define� t� b� th� indicate� fil� an� i� i� rea� i� �
immediatel� (subsequen� � comman� i� no� necessary)��  Whe� �
th� use� issue� th� � command� h� wil� b� prompte� with:

         Name of File (<RETURN> = filename.typ)?

I� h� strike� RETURN�� th� defaul� fil� i� read�  Otherwise� �
h� ca� typ� i� � fil� nam� o� hi� choice��  N� defaul� fil� �
typ� i� assumed�� s� th� fil� ma� b� an�� name��  Th� sam� �
promp� appear� t� th� � (Write� command��  I� bot� cases� i� �
th� use� wishe� t� ente� hi� ow� fil� name� i� ma� b� o� th� �
for� "dir:filename.typ� s� h� ca� rea� i� fro� o� plac� i� �
anywhere.
                                                              Cmd: W
    נ wil� writ� bac� t� th� curren� director� a� oppose� �
t� th� director�� th� fil� originall� cam� fro� i� th� �
defaul� for� i� accepted.
                                                              Cmd: S
    Finally�� th� � comman� (Status� tell� th� use� som� �
statu� informatio� o� MKDIR.

:2
              Memory-Based Named Directories

    Name� Directorie� ar� implemente� b� loadin� � *.ND� �
fil� create� b� MKDI� int� th� ZCPR� memor� buffe� reserve� �
t� contai� th� name� director� definition�  Onc� loaded� al� �
directory-to-D� association� i� th� fil� ar� mad� effective� �
and any ZCPR3 command can make use of them.

    On� o� th� man� purpose� o� LD� i� t� loa� � *.ND� fil� �
int� memory��  LD� recognize� th� ND� fil� typ� t� refe� t� �
name� director� files�� an� i� load� th� file� doin� � quic� �
forma� chec� t� ensur� tha� i� i� � vali� name� director� �
file.

:P

Command:  PWD 1.0

Syntax:

    PWD o

Function:

    PWĠ function� t� displa�� th� name� o� th� name� �
directorie� t� th� user��  I� th� � (Password�� optio� i� �
included�� the� th� password� t� th� directorie� wil� b� �
included in the display IF the Wheel Byte is set.

Options:

    P - Display Passwords


Comments:

    I� th� Whee� Byt� i� no� implemente� fo� � system� the� �
it� addres� i� 0� wher� th� JM� instructio� t� th� War� Boo� �
routin� i� th� BIO� i� located��  Sinc� JM� i� non-zer� i� �
value�� th� Whee� Byt� i� TRUE�� an� password� wil� b� �
displayed by PWD.

Selected Error Messages:

    "Passwor� Reques� Denie� - No� Wheel� mean� tha� th� � �
optio� wa� give� bu� th� Whee� Byt� wa� no� set�� s� �
passwords will not be displayed.

    "Name� Director� Buffe� No� Available� mean� tha� name� �
directories are not implemented.


Examples of Use:

    PWD
         -- display named directories

    PWD P or PWD PASSWORD (only leading P is significant)
         -- display named directories and passwords

:C

Command:  CD 3.0

Syntax:

    CD dir:
or
    CD du:

Function:

    CĠ� (Chang� Directory�� i� use� t� mov� fro� on� �
director� t� anothe� b� usin� th� name� o� litera� Dՠ form� �
associate� wit� th� directories��  C� firs� log� int� th� �
reference� directory�� and�� i� ther� i� � fil� name� ST.CO� �
i� it�� C� wil� lo� th� use� int� th� reference� director� �
an� invok� ST.COM��  I� ther� i� n� fil� name� ST.CO� i� th� �
directory� C� wil� simpl� lo� th� use� in.


Options:
    None

Comments:

    Unde� ZCPR3�� ther� ar� tw� basi� way� t� lo� int� � �
directory��  On� wa� i� b� usin� th� DU�� o� DIR�� prefix� �
like:

         B1:ASM>TEXT:
or
         B1:ASM>C7:

The other way is by using CD, like:

         B1:ASM>CD TEXT:
or
         B1:ASM>CD C7:


    Th� tradeof� i� i� use� efficiency��  I� � director� i� �
alway� use� fo� � particula� function�� suc� a� catalogin� �
disks�� C� ma� b� preferre� becaus� i� wil� no� onl� lo� th� �
use� i� bu� wil� als� ru� ST.COM�� whic� ca� se� u� hi� �
environment�� suc� a� b� runnin� MEN� o� som� othe� progra� �
o� grou� o� programs.

    ST.CO� i� a� Alias��  Th� onl� purpos� o� S� i� t� loa� �
th� Multipl� Comman� Lin� Buffe� wit� � comman� lin� whe� i� �
i� execute� withou� an� options��  Thi� comman� lin� ma� �
contai� � reasonabl� numbe� o� command� whic� perfor� an� �
desire� se� o� functions.


    I� th� ZCPR� environment� goo� candidat� command� t� b� �
execute� b� runnin� S� vi� C� includ� th� following:

         LDR file.NDR   <-- Set up a new directory environ
         PAT� path-ex�  <-- Se� u� � ne� Comman� Searc� Path
         MENU           <-- Invoke the MENU Preprocessor
         ECHO message   <-- Print a Message to the User

    Th� user'� environmen� ca� chang� drasticall� b�� usin� �
CĠ t� lo� int� � ne�� directory���  Th� name� o� th� �
directorie� h� ca� acces� ca� chang� (LDҠ change� th� �
Memory-Base� names)�� th� comman� searc� pat� h� use� ca� �
change�� an� h� ca� eve� fin� himsel� i� � MEN� environmen� �
o� othe� front-en� instea� o� � ZCPR� comman� environment.


Selected Error Messages:

    "Comman� Lin� Overflow� mean� tha� ther� wa� no� enoug� �
roo� i� th� comman� lin� t� inser� th� comman� t� invok� �
ST.COM.

Examples of Use:

    CD TEXT:
         -- log into directory TEXT