home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / f.lbr / FILEATTR.HZP / FILEATTR.HLP
Encoding:
Text File  |  1991-11-18  |  4.6 KB  |  118 lines
  1. ;
  2.                                FILEATTR.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (29)   0B94  1.2        Carson Wilson 88         Z3COM3
  6.  
  7.   1- Syntax/Options  2- Output  3- Error Messages  4- Examples of Use         
  8.  
  9.  
  10.    FILEATTR displays or sets the  attributes of selected groups of files under
  11. CP/M 2.2 or any of its replacements.   Groups of files  are specified by name,
  12. drive, and (under ZCPR3) user number or directory.  If a ZCPR TCAP facility is
  13. active, FILEATTR displays use dim or reverse video for enhanced clarity.
  14.  
  15.    While  no  installation is  necessary, FILEATTR's  command  options  may be
  16. altered with ZCNFG.COM, the Z-System Configuration Utility.
  17. :1
  18.  
  19.    Syntax:  FA /                     - help
  20.             FA [dir:][afn] [/][o...] - display or set attributes
  21.   Options:                                                Bit:
  22.             1 - F1 on             N1 - F1 off             (f1)
  23.             P - Public            NP - Private            (f2)
  24.             D - Datestamp         ND - No Datestamp       (f3)
  25.             4 - F4 on             N4 - F4 off             (f4)
  26.             W - Wheel protect     NW - Wheel unprotect    (f8)
  27.             R - Read/Only         NR - Read/Write         (t1)
  28.             S - System            NS - Directory          (t2)
  29.             A - Archive           NA - Modified           (t3)
  30.             Q - Quiet
  31.  
  32.    FILEATTR displays  all  eight  attributes  of  a file  or  group  of  files
  33. specified  by  an ambiguous or unambiguous filename.   A  CP/M drive  or  ZCPR
  34. directory may also  be specified  on the command line.  Files are displayed in
  35. unsorted  order (i.e.,  in  the  order  in  which  they  appear  on  a  disk's
  36. directory tracks).  SYStem files are always included.
  37. :2
  38.  
  39. FILEATTR Output:
  40.  
  41.    The  screen output  of  FILEATTR is  nearly identical in  both the  set and 
  42. display file attribute modes.   An unsorted list  of matching files  is shown,
  43. followed by  a summary line.   Each line describes the drive, user area, name,
  44. and current attribute settings of one file.
  45.  
  46.    FILEATTR always shows attributes which are  set to  the  'on' (non-default)
  47. state  in upper case.   Under ZCPR,  attributes set to the off (default) state
  48. are shown in reverse or dim video, if available.
  49.  
  50.    FILEATTR's summary  line  gives total  files matched and total changes just
  51. made.   'Files  matched'  is  the  number  of  files  displayed  by  FILEATTR.  
  52. 'Attributes  altered' is  the  number  of  file  attributes  just  changed  by 
  53. FILEATTR.   This does  not necessarily  equal  the  number of  file attributes
  54. specified in the command.  
  55. :3
  56.  
  57. Error Messages:
  58.  
  59.    "Not Wheel"
  60.  
  61.       FILEATTR cannot be operated under ZCPR unless the Wheel byte is on.
  62.  
  63.    "Conflicting entry ... can't set Public attribute!"
  64.  
  65.       There are additional copies of  the file you are trying to set to Public
  66.       at another user area on the same drive.  You must remove or rename these
  67.       files before proceeding.
  68.  
  69.    "No files on disk"
  70.  
  71.       You are trying to display or set file attributes on an empty disk.
  72.  
  73.  
  74. Error Messages: (cont'd)
  75.  
  76.    "BIOS write error near directory sector ...."
  77.  
  78.        A write error occurred at or near the indicated directory sector.   The
  79.        number given is the offset in decimal sectors from the beginning of the
  80.        directory tracks.
  81.  
  82.    "CP/M version 2.0 or higher required"
  83.  
  84.       FILEATTR  requires  an  operating  system which  is compatile  with CP/M
  85.       version 2.0 or higher.
  86.  
  87.    "Bad option:  /x"
  88.  
  89.       You entered a command line option which FILEATTR does not recognize.
  90.  
  91.  
  92. Error Messages (cont'd):
  93.  
  94.    "Drive R/O"
  95.  
  96.       The disk drive specified in your command  has been set  to READ ONLY  by
  97.       the operating system.  Attributes cannot be set on read-only drives.
  98.  
  99.    "BIOS set track detected - FA aborting"
  100.  
  101.       FILEATTR had detected  a background program,  such as  a screen-trapping
  102.       program, which is  attempting to change the current  BIOS track setting.
  103.       The background program  must be  removed before using FILEATTR  to alter
  104.       file attributes.
  105. :4
  106.  
  107.  
  108. Examples of Use:
  109.  
  110.    a. FILEATTR B:*.COM R
  111.  
  112.       - Sets all files ending in .COM on drive B: to Read/Only.
  113.  
  114.    b. FILEATTR MY.TXT NP,A,W  (or FILEATTR MY.TXT NPAW)
  115.  
  116.       - Sets the file  MY.TXT in the  current directory to  Private,  Archive,
  117.         and Wheel Protect.  All other attributes are unaffected.
  118.