home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / dos / fil.lzh / FIL.DOC < prev   
Text File  |  1986-04-29  |  5KB  |  92 lines
  1.                              FIL.COM
  2.  
  3.                  A supplement to the DIR command.
  4.  
  5.     PURPOSE:  The fil(es) command was developed to provide information
  6.     that is not available with the DIR command.  The base code comes
  7.     from Professional Basic by Morgan Computing.  This routine is
  8.     copyrighted by Morgan Computing.  It may be freely distributed.
  9.     However, it may not be sold.  Morgan Computing is not resposible
  10.     for any damages resulting from the use of this program.
  11.  
  12.     INVOCATION:  FIL is invoked in the same manner as DIR.
  13.  
  14.                example: FIL b:*.bas
  15.  
  16.     This example will list all the files with the tag BAS in the current
  17.     directory on drive B.  A small but significant difference is that
  18.     if the name specified is a sub-directory entry and that entry is
  19.     in the current directory, the entry will be listed.  (DIR lists
  20.     the contents of the sub-directory.)  To list the contents of the
  21.     sub-directory with FIL, enter the name of the sub-directory followed
  22.     by a slash.  Example:  FIL a:basprogs\   will list the contents of
  23.     sub-directory BASPROGS.
  24.  
  25.     The output from FIL can be redirected.  Example:  FIL c:*.* >PRN
  26.     will direct the output to the printer.  A more useful redirection
  27.     is  FIL A: > C:DISK113.DIR  which puts a copy of the directory
  28.     on the diskette in drive A into a disk(ette) file on drive C.
  29.  
  30.     OUTPUT: FIL lists the type of media in the drive, the files
  31.     specified on the command line, and a summary of the number of
  32.     files listed and the sum of the bytes of those files and the
  33.     bytes free (left) on the drive.
  34.  
  35.     The type of media table in FIL recognizes single and double sided
  36.     diskettes, 8 and 9 sector formatting and some hard disks.  It is
  37.     used for identifying diskettes that have been sent to us from
  38.     outside sources.
  39.  
  40.     The file names, their length in bytes and their attribute bit
  41.     settings are listed in pairs.  The lengths shown are the directory
  42.     entry length not the actual length used on disk(ette).  Disk(ette)
  43.     files are allocated in clusters which often causes the amount of
  44.     spaced used by a file to exceed its length.  The attribute bits
  45.     are used by PC-DOS to "protect" certain files.  The codes shown are
  46.           A  - Archive bit set.  (See the BACKUP routine.)
  47.           S  - System file.
  48.           H  - Hidden file.  This file is not listed with DIR.
  49.           R  - Read Only.  This file cannot be opened for output
  50.                or append under PC-DOS.
  51.  
  52.     The final line is a summary of the files listed.  It lists the
  53.     number of entries selected and the total bytes used by those
  54.     entries.  For example, if FIL was invoked with a  *.BAS  to list
  55.     all the Basic source files in a directory, the summary line would
  56.     total all the bytes used by those Basic source files.  The final
  57.     entry is the bytes left on the drive.  Note that the sum of the
  58.     all the files on a disk(ette) and the bytes left does not normally
  59.     equal the total capacity of the drive.  This is due to files being
  60.     allocated by cluster which leads to bytes being allocated to files
  61.     which are currently not used.
  62.  
  63.     KEYBOARD CONTROL:  In keeping with the operational philosophy of
  64.     Morgan Computing's software, FIL can be controlled from the keyboard
  65.     while it is running.
  66.  
  67.     The space bar will single step the listing.  Each push of the space
  68.     bar lists the next line.  This feature allows the user to look at
  69.     directories that cannot be contained in one screen.
  70.  
  71.     The return key will return the program to full speed.  Each line
  72.     will appear on the screen when the program is ready to print it.
  73.     There is no restriction on the number of times that you can toggle
  74.     between single step and full speed modes.
  75.  
  76.     The ESCape key will terminate the listing prematurely.  The FIL
  77.     program will go directly to the summary line.  The summary line
  78.     will reflect only the entries listed before the ESCape key was
  79.     pushed.
  80.  
  81.     COMMENTS:  This program has been useful to me.  I built it to
  82.     get answers about disk(ette)s that were not available elsewhere
  83.     in PC-DOS.  I would appreciate suggestions about improvements.
  84.  
  85.                         J. C. Hoisington
  86.                         MORGAN COMPUTING
  87.                 10400 N Central Expwy.  Suite 210
  88.                       Dallas, Texas  75231
  89.                         (214) 739-5895
  90.  
  91.                                                            84'11'12  jch
  92.