;
                               FILEDATE.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
FD.COM         5k (34)   7C71  2.2        Carson Wilson 9/89       Z3COM3
FD+.COM        5k (35)   286F  2.2        Carson Wilson 9/8        Z3COM3

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

   FILEDATE is a disk directory display program for computers with DateStamper
or equivalent file time and date stamping capabilities.  FILEDATE displays the
dates and times files were created, last accessed,  and last modified.   Using 
an  extended command line syntax,  FILEDATE can select and sort its display by
file time and date stamp as well as by file name.  

   FILEDATE is  a command-line  driven  utility,  rather  than  an interactive
program.  It processes  a single command from the user and returns immediately
to the operating system.  While no installation is necessary,  default options
may be customized by use of ZCNFG.COM, the Z-System Configuration utility.
:1


   Syntax   FILEDATE [dir:][afn] [/][options][<, =, or >dd.mm.yy time]
  
  Options   /       - help
           +,-      - sort by date
            A       - use Access
            C       - use Create
            D       - all Dates
            N       - No pause
            S       - System files
            U       - all Users

     Time   hh:mm   - real
            +dddd   - relative
:2
 FILEDATE Notes - 1/2 

   a. Display Output

         In default mode (no options selected),  FILEDATE displays the current
      date and time and an alphabetized listing of all files at the current du
      area, along with the dates and times when  the files were created,  last
      accessed and last  modified,  individual and total file sizes, and space
      remaining on the selected drive.  File attributes are shown in alternate
      video (if available) under ZCPR3.   If a file attribute falls on a space
      character, the character is shown as an underline character in alternate
      video under ZCPR3.

         Normally,  FILEDATE only displays date information if it differs from
      the current values,  and fields matching the  current date are displayed
      as "...".  This unclutters the  display and allows experienced  users to
      quickly distinguish  between today/previous  days,  this  month/previous
      months,  and this  year/previous  years  (the D  option  overrides  this
      feature).
 FILEDATE Notes - 2/2 

   b. Vs 2.2 fixes operation of wildcards in  date  fields.   FD22+.COM is the
      CP/M plus version and does not operate under ZSDOS!
:3
 Error Messages - 1/3 

   "Bad Option: /x"

      FILEDATE detected  an invalid option character after the slash.   Either
      the option  does not exist,  or  a non-wheel user tried  to use a wheel-
      protected option, such as S or U.

   "!!!TIME&.DAT file missing"

      FILEDATE cannot find the special file containing file datestamp informa-
      tion at user area 0 of your disk.
 Error Messages - 2/3 

   "bad system"

      FILEDATE requires  a CP/M 2.2  or equivalent operating system  and Date-
      Stamper support.  

   "TPA overflow"

      FILEDATE ran out of space while reading in file names.  Select a smaller
      set of files  to display  and/or remove  any RAM-resident utilties which
      may be taking up Transient Program Area (TPA).

 Error Messages - 3/3 

   "!!!TIME&.DAT file error, offset nn"

      As it  reads datestamps from  the !!!TIME&.DAT file,  FILEDATE tests the
      file for checksum errors.   This report indicates that a  sector of  the
      file has become corrupted,  preventing further datestamping.  The offset
      given is the decimal record number of the first corrupt sector (starting
      with 0) found.

      !!!TIME&.DAT checksum errors should not occur during normal use of ZSDOS
      and  generally indicate  a serious hardware or software problem.   After
      finding the source of the problem, you may restore the !!!TIME&.DAT file
      for further use either by zeroing out the affected sector(s) with a disk
      utility, or by reinitializing your disk with PUTDS. 
:4
 Examples of Use - 1/2 

   a. FD //         <-- display built-in help message

   b. FD NOVEL.*    <-- match all files beginning with the name "NOVEL" at the
                        current directory
 
   c. FD 4:         <-- match all files on the current driver at user 4 (ZCPR)

   c. FD /N         <-- display files without pausing

   c. FD /+AU       <-- display files from all user areas, sorted in ascending
                        order by access date

   d. FD *.DOC +    <-- display files  at the current  du ending  with ".DOC",
                        sorted from earliest to latest

   e. FD B: -       <-- display files on drive B, sorted fm latest to earliest
 Examples of Use - 2/2 

   f. FD /+A        <-- display files at the current du: in the order in which
                        they were last accessed

   g. FD /C=        <-- display all files at the current du which were created
                        today

   h. FD B1: >*.1   <-- display all files  at du B1: which  were last modified
                        after January of the current year

   i. FD WORK:*.Z80 -= <-- display all files  at WORK:  last  modified  today, 
                           most recent first

   j. FD B:*.Z80 -AU=  <-- Display all files on all user areas of drive B with
                           the file type .Z80 which  were  accessed  today, in 
                           order from the  most recently accessed to the least 
                           recently accessed.
