home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / sys_util / sftm142.zip / SFTM.DOC < prev    next >
Text File  |  1993-08-04  |  9KB  |  226 lines
  1.  
  2. SFTM 1.42
  3. ---------
  4. Copyright (c) 1992-1993 by Craig R. Clark
  5.  
  6.  
  7. DESCRIPTION
  8.  
  9. System File Table Monitor is a full screen, interactive monitor written
  10. in Turbo Pascal 6.0 that displays a list of filenames currently open,
  11. along with a summary of the access mode used to open the file, and the
  12. current sharing mode.
  13.  
  14. Displayed on the upper status bar are the number of file tables found in
  15. DOS, the total number of handles allocated via FILES= statements, the
  16. maximum number of handles used at one time, and the number of files
  17. currently open.
  18.  
  19. A clock is displayed on the lower status bar, as well as the program
  20. title and version number.  If run on a machine with the Lantastic REDIR
  21. loaded, the machine name also appears on this status bar.
  22.  
  23.  
  24. COMPATIBILITY
  25.  
  26. SFTM has been tested under Desqview 2.42, Windows 3.1, Lantastic 5.0,
  27. and DOS 6.0 on 286, 386 and 486 processors.  It displays the additional
  28. file tables created by Quarterdeck's FILES.COM utility included with
  29. QEMM.
  30.  
  31. It can be run in a 64K Desqview window, yet still monitor all files
  32. opened by every other application running under Desqview.  Functionality
  33. under Windows 3.1 is similar.
  34.  
  35.  
  36. OPERATION
  37.  
  38. To run SFTM.EXE, type 'SFTM' at the DOS prompt or create a suitable DV
  39. or Windows PIF for it.  It will detect the current video mode, and
  40. adjust for monochrome or colour adapters.  It will also determine the
  41. maximum number of displayable lines, and run in that mode, whether it is
  42. 25, 28, 43, 50 lines or higher.
  43.  
  44. There are three optional command line parameters, in addition to the
  45. ubiquitous '/?'.  They are:
  46.                                                                                 
  47.   /D delay    time (ms) between successive scans of the system                  
  48.               file table; default is 10, range is 0 to 1000
  49.                                                                                 
  50.   /P path     drive and directory for SFTM.DAT,                                 
  51.               default is current drive and directory                            
  52.                                                                                 
  53.   /S          suppress creation and update of SFTM.DAT
  54.  
  55.   /U          unattended operation, no prompts
  56.                                                                                 
  57. None of the parameters are mandatory; by default SFTM will delay 10
  58. milliseconds between successive scans of the file table, and will create
  59. a data file in the current directory.  See the enclosed SFT.BAT for a
  60. typical usage.
  61.  
  62. The delay parameter was introduced to avoid slowing down a heavily
  63. loaded machine.  It is particularly useful on a Lantastic server that
  64. has multiple printers attached.  With the default setting of 10, some
  65. slowdown of despooling may be noticed.  Setting the delay to a higher
  66. number will avoid any slowdown.
  67.  
  68. With a large delay factor, some files may be missed if they are briefly
  69. opened and closed again.  With a delay factor of '0' (zero), some
  70. slowdown may be noticed if running SFTM under Desqview or Windows.
  71.  
  72. The path parameter was added at the request of a registered user.  The
  73. default path for the SFTM.DAT file is the current directory.  This data
  74. file contains a number corresponding to the maximum file handles in use
  75. at one time.  Previously the maximum would be lost when exiting SFTM;
  76. now it is recorded to a file.
  77.  
  78. If you don't want the data file in your current directory, just include
  79. a complete path (drive/directory) to where you would like it.  SFTM will
  80. ensure the path exists first, and then check it for the existence of a
  81. previous data file.  If one exists, the 'MAXIMUM USED' total on the
  82. screen is updated to that number.  Upon exit, the new total is written
  83. back to this file.
  84.  
  85. The 'suppress' parameter makes SFTM ignore the data file entirely.  No
  86. file will be looked for, and no file will be created.  This is how the
  87. earlier versions of SFTM worked.  If you use this parameter, SFTM will
  88. always start your cumulative totals from zero, and the totals will be
  89. lost when exiting SFTM.
  90.  
  91. The 'unattended' parameter is useful if you always run SFTM from a batch
  92. file, and want it to start up even if the SFTM.DAT data file has been
  93. corrupted.  SFTM checks the data in SFTM.DAT when it starts (providing
  94. you are not using the /S parameter), and if valid uses it to display the
  95. previous 'Maximum Used' handles.  If invalid it displays a warning
  96. message and pauses.  The /U parameter eliminates this pause.
  97.  
  98. When using a normal 25 line screen, up to 88 files can be simultaneously
  99. displayed, along with their access modes.  On a 50 line screen, up to
  100. 188 files can be simultaneously displayed.
  101.  
  102. This utility can be invaluable in determining the access modes used by
  103. other software as an aid in troubleshooting system problems or for
  104. program debugging.  It will also be obvious if FILE HANDLES are set
  105. dangerously low, or excessively high.
  106.  
  107. Run on a Lantastic server, it is a useful alternative to ALONE.  All
  108. files open through DOS can be seen at a glance, and if left running for
  109. an extended period, the statistic collected on maximum files opened is
  110. useful in determining the optimum number of file handles to allocate
  111. without wasting resources.
  112.  
  113. The abbreviations used are as follows:
  114.  
  115. Access Modes:
  116.  
  117. RO - Read Only
  118. RW - Read/Write
  119. WO - Write Only
  120.  
  121. Sharing Modes:
  122.  
  123. CMP - Compatibility Mode
  124. EXC - Exclusive or Deny Read/Write
  125. DWR - Deny Write
  126. DRD - Deny Read
  127. DNO - Deny None
  128.  
  129.  
  130. COPYRIGHT
  131.  
  132. This is shareware software, not free software.  You are allowed to use
  133. it without obligation for a 10-day evaluation period.  For use beyond
  134. that time please register this software.
  135.  
  136. Registration will allow me to continue development of this utility. This
  137. software is not crippled in any way, as I do not believe you can fully
  138. evaluate the usefulness of crippled software.
  139.  
  140. Permission is given to shareware and CD-ROM compilers, online services
  141. and Bulletin Board operators to distribute or carry this archive.  The
  142. files SFTM.EXE and SFTM.DOC must not be altered in any way.
  143.  
  144.  
  145. FUTURE DEVELOPMENT
  146.  
  147. A TSR version.
  148. Remote monitoring.
  149. Enhancements to allow for the display of more files than can fit on the
  150. screen at one time (multiple pages of files).
  151. Optional display of the complete drive/path.
  152. Name(s) of owner program(s).
  153. Suggestions?
  154.  
  155.  
  156. SUPPORT
  157.  
  158. Bug reports are welcome, and verified bugs will be corrected in the next
  159. release.
  160.  
  161. Support BBS:
  162. Christian Deliverance BBS - two lines, 24 hours a day
  163. 1-809-292-7376 USR HST 14.4K   1-809-292-1774 Intel V.32bis
  164.  
  165. Network Addresses:
  166. Fidonet 1:18/20 (no crash mail)
  167.  
  168. I am also a regular caller to the Artifacts BBS, 1-602-293-0068.  I am
  169. not affiliated with Artisoft in any way, and Artisoft is in no way
  170. responsible for support of this product.  I give their number for use
  171. only if you cannot reach me any other way.  The most timely support will
  172. always be through my support BBS numbers listed above.
  173.  
  174.  
  175. DISCLAIMER
  176.  
  177. While I have made every effort to ensure that this software works as it
  178. is intended to and I have tested it under a variety of operating
  179. conditions, I cannot be held responsible in the unlikely event of damage
  180. to your system by this product.
  181.  
  182.  
  183. REGISTRATION
  184.  
  185. Cost $15 US, $19 Canadian funds.
  186.  
  187. If you would like the latest version mailed to you on a diskette, please
  188. enclose an additional $5 US ($7 Canadian), specifying size and density.
  189.  
  190. All remittance should be in US or Canadian funds - personal cheques and
  191. money orders are acceptable.  Please make payable to 'Craig R. Clark'.
  192.  
  193. All funds and any other correspondence should be mailed to:
  194.  
  195. Craig R. Clark
  196. P.O. Box DV 3
  197. Devonshire, DV BX
  198. BERMUDA.
  199.  
  200.  
  201. REVISION HISTORY
  202. ----------------
  203.  
  204. August 3rd, 1993 - Version 1.42
  205. New command line switch added by user request for unattended operation.
  206. (thanks for the idea to Lou R.)  Recoded portion of display logic to
  207. avoid 'pulsing' screen under some conditions.
  208.  
  209. May 30th, 1993 - Version 1.4
  210. General release version; e-mail address changed.
  211.  
  212. May 8th, 1993 - Version 1.39
  213. New features; added command line switches.  Cumulative total for maximum
  214. handles used written to file.  User settable delay factor for
  215. performance issues.  Docs updated.
  216.  
  217. March 21st, 1993 - Version 1.32
  218. Minor bug fix.  Swapped positions of top status line and bottom status
  219. bar.  Changed wording of top status line.  Cosmetic changes.
  220.  
  221. January 27th, 1993 - Version 1.30
  222. Initial public release after extensive beta testing.
  223.  
  224. ** End.
  225.  
  226.