;
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