;
                               FILEATTR.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               4k (29)   0B94  1.2        Carson Wilson 88         Z3COM3

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


   FILEATTR displays or sets the  attributes of selected groups of files under
CP/M 2.2 or any of its replacements.   Groups of files  are specified by name,
drive, and (under ZCPR3) user number or directory.  If a ZCPR TCAP facility is
active, FILEATTR displays use dim or reverse video for enhanced clarity.

   While  no  installation is  necessary, FILEATTR's  command  options  may be
altered with ZCNFG.COM, the Z-System Configuration Utility.
:1

   Syntax:  FA /                     - help
            FA [dir:][afn] [/][o...] - display or set attributes
  Options:                                                Bit:
            1 - F1 on             N1 - F1 off             (f1)
            P - Public            NP - Private            (f2)
            D - Datestamp         ND - No Datestamp       (f3)
            4 - F4 on             N4 - F4 off             (f4)
            W - Wheel protect     NW - Wheel unprotect    (f8)
            R - Read/Only         NR - Read/Write         (t1)
            S - System            NS - Directory          (t2)
            A - Archive           NA - Modified           (t3)
            Q - Quiet

   FILEATTR displays  all  eight  attributes  of  a file  or  group  of  files
specified  by  an ambiguous or unambiguous filename.   A  CP/M drive  or  ZCPR
directory may also  be specified  on the command line.  Files are displayed in
unsorted  order (i.e.,  in  the  order  in  which  they  appear  on  a  disk's
directory tracks).  SYStem files are always included.
:2

FILEATTR Output:

   The  screen output  of  FILEATTR is  nearly identical in  both the  set and 
display file attribute modes.   An unsorted list  of matching files  is shown,
followed by  a summary line.   Each line describes the drive, user area, name,
and current attribute settings of one file.

   FILEATTR always shows attributes which are  set to  the  'on' (non-default)
state  in upper case.   Under ZCPR,  attributes set to the off (default) state
are shown in reverse or dim video, if available.

   FILEATTR's summary  line  gives total  files matched and total changes just
made.   'Files  matched'  is  the  number  of  files  displayed  by  FILEATTR.  
'Attributes  altered' is  the  number  of  file  attributes  just  changed  by 
FILEATTR.   This does  not necessarily  equal  the  number of  file attributes
specified in the command.  
:3

Error Messages:

   "Not Wheel"

      FILEATTR cannot be operated under ZCPR unless the Wheel byte is on.

   "Conflicting entry ... can't set Public attribute!"

      There are additional copies of  the file you are trying to set to Public
      at another user area on the same drive.  You must remove or rename these
      files before proceeding.

   "No files on disk"

      You are trying to display or set file attributes on an empty disk.


Error Messages: (cont'd)

   "BIOS write error near directory sector ...."

       A write error occurred at or near the indicated directory sector.   The
       number given is the offset in decimal sectors from the beginning of the
       directory tracks.

   "CP/M version 2.0 or higher required"

      FILEATTR  requires  an  operating  system which  is compatile  with CP/M
      version 2.0 or higher.

   "Bad option:  /x"

      You entered a command line option which FILEATTR does not recognize.


Error Messages (cont'd):

   "Drive R/O"

      The disk drive specified in your command  has been set  to READ ONLY  by
      the operating system.  Attributes cannot be set on read-only drives.

   "BIOS set track detected - FA aborting"

      FILEATTR had detected  a background program,  such as  a screen-trapping
      program, which is  attempting to change the current  BIOS track setting.
      The background program  must be  removed before using FILEATTR  to alter
      file attributes.
:4


Examples of Use:

   a. FILEATTR B:*.COM R

      - Sets all files ending in .COM on drive B: to Read/Only.

   b. FILEATTR MY.TXT NP,A,W  (or FILEATTR MY.TXT NPAW)

      - Sets the file  MY.TXT in the  current directory to  Private,  Archive,
        and Wheel Protect.  All other attributes are unaffected.
