home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / ptdem3.zip / APPMON.HLP (.txt) < prev    next >
OS/2 Help File  |  1994-03-08  |  10KB  |  293 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Help For Application Monitor ΓòÉΓòÉΓòÉ
  3.  
  4. Application Monitor General Help 
  5.  
  6. The C.O.L. Systems Inc. Application Monitor (AppMon) is one of the Pegasus 
  7. Tools utilities. 
  8.  
  9. With AppMon you can monitor one or more instances of a specific application, as 
  10. well as children processes that the main application spawns. 
  11.  
  12. With AppMon you can monitor each Thread and/or File that the application(s) 
  13. reference. You can also monitor the system CPU during collection. 
  14.  
  15. AppMon collects all measurements and stores them to a log file of your naming 
  16. choice. This log file can then be processed by PegLog, the post processing log 
  17. utility. 
  18.  
  19.  
  20. ΓòÉΓòÉΓòÉ 2. Help For Application Monitor Main Window ΓòÉΓòÉΓòÉ
  21.  
  22. Application Monitor Main Window 
  23.  
  24. Monitoring an application is now a simple process: 
  25.  
  26.       1. Enter the name of the process that you want to monitor, making sure to 
  27.          include the 'EXE' or 'COM' extension. 
  28.  
  29.       2. Setup a log file to collect measurements to. If the 'Use Log File' 
  30.          check is not set, logging will be disabled. 
  31.  
  32.       3. Set whether you want to collect measurements for single or multiple 
  33.          instances of the named process, as well as any children it may spawn. 
  34.  
  35.       4. Set which measurement you want to collect. 
  36.  
  37.       5. Optionally, change the default frequency and duration for the monitor 
  38.          session. 
  39.  
  40.       6. Click Start! 
  41.  
  42.       7. When complete, run PegLog against the log to produce output in report 
  43.          or table format. 
  44.  
  45.      For detailed help on each of the options in this screen, click on the 
  46.      option then press the F1 key. 
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 2.1. Help For Application Name ΓòÉΓòÉΓòÉ
  50.  
  51. Application Name 
  52.  
  53. This is where you identify the process name that you want to monitor.  You must 
  54. supply the name for the process that usually appears in the rm2stat list: 
  55.  
  56. For example:
  57.  
  58. EPM ===> enter EPM.EXE
  59.  
  60. This is a required field. 
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ 2.2. Help For Frequency Minutes ΓòÉΓòÉΓòÉ
  64.  
  65. Frequency Minutes 
  66.  
  67. Set the number of minutes between samples for the monitored application. Valid 
  68. minutes range is 0-59. 
  69.  
  70.  
  71. ΓòÉΓòÉΓòÉ 2.3. Help For Frequency Seconds ΓòÉΓòÉΓòÉ
  72.  
  73. Frequency Seconds 
  74.  
  75. Set the number of seconds between samples for the monitored application. Valid 
  76. seconds range is 0-59. 
  77.  
  78.  
  79. ΓòÉΓòÉΓòÉ 2.4. Help For Duration Hours ΓòÉΓòÉΓòÉ
  80.  
  81. Duration Hours 
  82.  
  83. Set the number of hours that the monitored application should collect data for. 
  84. Valid hours range is 0-23. 
  85.  
  86. Pegasus Application Monitor allows you to set a watchdog timer that, when 
  87. elapsed time is completed, will stop monitoring the selected application. 
  88.  
  89. This timer will be relinquished if the application ends before it expires. 
  90.  
  91.  
  92. ΓòÉΓòÉΓòÉ 2.5. Help For Duration Minutes ΓòÉΓòÉΓòÉ
  93.  
  94. Duration Minutes 
  95.  
  96. Set the number of minutes that the monitored application should collect data 
  97. for. Valid range is from 1-59. 
  98.  
  99. Pegasus Application Monitor allows you to set a watchdog timer that, when 
  100. elapsed time is completed, will stop monitoring the selected application. 
  101.  
  102. This timer will be relinquished if the application ends before it expires. 
  103.  
  104.  
  105. ΓòÉΓòÉΓòÉ 2.6. Help For Single Application Tracking ΓòÉΓòÉΓòÉ
  106.  
  107. Single Application 
  108.  
  109. This option indicates wheter Pegasus Application Monitor should monitor only a 
  110. single instance of an application with the same name. 
  111.  
  112. If not set, all applications with a matching name will be monitored. 
  113.  
  114.  
  115. ΓòÉΓòÉΓòÉ 2.7. Help For Children Tracking ΓòÉΓòÉΓòÉ
  116.  
  117. Children Tracking 
  118.  
  119. This option indicates whether children processes of the monitored application 
  120. are to be monitored as well. 
  121.  
  122. If not set, Pegasus Application Monitor will discard children process 
  123. statistics. 
  124.  
  125.  
  126. ΓòÉΓòÉΓòÉ 2.8. Help For Thread Tracking ΓòÉΓòÉΓòÉ
  127.  
  128. Thread Tracking 
  129.  
  130. For each application, every thread can be monitored. 
  131.  
  132. This option indicates that Pegasus Application Monitor should collect thread 
  133. activity for the process being monitored. 
  134.  
  135. Note:  You must select either Thread, File or both for application monitoring. 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ 2.9. Help For File Tracking ΓòÉΓòÉΓòÉ
  139.  
  140. File Tracking 
  141.  
  142. For each application, every file that is accessed by the process can be 
  143. tracked. 
  144.  
  145. This option indicates that Pegasus Application Monitor should collect file 
  146. activity for the process being monitored. 
  147.  
  148. Note:  You must select either Thread, File or both for application monitoring. 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ 2.10. Help For System CPU ΓòÉΓòÉΓòÉ
  152.  
  153. System CPU 
  154.  
  155. In addition to tracking application thread percent busy, the overall System 
  156. percent busy can be collected. 
  157.  
  158. With this option, System CPU statistics will be written to the log (if 
  159. activated) as well as displayed in the CPU % indicator during monitoring. 
  160.  
  161.  
  162. ΓòÉΓòÉΓòÉ 2.11. Help For End Of Run Default ΓòÉΓòÉΓòÉ
  163.  
  164. End Of Run Default 
  165.  
  166. This button controls what action to take when an end of process run is 
  167. detected. 
  168.  
  169. The default is based on the following rules: 
  170.  
  171.       1. Single Instance with Children - AppMon will wait until any running 
  172.          children processes have ended as well. It will then close the log. 
  173.  
  174.       2. Single Instance with No Children - AppMon will close the log. 
  175.  
  176.       3. Multiple Instance with Children - AppMon will wait until all instances 
  177.          and children have ended before closeing the log. 
  178.  
  179.       4. Multiple Instance with No Children - AppMon will wait until all 
  180.          instances have ended before closeing the log. 
  181.  
  182.      Note:  If you have duration set and it expires before any of the above 
  183.      rules take effect, AppMon will close the log. 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 2.12. Help For End Of Run Auto Close ΓòÉΓòÉΓòÉ
  187.  
  188. End Of Run Auto Close 
  189.  
  190. This button controls what action to take when an end of process run is 
  191. detected. 
  192.  
  193. The Auto Close is based on the following rules: 
  194.  
  195.       1. Single Instance with Children - AppMon will close the log when the 
  196.          parent process has ended. 
  197.  
  198.       2. Single Instance with No Children - AppMon will close the log. 
  199.  
  200.       3. Multiple Instance with Children - AppMon will wait until all parent 
  201.          instances have ended before closeing the log. 
  202.  
  203.       4. Multiple Instance with No Children - AppMon will wait until all 
  204.          instances have ended before closeing the log. 
  205.  
  206.      Note:  If you have duration set and it expires before any of the above 
  207.      rules take effect, AppMon will close the log. 
  208.  
  209.  
  210. ΓòÉΓòÉΓòÉ 2.13. Help For End Of Run Prompt ΓòÉΓòÉΓòÉ
  211.  
  212. End Of Run Prompt 
  213.  
  214. This button controls what action to take when an end of process run is 
  215. detected. 
  216.  
  217. The user will be prompted to close the log or continue based on the following 
  218. rules: 
  219.  
  220.       1. Single Instance with Children - AppMon will wait the parent ends and 
  221.          then prompt to continue monitoring children if there are children 
  222.          running, otherwise it will close the log. 
  223.  
  224.       2. Single Instance with No Children - AppMon will close the log. 
  225.  
  226.       3. Multiple Instance with Children - AppMon will wait until the parent 
  227.          ends and the prompt to continue monitoring multiple instances if there 
  228.          are multiple instances running, otherwise it will close the log. 
  229.  
  230.       4. Multiple Instance with No Children - AppMon will wait until the parent 
  231.          ends and the prompt to continue monitoring multiple instances if there 
  232.          are multiple instances running, otherwise it will close the log. 
  233.  
  234.      Note:  If you have duration set and it expires before any of the above 
  235.      rules take effect, AppMon will close the log. 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 2.14. Help For Application Monitor Start ΓòÉΓòÉΓòÉ
  239.  
  240. Application Monitor Start 
  241.  
  242. This button, when clicked, will start the application monitor if settings 
  243. fields are properly set. 
  244.  
  245. Once the application has started being monitored, the Stop button will be 
  246. available to cancel the operation. 
  247.  
  248.  
  249. ΓòÉΓòÉΓòÉ 2.15. Help For Application List ΓòÉΓòÉΓòÉ
  250.  
  251. Application List 
  252.  
  253. Once the application monitor begins, this list box will fill with the fully 
  254. qualified name of the applications found to monitor. 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 2.16. Help For File List ΓòÉΓòÉΓòÉ
  258.  
  259. File List 
  260.  
  261. Once the application monitor begins, this list box will fill with the fully 
  262. qualified name of the files opened for the applications being monitored. 
  263.  
  264. Note:  This box will only be filled if: 
  265.  
  266.      o The File Tracking option is set. 
  267.  
  268.      o The monitored application opens files. 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 2.17. Help For CPU Activity ΓòÉΓòÉΓòÉ
  272.  
  273. CPU Activity 
  274.  
  275. This gauge control displays the total system CPU percent busy. 
  276.  
  277. Note:  This is only active if the System Cpu option is set. 
  278.  
  279.  
  280. ΓòÉΓòÉΓòÉ 2.18. Help For Use Log File ΓòÉΓòÉΓòÉ
  281.  
  282. Use Log File 
  283.  
  284. If this option is set (checked), then the log file you have identified using 
  285. the Set Log option will be used to collect data measurements to. 
  286.  
  287.  
  288. ΓòÉΓòÉΓòÉ 2.19. Help For Set Log ΓòÉΓòÉΓòÉ
  289.  
  290. Set Log 
  291.  
  292. Use this control to setup the name of the log file where you want to collect 
  293. measurements to.