home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 15 / CDACTUAL15.iso / cdactual / program / asm / OKTIMDAT.ZIP / FTD.DOC < prev    next >
Encoding:
Text File  |  1988-11-12  |  3.7 KB  |  67 lines
  1.  
  2.                                     FTD.DOC
  3.  
  4.                       File Time/Date stamper DOCumentation
  5.  
  6.         Background: Among the fields of a file directory are wordsize
  7.         bit-maps of the date and time when that file was created or
  8.         up-dated.  Like the file length, the file date and time are
  9.         intended to show accurate information about the file and,
  10.         therefore, are not made available for casual change.  File
  11.         attributes, date/time stamps and file length were originally
  12.         intended to be read/only information to directory programs.
  13.  
  14.         Problem:    Just as legitimate reasons for altering the file
  15.         Hidden, System and Read/Only attributes have led to utility
  16.         programs to alter them, there are at least two reasons for
  17.         changing the Date and Time stamps without rewriting the file.
  18.         Whether failure to set the system date/time has resulted in
  19.         stamps of the 1/1/80 IBM birthdate plus time since boot-up or
  20.         ordering by date and time would "professionalize" directory
  21.         appearance, FTD is at your service.
  22.  
  23.         Solution:   The command FTD followed by a File Specification
  24.         will update the Time and Date stamps for any file which matches
  25.         the File Specification to the Current DOS Date and Time.  If
  26.         optional Date and/or Time parameters follow the "file spec" in
  27.         either order, that Date and/or Time will be used for the stamp.
  28.         Should the Date parameter be invalid, the Current Date will be
  29.         used.  The new Time stamp will be as entered.
  30.  
  31.         Syntax:     FTD filespec [mm/dd/yy[yy]] [hh[:mm[:ss]]]
  32.  
  33.         Notice: that the year may be specified as 2 or 4 digits.  This
  34.         will be convenient a century from now for entering 12/21/2089.
  35.         On the other hand, the first of January 2000 can be entered as:
  36.         1/1/0.  Any part of the Time parameter which is omited will be
  37.         assumed to be zero.  For example FTD *.* 0 will stamp all files
  38.         in the default directory to the current date with midnight as
  39.         the time (00:00:00).  Since 2000 will be a leap year you can do
  40.         FTD LEAPYEAR.* 0 2/29/0 for stamping all default directory files
  41.         with the primary filename of "LEAPYEAR" to midnight - 2/29/2000.
  42.         A full File Specification is the drive letter and any directory
  43.         paths for the file - ie FTD d:\mainpath\nextpath\lastpath\file.
  44.  
  45.         Limitations:    Some deliberate limitations are imposed to avoid
  46.         inadvertently restamping files which you did not intend with an
  47.         ambiguous File Specification (using *s or ?s).  Hidden or System
  48.         and Read/Only files will NOT be restamped.  Should you want to
  49.         restamp such files, you may use any ATTRIBute changing program
  50.         before and after restamping the Time/Date with FTD.  An invalid
  51.         date will NOT be accepted.  DOS and FTD are NOT so fussy about
  52.         the validity of the time.
  53.  
  54.         The FTD command buffer is only 42 bytes long and so using the
  55.         three directory path File Specification with a filename and ext
  56.         of 12 characters plus a Date and/or Time will corrupt the name
  57.         of the day of the week which is normally supplied by FTD if it
  58.         happens to be "Sunday".
  59.  
  60.         Niceties:   The lead-in display of FTD before beginning the list
  61.         of files stamped report includes the NAME of the Day of the Week
  62.         for the date being stamped.  It may be NICE to KNOW that 2/29/88
  63.         was a "Monday".  Should the list of files be long enough it will
  64.         be "paged" so that you must press a key to continue the display.
  65.         This "paging" will allow reading the lead-in message.
  66.  
  67.