home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / z3help37.lbr / DA.HZP / DA.HLP
Encoding:
Text File  |  1993-06-07  |  8.3 KB  |  203 lines
  1. ;
  2.                                      DA.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                3k (19)   FDF1  3.0        Gene Pizzetta 9/89       Z3COM5
  6.  
  7.   1- Syntax/Options  2- Attributes  3- Limitations  4- Notes  5- Examples     
  8.  
  9.  
  10.    DA is a  utility for manipulating and displaying file directory attributes.
  11. Displays in lower-case, alphabetized, and paged.  Runs only under ZCPR3.
  12.  
  13.    Based on Eric Meyer's DA 2.2.
  14. :1
  15.  Syntax   DA {dir:}{<{afn}.aft>} {{/}{<options>}<attributes>}
  16.  
  17.  
  18.    If no DIR or DU specification is given,  the current drive/user is assumed.
  19. If a filetype is given without a filename,  then the filename is automatically
  20. wildcarded.   If no filename or  filetype is  given,  DA defaults to all files
  21. (*.*).
  22.  Options - 1/2 
  23.  
  24.    If no drive/user or filename is given,  the  option/attribute  list must be
  25. preceded by a slash (/).   Otherwise, the slash is optional.   If no option is
  26. given,  DA  defaults  to  displaying  files  with  the attributes given in the
  27. attribute list.  The options are:
  28.  
  29.      ~    Display files that do not have the specified
  30.           attributes.
  31.  
  32.      +    Set specified attributes on the specified files or on
  33.           all files.
  34.  
  35.      -    Clear (reset) specified attributes on the specified
  36.           files or on all files.
  37.  
  38.      Q    Toggle observance of ZCPR3 Quiet flag.  Normally, DA
  39.           observes the Quiet flag (no display when it is set).
  40.           This option reverses that observance (display when flag
  41.           is set; no display when it is reset).
  42.  Options - 2/2 
  43.  
  44.    Only one option can be used and it must precede the attribute list.   The Q
  45. option,  however,  can  be  used  with  or  without  other options, and can be
  46. anywhere in the  option/attribute list.   Two Q's in the list will effectively
  47. negate each other.
  48. :2
  49.  Attributes - 1/2 
  50.  
  51. The following are legal in the attribute list.
  52.  
  53.      R     READ ONLY (t1) -- file cannot be erased or modified.
  54.  
  55.      S     SYSTEM (t2) -- "hidden" file that does not appear in
  56.            ordinary directory displays.
  57.  
  58.      A     ARCHIVE (t3) -- file has not been changed since last
  59.            backed up.  (Only CP/M 3.0, and 2.2 BDOS replacements
  60.            like ZRDOS and ZSDOS, fully support this attribute.)
  61.  
  62.      1     USER 1 (f1) -- user defined attribute.
  63.  
  64.    P or 2  PUBLIC (f2) -- file is public file under Plu*Perfect
  65.            definition for such files.
  66.  
  67.    D or 3  DATESTAMP (f3) -- under DateStamper, no date stamping.
  68.            Under DateStamper with ZSDOS, no access date stamping.
  69.  Attributes - 2/2 
  70.  
  71.      4     USER 4 (f4) -- user defined attribute.
  72.  
  73.    W or 8  WHEEL (f8) -- file cannot be used or program run
  74.            unless the Wheel byte is set, under ZRDOS and ZSDOS.
  75.  
  76.    You may include as many attributes as you want in the attribute list.  Well
  77. . . . actually, you can't have more  than 11  elements in the option/attribute
  78. list, or the rest will be ignored.   That's room for all  eight  user-settable
  79. attributes, plus one attribute option and a couple of Q options.
  80. :3
  81.  Limitations 
  82.  
  83.    DA will not search for an ambiguous filename beginning with a slash, unless
  84. a DIR or DU specification, or even just a colon,  precedes the slash.   Other-
  85. wise, DA will think it has an option list and it will default to all files.
  86.  
  87.    DA can cope with a maximum of 255 matching files.   This should be adequate
  88. for most people,  but if you  need  to  change  or display the attributes of a
  89. larger number of files,  you  will  have  to  do  it  in  smaller groups using
  90. ambiguous file masks.   I  hope  to  eliminate  this  limitation with the next
  91. version.
  92. :4
  93.  DA Notes - 1/2 
  94.  
  95.    a. I was dissatisfied with all the  file  attribute  utilities  I had used.
  96.       SFA, which comes with ZRDOS,  sets attributes, but doesn't display them.
  97.       A separate program,  DFA,  is  required  for  that.   In  addition,  SFA
  98.       requires typing three or four characters for each  attribute you want to
  99.       set or reset.   FA, which comes with ZSDOS,  works well and quickly, but
  100.       its display stretches 80 columns for each file,  so you can only display
  101.       around 25 files at a time.  In addition,  the display doesn't page auto-
  102.       matically and the filenames are not displayed in alphabetical order,  so
  103.       finding what you want can be chore.   SETATT  resets  all attribbutes on
  104.       files, unless they are in the option list to be set, a real drawback.
  105.       
  106.       My favorite such utility was  DA 2.2 by Eric Meyer,  but it defaulted to
  107.       file directory mode, so I decided to make it  default to displaying file
  108.       attributes.   What  started so  simple,  turned  into a major project to
  109.       convert DA to a  ZCPR3  utility,  and to make the display similar to the
  110.       ZCPR3 version of D.COM, which I recently released.   As a result,  about
  111.       half the code in this version is new or heavily modified,  and little of
  112.       the code is untouched.   It now  satisfies all  the  objections I had to
  113.       other attribute programs, so I hope others will find it useful.
  114.  Notes - 2/2 
  115.  
  116.    b. Vs 3.0 updates (9/8/89, Gene Pizzetta):
  117.       - Rewritten as ZCPR3 utility, uses TCAP.  
  118.       - Now supports user areas through 31.  
  119.       - Initial disk reset eliminated.  
  120.       - Now is a file  attribute  utility,  setting  them,  resetting them, or
  121.         displaying them; no ordinary disk directory services remain.
  122.       - New parser changed option delimiter to '/', but made it unnecessary if
  123.         a filename or du is supplied.  
  124.       - Will now  accept  a filetype (".TYP") without a filename; the filename
  125.         will be automatically wildcarded.  
  126.       - Now accepts named directory specifications.  
  127.       - Now checks Quiet flag,  but Q  option makes DA operate opposite of the
  128.         Quiet flag setting.
  129.       - Now supports F8 (Wheel) attribute.  
  130.       - No user patches,  but  RevVid  equate  in  source code  allows special
  131.         version for terminals using reverse video highlighting.
  132. :5
  133.  Examples of Use - 1/4 
  134.  
  135.    a. da //  
  136.    
  137.       ->  displays brief usage information (as with most ZCPR3 utilities)
  138.  
  139.    b. C0>da
  140.    
  141.       ->  displays filenames and attributes of all files on current disk
  142.  
  143.       =====================================================================
  144.       !!!time&dat --D-- RS- | da      com ----- -S- | slrmac  com ----W RSA
  145.       d       com ----- -SA | da30    mac ----- ---
  146.       =====================================================================
  147.       5 Matching files found on C0:ASM
  148.  
  149.    c. A0>da d1:
  150.      
  151.       -> displays attributes of all files on drive D, user 1
  152.  Examples of Use - 2/4 
  153.  
  154.    d. A0>da d1: sa   
  155.    
  156.       -> displays only system files that have been backed up
  157.  
  158.    e. A0>da /sa
  159.    
  160.       -> same display as above, but for current drive/user
  161.  
  162.    f. A0>da asm:.mac a
  163.    
  164.       -> displays all MAC files on C0:ASM that have been backed up.  Note that
  165.          only ".MAC" was entered on the  command  line,  but DA expanded it to
  166.          "*.MAC".
  167.  
  168.    g. A0>da asm:.mac /~a
  169.    
  170.       -> displays all MAC files that have not been backed up
  171.  Examples of Use - 3/4 
  172.       
  173.    h. A0>da .com +r
  174.    
  175.       -> makes all COM files on drive A, user 0, read-only
  176.    
  177.    i. A0>da /-s
  178.    
  179.       -> makes all files non-system on the same drive/user
  180.  
  181.    j. A0>da turbo*.* +1pd4w
  182.  
  183.       -> sets the user 1 and 4 attributes,  along with the Public,  Datestamp,
  184.          and Wheel attributes on matching files.
  185.  
  186.    k. A0>da turbo*.* +12348
  187.  
  188.       -> same as above with all numbers
  189.  Examples of Use - 4/4 
  190.  
  191.    l. A0>da /-a
  192.  
  193.       -> resets all  archive  attributes on  the  current  drive/user,  so you
  194.          can begin a total backup.
  195.  
  196.    m. A0>da *.doc +rqa
  197.    
  198.       -> If the ZCPR3  Quiet  flag is  off,  sets  the  read-only  and archive
  199.          attributes on all DOC  files,  but  there  will  be no screen display
  200.          at all.   If the  Quiet flag is set (on),  then the same command will
  201.          cause the files and  attributes to be displayed,  just as if you used
  202.          no Q option while the Quiet flag is off.
  203.