home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / ZSUS / Z3HELP-3.LBR / P.LBR / PWD.HZP / PWD.HLP
Text File  |  2000-06-30  |  6KB  |  126 lines
  1. ;
  2.                                     PWD.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (26)   EFE2  2.0        Al Hawley 10/89          Z3COM9
  6.  
  7.   1- Syntax/Options  2- Notes  3- Error Messages  4- Examples of Use          
  8.  
  9.    PWD displays the names of DU and Directory names with paging.   If  the  /P 
  10. option is included, then the passwords to the directories  will be included in
  11. the display (but only if the  wheel byte is  set).   Display may be limited to
  12. specified drives and/or to automatically wildcarded name specifications.
  13.  
  14.    If the  Wheel Byte  is not implemented for a system, then its address is 0,
  15. where the JMP instruction to  the  Warm  Boot routine  in the BIOS is located.
  16. Since JMP is non-zero in value, the Wheel Byte is TRUE,  and passwords will be
  17. displayed by PWD.
  18.  
  19.    Vs. 1.0 (3/84) by R. Conn. 
  20. :1
  21.  
  22.   Syntax   PWD [<arg>...]  (delimiters are Space/Tab/Comma)
  23.  
  24.          <arg>  Auto-wildcarded names to display
  25.          <arg>: Display names for drives listed in <arg> ONLY
  26.         ~<arg>: Exclude names for drives listed in <arg>
  27.         /<arg>  Honor an option or display help and quit.
  28.                 
  29.  Examples 
  30.  
  31.         <arg>           Displays:
  32.  
  33.         (none)          All Directory Names
  34.         CA              All Dir names starting with "CA"
  35.         D:CA            Dir names "CA??????" for drive D: only
  36.         B-F:            Dir names for drives B,C,D,E, and F
  37.         BCML:           Dir names for drives B,C,M, and L
  38.         ~M:             Dir names for all EXCEPT drive M:
  39.         /P              Directory Names & Passwords (WHEEL only)
  40. :2
  41.  PWD Notes - 1/3 
  42.  
  43.    a. Vs 2.0 updates:
  44.       - Complete revision replaces dependance on BYE3 with reference to the Z3
  45.         Environment Descriptor  (including the  extended env  introduced  with 
  46.         V4LIBS) and to configurable program  defaults.   The  source  code for 
  47.         PWD2 is written  with  a Type 3 Header,  which means that its load and 
  48.         execution address is whatever the program is linked for.  If linked to 
  49.         load at 100H, then it will be executable in  a CP/M or ZCPR3.0 system. 
  50.         If linked for loading/execution at a higher address,  the program will 
  51.         abort gracefully with an error message if the current operating system 
  52.         does not support Type 3 file  execution.   The  Type 3  provisions are 
  53.         unchanged from V 1.4.
  54.       - The display is Paged, with  page  length from the Environment.   Added
  55.         Cntl-C user abort at end of each line and at screen pause.
  56.       - The width of the display also  changes according to the  console width
  57.         parameter in the Z3 Environment.
  58.       - ALL elements of the NDR are displayable for a WHEEL,  but command line
  59.         options may be used to limit the entries displayed.
  60.       - Display of DU: is controlled by the  DUOK flag (Z3 environment) if  so
  61.         configured with ZCNFG.  
  62.  PWD Notes - 2/3
  63.  
  64.       - When the wheel byte is reset (no privileges),  the  following options/
  65.         restrictions become active:
  66.         1) Hiding of passworded directories from non  wheels is supported as a
  67.            configurable option.
  68.         2) Passwords are NEVER displayed to non-wheel users.  (no  change from 
  69.            v1.4)
  70.         3) An internal drive vector is  maintained  which inhibits display for
  71.            drives greater than the MAXDRIVE parameter in the environment.   If
  72.            an extended environment is present,  then  the  drive  vector  from 
  73.            there inhibits  display  for  drives  marked not available, even if 
  74.            they are less than the maximum  drive allowed.   The internal drive 
  75.            vector is configurable  with  ZCNFG.   An  internal  MAXDRIVE is no 
  76.            longer needed; its function is  filled by the  drive vector and the 
  77.            values from the environment.
  78.         4) Display is inhibited for  directories  whose user number is greater
  79.            than MAXUSER from the environment.
  80.       -  A configuration overlay for use with ZCNFG is provided.
  81.  PWD Notes - 3/3 
  82.  
  83.         6) A new command syntax allows limiting the display to Dir Names which
  84.            satisfy an  auto-wildcard  argument  and/or satisfy  a  drive  spec 
  85.            expression.   For example,  "PWD C" displays only dirnames starting 
  86.            with 'C'.   Drive specs may comprise a list of drives, like 'ABMDH' 
  87.            (order unimportant).   Only the names for the drives listed will be 
  88.            displayed.  One  or  more  of  the  list  members  can  be  a range 
  89.            expression,  like C-G.   Another way  to limit  the  display  is to 
  90.            EXCLUDE the drives listed (including a range) by preceding the list
  91.            with a negation operator,  a ~ (tilde).   The  range  and  negation 
  92.            operators are configurable.  Back to basics: PWD (no argument) does
  93.            the same display as before, within the constraints configured.  The
  94.            syntax to display passwords has been changed to '/P',  in line with 
  95.            other Z utilities which support options.
  96.  
  97.    b. Vs. 1.4 updates:
  98.       - Type 3 format with safety header 
  99.       - smart help screen
  100.       - RAS-oriented  options  (patch  102H  to  80H  for  BYE  detection  and 
  101.         obedience, 01H for hiding passworded directories from non-wheels,  81H 
  102.         for both, or 00H for neither).
  103. :3
  104.  Error Messages   
  105.  
  106.    "Password Request Denied - Not Wheel"  
  107.  
  108.       - P option given but wheel byte not set, so passwords will not be
  109.         displayed
  110.  
  111.  
  112.    "Named Directory Buffer Not Available" 
  113.  
  114.       - Named Directories not implemented
  115. :4
  116.  Examples of Use 
  117.  
  118.    a.  PWD //           <--  displays internal help screen
  119.  
  120.    b.  PWD HBJMF:       <--  displays DU/DIRs for drives H, B, J, M, F
  121.  
  122.    c.  PWD B-FM:        <--  displays DU/DIRs for drives B through F, and M 
  123.  
  124.    d.  PWD ~bc:         <--  displays DU/DIRs for all drives except B and C
  125.  
  126.    e.  PWD A-P: ~lmno:  <--  displays DU/DIRs for all drives except L, M, N, O