; 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 (? 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 ( = 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