home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / PTDEM3.ZIP / PEGTOOLS.INF (.txt) < prev    next >
OS/2 Help File  |  1994-03-08  |  53KB  |  814 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Notices ΓòÉΓòÉΓòÉ
  3.  
  4.                                   Pegasus Tools
  5.                                   Version 1.10
  6.                         (c) 1993,1994 C.O.L. Systems Inc.
  7.                                All Rights Reserved
  8.  
  9.                         PegRexx (Pegasus Rexx Extension)
  10.                                   Version 1.10
  11.                         (c) 1993,1994 C.O.L. Systems Inc.
  12.                                All Rights Reserved
  13.  
  14. C.O.L. Systems Inc. has been in the business of software development and 
  15. consulting since 1987. Our software has, and will continue to be, geared 
  16. towards performance and capacity management needs. 
  17.  
  18. From the standalone OS/2 station tools (Pegasus Resource Monitor and Pegasus 
  19. Tools) to heterogenous performance and capacity management (Osrm2*), we 
  20. continue to meet the users needs in sophisticated, low price, software. 
  21.  
  22. *Osrm2 (c) 1991,1994 C.O.L. Systems Inc. 
  23.  
  24. Other Notices 
  25.  
  26. OS/2 is copyright by IBM Corporation. 
  27.  
  28.  
  29. Contact and Support 
  30.  
  31. We have moved to a new location with new phones as well: 
  32.  
  33. Mailing Address: 
  34.  
  35.                                C.O.L. Systems Inc.
  36.                                10 Watergate Drive
  37.                                Amawalk, NY. 10501
  38.  
  39. Telephone Numbers for: 
  40.  
  41. Voice  -       (914) 245-0442
  42. FAX    -       (914) 245-0452
  43. BBS    -       (914) 245-1561
  44.  
  45.  
  46. ΓòÉΓòÉΓòÉ 2. License and Warranty ΓòÉΓòÉΓòÉ
  47.  
  48. License Agreement and Warranty Disclaimer 
  49.  
  50. You should carefully read the following terms and conditions before using this 
  51. software.  Use of this software indicates your acceptance of these terms and 
  52. conditions. If you do not agree with them, do not use the software.  The term 
  53. Pegasus Tools refers to: 
  54.  
  55.      o AppMon Application Activity Monitor 
  56.  
  57.      o FileMon File Activity Monitor 
  58.  
  59.      o CacheMon Cache Activity Monitor 
  60.  
  61.      o PegRexx Pegasus Tools Log Post Processor Rexx Extension 
  62.  
  63.  Shareware Version 
  64.  
  65.  You are hereby licensed to:  use the Shareware Version of the software for a 
  66.  21 day evaluation period; make as many copies of the Shareware version of this 
  67.  software and documentation as you wish; give exact copies of the original 
  68.  Shareware version to anyone; and distribute the Shareware version of the 
  69.  software and documentation in its unmodified form via electronic means.  There 
  70.  is no charge for any of the above. 
  71.  
  72.  You are specifically prohibited from charging, or requesting donations, for 
  73.  any such copies, however made; and from distributing the software and/or 
  74.  documentation with other products (commercial or otherwise) without prior 
  75.  written permission from C.O.L. Systems Inc. 
  76.  
  77.  Unregistered use of Pegasus Tools after the 21-day evaluation period is in 
  78.  violation of federal copyright laws. 
  79.  
  80.  Evaluation and Registration 
  81.  
  82.  This is not free software.  This license allows you to use this software for 
  83.  evaluation purposes without charge for a period of 21 days.  If you use this 
  84.  software after the 21 day evaluation period a registration fee is required as 
  85.  described in Registration Forms. 
  86.  
  87.  Quantity discounts are available, see the apporirate order form for details. 
  88.  
  89.  One registered copy of Pegasus Tools may be dedicated to a single person who 
  90.  uses the software on one or more computers or to a single workstation used by 
  91.  multiple people. You may access the registered version of Pegasus through a 
  92.  network, provided that you have obtained individual license for the software 
  93.  covering all workstations that will access the software through the network. 
  94.  
  95.  Governing Law 
  96.  
  97.  This agreement shall be governed by the laws of the State of New York. 
  98.  
  99.  Disclaimer of Warranty 
  100.  
  101.  This software and the accompanying files are sold "as is" and without 
  102.  warranties as to performance of merchantability or any other warranties 
  103.  whether expressed or implied.  Because of the various hardware and software 
  104.  environments into which this program may be put, no warranty of fitness for a 
  105.  particular purpose is offered. Good data processing procedure dictates that 
  106.  any program be thoroughly tested with non-critical data before relying on it. 
  107.  The user must assume the entire risk of using the program.  Any liability of 
  108.  the seller will be limited exclusively to product replacement or refund of 
  109.  purchase price. 
  110.  
  111.  
  112. ΓòÉΓòÉΓòÉ 3. Registration Forms ΓòÉΓòÉΓòÉ
  113.  
  114. Registering Pegasus Tools 
  115.  
  116. C.O.L. Systems Inc. will accept MasterCard, or Visa Credit Cards. 
  117.  
  118. C.O.L. Systems Inc. will accept checks or Money Orders in US funds only. 
  119.  
  120. After printing the appropriate form, mail it in with your payment ( or fax it 
  121. if registering by Credit Card ). 
  122.  
  123.  o For General Registration, print and fill in the information and fax or mail 
  124.    the REGISTER.DOC file. 
  125.  
  126.    C.O.L. Systems Inc. maintains a Pegasus message and file area for registered 
  127.    users on it's BBS @(914) 245-1561. 
  128.  
  129.  o For Os/2 Shareware BBS users, print, fill in the information and fax or mail 
  130.    the OS2SHARE.DOC file. 
  131.  
  132.    C.O.L. Systems Inc. maintains a Pegasus file area for registered users. Once 
  133.    we receive registration we will notify you via Os/2 Shareware private e-mail 
  134.    with the password to this file area. 
  135.  
  136.  o For Pyramid/2 BBS users, print, fill in the information and fax or mail the 
  137.    REGISTER.DOC file. 
  138.  
  139.    C.O.L. Systems Inc. maintains a Pegasus file and message area for registered 
  140.    users. Once we have received registration we will have the Pyrmaid/2 sysop 
  141.    update your security level to proivde access to these areas. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 4. APAR Notices ΓòÉΓòÉΓòÉ
  145.  
  146. The following are APARS and associated fixes that may be required to run the 
  147. Pegasus Resource Monitor or Pegasus Tools. These fixes are available from the 
  148. IBM Corporation. 
  149.  
  150.  The following APARs apply to OS/2 2.0 plus Service Pak 1. 
  151.  
  152.      o PJ06434 - Disk Device Driver 
  153.  
  154.        The fix concerns a problem where disk timers were getting corrupted. 
  155.  
  156.  The following APARs apply to either OS/2 2.0 plus Service Pak 2 or OS/2 2.1. 
  157.  
  158.      o PJ08459 - Occasional negative values for Process Page Fault Time. 
  159.  
  160.        Page Fault time is a metric which measures how much time a thread has 
  161.        spent waiting on a page fault.  This metric is part of the thread 
  162.        resource group. On a heavily loaded machine, this timer can go negative 
  163.        briefly. 
  164.  
  165.      o PJ09410 - Trap E when collecting thread data on a busy system. 
  166.  
  167.        On a heavily loaded managed system with excessive thread activity, there 
  168.        is a potential for a TRAP E to occur while collecting 
  169.        application/process/thread level data. To avoid this trap, obtain the 
  170.        selective fix for APAR PJ09410. 
  171.  
  172.      o PJ09893 - Trap D on dirty HPFS disk. 
  173.  
  174.        If you have HPFS installed, you may experience a trap D in OS2KRNL while 
  175.        collecting data.  The trap occurs if chkdsk was run during config.sys 
  176.        time. If you experience this problem, obtain the selective fix for APAR 
  177.        PJ09893. 
  178.  
  179.      o PJ10475 - A variety of traps in OS2KRNL 
  180.  
  181.        During data collection on a heavily loaded machine. APAR PJ10475 fixes 
  182.        these traps. 
  183.  
  184.      o APAR PJ10476 and PJ10275. 
  185.  
  186.        If you start and stop data collection more than 140 times without 
  187.        rebooting, OS/2 stops returning data.  To avoid this symptom, obtain the 
  188.        selective fix for APAR PJ10275 or PJ010476. 
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 5. What is the Pegasus System? ΓòÉΓòÉΓòÉ
  192.  
  193. The Pegasus System Is set of 32 bit application: 
  194.  
  195.      The Pegasus Resource Monitor is a kernel level, real-time, Presentation 
  196.      Manager monitoring tool for system and application resource usage under 
  197.      OS/2 2.x. Including a configurable sample rate, thresholds settings, 
  198.      exception notification and logging, as well as graphical indicators, the 
  199.      Pegasus Resource Monitor provides the most comprehensive monitoring tool 
  200.      for OS/2. 
  201.  
  202.      The Pegasus Tools utilities are a number of system measurement and 
  203.      reporting utilities designed to provide detailed insight of system 
  204.      resource activity through intensive monitoring, log collection and post 
  205.      processing reports (PegRexx). These utilities include: 
  206.  
  207.           o AppMon 
  208.           o FileMon 
  209.           o CacheMon 
  210.  
  211.  Additional information can be found in: 
  212.  
  213.           o General Menu Options 
  214.           o Command Line Options 
  215.           o Demo Restrictions 
  216.           o History Of Changes 
  217.           o Frequently Asked Questions 
  218.  
  219.  For information on post processing of the Pegasus Tools monitor output files 
  220.  refer to the PEGREXX.INF file. 
  221.  
  222.  
  223. ΓòÉΓòÉΓòÉ 6. Common Options ΓòÉΓòÉΓòÉ
  224.  
  225. Following are options that are available for all three of the Pegasus Tools 
  226. utilities. 
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ 6.1. Menu Options ΓòÉΓòÉΓòÉ
  230.  
  231. All of the Pegasus Tools utilities have the ability to save session settings so 
  232. that you can quickly recall them without having to remember how you set up a 
  233. previous session. This becomes valuable when you want to record multiple data 
  234. logs that maintain the same sample criteria. For example, if testing Cache 
  235. effectiveness you would take one sample with CacheMon, possibly change the size 
  236. of the FAT or HPFS cache, and re-run Cachemon with the same frequency and 
  237. options as set for the first run. You could then compare the two outputs. 
  238.  
  239. The save and load options place no restrictions on the filenames used to store 
  240. the information. Each of the tools can detect if a selected file for input is 
  241. in fact a Pegasus Tools configuration file. 
  242.  
  243. If you load an existing configuration file you need only click the Start button 
  244. to begin collection. 
  245.  
  246. Refer to Command Line Options for additional information. 
  247.  
  248. The save and load options can be invoked from the File menu action on each of 
  249. the utilities. 
  250.  
  251.  
  252. ΓòÉΓòÉΓòÉ 6.2. Command Line Options ΓòÉΓòÉΓòÉ
  253.  
  254. All of the Pegasus Tools utilities support the following optional command line 
  255. options: 
  256.  
  257.      TOOLNAME -M filename 
  258.  
  259.  Examples: 
  260.  
  261.  
  262.    AppMon -m
  263.  
  264.      will start the Application Monitor in a minimized state.
  265.  
  266.    FileMon theFiles.CfG
  267.  
  268.      will start the File Monitor, load the configuration
  269.      file THEFILES.CFG and automatically invoke the collection
  270.      engine.
  271.  
  272.    CacheMon -m cachechk.001
  273.  
  274.      will start the Cache Monitor, minimize the CacheMon main
  275.      window, load the configuration file CACHECHK.001 and
  276.      automatically invoke the collection engine.
  277.  
  278.  
  279. ΓòÉΓòÉΓòÉ 7. AppMon ΓòÉΓòÉΓòÉ
  280.  
  281. There are many utilities which provide general OS/2 application information, as 
  282. well as a number of code profilers. There was not, until now, an affordable 
  283. utility which can track detailed application activity at the thread and file 
  284. level without inside knowledge of the application code. 
  285.  
  286. AppMon is designed to provide the user with the following features: 
  287.  
  288.      o The ability to monitor and capture statistics for: 
  289.  
  290.          1. A single instance of an application. 
  291.  
  292.          2. Multiple instances of an application. 
  293.  
  294.          3. Children processes of the monitored application. 
  295.  
  296.          4. Individual Application Thread(s) or Application File(s) activity, 
  297.             or both. 
  298.  
  299.          5. System CPU statistics. 
  300.  
  301.      o Granularity between measurements: 
  302.  
  303.          1. From 1 second to 44 minutes 59 seconds. 
  304.  
  305.      o Duration of measurements: 
  306.  
  307.          1. Until the application ends. 
  308.  
  309.          2. Manually stopped by user. 
  310.  
  311.          3. Timed monitoring from 1 minute to 23 hours 59 minutes. 
  312.  
  313.  Detailed information can be found in: 
  314.  
  315.      o Setting Up A Session 
  316.  
  317.  
  318. ΓòÉΓòÉΓòÉ 7.1. Setting Up A Session ΓòÉΓòÉΓòÉ
  319.  
  320. The following is the AppMon configuration and status panel. Descriptions for 
  321. each of the controls can be found after the picture. 
  322.  
  323.      o Setup Options Setup define the characteristics for the monitor session. 
  324.  
  325.          1. Application Name This field is used to identify the application you 
  326.             want to monitor. You must supply at least the application name and 
  327.             extension, for example: 
  328.  
  329.                               NMAKE.EXE
  330.  
  331.          2. Use Log File This check box indicates that you want to use the log 
  332.             file selected with the Set Log control. This is optional and if 
  333.             left blank AppMon will track activity without writing statistics to 
  334.             disk. 
  335.  
  336.          3. Set Log  This button will invoke a file dialog box which allows you 
  337.             to name the output log file. 
  338.  
  339.          4. Frequency The frequency option has two controls, minutes and 
  340.             seconds. These control how often measurement snapshots are taken 
  341.             and optionally written to the log file if named. The range for 
  342.             frequency is from 1 second to 44 minutes and 59 seconds. 
  343.  
  344.             Note:  Some data samples may be lost if you set a very high 
  345.             frequency on very active systems. In general, higher frequencies 
  346.             will flatten out detail statistics which may not be desired. 
  347.             Samples of 1 minute or less are suggested for performance 
  348.             reporting. 
  349.  
  350.          5. Duration The duration option has two controls, hours and minutes. 
  351.             These control how long measurements are to be taken. If duration is 
  352.             set at 0, data will be recorded until manually stopped or if the 
  353.             application being monitored ends. If you set the duration to any 
  354.             other value, the application will continued to be monitored until 
  355.             any of the following events occur: 
  356.  
  357.             a. The duration expires. 
  358.  
  359.             b. The application being monitored ends. 
  360.  
  361.             c. The session is manually stopped. 
  362.  
  363.             The range for duration is from 1 minute to 23 hours 49 minutes. 
  364.  
  365.             Note:  The duration must be larger than the frequency or an error 
  366.             message will generated. 
  367.  
  368.          6. Single This checkbox controls whether or not AppMon will track the 
  369.             first or all instances of the named application that it finds 
  370.             during the session. By default AppMon is set to track a single 
  371.             instance of the named application. 
  372.  
  373.          7. Children This checkbox controls whether or not AppMon will track 
  374.             children processes spawned by the named application. By default 
  375.             AppMon is set to ignore any children processes of the named 
  376.             application. 
  377.  
  378.          8. Threads This checkbox controls the collection and logging of active 
  379.             thread information for the named application(s) and any children if 
  380.             the Children option is set. By default AppMon collects thread 
  381.             information. 
  382.  
  383.          9. Files This checkbox controls the collection and logging of accessed 
  384.             files information for the named application(s) and any children if 
  385.             the Children option is set. By default AppMon collects file 
  386.             information. 
  387.  
  388.         10. System CPU This checkbox controls the collection and logging of 
  389.             system wide CPU information. If set, AppMon will display the 
  390.             average system CPU by sample on the CPU Gauge control at the bottom 
  391.             of the window. By default AppMon collects CPU information. 
  392.  
  393.      o End Of Run Options End of run options determine the actions that should 
  394.        be taken when the specified application exits the system. Some of these 
  395.        options are goverened by the Single and Children settings. 
  396.  
  397.          1. Default If set the default is based on the following rules: 
  398.  
  399.             a. Single Instance with Children - AppMon will wait until any 
  400.                running children processes have ended as well. It will then 
  401.                close the log. 
  402.  
  403.             b. Single Instance with No Children - AppMon will close the log. 
  404.  
  405.             c. Multiple Instance with Children - AppMon will wait until all 
  406.                instances and children have ended before closeing the log. 
  407.  
  408.             d. Multiple Instance with No Children - AppMon will wait until all 
  409.                instances have ended before closeing the log. 
  410.  
  411.          2. Automatically Close The Auto Close is based on the following rules: 
  412.  
  413.             a. Single Instance with Children - AppMon will close the log when 
  414.                the parent process has ended. 
  415.  
  416.             b. Single Instance with No Children - AppMon will close the log. 
  417.  
  418.             c. Multiple Instance with Children - AppMon will wait until all 
  419.                parent instances have ended before closeing the log. 
  420.  
  421.             d. Multiple Instance with No Children - AppMon will wait until all 
  422.                instances have ended before closeing the log. 
  423.  
  424.          3. Prompt For Close The user will be prompted to close the log or 
  425.             continue based on the following rules: 
  426.  
  427.             a. Single Instance with Children - AppMon will wait the parent ends 
  428.                and then prompt to continue monitoring children if there are 
  429.                children running, otherwise it will close the log. 
  430.  
  431.             b. Single Instance with No Children - AppMon will close the log. 
  432.  
  433.             c. Multiple Instance with Children - AppMon will wait until the 
  434.                parent ends and the prompt to continue monitoring multiple 
  435.                instances if there are multiple instances running, otherwise it 
  436.                will close the log. 
  437.  
  438.             d. Multiple Instance with No Children - AppMon will wait until the 
  439.                parent ends and the prompt to continue monitoring multiple 
  440.                instances if there are multiple instances running, otherwise it 
  441.                will close the log. 
  442.  
  443.      o Start Once the information in the Setup area is complete, this button 
  444.        will invoke the Pegasus Tools collection engine and begin monitoring. 
  445.  
  446.      o Stop Once collection has started, this button becomes available to 
  447.        manually stop the session at any time. 
  448.  
  449.      o Application List When the collection engine detects the occurrence of 
  450.        the named application(s) or children, if the Child option is set, it 
  451.        will display the fully qualified path for that process in this list box. 
  452.        When any process ends, and it's name is in the list, it will be removed 
  453.        from the list. 
  454.  
  455.      o Files List Any files that are opened for the named application(s) or 
  456.        children, if the Child option is set, will be displayed in this list 
  457.        box. As files are closed they will be removed from the list. 
  458.  
  459.      o CPU Gauge If the System CPU option is set, the collection engine will 
  460.        update this gauge at each frequency sample. 
  461.  
  462.      o Samples This field will be updated with the number of samples at each 
  463.        snapshot interval. 
  464.  
  465.  
  466. ΓòÉΓòÉΓòÉ 8. FileMon ΓòÉΓòÉΓòÉ
  467.  
  468. There are many utilities which provide general OS/2 disk/file information There 
  469. was not, until now, an affordable utility which can track detailed physical 
  470. disk and file activity. 
  471.  
  472. FileMon is designed to provide the user with the following features: 
  473.  
  474.      o The ability to monitor and capture statistics for: 
  475.  
  476.          1. Physical Disk I/O activity 
  477.  
  478.          2. Logical disk File I/O Activity 
  479.  
  480.          3. File I/O by Application. 
  481.  
  482.          4. System CPU statistics. 
  483.  
  484.      o Granularity between measurements: 
  485.  
  486.          1. From 1 second to 44 minutes 59 seconds. 
  487.  
  488.      o Duration of measurements: 
  489.  
  490.          1. Manually stopped by user. 
  491.  
  492.          2. Timed monitoring from 1 minute to 23 hours 59 minutes. 
  493.  
  494.  Detailed information can be found in: 
  495.  
  496.      o Setting Up A Session 
  497.  
  498.  
  499. ΓòÉΓòÉΓòÉ 8.1. Setting Up A Session ΓòÉΓòÉΓòÉ
  500.  
  501. The following is the FileMon configuration and status panel. Descriptions for 
  502. each of the controls can be found after the picture. 
  503.  
  504.      o Setup Options 
  505.  
  506.          1. Use Log File This check box indicates that you want to use the log 
  507.             file selected with the Set Log control. This is optional and if 
  508.             left blank FileMon will track activity without writing statistics 
  509.             to disk. 
  510.  
  511.          2. Set Log  This button will invoke a file dialog box which allows you 
  512.             to name the output log file. 
  513.  
  514.          3. Frequency The frequency option has two controls, minutes and 
  515.             seconds. These control how often measurement snapshots are taken 
  516.             and optionally written to the log file if named. The range for 
  517.             frequency is from 1 second to 44 minutes and 59 seconds. 
  518.  
  519.             Note:  Some data samples may be lost if you set a very high 
  520.             frequency on very active systems. In general, higher frequencies 
  521.             will flatten out detail statistics which may not be desired. 
  522.             Samples of 1 minute or less are suggested for performance 
  523.             reporting. 
  524.  
  525.          4. Duration The duration option has two controls, hours and minutes. 
  526.             These control how long measurements are to be taken. If duration is 
  527.             set at 0, data will be recorded until manually stopped. If you set 
  528.             the duration to any other value, FileMon will continued to monitor 
  529.             until any of the following events occur: 
  530.  
  531.             a. The duration expires. 
  532.  
  533.             b. The session is manually stopped. 
  534.  
  535.             The range for duration is from 1 minute to 23 hours 49 minutes. 
  536.  
  537.             Note:  The duration must be larger than the frequency or an error 
  538.             message will generated. 
  539.  
  540.          5. Files This checkbox controls the collection and logging of all 
  541.             accessed file information. By default FileMon collects file 
  542.             information. 
  543.  
  544.          6. Physical Disk This checkbox controls the collection and logging of 
  545.             physical disk activity. By default FileMon collects physical disk 
  546.             information. 
  547.  
  548.          7. System CPU This checkbox controls the collection and logging of 
  549.             system wide CPU information. If set, FileMon will display the 
  550.             average system CPU by sample on the CPU control at the bottom of 
  551.             the window. By default FileMon collects CPU information. 
  552.  
  553.      o Start Once the information in the Setup area is complete, this button 
  554.        will invoke the Pegasus Tools collection engine and begin monitoring. 
  555.  
  556.      o Stop Once collection has started, this button becomes available to 
  557.        manually stop the session at any time. 
  558.  
  559.      o Disk List As the collection engine detects physical local disks, their 
  560.        id (0-23) will be displayed in this list box. 
  561.  
  562.      o Files List Any files that are opened on the system will be displayed in 
  563.        this list box. As files are closed they will be removed from the list. 
  564.  
  565.      o CPU Gauge If the System CPU option is set, the collection engine will 
  566.        update this gauge at each frequency sample. 
  567.  
  568.      o Samples This field will be updated with the number of samples at each 
  569.        snapshot interval. 
  570.  
  571.  
  572. ΓòÉΓòÉΓòÉ 9. CacheMon ΓòÉΓòÉΓòÉ
  573.  
  574. There has not been, until now, an affordable utility which can track detailed 
  575. cache (FAT/HPFS) statistics for OS/2. 
  576.  
  577. CacheMon is designed to provide the user with the following features: 
  578.  
  579.      o The ability to monitor and capture statistics for: 
  580.  
  581.          1. FAT Cache Activity. 
  582.  
  583.          2. HPFS Cache Activity. 
  584.  
  585.          3. System Memory/Paging Activity. 
  586.  
  587.          4. System CPU statistics. 
  588.  
  589.      o Granularity between measurements: 
  590.  
  591.          1. From 1 second to 44 minutes 59 seconds. 
  592.  
  593.      o Duration of measurements: 
  594.  
  595.          1. Until the application ends. 
  596.  
  597.          2. Manually stopped by user. 
  598.  
  599.          3. Timed monitoring from 1 minute to 23 hours 59 minutes. 
  600.  
  601.  Detailed information can be found in: 
  602.  
  603.      o Setting Up A Session 
  604.  
  605.  
  606. ΓòÉΓòÉΓòÉ 9.1. Setting Up A Session ΓòÉΓòÉΓòÉ
  607.  
  608. The following is the CacheMon configuration and status panel. Descriptions for 
  609. each of the controls can be found after the picture. 
  610.  
  611.      o Setup Options 
  612.  
  613.          1. Use Log File This check box indicates that you want to use the log 
  614.             file selected with the Set Log control. This is optional and if 
  615.             left blank CacheMon will track activity without writing statistics 
  616.             to disk. 
  617.  
  618.          2. Set Log  This button will invoke a file dialog box which allows you 
  619.             to name the output log file. 
  620.  
  621.          3. Frequency The frequency option has two controls, minutes and 
  622.             seconds. These control how often measurement snapshots are taken 
  623.             and optionally written to the log file if named. The range for 
  624.             frequency is from 1 second to 44 minutes and 59 seconds. 
  625.  
  626.             Note:  Some data samples may be lost if you set a very high 
  627.             frequency on very active systems. In general, higher frequencies 
  628.             will flatten out detail statistics which may not be desired. 
  629.             Samples of 1 minute or less are suggested for performance 
  630.             reporting. 
  631.  
  632.          4. Duration The duration option has two controls, hours and minutes. 
  633.             These control how long measurements are to be taken. If duration is 
  634.             set at 0, data will be recorded until manually stopped. If you set 
  635.             the duration to any other value, FileMon will continued to monitor 
  636.             until any of the following events occur: 
  637.  
  638.             a. The duration expires. 
  639.  
  640.             b. The session is manually stopped. 
  641.  
  642.             The range for duration is from 1 minute to 23 hours 49 minutes. 
  643.  
  644.             Note:  The duration must be larger than the frequency or an error 
  645.             message will generated. 
  646.  
  647.          5. Memory 
  648.  
  649.          6. FAT Cache 
  650.  
  651.          7. HPFS Cache 
  652.  
  653.          8. System CPU This checkbox controls the collection and logging of 
  654.             system wide CPU information. If set, CacheMon will display the 
  655.             average system CPU by sample on the CPU Gauge control at the bottom 
  656.             of the window. By default CacheMon collects CPU information. 
  657.  
  658.      o Start Once the information in the Setup area is complete, this button 
  659.        will invoke the Pegasus Tools collection engine and begin monitoring. 
  660.  
  661.      o Stop Once collection has started, this button becomes available to 
  662.        manually stop the session at any time. 
  663.  
  664.      o CPU Gauge If the System CPU option is set, the collection engine will 
  665.        update this gauge at each frequency sample. 
  666.  
  667.      o Resident Memory Gauge If the Memory option is set, the collection engine 
  668.        will update this gauge with the percent of total memory that is 
  669.        resident. Resident memory is non-discardable and non-pageable. 
  670.  
  671.      o Used Memory Gauge If the Memory option is set, the collection engine 
  672.        will update this gauge with the percent of total memory that is in use 
  673.        at the sampe time. 
  674.  
  675.      o FAT Cache Effectiveness Gauge If the FAT Cache option is set, the 
  676.        collection engine will update this gauge with the percentage of cache 
  677.        accesses ( Hits plus Misses ) where the desired data was found ( Hits ). 
  678.  
  679.      o HPFS Cache Effectiveness Gauge If the HPFS Cache option is set, the 
  680.        collection engine will update this gauge with the percentage of cache 
  681.        accesses ( Hits plus Misses ) where the desired data was found ( Hits ). 
  682.  
  683.      o Memory and Paging Indicators If the Memory option is set the collection 
  684.        engine will update these text indicators with: 
  685.  
  686.          1. Memory - The total memory (in megabytes) found on the system as 
  687.             reported by OS/2. 
  688.  
  689.          2. Page In - The number of Page In events during the past snapshot 
  690.             interval. 
  691.  
  692.          3. Page Out - The number of Page Out events during the past snapshot 
  693.             interval. 
  694.  
  695.      o Samples This field will be updated with the number of samples at each 
  696.        snapshot interval. 
  697.  
  698.  
  699. ΓòÉΓòÉΓòÉ 10. Demo Restrictions ΓòÉΓòÉΓòÉ
  700.  
  701. If this version of Pegasus Tools is the demo suite, then the following 
  702. restrictions are imposed: 
  703.  
  704.       1. The Save configuration and Load configuration menu options are 
  705.          disabled. 
  706.  
  707.       2. Command line parameters and drag drop of configuration files are 
  708.          ignored. 
  709.  
  710.       3. The Log File name will be set to PTOOL. If you have set this control 
  711.          differently it will be reset before the collection engine starts. 
  712.  
  713.       4. The Frequency setting will not go above 10 seconds or below 5 seconds. 
  714.          If you have set this control differently it will be reset before the 
  715.          collection engine starts. 
  716.  
  717.       5. The Duration setting will not go above 2 minutes or below 1 minute. If 
  718.          you have set this control differently it will be reset before the 
  719.          collection engine starts. 
  720.  
  721.       6. The Stop button will be disabled ever during the active collection. 
  722.  
  723.       7. The following options are effected in the demo suite: 
  724.  
  725.         o If you are running AppMon: 
  726.  
  727.             a. Only a Single instance of the specified application is tracked. 
  728.  
  729.             b. Children processes are not tracked. 
  730.  
  731.             c. Threads are tracked. 
  732.  
  733.             d. File and System CPU are not tracked. 
  734.  
  735.         o If you are running FileMon: 
  736.  
  737.             a. Files are tracked. 
  738.  
  739.             b. Physical Disk and System CPU are not tracked. 
  740.  
  741.         o If you are running CacheMon: 
  742.  
  743.             a. FAT and HPFS Cache are tracked. 
  744.  
  745.             b. Memory and System CPU are not tracked. 
  746.  
  747.      Note:  These retstrictions do NOT apply to the registered version of 
  748.      Pegasus Tools. 
  749.  
  750.  
  751. ΓòÉΓòÉΓòÉ 11. History Of Changes ΓòÉΓòÉΓòÉ
  752.  
  753. The following are a list of changes for the product in general, as well as 
  754. changes that apply to the registered version and demo suite version. The most 
  755. recent changes will be inserted at the top of the list. 
  756.  
  757.      o Version 1.10 
  758.  
  759.          1. Converted all tools to integer collector engine. 
  760.  
  761.          2. Reworked log file to accept any location. 
  762.  
  763.          3. New packaging now includes PegRexx.Dll and PegRexx.Inf. 
  764.  
  765.      o Version 1.0 
  766.  
  767.          1. Complete PEGLOG log post processor, including Level 3 support. 
  768.  
  769.          2. Online documentation. (This file). 
  770.  
  771.      o Registered Version 
  772.  
  773.          1. Added command line options. 
  774.  
  775.          2. Activated the Save and Load File menu options. 
  776.  
  777.      o Demo Suite 
  778.  
  779.          1. Increased the frequency and duration time limits. 
  780.  
  781.  
  782. ΓòÉΓòÉΓòÉ 12. Frequently Asked Question (FAQ) ΓòÉΓòÉΓòÉ
  783.  
  784. This section will provide answers to many of the questions asked about the 
  785. Pegasus Tools. We will organized the questions into relative sections and made 
  786. reference to supporting areas of the Pegasus Tools when applicable. 
  787.  
  788.  
  789. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  790.  
  791. Where TOOLNAME is one of the following: 
  792.  
  793.      o AppMon 
  794.  
  795.      o FileMon 
  796.  
  797.      o CacheMon 
  798.  
  799.  
  800. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  801.  
  802. When this option is specified on the command line, the Pegasus Tools  utility 
  803. will start minimized. 
  804.  
  805.  
  806. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  807.  
  808. When filename is used, the Pegasus Tools utility will load the filename 
  809. specified as a configuration file and automatically start  the collection 
  810. session. 
  811.  
  812. Note:  You can also drag a configuration file onto one of the Pegasus Tools 
  813. utilities. Just make sure that you add %* to the Parameters field of the 
  814. setting notebook for each  tool you want this functionality to exist for.