;
                                   PATH.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
PATH.COM       2k (12)   08CE  3.2        Bruce Morgen 6/91        Z3COM7
PATH.4OM       2k (15)   6BC4  3.2        Bruce Morgen 6/91        Z3COM7

  1- Syntax  2- Usage  3- Notes  4 - Error Messages  5- Examples of Use       


   PATH  allows the user to display the current path or set a new  path.   The 
display shows the path in three formats:   Symbolic,  Absolute (DU), and Named 
Directory  (DIR).   The  path expression may intermix any of these formats  as 
desired to express the new path.   For example,  if a user is logged into B0:, 
the path "$0 A$ A0 ROOT" represents the sequence B0 to A1 to A0 to  ROOT.   Vs 
3.0 (4/84) by R. Conn.
:1
    Syntax   PATH             <-- Display Path
  
             PATH expr [[/]Q] <-- Set Path

   "Q" forces quiet operation
:2
 Usage 

   The PATH command is used to dynamically change a  memory-based  file search
path or the ZCPR3 command search path.   With PATH, the  user can define a new
path to be followed or he can view what the current path is.

   PATH determines the address of the path it is going to  work  with from the
ZCPR3 Environment Descriptor.

   The PATH command deals with  path  expressions.   A  path  expression  is a
sequence of directory names  which can be  expressed as  "ambiguous" DU forms,
absolute DU forms, or Named Directory forms.

   An absolute DU form indicates just a disk letter (current user is assumed),
just a user number (current disk is assumed), or both a disk letter and a user
number.  An "ambiguous" DU form is one in which the disk letter or user number
or both is replaced  with a  "$" character, meaning "current disk" or "current
user".  A Named Directory form, of course, is simply the name of a directory.

   To illustrate, let's say that the user is logged into B1.   The path "$0 A$ 
A0 ROOT" represents the sequence "B0 to A1 to A0 to ROOT".
:3
 Notes 

   a. Version 3.2 updates (6/7/91, Bruce Morgen):
      - Z80 opcodes, quiet option, Z3 test, two internal routines cut in favor
        of SYSLIB equivalents, etc.

   b. Version 3.1 updates (3/12/85, Joe Wright):
      - Now responds to the quiet flag.
      - Now limits the  declared  path to the length specified in the environ-
        ment. 
:4
 Error Messages 

"Bad Expression at <text>"    <-- there was an error in the path expression 
:5
 Examples of Use 

   PATH $0 A$ A15        <-- set path from current disk/user 0 to disk
                             A/current user to disk A/user 15

   PATH A$ ROOT          <-- set path from disk A/current user to ROOT:

