;
                                    PWD.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
PWD.3OM        4k (25)   A760  2.1        Bruce Morgen 11/91       Z3COM16
PWD.4OM        4k (30)   CEB4  2.1        Bruce Morgen 11/91       Z3COM16
PWD.COM        4k (25)   813E  2.1        Bruce Morgen 11/91       Z3COM16

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

   PWD displays the names of DU and Directory names with paging.   If  the  /P 
option is included, then the passwords to the directories  will be included in
the display (but only if the  wheel byte is  set).   Display may be limited to
specified drives and/or to automatically wildcarded name specifications.

   If the  Wheel Byte  is not implemented for a system, then its address is 0,
where the JMP instruction to  the  Warm  Boot routine  in the BIOS is located.
Since JMP is non-zero in value, the Wheel Byte is TRUE,  and passwords will be
displayed by PWD.  Vs. 1.0 (3/84) by R. Conn. 
:1

  Syntax   PWD [<arg>...]  (delimiters are Space/Tab/Comma)

         <arg>  Auto-wildcarded names to display
         <arg>: Display names for drives listed in <arg> ONLY
        ~<arg>: Exclude names for drives listed in <arg>
        /<arg>  Honor an option or display help and quit.
                
 Examples 

        <arg>           Displays:

        (none)          All Directory Names
        CA              All Dir names starting with "CA"
        D:CA            Dir names "CA??????" for drive D: only
        B-F:            Dir names for drives B,C,D,E, and F
        BCML:           Dir names for drives B,C,M, and L
        ~M:             Dir names for all EXCEPT drive M:
        /P              Directory Names & Passwords (WHEEL only)
:2
 PWD Notes - 1/5 

   a. Vs 2.1 updates (11/12/91, Bruce Morgen):
      - Maintenance  update  introducing  Type 4  executable.   Type 4 is well
        under 4K, others slightly smaller than v2.0; no functional changes.
      - Uses ZSLIB highlighting in lieu of much bulkier VLIB equivalents.
      - Adds display of Type number and execution address to banner.  

   b. Vs 2.0 updates (9/30/89, Al Hawley):
      - Complete revision replaces dependance on BYE3 with reference to the Z3
        Environment Descriptor  (including the  extended env  introduced  with 
        V4LIBS) and to configurable program  defaults.   The  source  code for 
        PWD2 is written  with  a Type 3 Header,  which means that its load and 
        execution address is whatever the program is linked for.  If linked to 
        load at 100H, then it will be executable in  a CP/M or ZCPR3.0 system. 
        If linked for loading/execution at a higher address,  the program will 
        abort gracefully with an error message if the current operating system 
        does not support Type 3 file  execution.   The  Type 3  provisions are 
        unchanged from V 1.4.
 PWD Notes - 2/5 

      - The display is Paged, with  page  length from the Environment.   Added
        Cntl-C user abort at end of each line and at screen pause.
      - The width of the display also  changes according to the  console width
        parameter in the Z3 Environment.
      - ALL elements of the NDR are displayable for a WHEEL,  but command line
        options may be used to limit the entries displayed.
      - Display of DU: is controlled by the  DUOK flag (Z3 environment) if  so
        configured with ZCNFG.  
      - When the wheel byte is reset (no privileges),  the  following options/
        restrictions become active:
        1) Hiding of passworded directories from non  wheels is supported as a
           configurable option.
        2) Passwords are NEVER displayed to non-wheel users.  (no  change from 
           v1.4)
        3) An internal drive vector is  maintained  which inhibits display for
           drives greater than the MAXDRIVE parameter in the environment.   If
           an extended environment is present,  then  the  drive  vector  from 
           there inhibits  display  for  drives  marked not available, even if 
           they are less than the maximum  drive allowed.   The internal drive 
 PWD Notes - 3/5 

           vector is configurable  with  ZCNFG.   An  internal  MAXDRIVE is no 
           longer needed; its function is  filled by the  drive vector and the 
           values from the environment.
        4) Display is inhibited for  directories  whose user number is greater
           than MAXUSER from the environment.
      -  A configuration overlay for use with ZCNFG is provided.
      -  A new command syntax allows limiting the display to  Dir Names  which
         satisfy  an  auto-wildcard  argument  and/or  satisfy  a  drive  spec
         expression.  For example,  "PWD C"  displays  only  dirnames starting
         with 'C'.   Drive specs may comprise a list of  drives,  like 'ABMDH'
         (order unimportant).   Only the names for the  drives  listed will be
         displayed.   One or more of the list members  can be a range express-
         ion, like C-G.   Another way to limit the display is to  EXCLUDE  the
         drives listed (including a range) by preceding  the list with a nega-
         tion operator,  a ~ (tilde).   The range and negation  operators  are
         configurable.   Back to basics:  PWD (no argument) does the same dis-
         play as before,  within the  constraints  configured.  The  syntax to
         display passwords has been changed to  '/P',  in  line  with  other Z
         utilities which support options.
 PWD Notes - 4/5 

   c. Vs. 1.4 updates (4/3/88, Bruce Morgen):
      - Type 3 format with safety header 
      - smart help screen
      - RAS-oriented  options  (patch  102H  to  80H  for  BYE  detection  and 
        obedience, 01H for hiding passworded directories from non-wheels,  81H 
        for both, or 00H for neither).

   d. Vs 1.3 updates (11/21/86, Dave McCord):
      - Translated source to permit assembly with ZAS.  No other changes.

   e. Vs 1.2 updates (06/03/85, Bruce Morgen):
      - Consolidated Jay's and Dave's separate PWD11s into a  `universal'  PWD
        for remote use.   Both mods work very well, Jay's  - controlled by the
        `hidepw' equate -  allows the sysop or  privileged user see  all pass-
        worded named directories and their passwords but keeps  non-wheels  in
        the dark, while Dave's - controlled by the  `chkbye'  equate - follows
        what BYE dictates and provides a more  `absolute'  kind  of protection
        since no directory beyond what  BYE  allows shows up regardless of the
        state of the wheel byte.   The  routines  seem  to  co-exist  with  no
        conflict and may be chosen  separately or  together.   
 PWD Notes - 5/5 

   f. Vs 1.1 updates (02/13/85-Jay Sage, 10/30/84-Bruce Morgen):
      - Modified to suppress display of  directories that  are passworded when
        the user is not a wheel. 
      - Added findbye routine and other code so that when used in rcp/m appli-
        cation, users will only be shown  directories that they have access to
        under BYE.
:3
 Error Messages   

   "Password Request Denied - Not Wheel"  

      - P option given but wheel byte not set, so passwords will not be
        displayed


   "Named Directory Buffer Not Available" 

      - Named Directories not implemented
:4
 Examples of Use 

   a.  PWD //           <--  displays internal help screen

   b.  PWD HBJMF:       <--  displays DU/DIRs for drives H, B, J, M, F

   c.  PWD B-FM:        <--  displays DU/DIRs for drives B through F, and M 

   d.  PWD ~bc:         <--  displays DU/DIRs for all drives except B and C

   e.  PWD A-P: ~lmno:  <--  displays DU/DIRs for all drives except L, M, N, O
