home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / PEG110.ZIP / PEGASUS.ZIP / PEGASUS.INF (.txt) < prev    next >
OS/2 Help File  |  1994-03-08  |  96KB  |  921 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Notices ΓòÉΓòÉΓòÉ
  3.  
  4.                             Pegasus Resource Monitor
  5.                                   Pegasus Tools
  6.                              Version 1.0 Release 010
  7.                         (c) 1993,1994 C.O.L. Systems Inc.
  8.                                All Rights Reserved
  9.  
  10. C.O.L. Systems Inc. has been in the business of software development and 
  11. consulting since 1987. Our software has, and will continue to be, geared 
  12. towards performance and capacity management needs. 
  13.  
  14. From the standalone OS/2 station tools (Pegasus Resource Monitor and Pegasus 
  15. Tools) to heterogenous performance and capacity management (Osrm2*), we 
  16. continue to meet the users needs in sophisticated, low price, software. 
  17.  
  18. *Osrm2 (c) 1991,1994 C.O.L. Systems Inc. 
  19.  
  20. Contact and Support 
  21.  
  22. We have moved to a new location with new phones as well: 
  23.  
  24. Mailing Address: 
  25.  
  26.                                C.O.L. Systems Inc.
  27.                                10 Watergate Drive
  28.                                Amawalk, NY. 10501
  29.  
  30. Telephone Numbers for: 
  31.  
  32. Voice  -       (914) 245-0442
  33. FAX    -       (914) 245-0452
  34. BBS    -       (914) 245-1561
  35.  
  36. Other Notices 
  37.  
  38. OS/2 is copyright by IBM Corporation. 
  39.  
  40.  
  41. ΓòÉΓòÉΓòÉ 2. License and Warranty ΓòÉΓòÉΓòÉ
  42.  
  43. License Agreement and Warranty Disclaimer 
  44.  
  45. You should carefully read the following terms and conditions before using this 
  46. software.  Use of this software indicates your acceptance of these terms and 
  47. conditions. If you do not agree with them, do not use the software. 
  48.  
  49. Shareware Version 
  50.  
  51. You are hereby licensed to:  use the Shareware Version of the software for a 21 
  52. day evaluation period; make as many copies of the Shareware version of this 
  53. software and documentation as you wish; give exact copies of the original 
  54. Shareware version to anyone; and distribute the Shareware version of the 
  55. software and documentation in its unmodified form via electronic means.  There 
  56. is no charge for any of the above. 
  57.  
  58. You are specifically prohibited from charging, or requesting donations, for any 
  59. such copies, however made; and from distributing the software and/or 
  60. documentation with other products (commercial or otherwise) without prior 
  61. written permission from C.O.L. Systems Inc. 
  62.  
  63. Unregistered use of Pegasus after the 21-day evaluation period is in violation 
  64. of federal copyright laws. 
  65.  
  66. Evaluation and Registration 
  67.  
  68. This is not free software.  This license allows you to use this software for 
  69. evaluation purposes without charge for a period of 21 days.  If you use this 
  70. software after the 21 day evaluation period a registration fee is required as 
  71. described in Registration Forms. 
  72.  
  73. Quantity discounts are available, see the apporirate order form for details. 
  74.  
  75. One registered copy of Pegasus may be dedicated to a single person who uses the 
  76. software on one or more computers or to a single workstation used by multiple 
  77. people. You may access the registered version of Pegasus through a network, 
  78. provided that you have obtained individual license for the software covering 
  79. all workstations that will access the software through the network. 
  80.  
  81. Governing Law 
  82.  
  83. This agreement shall be governed by the laws of the State of New York. 
  84.  
  85. Disclaimer of Warranty 
  86.  
  87. This software and the accompanying files are sold "as is" and without 
  88. warranties as to performance of merchantability or any other warranties whether 
  89. expressed or implied.  Because of the various hardware and software 
  90. environments into which this program may be put, no warranty of fitness for a 
  91. particular purpose is offered. Good data processing procedure dictates that any 
  92. program be thoroughly tested with non-critical data before relying on it.  The 
  93. user must assume the entire risk of using the program.  Any liability of the 
  94. seller will be limited exclusively to product replacement or refund of purchase 
  95. price. 
  96.  
  97.  
  98. ΓòÉΓòÉΓòÉ 3. Registration Forms ΓòÉΓòÉΓòÉ
  99.  
  100. Registering Pegasus 
  101.  
  102. C.O.L. Systems Inc. will accept MasterCard, or Visa Credit Cards. 
  103.  
  104. C.O.L. Systems Inc. will accept checks or Money Orders in US funds only. 
  105.  
  106. After printing the appropriate form, mail it in with your payment ( or fax it 
  107. if registering by Credit Card ). 
  108.  
  109. o For General Registration, print and fill in the information and fax or mail 
  110.   the REGISTER.DOC file. 
  111.  
  112.   C.O.L. Systems Inc. maintains a Pegasus message and file area for registered 
  113.   users on it's BBS @(914) 245-1561. 
  114.  
  115. o For Os/2 Shareware BBS users, print, fill in the information and fax or mail 
  116.   the OS2SHARE.DOC file. 
  117.  
  118.   C.O.L. Systems Inc. maintains a Pegasus file area for registered users. Once 
  119.   we receive registration we will notify you via Os/2 Shareware private e-mail 
  120.   with the password to this file area. 
  121.  
  122. o For Pyramid/2 BBS users, print, fill in the information and fax or mail the 
  123.   REGISTER.DOC file. 
  124.  
  125.   C.O.L. Systems Inc. maintains a Pegasus file and message area for registered 
  126.   users. Once we have received registration we will have the Pyrmaid/2 sysop 
  127.   update your security level to proivde access to these areas. 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ 4. APAR Notices ΓòÉΓòÉΓòÉ
  131.  
  132. The following are APARS and associated fixes that may be required to run the 
  133. Pegasus Resource Monitor. These fixes are available from the IBM Corporation. 
  134.  
  135.  The following APARs apply to OS/2 2.0 plus Service Pak 1. 
  136.  
  137. o PJ06434 - Disk Device Driver 
  138.  
  139.   The fix concerns a problem where disk timers were getting corrupted. 
  140.  
  141. The following APARs apply to either OS/2 2.0 plus Service Pak 2 or OS/2 2.1. 
  142.  
  143. o PJ08459 - Occasional negative values for Process Page Fault Time. 
  144.  
  145.   Page Fault time is a metric which measures how much time a thread has spent 
  146.   waiting on a page fault.  This metric is part of the thread resource group. 
  147.   On a heavily loaded machine, this timer can go negative briefly. 
  148.  
  149. o PJ09410 - Trap E when collecting thread data on a busy system. 
  150.  
  151.   On a heavily loaded managed system with excessive thread activity, there is a 
  152.   potential for a TRAP E to occur while collecting application/process/thread 
  153.   level data. To avoid this trap, obtain the selective fix for APAR PJ09410. 
  154.  
  155. o PJ09893 - Trap D on dirty HPFS disk. 
  156.  
  157.   If you have HPFS installed, you may experience a trap D in OS2KRNL while 
  158.   collecting data.  The trap occurs if chkdsk was run during config.sys time. 
  159.   If you experience this problem, obtain the selective fix for APAR PJ09893. 
  160.  
  161. o PJ10475 - A variety of traps in OS2KRNL 
  162.  
  163.   During data collection on a heavily loaded machine. APAR PJ10475 fixes these 
  164.   traps. 
  165.  
  166. o APAR PJ10476 and PJ10275. 
  167.  
  168.   If you start and stop data collection more than 140 times without rebooting, 
  169.   OS/2 stops returning data.  To avoid this symptom, obtain the selective fix 
  170.   for APAR PJ10275 or PJ010476. 
  171.  
  172.  
  173. ΓòÉΓòÉΓòÉ 5. What is Pegasus? ΓòÉΓòÉΓòÉ
  174.  
  175. Pegasus ( The Greek Myth ) A winged horse that with a stroke of his hoof caused 
  176. the fountain Hippocrene to spring forth from Mount Helicon. 
  177.  
  178. Pegasus Resource Monitor ( The OS/2 Product ) A 32 bit application that with a 
  179. click of a mouse causes a fountain of performance statistics to spring forth 
  180. from Mount OS/2 2.x! 
  181.  
  182. The Pegasus Resource Monitor is a kernel level, real-time, Presentation Manager 
  183. monitoring tool for system and application resource usage under OS/2 2.x. 
  184. Including a configurable sample rate, thresholds settings, exception 
  185. notification and logging, working set analysis, kill process options, as well 
  186. as graphical indicators, the Pegasus Resource Monitor provides the most 
  187. comprehensive monitoring tool for OS/2. 
  188.  
  189.  
  190. ΓòÉΓòÉΓòÉ 6. The Interface ΓòÉΓòÉΓòÉ
  191.  
  192. Most of the control for Pegasus can be found in the main window. From here, you 
  193. can select different display and configuration options. The following shows the 
  194. main window with the System Activity view being selected. 
  195.  
  196. Accessing the Displays 
  197.  
  198. There are a number of views and a graph display that can be opened at the same 
  199. time. Click or press enter with one of the following to learn more about 
  200. Pegasus Views: 
  201.  
  202. o System Activity 
  203.  
  204. o I/O Activity 
  205.  
  206. o Application Activity 
  207.  
  208. o Per Process Memory 
  209.  
  210. o Mini-Monitor 
  211.  
  212. Configuring the system 
  213.  
  214. You can change most of the behaviour of the Pegasus resource monitor by 
  215. selecting Options->Configuration from the main menu actions. 
  216.  
  217. More information about configuring the system can be found in Configuring 
  218. Pegasus. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 6.1. System Activity View ΓòÉΓòÉΓòÉ
  222.  
  223. The System Activity View displays general system resources in a detail 
  224. container format as shown in the following example. Fields are described below 
  225. this picture. 
  226.  
  227. To start the system view select Views->System Activity from the main menu. 
  228. Depending on the refresh rate, as set in the configuration, the system view 
  229. will begin updating in 5 seconds, 1 minute, or 15 minutes. 
  230.  
  231. The system view consists of five (5) rows of information. There are a number of 
  232. columns that pertain to each of the five rows, and some of these columns are 
  233. overlapped, as will be described: 
  234.  
  235. o Cpu This row has two (2) fields: 
  236.  
  237.     1. Busy - The percentage of the sample interval that the system was 
  238.        performing work. 39% busy in the example 
  239.  
  240.     2. Count - The task dispatch count during the measured interval. 405 times 
  241.        in the example. 
  242.  
  243. o Irq This row has two (2) fields: 
  244.  
  245.     1. Busy - The percentage of the sample interval that the system was busy 
  246.        servicing interrupts. 9% busy in the example 
  247.  
  248.     2. Count - The interrupt dispatch count during the measured interval. 
  249.        1,670 times in the example. 
  250.  
  251. o Page In This row has three (3) fields: 
  252.  
  253.     1. Count - The number of pages that were swapped in from disk in the sample 
  254.        interval. 0 in this example. 
  255.  
  256.     2. Fault - The number of page faults that occured in the sample interval. 
  257.        268 in this example. 
  258.  
  259.     3. Demand - The number of pages demand loaded from disk during sample 
  260.        interval. 136 in this example. 
  261.  
  262. o Page Out This row has three (3) fields: 
  263.  
  264.     1. Count - The number of pages that were swapped out to disk in the sample 
  265.        interval. 0 in this example. 
  266.  
  267.     2. Discards - The number of pages that were discarded during the sample 
  268.        interval. 0 in this example. 
  269.  
  270.     3. Reclaims - The number of pages that were reclaimed for use during the 
  271.        sample interval 28 in this example. 
  272.  
  273. o Memory This row has five (5) fields: 
  274.  
  275.     1. Resident - The number of pages in memory that are in the 
  276.        non-swappable/non-discardable arena. 753 in this example. 
  277.  
  278.     2. Free - The number of pages in physical memory that are available for 
  279.        use. 859 in this example. 
  280.  
  281.     3. Used - The number of pages, in physical memory, that are in use. 3,122 
  282.        in this example. 
  283.  
  284.     4. Idled - The number of pages, in physical memory, that are marked idle. 
  285.        32 in this example. 
  286.  
  287.     5. Reassigned - The number of idled pages that were reassigned for use by 
  288.        another process. 351 in this example. 
  289.  
  290.  
  291. ΓòÉΓòÉΓòÉ 6.2. I/O Activity View ΓòÉΓòÉΓòÉ
  292.  
  293. The I/O Activity View displays I/O event measurements in a detail container 
  294. format as shown in the following example. Fields are described below this 
  295. picture. 
  296.  
  297. To start the I/O view select Views->I/O Activity from the main menu. Depending 
  298. on the refresh rate, as set in the configuration, the I/O view will begin 
  299. updating in 5 seconds, 1 minute, or 15 minutes. 
  300.  
  301. The I/O view displays each of the I/O devices found on the system. These can 
  302. consist of: 
  303.  
  304. o Floppy disk drives 
  305.  
  306. o Local Disk Partitions (FAT or HPFS) 
  307.  
  308. o Com Ports 
  309.  
  310. o Printer Ports 
  311.  
  312. For each of the devices listed above, the following fields are maintained: 
  313.  
  314. o Read Activity 
  315.  
  316.     1. Read Events - The number of read I/O events for this device in the 
  317.        sample interval. 
  318.  
  319.     2. Read Response Average - The average read response time for this device. 
  320.  
  321.     3. Average Bytes Per Read Event - The average number of bytes read per read 
  322.        event. 
  323.  
  324. o Write Activity 
  325.  
  326.     1. Write Events - The number of write I/O events for this device in the 
  327.        sample interval. 
  328.  
  329.     2. Write Response Time Average - The average write response time for this 
  330.        device. 
  331.  
  332.     3. Average Bytes Per Write Event - The average number of bytes read per 
  333.        read event. 
  334.  
  335. Note:  Printer devices will not report read activty. 
  336.  
  337. In addition to these measurements, local disk partition storage is displayed 
  338. for 1 and 15 minute sample rates. These measurements include: 
  339.  
  340. o Storage 
  341.  
  342.     1. Used - The number of megabytes on the partition that are allocated. 
  343.  
  344.     2. Avail - The number of megabytes on the partition that are still 
  345.        available. 
  346.  
  347.  
  348. ΓòÉΓòÉΓòÉ 6.3. Application Activity View ΓòÉΓòÉΓòÉ
  349.  
  350. The Application Activity View displays summary information for each process on 
  351. the system in a detail container format as shown in the following example. 
  352. Fields are described below this picture. 
  353.  
  354. To start the Application view select Views->Application Activity from the main 
  355. menu. Depending on the refresh rate, as set in the configuration, the 
  356. Application view will begin updating in 1 to 60 minutes. 
  357.  
  358. In addition to the display description, you can learn how to Sort the display 
  359. and how to Run a Working Set Analysis or Kill runaway or background processes. 
  360.  
  361. The Application view displays each process found in the system. For each 
  362. process the following fields are maintained: 
  363.  
  364. o General Information 
  365.  
  366.     1. Process Name - This is the name of the process module. Similar to the 
  367.        results of running PSTAT, but without the fully qualified path. 
  368.  
  369.     2. Process ID - This is the process id number assigned to the process by 
  370.        the system. 
  371.  
  372. o Activity Information 
  373.  
  374.     1. Threads - This is the total number of threads found in the process 
  375.        during the sample interval. 
  376.  
  377.     2. CPU Utilization - This is the percent system utilization by this process 
  378.        during the sample interval. 
  379.  
  380.     3. Dispatch Counts - This is the total number of times the process was 
  381.        dispatched during the sample interval. 
  382.  
  383.     4. Page Faults - This is the total number of page faults for the process 
  384.        during the sample interval. 
  385.  
  386.     5. Page Fault Wait Time - This is the amount of time the process spent 
  387.        waiting for a memory page fault to be resolved. 
  388.  
  389.     6. File I/O Wait Time - This is the amount of time the process spent 
  390.        waiting for a file I/O event to complete. 
  391.  
  392. o I/O Activity 
  393.  
  394.     1. Reads - This is the total number of file read I/O events during the 
  395.        sample interval. 
  396.  
  397.     2. Writes - This is the total number of file write I/O events during the 
  398.        sample interval. 
  399.  
  400.  
  401. ΓòÉΓòÉΓòÉ 6.3.1. Sort Options ΓòÉΓòÉΓòÉ
  402.  
  403. The Application activity screen provides a number of sort options as shown 
  404. below. 
  405.  
  406. To activate the sort menu, click anywhere within the Application activity 
  407. client area with the right mouse button (RMB). The following sort options are 
  408. available: 
  409.  
  410. o Process Id 
  411.  
  412. o Process Name 
  413.  
  414. o Cpu Utilization 
  415.  
  416. o Dispatch Count 
  417.  
  418. o Thread Count 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ 6.3.2. Run a Working Set Analysis ΓòÉΓòÉΓòÉ
  422.  
  423. Note:  This option requires that the IBM Theseus/2 version 2.0v is installed on 
  424. the machine. Although this package has been found on many OS/2 BBS, it is 
  425. really part of a commercial product. C.O.L. Systems Inc. has aquired the rights 
  426. to sell the Theseus/2 2.0v library component for an additional $75.00. If you 
  427. would like to order a copy of the IBM Theseus/2 library, contact C.O.L. Systems 
  428. Inc. at (914) 245-0442. 
  429.  
  430. By double clicking on an active process, and selecting the Working Set Analysis 
  431. popup menu option, you can generate a report on how much memory an application 
  432. uses over time. 
  433.  
  434. An applications working set is those pages of memory that the application 
  435. references (reads or writes) over a period of time. The following example shows 
  436. the Workplace Shell component being monitored. A description follows the 
  437. picture. 
  438.  
  439. Working Set Interval 
  440.  
  441. You must set how many timer tic intervals are used to determine the working 
  442. set. For example, if you selected 3 then at every Sample time the application 
  443. will be checked for memory referenced over the past 3 timer tics. Even though 
  444. the range is from 3 - 45, setting this value low will potentially mask out the 
  445. dynamic memory reference for the process. 
  446.  
  447. Sample Rate 
  448.  
  449. This value controls how often the working set analyzer is called to calculate 
  450. new values and display them on the screen. Valid range is from 3 to 50 seconds. 
  451.  
  452. The Display 
  453.  
  454. As the working set analysis runs, the display is updated with the following 
  455. information: 
  456.  
  457.      o Date-Time - The date and time stamp for the sample. The most recent 
  458.        sample is placed at the top. 
  459.  
  460.      o Now(k) - How much memory was referenced in the current interval. 
  461.  
  462.      o WS(k) - How much memory was referenced in the past Working Set Interval. 
  463.  
  464.      o Accessed(k) - How much memory has been referenced since the analysis was 
  465.        started. 
  466.  
  467.  Note:  1 k = 1024 bytes of memory 
  468.  
  469.  Button Controls 
  470.  
  471.      There are a number of buttons to use with the Working Set Analysis: 
  472.  
  473.           o Start - Once you have configured the Interval and Sample rates, 
  474.             click this button to begin the analysis. 
  475.  
  476.           o Stop - To stop the analysis at anytime, select this button. Also, 
  477.             closing the analysis window will stop the sampleing as well but you 
  478.             won't be able to save the report. 
  479.  
  480.           o Save... - Once you have Stopped the sampling, you can save the 
  481.             report to an ascii disk file. When clicked, a file dialog will 
  482.             appear. 
  483.  
  484.             Note:  This button is only active once  you have accumulated 
  485.             samples. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 6.3.3. Kill Application Function ΓòÉΓòÉΓòÉ
  489.  
  490. By double clicking on an active process, and selecting the Kill Process popup 
  491. menu option, you can attempt to kill that process. This may or may not work as 
  492. described in the note at the end of this page. 
  493.  
  494. Killing a process is not the ideal way to shut it down. If possible, you should 
  495. use the applications close function. On the otherhand, the kill function is 
  496. ideal for background processes that don't have a keyboard or mouse interface. 
  497.  
  498. A message box will appear to confirm the request and will display the process 
  499. name that you selected. 
  500.  
  501. Note:  As mentioned, killing a process may not work if the process has 
  502. registered a signal handler. The process may choose to ignore this signal. 
  503.  
  504.  
  505. ΓòÉΓòÉΓòÉ 6.4. Per Process Memory ΓòÉΓòÉΓòÉ
  506.  
  507. Pegasus now provides a function for displaying the private and shared memory 
  508. allocated per process. 
  509.  
  510. Note:  This option requires that the IBM Theseus/2 version 2.0v is installed on 
  511. the machine. Although this package has been found on many OS/2 BBS, it is 
  512. really part of a commercial product. C.O.L. Systems Inc. has aquired the rights 
  513. to sell the Theseus/2 2.0v library component for an additional $75.00. If you 
  514. would like to order a copy of the IBM Theseus/2 library, contact C.O.L. Systems 
  515. Inc. at (914) 245-0442. 
  516.  
  517. The Display 
  518.  
  519. Once the Per Process memory option runs, the display is updated with the 
  520. following information: 
  521.  
  522.      o Process Name - The names of each process found in the system. 
  523.  
  524.      o PID - The process id (PID) which is related to the process. 
  525.  
  526.      o Private(k) - How much memory is allocated from the private memory pool 
  527.        by each process. 
  528.  
  529.      o Shared(k) - How much memory is allocated from the shared memory pool by 
  530.        each process. 
  531.  
  532.  Note:  1 k = 1024 bytes of memory 
  533.  
  534.  Button Controls 
  535.  
  536.      o Save... - You can save the report to an ascii disk file. When this 
  537.        button is clicked a file save dialog will appear. 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 6.5. The Mini-Monitor ΓòÉΓòÉΓòÉ
  541.  
  542. The Mini-Monitor Graph displays key system resources as bars in a graph window 
  543. as shown in the following example. Fields are described below this picture. 
  544.  
  545. The Mini-Monitor resides in it's own window on the desktop. It is common to 
  546. have the Mini-Monitor running and placed in a corner of the desktop, while the 
  547. Pegasus main window is iconized. If some measure of activity displayed in the 
  548. Mini-Monitor are of concern, then you just click on the Pegasus icon to restore 
  549. it and view detailed measurement information. There is less overhead in running 
  550. this way as well! 
  551.  
  552. To start the Mini-Monitor graph select View->Mini-Monitor from the main menu 
  553. bar. The refresh rate for the Mini-Monitor is the same as for the system record 
  554. refresh. 
  555.  
  556. The Mini-Monitor consists of three (3) key resources: 
  557.  
  558.   1. CPU - This is a bar graph of system utilization as measured during the 
  559.      sample interval. By default this bar will be BLUE. If the CPU utilization 
  560.      is equal to or exceeds a user configured threshold, then this bar will be 
  561.      RED. 
  562.  
  563.      Next to the CPU legend is a numeric indication of the percent CPU busy, 
  564.      where 0.10 = ten percent, etc. 
  565.  
  566.   2. RAM - This is a multi-informational bar. This first indicator is colored 
  567.      GREEN, this portion of the bar represents the percent of total physical 
  568.      memory that is marked as resident.Resident storage is non-swappable and 
  569.      non-discardable. The second portion of the bar represents the percent of 
  570.      total physical memory that is in use. By default this bar will be BLUE, 
  571.      unless a threshold has been met or exceeded in which case it will be RED. 
  572.  
  573.      Next to the RAM legend is a numeric indication of the percent RAM in use, 
  574.      where 0.10 = ten percent, etc. 
  575.  
  576.   3. SWP - Like the RAM bar, this is multi-informational. The first indicator 
  577.      represents the percent of calculated swap storage that was pre-allocated 
  578.      at boot time. This is based on the size defined in your config.sys file. 
  579.      The second portion of the bar represents the percent of calculated swap 
  580.      storage that is currently in use by swapper.dat 
  581.  
  582.      Next to the SWP legend is a numeric indication of the percent of 
  583.      calculated disk storage is used by swapper.dat, where 0.10 = ten percent, 
  584.      etc. 
  585.  
  586.      Note:  Calculated space is defined as the current swap file size plus the 
  587.      available space on the partition where the swap file resides. 
  588.  
  589.  As mentioned, each of the Mini-Monitor resources can show when a threshold is 
  590.  met or exceeded. The thresholds are defined in the Configuration Dialog When a 
  591.  bar turns RED, indicating a threshold exception has occured, the information 
  592.  is recorded to an in-memory exception log. This log can be viewed by double 
  593.  clicking the Mini-Monitor window with the right mouse button (RMB). See The 
  594.  Exception Log for more information on this dialog. 
  595.  
  596.  
  597. ΓòÉΓòÉΓòÉ 6.5.1. The Exception Log ΓòÉΓòÉΓòÉ
  598.  
  599. The Exception Log Dialog maintains a list of exceptions that met or passed the 
  600. threshold as set in the Options->Configuration panel. An example log is shown 
  601. and the entries are described below this picture. 
  602.  
  603. As new exceptions occur, they are added to the top of the list (most recent 
  604. first). Each entry consists of the folowing form: 
  605.  
  606. At hh:mm:ss : RESOURCE Measured XX Threshold YY
  607.  
  608. where: 
  609.  
  610.  o hh:mm:ss is the time stamp that the exception was received. 
  611.  
  612.  o RESOURCE is the resource for which this exception occured. It can be any one 
  613.    of: 
  614.  
  615.     - CPU 
  616.  
  617.     - RAM 
  618.  
  619.     - SWP 
  620.  
  621.  o XX is the resources actual measured value. 
  622.  
  623.  o YY is the threshold as set in the configuration options. 
  624.  
  625.  
  626. ΓòÉΓòÉΓòÉ 6.6. Configuring Pegasus ΓòÉΓòÉΓòÉ
  627.  
  628. There are a number configuration options available from the 
  629. Options->Configuration menu item. Most of the options go into effect as soon as 
  630. the Save button is clicked, others take effect when Pegasus is restarted. 
  631.  
  632. The Configuration Panel has a display of what the option controls look like. 
  633.  
  634.  
  635. ΓòÉΓòÉΓòÉ 6.6.1. The Configuration Panel ΓòÉΓòÉΓòÉ
  636.  
  637. The following is an example of the Pegasus Configuration Options dialog window. 
  638. Descriptions for each of the settings can be found after the picture. 
  639.  
  640. Detailed descriptions can be found in: 
  641.  
  642. Window Actions 
  643.  
  644. Refresh Rates 
  645.  
  646. Threshold Levels 
  647.  
  648. Control Buttons 
  649.  
  650.  
  651. ΓòÉΓòÉΓòÉ 6.6.2. Setting Automatic Window Actions ΓòÉΓòÉΓòÉ
  652.  
  653. There are two (2) types of window actions that can be configured: 
  654.  
  655.   1. Save Window Positions - This option, when set, will record all the open 
  656.      Pegasus Views and Mini-Monitor graph position and size information. 
  657.  
  658.   2. Auto Start - These options control which windows should be automatically 
  659.      opened when Pegasus is loaded. 
  660.  
  661.  
  662. ΓòÉΓòÉΓòÉ 6.6.3. Setting Sample Refresh Rates ΓòÉΓòÉΓòÉ
  663.  
  664. There are two (2) sample rates that can be configured in Pegasus: 
  665.  
  666.   1. System Refresh - This identifies the rate at which samples are taken for 
  667.      the System Activity, I/O Activity, and the Mini-Monitor. Valid settings 
  668.      for this value are 5 second, 1 minute, and 15 minute intervals. 
  669.  
  670.   2. Application Refresh - This identifies the rate at which samples are taked 
  671.      for the Application Activity View. 
  672.  
  673.  
  674. ΓòÉΓòÉΓòÉ 6.6.4. Setting Threshold Levels ΓòÉΓòÉΓòÉ
  675.  
  676. There are three (3) threshold percentages that can be set: 
  677.  
  678.   1. Cpu Busy Warning - This indicates the percent CPU busy that should 
  679.      generate an exception if met or exceeded. 
  680.  
  681.   2. Ram Used Warning - This indicates the percent of physical memory, when 
  682.      used, that should generate an exeption. 
  683.  
  684.   3. Swap Used Warning - This indicates the percentage of calculated swap 
  685.      space, when used by swapper.dat, that should generate an exception. 
  686.  
  687.  
  688. ΓòÉΓòÉΓòÉ 6.6.5. Control Buttons ΓòÉΓòÉΓòÉ
  689.  
  690. The control button on the bottom of the configuration dialog will: 
  691.  
  692.  o Save - Any changes you have made in the dialog. 
  693.  
  694.  o Reset - Reset the dialog to the settings before any changes made. 
  695.  
  696.  o Help - Display the general help window for the dialog. In addition, context 
  697.    sensitive help is available for any of the configuration controls by 
  698.    pressing the F1 key when the control in question has the focus. 
  699.  
  700.  You can also Cancel the dialog by double clicking on the system menu for the 
  701.  configuration dialog. 
  702.  
  703.  
  704. ΓòÉΓòÉΓòÉ 7. History Of Changes ΓòÉΓòÉΓòÉ
  705.  
  706. Version 1 Release 10 
  707.  
  708.   1. Dramatic reduction in overhead used by Pegasus. This is primarily the 
  709.      benefit of changing from a floating point collection engine to an integer 
  710.      engine. Over 90% improvement on non-x87 machines. 
  711.  
  712.   2. Changes to handling of non-OS/2 processes in application activity view. 
  713.      Checking is now performed for PMSHELL validation or VDM. 
  714.  
  715.   3. Addition of Per Process memory usage display and report. This feature 
  716.      requires the IBM Theseus/2 installed. 
  717.  
  718.   4. Added configuration option for displaying process ids (PIDs) in hex or 
  719.      decimal. 
  720.  
  721.  Version 1 Release 9 
  722.  
  723.   1. If detect IBM Theseus/2 installed will allow working set analysis on a 
  724.      running process. See Run a Working Set Analysis for more information. 
  725.  
  726.   2. Changed double click action in Application Activity. Now pops up menu of 
  727.      choices (Working Set Analysis, Kill Process). 
  728.  
  729.   3. Added Exception Log save option. 
  730.  
  731.   4. Updated on-line help and documentation. 
  732.  
  733.  Version 1 Release 8 A 
  734.  
  735.  Refresh of PEGASUS.EXE only. 
  736.  
  737.   1. Modified Pegasus.Exe to track DOS and/or Window apps by their right name 
  738.      in the Application Activity View. 
  739.  
  740.  Version 1 Release 8 
  741.  
  742.   1. Added text indicators next to Mini-Monitor graph bars. 
  743.  
  744.   2. Extended discount program to Os/2 Shareware BBS 
  745.  
  746.   3. Provided ability to register by Credit Card. 
  747.  
  748.  Version 1 Release 7 
  749.  
  750.   1. New collection engine. 
  751.  
  752.   2. New documentation in OS/2 INF format. 
  753.  
  754.   3. Change to the configuration dialog provides more intuitive save and cancel 
  755.      procedures. 
  756.  
  757.   4. Loss of IO events corrected. 
  758.  
  759.   5. Abend when opening I/O Monitor window with certain CD-ROM or re-directed 
  760.      drive configurations corrected. 
  761.  
  762.   6. Abend when opening Exception Log Dialog corrected. 
  763.  
  764.  Version 1 Release 5 
  765.  
  766.   1. Mini-Monitor Exception Log 
  767.  
  768.   2. Modified on-line help. 
  769.  
  770.  Version 1 Release 4.B 
  771.  
  772.   1. Application Kill Process option added to Application View. 
  773.  
  774.   2. Added SWAP SPACE measurements to the Mini-Monitor. 
  775.  
  776.   3. Modified configuration options. 
  777.  
  778.  Version 1 Release 4.0 
  779.  
  780.   1. Application screen sort options. 
  781.  
  782.   2. Added the resident memory (NONSWAP/NONDISCARD) percent to the Ram bar in 
  783.      the Mini-Monitor. 
  784.  
  785.   3. Modified on-line help. 
  786.  
  787.  Version 1 Release 3.0R 
  788.  
  789.   1. Autosave and restore of last known window positions. 
  790.  
  791.   2. Mini-Monitor Added. 
  792.  
  793.   3. Enhanced configuration options. 
  794.  
  795.   4. Improved on=line help system. 
  796.  
  797.  Version 1 Release 3.0 
  798.  
  799.   1. Removal of two (2) dynamic link library and one (1) executable as we have 
  800.      integrated the main collection code into the Pegasus executable. 
  801.  
  802.   2. Corrected random traps in the OS2DCF.EXE. 
  803.  
  804.  
  805. ΓòÉΓòÉΓòÉ 8. Frequently Asked Question (FAQ) ΓòÉΓòÉΓòÉ
  806.  
  807. This section provides answers to many of the questions often asked about the 
  808. Pegasus Resource Monitor. We have organized the questions into relative 
  809. sections and made reference to supporting areas of the Pegasus Resource Monitor 
  810. when applicable. 
  811.  
  812. The following sections can be linked to from here: 
  813.  
  814.  o FAQ about Memory 
  815.  
  816.  o FAQ About I/O 
  817.  
  818.  o FAQ About Application Activity 
  819.  
  820.  
  821. ΓòÉΓòÉΓòÉ 8.1. FAQ about Memory ΓòÉΓòÉΓòÉ
  822.  
  823. This section answers questions about system memory. 
  824.  
  825. Q: What is a page? 
  826. A: A page is a fixed length block of storage that is transfered as a unit 
  827. between physical memory and disk. In OS/2 2.x, a page is 4096 bytes in size. 
  828.  
  829. Q: What is a page event? 
  830. A: A page event is when the memory management of OS/2 either writes the 
  831. contents of a memory page to the swapper.dat file to make room for other 
  832. process memory requirements, or when a process references a page (page fault) 
  833. that is not longer in memory and it must be paged, or read, back in. 
  834.  
  835. Typically only data, not executable, memory is paged out. As OS/2 prohibits 
  836. executable pages from being modified, the system can re-read the contents of a 
  837. discarded code page back in from the EXE file. 
  838.  
  839. Note:  Page In and Page Out events can be monitored in the System Activity View 
  840. of Pegasus. 
  841.  
  842.  Q: What is a page fault? 
  843. A: A page fault is an exception that occurs when a process references a page of 
  844. memory that is not present. This can be due to one of the following: 
  845.  
  846.   1. The original contents of that page of memory had been swapped out to make 
  847.      room for other processes memory. In this case, the memory manager swaps 
  848.      the page back in. 
  849.  
  850.   2. The original contents of that page have been discarded. 
  851.  
  852.  Note:  The number of Page faults for the system can be monitored in the System 
  853.  Activity View, and page faults per process can be monitored in the Application 
  854.  Activity View of Pegasus. 
  855.  
  856.  Q: What is a resident page? 
  857.  A: A resident page of memory is a page that is never paged out or discarded. 
  858.  For the most part, this area of memory remains fixed. Typically this area 
  859.  contains operating system allocated areas, device driver allocated areas, 
  860.  cache buffers, etc.. 
  861.  
  862.  Note:  Resident pages are monitored in either the System Activity View or 
  863.  Mini-Monitor of Pegasus. 
  864.  
  865.  Q: What is a reclaimed event? 
  866.  A: Pages of memory become candidates for a page out event based on the 
  867.  frequency of use. Before a page is physically paged out it is placed in the 
  868.  idle page queue. If a process references that page, and it is not yet paged 
  869.  out, it is reclaimed from the idle list. 
  870.  
  871.  Note:  Page reclaims can be monitored on the Page Out row of the System 
  872.  Activity View in Pegasus. 
  873.  
  874.  Q:Right after bootup I show a large portion of memory as being used, but I 
  875.  don't have much running. 
  876.  A: When the operating system first loads, it uses as much memory as it needs. 
  877.  Much of this memory is taken up by parts of the operating system that are 
  878.  pageable or discardable. As soon as you start running other processes the 
  879.  oldest non-referenced pages are the first to be swapped or discarded. 
  880.  
  881.  
  882. ΓòÉΓòÉΓòÉ 8.2. FAQ About I/O ΓòÉΓòÉΓòÉ
  883.  
  884. This section answers questions about I/O. 
  885.  
  886. Q:The disk storage indicators on the I/O Monitor window are not updating, why? 
  887. A: Disk storage is scanned once a minute, you probably have your system refresh 
  888. set at 5 seconds. 
  889.  
  890. Q:I never see my COM devices update even though I run many communications 
  891. programs 
  892. A:Check your config.sys. If you are running SIO versus the IBM supplied com 
  893. drivers you will not see I/O for com ports as the SIO driver does not contain 
  894. the performance hooks neccessary to track activity. 
  895.  
  896. Q:What format are the response fields in? 
  897. A: These fields are response time average in milleseconds. 
  898.  
  899. Q:What format are the byte fields in? 
  900. A: These fields are bytes per I/O average. 
  901.  
  902. Q:What format is the disk storage fields? 
  903. A: These fields are used and available storage in megabytes. 
  904.  
  905.  
  906. ΓòÉΓòÉΓòÉ 8.3. FAQ About Application Activity ΓòÉΓòÉΓòÉ
  907.  
  908. This section answers question about Application Activity. 
  909.  
  910. Q:Sometimes the application thread count goes to zero (0) and on the next 
  911. refresh it disappears. 
  912. A: This occurs when we detect that an application has ended. We felt that 
  913. rather than remove it as soon as it ends, we would leave it displayed so that 
  914. the last measurements before process end could be viewed. 
  915.  
  916. Q:There are two (2) entries for PMSHELL in my application display, is this 
  917. right? 
  918. A: Yes! The first entry, or lowest process id if you are sorting differently, 
  919. is the actual PM Shell, the second is the Workplace Shell. 
  920.  
  921.