home *** CD-ROM | disk | FTP | other *** search
/ Tools en Utilities / CDASS_5.ISO / shell / file / fstat.arj / FSTAT.TXT < prev    next >
Encoding:
Text File  |  1992-11-29  |  9.7 KB  |  249 lines
  1.  
  2.  
  3.                                 FileStat
  4.                       ShareWare User Documentation
  5.  
  6.  
  7.  
  8. Introduction
  9.  
  10. FileStat is a set of useful utilities for keeping track of what files are 
  11. regularly used on your hard disk, and which are not.  It consists of 
  12. a 9k TSR (memory resident program), a conversion program, a 
  13. program to produce a sorted, printable text file in report format, 
  14. and a program to produce an ASCII file list of unused or inactive 
  15. files.
  16.  
  17. FileStat works by recording all file accesses in a log file.  The user 
  18. then runs a program (preferably on a daily basis) which converts 
  19. the log file into a dBase III+  compatible data base file.  Each 
  20. time the conversion program is run, the data base is updated.  If 
  21. new a file access has already been converted to the data base 
  22. file, then its access count is incremented and the date of last 
  23. access is updated. If the new file access has never previously 
  24. been converted to the database file, then a new record is 
  25. added.
  26.  
  27. By running FileStat for a significant period of time, (a period of 
  28. several weeks is recommended) a comprehensive data base of 
  29. file names and accesses can be developed. This allows the user 
  30. to see what files on their hard disk are actually used, how often, 
  31. and how long ago.
  32.  
  33.  
  34.  
  35.  
  36.  
  37. Installation
  38.     
  39. Installation of FileStat is very simple.  All you need to do is copy the 
  40. contents of your distribution disk to any sub directory on your 
  41. hard disk.  The sub directory you choose should be where you 
  42. normally keep your utility programs.  For example, if you have a 
  43. directory where your utility programs are stored called C:\UTILITY,
  44. you would Insert your distribution disk in your A drive, and simply 
  45. type the following at the DOS prompt:
  46.  
  47.                          COPY A:*.* C:\UTILITY
  48.  
  49. Whatever sub directory you install the FileStat programs in should 
  50. be included in your PATH statement.
  51.  
  52.  
  53. Operation
  54.  
  55. There are five executable programs  included with the FileStat 
  56. package.  Each program, and its operation are described below.  
  57. For ease of reference, each program is numbered in the order 
  58. that they would normally be used.
  59.  
  60. 1.    CONFIGFS.EXE - This is the FileStat configuration program.  You 
  61. MUST run this program before running any of the FileStat 
  62. programs.  It will create a configuration file in the root 
  63. directory of your hard disk called F_STAT.INF.  It will also create 
  64. a sub-directory on the current drive called \F_STAT , where 
  65. your FileStat files will be maintained.
  66.  
  67. 2.    FILELOG.EXE - This is the TSR program that will keep track of all 
  68. file accesses.  It will occupy about 9k of RAM, and can be 
  69. loaded high.  Its operation should be imperceptible to the 
  70. user.  FILELOG will create a file called FILELOG.DAT in the 
  71. FileStat directory.  This is where all file accesses will be 
  72. recorded. FILELOG can be unloaded by using the /U option 
  73. (i.e. FILELOG /U ).  FILELOG can also be loaded in a "quiet" 
  74. mode (no screen information) by using the /Q option (i.e. 
  75. FILELOG /Q ).
  76.  
  77.  
  78. 3.    FILESTAT.EXE - This program will create and maintain a file in 
  79. your FileStat directory called FILESTAT.DBF.  It should be run at 
  80. least once a day (from your AUTOEXEC.BAT file).  It will read all 
  81. file accesses recorded in the FILELOG.DAT file, and update the 
  82. FILESTAT.DBF file.  The FILELOG.DAT file is then deleted, and 
  83. FILELOG will create a new one when there are more file 
  84. accesses to record.  FILESTAT.DBF is a standard dBase III+ file 
  85. and can be used by any program that is compatible with DBF 
  86. type files.
  87.  
  88. 4.    STATREPT.EXE - This program will read your data base file 
  89. (FILESTAT.DBF) and create an ASCII text file called STATS.TXT.  
  90. STATS.TXT can be viewed or edited by any text editor or word 
  91. processor.  You can also print STATS.TXT by typing the following 
  92. command at the DOS prompt:
  93.  
  94.                       COPY C:\F_STAT\STATS.TXT PRN
  95.  
  96. You may view it on your screen with the following command:
  97.  
  98.                     TYPE C:\F_STAT\STATS.TXT | MORE
  99.  
  100. STATREPT will pre-sort your data in specific order if you like.
  101.  
  102. STATREPT /N  will sort the data by the full path and file 
  103. name.  This is the default.
  104.  
  105. STATREPT /A  will sort the data by the number of file 
  106. accesses with the most active files first.
  107.  
  108. STATREPT /D  will sort the data by date the file was last 
  109. accessed with the most recent files  first.
  110.  
  111. 5.    NOTUSED.EXE - This program will create a current list of all files 
  112. residing on your hard disk that have not been accessed since 
  113. you began using FileStat.  The list created is in ASCII file format 
  114. and is named NOTUSED.TXT  It can be viewed, printed, or 
  115. edited in the same way as the STATS.TXT file.  NOTUSED can will 
  116. also accept a file specification mask.  For example, NOTUSED 
  117. *.EXE will produce a listing of all unused files with the 
  118. extension EXE.  Whenever you use a file specification mask, the
  119. resultant NOTUSED file created will use the same extention.  In this
  120. way you can set up numerous NOTUSED files for various situations.
  121. There a few situations where the extention will not be exactly the
  122. same as the file specification mask.  The extention EXE will be
  123. changed to EX_, COM will be changed to C_M, and BAT will become B_T.
  124. In addition, when you use a mask like  NOTUSED *.B??, the resultant
  125. file created by not used will be NOTUSED.B--.  A file mask like
  126. NOTUSED *.B* will create a file called NOTUSED.B%.  In other words,
  127. ? will become - and * will become % whenever they are used as part of
  128. the file extention mask.
  129.  
  130. The NOTUSED.TXT file can also be used as a "response" file for
  131. other programs.  A "response" file is an ASCII file that supplies 
  132. input data to other programs.  In this case, the input data 
  133. would be the full drive, path, and file name of inactive files.  
  134. Many back-up, "move", and archiving (ZIP) programs allow the use
  135. of response files.  NOTUSED.TXT can, and SHOULD be used to 
  136. create some type archival copy or back-up of any files you 
  137. plan to delete or remove from your system.
  138.  
  139.  
  140. Be Careful!
  141.  
  142. There are some dangers involved in using this program.  Some files 
  143. reported by FileStat as inactive, may actually be needed on your 
  144. system.  Here' s some guidelines to help you decide what files to 
  145. leave alone.
  146.  
  147. 1.  Be sure to disable FILELOG before using any backup programs or
  148. every file on your hard disk will show up in your FILESTAT database.
  149.  
  150. 2.  ALWAYS unload FILELOG before running any disk maintenence or
  151. optimization programs.
  152.  
  153. 3.  Never mess around with DOS or system files unless you know
  154. what you are doing.
  155.  
  156. 4.  Never delete any files from accounting program directories
  157. unless you check with the software publisher first.  Many files 
  158. used by accounting programs are accessed only on a 
  159. quarterly or yearly basis.
  160.  
  161. 5.  NEVER NEVER NEVER delete any files without backing them up
  162. first.  You may find out some time in the future that you will 
  163. need a couple of them!  IF YOU DON'T BACK-UP FILES THAT 
  164. YOU INTEND TO DELETE, AND YOU FIND THAT YOU DELETED 
  165. SOMETHING IMPORTANT, DON'T CALL US  WE CAN'T HELP YOU!
  166.  
  167.  
  168.  
  169.  
  170. WHY REGISTER?
  171.  
  172. First of all, if you use the program, it is the right thing to do.  A lot
  173. of time and money goes into the development of any software program.
  174. Solid Oak Software is a "real" software development company with several
  175. commercial programs in distribution.  This is NOT a spare time venture.
  176. Whether or not we continue to offer ShareWare versions of new software
  177. in the future depends on its economic viability.
  178.  
  179. Secondly, you get some good benefits.  When you register you receive
  180. commercial versions of the programs without any restrictions or other
  181. annoyances.  You will also get notices and discounts on new products
  182. and product updates.
  183.  
  184. You also get TOLL FREE technical support. Not for 30 or 60 days, but
  185. allways.
  186.  
  187.  
  188.                    ShareWare License and Information
  189.  
  190. You may use this program for 30 days as a ShareWare product. If you continue
  191. to use the program after that 30 day period, you are required to register.
  192.  
  193. DISK VENDORS and BBS OPERATORS.  You are free to distribute this program
  194. in any form as long as it is complete as indicated above, and no fee in
  195. excess of $10.00 is charged.
  196.  
  197.  
  198.                        FileStat v1.0 ORDER FORM
  199.  
  200.  
  201. ______ FileStat single user ShareWare registration...... $  39.00  $ ______
  202.  
  203. ______ FileStat Site License registration (per 100 users)$ 695.00  $ ______
  204.        ( Call for other pricing )
  205.  
  206. California orders please add Sales Tax .................... 7.75%  $ ______
  207.  
  208.  
  209.            ALL ORDERS SHIPPED 2nd DAY AIR...  Shipping & Handling  $   4.00
  210.  
  211.                                         Overseas orders add $15.00 $ ______
  212.  
  213.                                                   C.O.D. add $5.00 $ ______
  214.  
  215.                                                             Total  $ ______
  216.                                              
  217.  
  218.                   Payment by check, money order, COD.
  219.  
  220.        No credit card purchases on orders totaling $50.00 or less
  221.  
  222.                    Approved purchase orders accepted.
  223.  
  224.                       ORDER LINE: 1-800-388-2761
  225.  
  226.  
  227.   Name / Contact: _____________________________________________________
  228.  
  229.   Company: ____________________________________________________________
  230.  
  231.   Address: ____________________________________________________________
  232.  
  233.          : ____________________________________________________________
  234.  
  235.          : ____________________________________________________________
  236.  
  237.     Phone: ______________________________ FAX: ________________________
  238.  
  239.  
  240.  
  241.                Please complete and mail with payment or FAX to:
  242.  
  243.                               Solid Oak Software
  244.                                  P.O. Box 6826
  245.                            Santa Barbara, CA 93160
  246.                         805-568-5414  FAX 805-568-5419
  247.  
  248.  
  249.