═══ 1. General Help ═══ General Pegasus Help Pegasus (The Greek Myth) A winged horse that with a stroke of his hoof caused the fountain Hippocrene to spring forth from Mount Helicon. Pegasus Resource Monitor (The Product) A 32 bit application that with a click of a mouse causes a fountain of performance statistics to spring forth from Mount OS/2 2.x! Unlike other OS/2 system monitors, the measurements in Pegasus come directly from the operating system. This provides accurate measurement data as opposed to 'approximated' information found in other monitor systems. In addition, Pegasus can be upgraded to the C.O.L. Systems Inc. network performance and capacity management tool Osrm2 Version 2.0. As a matter of fact, Osrm2 uses the same data collection as Pegasus ═══ 2. Help For Per Process Memory ═══ Per Process Memory This option displays a dialog box which details, per running process on the system, memory utilization. Included in the statistics are: Note: This option is only available if the IBM Theseus/2 product is loaded. ═══ 3. Help For Mini Monitor ═══ General The MiniMonitor is a graphical representation of the following key metrics: o CPU Percent Busy o Free Memory o Drive Storage Available ( By Partition ) Note: This option is only available with registered copies of Pegasus 1.0. ═══ 4. Help For System Activity ═══ System Activity This windows displays the system activity table. The table consists of metrics for global resources such as CPU, Paging, and Memory. The CPU metrics contain: o Cpu Utilization - The percentage of time that the system was busy performing work during the interval. o Dispatch Counts - The number of times a thread was scheduled during this interval. o Irq Utilization - The percentage of time spent servicing interupts. o Irq Service Counts - The number of interupts that were serviced during this interval. The Paging and Memory metrics values, with the exception of PageIn and PageOut counts, are displayed in pages. A page represents 4,096 bytes of memory. The Paging metrics contain: o PageIn Count - The number of pages swapped in from the swapper.dat file. o Page Faults - The number of times a page 'miss' occured. This is denoted as Flt in the PageIn row. o Page Demand - The number of pages demand loaded from disk. This is denoted as Dmd in the PageIn row. o PageOut Count - The number of pages swapped out to the swapper.dat file. o Page Discard - The number of pages discarded. This is denoted as Dsc in the PageOut row. o Page Reclaim - The number of pages reclaimed. This is denoted as Rcl in the PageOut row. The Memory metrics include: o Resident - The number of resident pages. A resident page is a page that can not be swapped. o Free - The number of free pages. A free page is a page not currently in use. o Used - The number of used pages. Used pages include resident pages as well. o Idled - The number of idled pages. Idle pages are pages that have not been recently. o Reassigned - The number of pages re-assigned. ═══ 5. Help For Application Activity ═══ Application Activity The table contains per process resource usage measured between Application Refresh Intervals as set in the configuration dialog. o Name - Name of the executing process. o PID - System assigned process ID. o Thrds - The number of current threads in this process. o Cpu % - The system busy percentage as measured for this process. o Disp - The number of times this process was dispatched in the last interval. o Flts - The number of page faults that occured for this process during the last interval. o PWait - The amount of time, in milleseconds, that this process spent waiting for a memory page fault to resolve. o FWait - The amount of time, in milleseconds, that this process spent waiting for file I/O. o Reads - The total number of disk I/O read events. o Writes - The total number of disk I/O write events. Sort Options You can change the sort order of the window by clicking on the right mouse button when the mouse pointer is in the application table area. You can select from: o Process ID (default) o Process Name o Process CPU Utilization o Process Dispatch Counts o Process Active Threads Per Process Options There are additional procedures for each application that can be performed. By double clicking on an application that is active with the Left Mouse Button, or selecting it with the keyboard and pressing Enter, you can select from: o Generate a working set report - This option requires that the IBM Theseus/2 product is installed. o Kill An Application - This option allows you to terminate a running process. ═══ 5.1. Help For Sort By Process ID ═══ Sort By Process ID This option will sort the applications screen by Process ID (PID). ═══ 5.2. Help For Sort By Process Name ═══ Sort By Process Name This option will sort the applications screen by Process Name. ═══ 5.3. Help For Sort By Utilization ═══ Sort By Utilization This option will sort the applications by the measured percent busy from the last measurement. ═══ 5.4. Help For Sort By Dispatch Count ═══ Sort By Dispatch Count This option will sort the applications by the dispatch count from the last measurement. ═══ 5.5. Help For Sort By Threads ═══ Sort By Threads This option will sort the applications by the active thread count from the last measurement. ═══ 5.6. Help For Application Working Set ═══ Application Working Set This option can be used if Pegasus detects that Theseus/2 is installed on your system and you want to run a working set analysis. Working set analysis allows you to determine how much memory a particular application is using over time. ═══ 5.7. Help For Application Kill ═══ Application Kill Although a brutal term for it, in the rare occasion a runaway process must be stopped, or it is convenient to stop a process from Pegasus, this option will send a kill signal to the selected process. If the target process has a signal handler that chooses to ignore the kill signal, this option will not always work. ═══ 6. Help For I/O Activity ═══ I/O Activity This windows displays the I/O activity table. The table consists of metrics for global resources such as Logical Partitions, Printers, and Communication Ports. The Logical Partition metrics contain: o Read Events - The number of disk reads that occured to this logical drive. o Read Response - The average response time (in milliseconds) per I/O event. o Read Bytes - The average number of bytes read per I/O event. o Write Events - The number of disk writes that occured to this logical drive. o Write Response - The average response time (in milliseconds) per I/O event. o Write Bytes - The average number of bytes written per I/O event. o Used Storage - This indicates the amount of storage (in megabytes) that is used on the logical disk. o Available Storage - This indicates the amount of storage (in megabytes) that is available for use on the logical disk. For Communication Ports, the metrics are the same as those for Logical disk except there are no storage metrics. For Printers, the metrics are the same as those for Communication Ports except there are no Read Event metrics. ═══ 7. Help For Configuration Options ═══ Pegasus Settings Configuration Options Pegasus provides you with a number of controls for configuration of the system. For more information on each of the control settings, select the Contents menu item from the Help Manager's Options action. Note: All changes, with the exception of the Auto-Start options, take effect immediatley. ═══ 7.1. Help For Window Position Save ═══ Save Window Positions This option, when set, will cause Pegasus to save the last known positions of the active tables and graphs. When Pegasus is run again, all windows that are set for automatic open will re-appear in their last position. If not set for automatic open, the windows will appear in their last position when started from the View menu option. ═══ 7.2. Help For Process ID in hex ═══ Display Process ID in hexadecimal When this option is set, Pegasus will display the process id (PID) in hexadecimal instead of decimal. The hexadecimal display shows a 4 digit number. For example: The hexadecimal process id of : 0FD3 converts to (0x4096)+(15x256)+(13x16)+3 = 4051. ═══ 7.3. Help For System View Auto Start ═══ Auto Start Options Pegasus can automatically open the system resource monitor table when started. The system resource table is still available after startup from the Views action bar. ═══ 7.4. Help For I/O Display Auto Start ═══ Auto Start Options Pegasus can automatically open the I/O activity resource table when started. The I/O activity table is still available after startup from the Views action bar. ═══ 7.5. Help For Application View Auto Start ═══ Auto Start Options Pegasus can automatically open the Application resource table when started. The Application resource table is still available after startup from the Views action bar. ═══ 7.6. Help For Mini Monitor Auto Start ═══ Auto Start Options Pegasus can automatically open the Mini-monitor graph when started. The Mini-monitor can also be started from the Views action bar. ═══ 7.7. Help For Application Refresh ═══ Application Refresh Rate This option controls the frequency, in minutes, that Pegasus updates the Application Activity table. In addition to the automatic refreshes, the Application Activity panel is updated when : o When any process starts. o When any process ends. ═══ 7.8. Help For Sample Rate ═══ Sample Rate How often Pegasus updates the System and I/O Activity tables, and Mini-monitor graph, is based on the Sample Rate. Valid options are 5 Seconds, 1 Minute and 15 Minute intervals. ═══ 7.9. Help For Cpu Warning ═══ CPU Percent Warning This control determines when Pegasus should change the color of the CPU activity bar to red in the Mini-Monitor. Setting this to 0 will turn off color changes. ═══ 7.10. Help For RAM Warning ═══ RAM Used Percent Warning This control determines when Pegasus should change the color of the RAM used bar to red in the Mini-Monitor. Setting this to 0 will turn off color changes. ═══ 7.11. Help For Swap Percent Warning ═══ Swap Percent Warning This control determines when Pegasus should change the color of the Swap activity bar to red in the Mini-Monitor. Swap percent is that percentage of available space used by swapper.dat. The higher the value the less free space remains. Setting this to 0 will turn off color changes. ═══ 7.12. Help For Settings Reset ═══ Settings Reset This button will reset all changes made since the dialog box had been invoked. ═══ 8. Help For Pegasus Mini Monitor ═══ Pegasus Mini-Monitor The Mini-Monitor displays bar graphs for the following resources: o CPU Busy - The bar measures the percent CPU busy from 0 to 100%. o RAM Used - The bar measures the percent of total Physical (BLUE/RED) memory in use and the percent of Resident memory (GREEN). o Swap Used - The bar measures the percent of available space (BLUE/RED) consumed by swapper.dat and the percent that was originally allocated at boot time (GREEN). You can set when the bar color changes from blue to red (warning) from the Options->Configuration Dialog. Exception Log The Mini-Monitor maintains an exception log. This log can be displayed by double clicking on the client area of the Mini-Monitor with the Right Mouse Button. ═══ 9. Help For Exception Log ═══ Exception Log The Exception Log contains a list of exceptions that have been generated based on the warning thresholds as set in the Options->Configuration dialog. Exceptions are list by: 1. Time Stamp 2. Type ( Cpu, Ram, Swap ) 3. Threshold Exceeded ( set in Configuration ) 4. Current Value The list is added at the top, this way the most recent exceptions will be displayed. To save the data to an ascii text file, select the Save button. You will be prompted for a file name. Once the exceptions have been viewed or saved, you can clear the list by clicking on the Clear button. CAUTION: If there are a large number of exceptions and you do not clear them out from time to time Pegasus will begin to discard the messages. ═══ 10. Help For Working Set Dialog ═══ General This dialog allows you to track a single applications working set. A working set is defined as the amount of memory references over a period of time (working set interval) by the application. Note: Working set interval and sample rate are not the same. The working set interval is how many time tics qualify a memory page as part of the working set. The sample rate is how often do you want to update the display with this information. After setting the Working Set Interval and the Sample rate, and clicking the Start button, the display will begin to update the following: o Date-Time The date and time stamp of the Sample. o Now(k) The amount of memory accessed at the time of the Sample. o WS(k) The amount of memory found to be accessed within the Working Set Interval specified. o Accessed(k) Note: 1 k = 1024 bytes. ═══ 10.1. Help For WS Interval ═══ Working Set Interval In short, the working set interval determines the number of memory pages referenced over a period of time. For example, if you set this value to 3, the working set analysis will see how many pages have been referenced within the last 3 timer tics intervals. Use the Sample Rate to set how often you want the display updated. ═══ 10.2. Help For Working Set Sample Rate ═══ Working Set Sample Rate The working set sample rate determines how often the screen is updated with the analysis data. Each new sample is placed at the top of the screen to avoid scrolling. Use the Working Set Interval to set how many intervals should be considered in the working set analysis. ═══ 11. Help For Process Memory Dialog ═══ Process Memory This dialog displays per process memory usage information. A snapshot taken when the dialog is invoked and the user is warned that the dynamics of memory ownership are likely to change the values once the snapshot is taken. For each process in the system, the following information is provided: 1. Process Name 2. Process ID 3. Private Memory The amount of memory, in kilobytes, in the private arena of this process. If there are more than one process that has a map to this private page, the process with the lowest process id (PID) is charged with ownership. 4. Shared Memory The amount of memory, in kilobytes, from the shared arena owned by this process. ═══ ═══ Theseus/2 is copyright of IBM Corporation.