home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #1
/
monster.zip
/
monster
/
OS2
/
PEG110.ZIP
/
PEGASUS.ZIP
/
PEGASUS.HLP
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1994-03-08
|
19KB
|
537 lines
ΓòÉΓòÉΓòÉ 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.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
Theseus/2 is copyright of IBM Corporation.