home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / system / pegasus / pegasus.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1994-03-08  |  18.9 KB  |  537 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. General Help ΓòÉΓòÉΓòÉ
  3.  
  4. General Pegasus Help 
  5.  
  6. Pegasus (The Greek Myth) A winged horse that with a stroke of his hoof caused 
  7. the fountain Hippocrene to spring forth from Mount Helicon. 
  8.  
  9. Pegasus Resource Monitor (The Product) A 32 bit application that with a click 
  10. of a mouse causes a fountain of performance statistics to spring forth from 
  11. Mount OS/2 2.x! 
  12.  
  13. Unlike other OS/2 system monitors, the measurements in Pegasus come directly 
  14. from the operating system. This provides accurate measurement data as opposed 
  15. to 'approximated' information found in other monitor systems. 
  16.  
  17. In addition, Pegasus can be upgraded to the C.O.L. Systems Inc. network 
  18. performance and capacity management tool Osrm2 Version 2.0. As a matter of 
  19. fact, Osrm2 uses the same data collection as Pegasus 
  20.  
  21.  
  22. ΓòÉΓòÉΓòÉ 2. Help For Per Process Memory ΓòÉΓòÉΓòÉ
  23.  
  24. Per Process Memory 
  25.  
  26. This option displays a dialog box which details, per running process on the 
  27. system, memory utilization. 
  28.  
  29. Included in the statistics are: 
  30.  
  31. Note:  This option is only available if the IBM Theseus/2 product is loaded. 
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 3. Help For Mini Monitor ΓòÉΓòÉΓòÉ
  35.  
  36. General 
  37.  
  38. The MiniMonitor is a graphical representation of the following key metrics: 
  39.  
  40. o CPU Percent Busy 
  41.  
  42. o Free Memory 
  43.  
  44. o Drive Storage Available ( By Partition ) 
  45.  
  46. Note:  This option is only available with registered copies of Pegasus 1.0. 
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 4. Help For System Activity ΓòÉΓòÉΓòÉ
  50.  
  51. System Activity 
  52.  
  53. This windows displays the system activity table. The table consists of metrics 
  54. for global resources such as CPU, Paging, and Memory. 
  55.  
  56. The CPU metrics contain: 
  57.  
  58. o Cpu Utilization - The percentage of time that the system was busy performing 
  59.   work during the interval. 
  60.  
  61. o Dispatch Counts - The number of times a thread was scheduled during this 
  62.   interval. 
  63.  
  64. o Irq Utilization - The percentage of time spent servicing interupts. 
  65.  
  66. o Irq Service Counts - The number of interupts that were serviced during this 
  67.   interval. 
  68.  
  69. The Paging and Memory metrics values, with the exception of PageIn and PageOut 
  70. counts, are displayed in pages. A page represents 4,096 bytes of memory. 
  71.  
  72. The Paging metrics contain: 
  73.  
  74. o PageIn Count - The number of pages swapped in from the swapper.dat file. 
  75.  
  76. o Page Faults - The number of times a page 'miss' occured. This is denoted as 
  77.   Flt in the PageIn row. 
  78.  
  79. o Page Demand - The number of pages demand loaded from disk. This is denoted as 
  80.   Dmd in the PageIn row. 
  81.  
  82. o PageOut Count - The number of pages swapped out to the swapper.dat file. 
  83.  
  84. o Page Discard - The number of pages discarded. This is denoted as Dsc in the 
  85.   PageOut row. 
  86.  
  87. o Page Reclaim - The number of pages reclaimed. This is denoted as Rcl in the 
  88.   PageOut row. 
  89.  
  90. The Memory metrics include: 
  91.  
  92. o Resident - The number of resident pages. A resident page is a page that can 
  93.   not be swapped. 
  94.  
  95. o Free - The number of free pages. A free page is a page not currently in use. 
  96.  
  97. o Used - The number of used pages. Used pages include resident pages as well. 
  98.  
  99. o Idled - The number of idled pages. Idle pages are pages that have not been 
  100.   recently. 
  101.  
  102. o Reassigned - The number of pages re-assigned. 
  103.  
  104.  
  105. ΓòÉΓòÉΓòÉ 5. Help For Application Activity ΓòÉΓòÉΓòÉ
  106.  
  107. Application Activity 
  108.  
  109. The table contains per process resource usage measured between Application 
  110. Refresh Intervals as set in the configuration dialog. 
  111.  
  112. o Name - Name of the executing process. 
  113.  
  114. o PID - System assigned process ID. 
  115.  
  116. o Thrds - The number of current threads in this process. 
  117.  
  118. o Cpu % - The system busy percentage as measured for this process. 
  119.  
  120. o Disp - The number of times this process was dispatched in the last interval. 
  121.  
  122. o Flts - The number of page faults that occured for this process during the 
  123.   last interval. 
  124.  
  125. o PWait - The amount of time, in milleseconds, that this process spent waiting 
  126.   for a memory page fault to resolve. 
  127.  
  128. o FWait - The amount of time, in milleseconds, that this process spent waiting 
  129.   for file I/O. 
  130.  
  131. o Reads - The total number of disk I/O read events. 
  132.  
  133. o Writes - The total number of disk I/O write events. 
  134.  
  135. Sort Options 
  136.  
  137. You can change the sort order of the window by clicking on the right mouse 
  138. button when the mouse pointer is in the application table area. You can select 
  139. from: 
  140.  
  141. o Process ID (default) 
  142.  
  143. o Process Name 
  144.  
  145. o Process CPU Utilization 
  146.  
  147. o Process Dispatch Counts 
  148.  
  149. o Process Active Threads 
  150.  
  151. Per Process Options 
  152.  
  153. There are additional procedures for each application that can be performed. By 
  154. double clicking on an application that is active with the Left Mouse Button, or 
  155. selecting it with the keyboard and pressing Enter, you can select from: 
  156.  
  157. o Generate a working set report - This option requires that the IBM Theseus/2 
  158.   product is installed. 
  159.  
  160. o Kill An Application - This option allows you to terminate a running process. 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ 5.1. Help For Sort By Process ID ΓòÉΓòÉΓòÉ
  164.  
  165. Sort By Process ID 
  166.  
  167. This option will sort the applications screen by Process ID (PID). 
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ 5.2. Help For Sort By Process Name ΓòÉΓòÉΓòÉ
  171.  
  172. Sort By Process Name 
  173.  
  174. This option will sort the applications screen by Process Name. 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ 5.3. Help For Sort By Utilization ΓòÉΓòÉΓòÉ
  178.  
  179. Sort By Utilization 
  180.  
  181. This option will sort the applications by the measured percent busy from the 
  182. last measurement. 
  183.  
  184.  
  185. ΓòÉΓòÉΓòÉ 5.4. Help For Sort By Dispatch Count ΓòÉΓòÉΓòÉ
  186.  
  187. Sort By Dispatch Count 
  188.  
  189. This option will sort the applications by the dispatch count from the last 
  190. measurement. 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 5.5. Help For Sort By Threads ΓòÉΓòÉΓòÉ
  194.  
  195. Sort By Threads 
  196.  
  197. This option will sort the applications by the active thread count from the last 
  198. measurement. 
  199.  
  200.  
  201. ΓòÉΓòÉΓòÉ 5.6. Help For Application Working Set ΓòÉΓòÉΓòÉ
  202.  
  203. Application Working Set 
  204.  
  205. This option can be used if Pegasus detects that Theseus/2 is installed on your 
  206. system and you want to run a working set analysis. 
  207.  
  208. Working set analysis allows you to determine how much memory a particular 
  209. application is using over time. 
  210.  
  211.  
  212. ΓòÉΓòÉΓòÉ 5.7. Help For Application Kill ΓòÉΓòÉΓòÉ
  213.  
  214. Application Kill 
  215.  
  216. Although a brutal term for it, in the rare occasion a runaway process must be 
  217. stopped, or it is convenient to stop a process from Pegasus, this option will 
  218. send a kill signal to the selected process. 
  219.  
  220. If the target process has a signal handler that chooses to ignore the kill 
  221. signal, this option will not always work. 
  222.  
  223.  
  224. ΓòÉΓòÉΓòÉ 6. Help For I/O Activity ΓòÉΓòÉΓòÉ
  225.  
  226. I/O Activity 
  227.  
  228. This windows displays the I/O activity table. The table consists of metrics for 
  229. global resources such as Logical Partitions, Printers, and Communication Ports. 
  230.  
  231. The Logical Partition metrics contain: 
  232.  
  233. o Read Events - The number of disk reads that occured to this logical drive. 
  234.  
  235. o Read Response - The average response time (in milliseconds) per I/O event. 
  236.  
  237. o Read Bytes - The average number of bytes read per I/O event. 
  238.  
  239. o Write Events - The number of disk writes that occured to this logical drive. 
  240.  
  241. o Write Response - The average response time (in milliseconds) per I/O event. 
  242.  
  243. o Write Bytes - The average number of bytes written per I/O event. 
  244.  
  245. o Used Storage - This indicates the amount of storage (in megabytes) that is 
  246.   used on the logical disk. 
  247.  
  248. o Available Storage - This indicates the amount of storage (in megabytes) that 
  249.   is available for use on the logical disk. 
  250.  
  251. For Communication Ports, the metrics are the same as those for Logical disk 
  252. except there are no storage metrics. 
  253.  
  254. For Printers, the metrics are the same as those for Communication Ports except 
  255. there are no Read Event metrics. 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ 7. Help For Configuration Options ΓòÉΓòÉΓòÉ
  259.  
  260. Pegasus Settings 
  261.  
  262. Configuration Options 
  263.  
  264. Pegasus provides you with a number of controls for configuration of the system. 
  265.  
  266. For more information on each of the control settings, select the Contents menu 
  267. item from the Help Manager's Options action. 
  268.  
  269. Note:  All changes, with the exception of the Auto-Start options, take effect 
  270. immediatley. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 7.1. Help For Window Position Save ΓòÉΓòÉΓòÉ
  274.  
  275. Save Window Positions 
  276.  
  277. This option, when set, will cause Pegasus to save the last known positions of 
  278. the active tables and graphs. 
  279.  
  280. When Pegasus is run again, all windows that are set for automatic open will 
  281. re-appear in their last position. If not set for automatic open, the windows 
  282. will appear in their last position when started from the View menu option. 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 7.2. Help For Process ID in hex ΓòÉΓòÉΓòÉ
  286.  
  287. Display Process ID in hexadecimal 
  288.  
  289. When this option is set, Pegasus will display the process id (PID) in 
  290. hexadecimal instead of decimal. 
  291.  
  292. The hexadecimal display shows a 4 digit number. For example: 
  293.  
  294. The hexadecimal process id of : 0FD3
  295.  
  296. converts to (0x4096)+(15x256)+(13x16)+3 = 4051.
  297.  
  298.  
  299. ΓòÉΓòÉΓòÉ 7.3. Help For System View Auto Start ΓòÉΓòÉΓòÉ
  300.  
  301. Auto Start Options 
  302.  
  303. Pegasus can automatically open the system resource monitor table when started. 
  304.  
  305. The system resource table is still available after startup from the Views 
  306. action bar. 
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 7.4. Help For I/O Display Auto Start ΓòÉΓòÉΓòÉ
  310.  
  311. Auto Start Options 
  312.  
  313. Pegasus can automatically open the I/O activity resource table when started. 
  314.  
  315. The I/O activity table is still available after startup from the Views action 
  316. bar. 
  317.  
  318.  
  319. ΓòÉΓòÉΓòÉ 7.5. Help For Application View Auto Start ΓòÉΓòÉΓòÉ
  320.  
  321. Auto Start Options 
  322.  
  323. Pegasus can automatically open the Application resource table when started. 
  324.  
  325. The Application resource table is still available after startup from the Views 
  326. action bar. 
  327.  
  328.  
  329. ΓòÉΓòÉΓòÉ 7.6. Help For Mini Monitor Auto Start ΓòÉΓòÉΓòÉ
  330.  
  331. Auto Start Options 
  332.  
  333. Pegasus can automatically open the Mini-monitor graph when started. 
  334.  
  335. The Mini-monitor can also be started from the Views action bar. 
  336.  
  337.  
  338. ΓòÉΓòÉΓòÉ 7.7. Help For Application Refresh ΓòÉΓòÉΓòÉ
  339.  
  340. Application Refresh Rate 
  341.  
  342. This option controls the frequency, in minutes, that Pegasus updates the 
  343. Application Activity table. 
  344.  
  345. In addition to the automatic refreshes, the Application Activity panel is 
  346. updated when : 
  347.  
  348. o When any process starts. 
  349.  
  350. o When any process ends. 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 7.8. Help For Sample Rate ΓòÉΓòÉΓòÉ
  354.  
  355. Sample Rate 
  356.  
  357. How often Pegasus updates the System and I/O Activity tables, and Mini-monitor 
  358. graph, is based on the Sample Rate. 
  359.  
  360. Valid options are 5 Seconds, 1 Minute and  15 Minute intervals. 
  361.  
  362.  
  363. ΓòÉΓòÉΓòÉ 7.9. Help For Cpu Warning ΓòÉΓòÉΓòÉ
  364.  
  365. CPU Percent Warning 
  366.  
  367. This control determines when Pegasus should change the color of the CPU 
  368. activity bar to red in the Mini-Monitor. 
  369.  
  370. Setting this to 0 will turn off color changes. 
  371.  
  372.  
  373. ΓòÉΓòÉΓòÉ 7.10. Help For RAM Warning ΓòÉΓòÉΓòÉ
  374.  
  375. RAM Used Percent Warning 
  376.  
  377. This control determines when Pegasus should change the color of the RAM used 
  378. bar to red in the Mini-Monitor. 
  379.  
  380. Setting this to 0 will turn off color changes. 
  381.  
  382.  
  383. ΓòÉΓòÉΓòÉ 7.11. Help For Swap Percent Warning ΓòÉΓòÉΓòÉ
  384.  
  385. Swap Percent Warning 
  386.  
  387. This control determines when Pegasus should change the color of the Swap 
  388. activity bar to red in the Mini-Monitor. 
  389.  
  390. Swap percent is that percentage of available space used by swapper.dat. The 
  391. higher the value the less free space remains. 
  392.  
  393. Setting this to 0 will turn off color changes. 
  394.  
  395.  
  396. ΓòÉΓòÉΓòÉ 7.12. Help For Settings Reset ΓòÉΓòÉΓòÉ
  397.  
  398. Settings Reset 
  399.  
  400. This button will reset all changes made since the dialog box had been invoked. 
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ 8. Help For Pegasus Mini Monitor ΓòÉΓòÉΓòÉ
  404.  
  405. Pegasus Mini-Monitor 
  406.  
  407. The Mini-Monitor displays bar graphs for the following resources: 
  408.  
  409. o CPU Busy - The bar measures the percent CPU busy from 0 to 100%. 
  410.  
  411. o RAM Used - The bar measures the percent of total Physical (BLUE/RED) memory 
  412.   in use and the percent of Resident memory (GREEN). 
  413.  
  414. o Swap Used - The bar measures the percent of available space (BLUE/RED) 
  415.   consumed by swapper.dat and the percent that was originally allocated at boot 
  416.   time (GREEN). 
  417.  
  418. You can set when the bar color changes from blue to red (warning) from the 
  419. Options->Configuration Dialog. 
  420.  
  421. Exception Log 
  422.  
  423. The Mini-Monitor maintains an exception log. This log can be displayed by 
  424. double clicking on the client area of the Mini-Monitor with the Right Mouse 
  425. Button. 
  426.  
  427.  
  428. ΓòÉΓòÉΓòÉ 9. Help For Exception Log ΓòÉΓòÉΓòÉ
  429.  
  430. Exception Log 
  431.  
  432. The Exception Log contains a list of exceptions that have been generated based 
  433. on the warning thresholds as set in the Options->Configuration dialog. 
  434.  
  435. Exceptions are list by: 
  436.  
  437.  1. Time Stamp 
  438.  
  439.  2. Type ( Cpu, Ram, Swap ) 
  440.  
  441.  3. Threshold Exceeded ( set in Configuration ) 
  442.  
  443.  4. Current Value 
  444.  
  445. The list is added at the top, this way the most recent exceptions will be 
  446. displayed. 
  447.  
  448. To save the data to an ascii text file, select the Save button. You will be 
  449. prompted for a file name. 
  450.  
  451. Once the exceptions have been viewed or saved, you can clear the list by 
  452. clicking on the Clear button. 
  453.  
  454. CAUTION:
  455. If there are a large number of exceptions and you do not clear them out from 
  456. time to time Pegasus will begin to discard the messages. 
  457.  
  458.  
  459. ΓòÉΓòÉΓòÉ 10. Help For Working Set Dialog ΓòÉΓòÉΓòÉ
  460.  
  461. General 
  462.  
  463. This dialog allows you to track a single applications working set. 
  464.  
  465. A working set is defined as the amount of memory references over a period of 
  466. time (working set interval) by the application. 
  467.  
  468. Note:  Working set interval and sample rate are not the same. The working set 
  469. interval is how many time tics qualify a memory page as part of the working 
  470. set. The sample rate is how often do you want to update the display with this 
  471. information. 
  472.  
  473. After setting the Working Set Interval and the Sample rate, and clicking the 
  474. Start button, the display will begin to update the following: 
  475.  
  476. o Date-Time The date and time stamp  of the Sample. 
  477.  
  478. o Now(k) The amount of memory accessed at the time of the Sample. 
  479.  
  480. o WS(k) The amount of memory found to be accessed within the Working Set 
  481.   Interval specified. 
  482.  
  483. o Accessed(k) 
  484.  
  485. Note:  1 k = 1024 bytes. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 10.1. Help For WS Interval ΓòÉΓòÉΓòÉ
  489.  
  490. Working Set Interval 
  491.  
  492. In short, the working set interval determines the number of memory pages 
  493. referenced over a period of time. For example, if you set this value to 3, the 
  494. working set analysis will see how many pages have been referenced within the 
  495. last 3 timer tics intervals. 
  496.  
  497. Use the Sample Rate to set how often you want the display updated. 
  498.  
  499.  
  500. ΓòÉΓòÉΓòÉ 10.2. Help For Working Set Sample Rate ΓòÉΓòÉΓòÉ
  501.  
  502. Working Set Sample Rate 
  503.  
  504. The working set sample rate determines how often the screen is updated with the 
  505. analysis data. Each new sample is placed at the top of the screen to avoid 
  506. scrolling. 
  507.  
  508. Use the Working Set Interval to set how many intervals should be considered in 
  509. the working set analysis. 
  510.  
  511.  
  512. ΓòÉΓòÉΓòÉ 11. Help For Process Memory Dialog ΓòÉΓòÉΓòÉ
  513.  
  514. Process Memory 
  515.  
  516. This dialog displays per process memory usage information. A snapshot taken 
  517. when the dialog is invoked and the user is warned that the dynamics of memory 
  518. ownership are likely to change the values once the snapshot is taken. 
  519.  
  520. For each process in the system, the following information is provided: 
  521.  
  522.  1. Process Name 
  523.  
  524.  2. Process ID 
  525.  
  526.  3. Private Memory The amount of memory, in kilobytes, in the private arena of 
  527.     this process. If there are more than one process that has a map to this 
  528.     private page, the process with the lowest process id (PID) is charged with 
  529.     ownership. 
  530.  
  531.  4. Shared Memory The amount of memory, in kilobytes, from the shared arena 
  532.     owned by this process. 
  533.  
  534.  
  535. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  536.  
  537. Theseus/2 is copyright of IBM Corporation.