;
  (ZSDOS only)                    ZPATH.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               2k (16)   7AEB  1.0                                 Z3COM13

  1- Syntax/Options  2- Error Messages  3- Examples of Use                    



   ZPATH (for ZSDOS only) permits setting the Internal DOS path  as well  as a
ZCPR3 path.  It is a modification of ZCPR tool PATH.COM. 

   Since the purpose of ZPATH is  to dynamically  alter system parameters,  no
interactive  mode  is provided.   Search path parameters  are  passed  on  the 
command line, and may be embedded in a STARTUP alias, or SUBMIT file.
:1


   Syntax:  ZPATH [/[Q][o=]] expr [/[Q][o=expr]]

  Options:  C    <--  set the ZCPR3 Search Path
            D    <--  set the ZSDOS Internal Search Path
            Q    <--  Operate in a "Quiet" mode.  Do not print Path values
                      after setting them.

   Path elements (expr) are  defined as  a Drive letter,  A User Number,  both 
Drive Letter and User Number,  or a special character ($) which may be used in
place of either the drive, user, or both, signifying that the currently-logged
parameter should be used. 
:2

Error Messages:

   "Bad Expression at xx"

      A character, sequence of characters, or Command Parameter was in error.
      The character(s) causing the error will be shown as xx.

   "- None -"

      This message will be displayed for either the ZCPR3 or DOS path when no
      path is defined.

   "- Disabled -"

      The ZSDOS Internal Path has been disabled.


Error Messages (cont'd):

   "- Nil -"

      The path is defined, but has no elements defined (Zero length).

   "- No Wheel"

      An attempt was made to set a path without "Wheel" privileges.

   "- No ZCPR3 Path"

      An attempt was made to set the ZCPR3 path when it does not exist.

   "- No DOS Path"

      An attempt was made to set the ZSDOS path when it was disabled.
:3


Examples of Use:
 
   a. ZPATH                             <-- Display Path(s)

   b. ZPATH expr -or- ZPATH /C=expr     <-- Set ZCPR Path
   
   c. ZPATH /Q expr -or- ZPATH /QC=expr <-- ..do it Quietly
   
   d. ZPATH /D=expr                     <-- Set ZSDOS Path

   e. ZPATH /D=                         <-- Disable ZSDOS Path

   f. ZPATH expr,/D=expr                <-- Set Both Paths
   