home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / PMP207.ZIP / PMPATROL.INF (.txt) < prev    next >
OS/2 Help File  |  1994-01-29  |  30KB  |  1,017 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Installation ΓòÉΓòÉΓòÉ
  3.  
  4. To install PM Patrol, run INSTALL.CMD from the distribution diskette. 
  5.  
  6. This will install all necessary files and create a subdirectory called PMP. The 
  7. installation procedure also creates the PM Patrol desktop folder. You may move 
  8. this into another folder if you wish. 
  9.  
  10. To have PM Patrol start at system bootup, create a 'Shadow' copy of the PM 
  11. Patrol icon in the PM Patrol folder and specify the 'Startup' folder as the 
  12. target folder. Refer to the OS/2 Workplace Shell user guide for any additional 
  13. help. 
  14.  
  15. PM Patrol will not utilize Theseus until Theseus is installed. If the 'Theseus 
  16. RAM' and 'Theseus Swap' check box in the 'Options' dialog in PM Patrol is 
  17. greyed-out, Then Theseus is not installed correctly. 
  18.  
  19. PM Patrol does not require (c)SPM/2, just Version 2 of Theseus and the 
  20. following Theseus files installed if Theseus is to be used: 
  21.  
  22.  1. THESEUS2.SYS device driver in the CONFIG.SYS 
  23.  
  24.  2. THESEUS0.DLL accessible via LIBPATH in CONFIG.SYS 
  25.  
  26. Thesues comes highly recommended. It provides an enormous suite of information. 
  27. It is not, however, for the average user. 
  28.  
  29. Note:  Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available 
  30. on many OS/2 BBS services.  Refer to "Obtaining Theseus" section for obtaining 
  31. Theseus/2. 
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 2. Registration ΓòÉΓòÉΓòÉ
  35.  
  36. PM Patrol is developed by WallyWare. 
  37.  
  38. If this proves useful and you wish to continue using PM Patrol, you can receive 
  39. regular updates and support by submitting the registration form and $15.00 to: 
  40.  
  41. Dave Wallenberg
  42. Attn: WallyWare
  43. 2210 Kingston Drive
  44. Wheaton IL, 60187  USA
  45.  
  46. Compuserve ID 72702,2320
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 3. Support ΓòÉΓòÉΓòÉ
  50.  
  51. PM Patrol is currently supported primarily via CompuServe on the "OS2BVEN" 
  52. forum with the "Shareware" section. Although, many other OS2 user group BBSs 
  53. are updated regularly with the latest PM Patrol versions. 
  54.  
  55. Feel free to leave messsages via CompuServe ID: 72702,2320 
  56.  
  57. Additional support for PM Patrol and other WallyWare software can be obtained 
  58. by calling 708/574-0998 (extension 4626) and leaving voice mail for me. 
  59.  
  60. All mail sources are checked daily. 
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ 4. Production Information ΓòÉΓòÉΓòÉ
  64.  
  65. This section describes what PM Patrol is and what it offers 
  66.  
  67.  
  68. ΓòÉΓòÉΓòÉ 4.1. What is It? ΓòÉΓòÉΓòÉ
  69.  
  70. PM Patrol is a performance and resource monitoring tool for OS/2 v2.1 and up. 
  71. The display items, frequency of resource samples, and preferences are user 
  72. selectable allowing complete customization. 
  73.  
  74. Always accessible, PM Patrol extents the OS/2 desktop by providing several 
  75. utility items and system-wide control items. The goal of PM Patrol attempts to 
  76. enhance the desktop and provide insight into OS/2 activities. 
  77.  
  78. Data sampled is capable of being logged for further review. 
  79.  
  80. The appearance of PM Control has maintained the attitude that the tool should 
  81. be visible, yet not use valuable desktop space. As a result, the main status 
  82. line is displayed at the bottom of the display (as default). 
  83.  
  84.  
  85. ΓòÉΓòÉΓòÉ 4.2. What does it do for me? ΓòÉΓòÉΓòÉ
  86.  
  87. PM Patrol enables you see at a glance some critical system resource items. 
  88.  
  89. It can also play a valuable role in software testing and performance 
  90. measurements. 
  91.  
  92. The data can be logged for further review. Captured as text, the logged data 
  93. can be manipulated using tools such as Rexx, AWK, and GREP. 
  94.  
  95. PM Patrol can take advantage of (c)Thesues/2 from IBM to allow even more 
  96. granualarity of monitoring resources. 
  97.  
  98. Note:  Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available 
  99. on many OS/2 BBS services. 
  100.  
  101.  
  102. ΓòÉΓòÉΓòÉ 4.3. Why do I need it? ΓòÉΓòÉΓòÉ
  103.  
  104. You may desire the ability to monitor: 
  105.  
  106.  1. Inconspicuous display of current Date and Time 
  107.  
  108.  2. Elapsed time (user resettable) 
  109.  
  110.  3. Total system up-time 
  111.  
  112.  4. Process, thread, semaphore, DLL, drivers, and shared memory activity 
  113.  
  114.  5. Process and thread load compared to other active OS/2 activities 
  115.  
  116.  6. Complete drive summary and detailed information 
  117.  
  118.  7. Disk Drives online (including network drives) 
  119.  
  120.  8. Free space for selected drives (up to 2 drives including network drives) 
  121.  
  122.  9. OS/2 swap activity (with support for IBM Theseus for free swap pages) 
  123.  
  124. 10. Identify system levels for OS/2 component installed 
  125.  
  126. 11. OS/2 memory activity (with support for IBM Theseus) 
  127.  
  128. 12. Active number of OS/2 processes, threads, and desktop windows 
  129.  
  130. 13. CPU utilization (current vs. rolling average over last 1 minute) 
  131.  
  132. 14. Battery status for mobile computers 
  133.  
  134. 15. Changing the mouse and wait pointers in OS/2 
  135.  
  136. 16. Graphical views of memory and CPU usage 
  137.  
  138. 17. Several utility items and more 
  139.  
  140.     Note:  Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is 
  141.     available on many OS/2 BBS services. 
  142.  
  143. PM Patrol contains a growing number of utility functions such as: 
  144.  
  145.  1. Robust monitoring of OS/2 processes and threads (PStat Window) 
  146.  
  147.  2. Sumary and detailed information of drives 
  148.  
  149.  3. Summary and detailed information of OS/2 configuration 
  150.  
  151.  4. Find files (to be available soon) 
  152.  
  153.  5. Identify system levels for OS/2 component installed 
  154.  
  155.  6. Minimize all visible windows 
  156.  
  157.  7. Restore all minimized windows 
  158.  
  159.  8. System shutdown 
  160.  
  161.  9. Lockup system 
  162.  
  163. 10. Suspending power for mobile computers (sleep mode) 
  164.  
  165. 11. Suspending the monitor display 
  166.  
  167. 12. Starting an OS/2 window session 
  168.  
  169. 13. Changing type of mouse and wait pointers for all display types 
  170.  
  171. 14. And more. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 4.4. Who done it? ΓòÉΓòÉΓòÉ
  175.  
  176. (c)PM Patrol was developed by WallyWare. 
  177.  
  178. WallyWare develops OS/2 and UNIX utility based software. 
  179.  
  180.  
  181. ΓòÉΓòÉΓòÉ 5. How do I ? ΓòÉΓòÉΓòÉ
  182.  
  183. This section describes how to do things in PM Patrol that may not be obvious. 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 5.1. Set fonts ΓòÉΓòÉΓòÉ
  187.  
  188. You can also select "Font" from the PM Patrol "Options" dialog and select a 
  189. font for the PM Patrol main status line. 
  190.  
  191. Or, use the Font Pallete in the OS/2 "Setup" folder by dropping a font on the 
  192. PM Patrol status line. 
  193.  
  194. Select "Save Settings" from the PM Patrol "Options" dialog to store changes 
  195. permanently. 
  196.  
  197. Note:  PM Patrol supports two fonts.  One for the main status line.  The other 
  198. font is accessed through any of the listbox dialogs.  The listbox font allows 
  199. you to select a "Fixed Size" font for displays such as "PStat Window". 
  200.  
  201.  
  202. ΓòÉΓòÉΓòÉ 5.2. Set Colors ΓòÉΓòÉΓòÉ
  203.  
  204. Use the "Colors" dialog. This can be accessed via the PM Patrol Setting option 
  205. on the "Options" dialog. You can control both foreground and background RGB 
  206. colors with this mechanism. 
  207.  
  208. Or, use the Color Pallete in the OS/2 "Setup" folder by dropping a color 
  209. selection on the PM Patrol status line. 
  210.  
  211. Select "Save Settings" from the PM Patrol "Options" dialog to store changes 
  212. permanently. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 5.3. Move the Status line ΓòÉΓòÉΓòÉ
  216.  
  217. The following steps identify how to move the status line and then saving that 
  218. position for future use: 
  219.  
  220.  1. Single click with both mouse buttons (Chord click) on the PM Patrol status 
  221.     line.  This will enable the title bar to the status line. 
  222.  
  223.  2. Select the title bar and hold the mouse button while dragging the status 
  224.     line to the desired position. 
  225.  
  226.  3. Chord click the status line again (or select "Hide Controls" from the 
  227.     System Menu box) to hide the title bar. 
  228.  
  229.  4. Select "Save Settings" from the PM Patrol "Options" dialog to save the 
  230.     position permanently. 
  231.  
  232. Select "Save Settings" from the PM Patrol "Options" dialog to store changes 
  233. permanently. 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 5.4. Obtaining (c)Theseus/2 ΓòÉΓòÉΓòÉ
  237.  
  238. Theseus is available on several BBSs. Make sure you get the latest version. 
  239.  
  240. If you have trouble locating (c)Theseus/2, WallyWare can help. 
  241.  
  242. Theseus is shipped with SPM/2 which can be puchased from IBM for OS/2. 
  243.  
  244.  
  245. ΓòÉΓòÉΓòÉ 6. Features ΓòÉΓòÉΓòÉ
  246.  
  247. This section describes various feations of PM Patrol. 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 6.1. Utility ΓòÉΓòÉΓòÉ
  251.  
  252. The Utility section provides a growing number of utility items. This section 
  253. will, along with monitor items, grow extensively. Currently, there are some 
  254. options that are unavailable and planned for the next release 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 6.1.1. Drives ΓòÉΓòÉΓòÉ
  258.  
  259. The Drives options provides the ability to switch drives that are online and 
  260. you wish to monitor, format(full and fast), check, view summary and detail 
  261. information for a particular drive. 
  262.  
  263.  
  264. ΓòÉΓòÉΓòÉ 6.1.1.1. Monitor ΓòÉΓòÉΓòÉ
  265.  
  266. The Monitor option provides the ability to switch drives that are online that 
  267. you may want to monitor on the PM patrol status line. After selecting this 
  268. options, another listbox pops up for you to select a drive. 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 6.1.1.2. Drive Info ΓòÉΓòÉΓòÉ
  272.  
  273. The Drive Info option provides the ability to view summary and detail level 
  274. information for a selected drive. 
  275.  
  276. Summary level data displays volume specifics as well as media format and device 
  277. type. Summary level data displays a wealth of information. 
  278.  
  279. Detail level data allows you to display file allocations for a given "file 
  280. mask". A popup dialog box is supplied for the file mask you desire. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 6.1.1.3. Check Disk ΓòÉΓòÉΓòÉ
  284.  
  285. Check disk launches the PMCHKDSK utility shipped with OS/2. This also maps user 
  286. files, directory space, and extended attributes. 
  287.  
  288.  
  289. ΓòÉΓòÉΓòÉ 6.1.1.4. Format Disk ΓòÉΓòÉΓòÉ
  290.  
  291. Format disk launches the PMFORMAT utility shipped with OS/2. 
  292.  
  293.  
  294. ΓòÉΓòÉΓòÉ 6.1.1.5. Fast Format ΓòÉΓòÉΓòÉ
  295.  
  296. Fast Format performs a very fast format for diskettes (drives A or B) that are 
  297. ALREADY formatted. This is much faster, and easier, than manually deleting 
  298. files off a diskette. You'll be surprised how often this proves useful. 
  299.  
  300. Fast Format also allows you to specify a new volume label name. 
  301.  
  302.  
  303. ΓòÉΓòÉΓòÉ 6.1.2. PStat Window ΓòÉΓòÉΓòÉ
  304.  
  305. The PStat Window (Process Status) option provides the ability to monitor OS/2 
  306. internal process, thread, semaphore, shared memory, and modules that are 
  307. active. Processes (PIDs) can be "killed" by selecting "Kill" from the "Action" 
  308. menu. 
  309.  
  310. The data displayed in the Process Load window is as follows: Press Escape to 
  311. exit the window and terminate PStat monitoring. 
  312.  
  313.  1. "PID" Process ID (displayed as a hex value) 
  314.  
  315.  2. "Thd" Number of threads in the PID 
  316.  
  317.  3. "SType" Session type 
  318.  
  319.  4. "Act" Identifies an active process with an "*" in this column.  Active is 
  320.     defined as containing 1 or more threads in a "Running" or "Ready" state. 
  321.  
  322.  5. "SysTime" Amount of time PID (all threads) spends in the OS/2 kernal along 
  323.     with the percent of "SysTime" compared to TOTAL system-wide "SysTime". 
  324.  
  325.  6. "Name" Name of the executable 
  326.  
  327. The data displayed in the PStat Summary is as follows: Press Escape to exit the 
  328. window and terminate PStat monitoring. 
  329.  
  330.  1. "PID" Process ID (displayed as a hex value) 
  331.  
  332.  2. "PPID" Parent Process ID (displayed as a hex value) 
  333.  
  334.  3. "SID" Session ID (displayed as a hex value) 
  335.  
  336.  4. "SType" Session type 
  337.  
  338.  5. "Thd" Number of threads in the PID 
  339.  
  340.  6. "Sem" Number of semaphores used by the PID 
  341.  
  342.  7. "Mod" Number of modules (DLLs) used by the PID 
  343.  
  344.  8. "Shr" Number of shared memory references used by PID 
  345.  
  346.  9. "MMT" Memory Model Type (16 or 32 bit) 
  347.  
  348. 10. "Name" Name of the executable 
  349.  
  350. The data displayed in the Thread status window is for a given PID and has the 
  351. following attributes: Press Escape to go back to PStat Load window. 
  352.  
  353.  1. "TID" Thread ID (displayed as a hex value) 
  354.  
  355.  2. "Slot" Slot ID for the TID (displayed as a hex value) 
  356.  
  357.  3. "Blk ID" Block identifier for a blocked TID (displayed as a hex value) 
  358.  
  359.  4. "Pri" Current priority for the TID.  This displays both priority class 
  360.     along with the current priority level (display in hex) within the class. 
  361.  
  362.  5. "SysTime" Amount of time thread spends in the OS/2 kernal along with the 
  363.     percent of "SysTime" compared to TOTAL system-wide "SysTime". 
  364.  
  365.  6. "AppTime" Amount of time application time for the thread along with the 
  366.     percentage of "AppTime" compared to "AppTime" for all threads in the same 
  367.     PID.  This is relative to other threads getting time slices in the same 
  368.     PID. 
  369.  
  370.  7. "State" Identifies what state the thread is in; Blocked, Frozen, Running, 
  371.     and Ready. 
  372.  
  373. The data displayed in the Shared Memory Status has the following attributes: 
  374. Press Escape to exit the window and terminate PStat monitoring. 
  375.  
  376.  1. "HMem" Handle to memory allocation (displayed as a hex value) 
  377.  
  378.  2. "Sel" Selector to memory (displayed as a hex value) 
  379.  
  380.  3. "Refs" Number of references to the memory 
  381.  
  382.  4. "Name" Name of the memory used for obtaining addressability 
  383.  
  384. The data displayed in the Module Status has the following attributes:  Modules 
  385. include DLLs, Executables, drivers, fonts, and more. Press Escape to exit the 
  386. window and terminate PStat monitoring. 
  387.  
  388.  1. "HMod" Handle to the module (displayed as a hex value) 
  389.  
  390.  2. "MMT" Memory Model Type (16 or 32 bit) 
  391.  
  392.  3. "Refs" Number of references to the module 
  393.  
  394.  4. "Name" Name of the module 
  395.  
  396. The data displayed in the Semaphore Status has the following attributes: Press 
  397. Escape to exit the window and terminate PStat monitoring. 
  398.  
  399.  1. "Own" Owning thread of semaphore (displayed as a hex value) 
  400.  
  401.  2. "Indx" Index of semaphore (displayed as a hex value) 
  402.  
  403.  3. "Flag" Semaphore bit-mapped flags (displayed as a hex value) 
  404.  
  405.  4. "Refs" Number of references to semaphore by other programs 
  406.  
  407.  5. "Reqs" Number of requests for semaphore by other programs 
  408.  
  409.  6. "Name" Name of semaphore used to obtain access to semaphore by programs 
  410.  
  411.  
  412. ΓòÉΓòÉΓòÉ 6.1.3. Find Files ΓòÉΓòÉΓòÉ
  413.  
  414. The Find option will be available in a future release and will provide the 
  415. ability to find files of various attributes along with duplicate files across 
  416. multiple drives. This will be displayed in a "Container" format. 
  417.  
  418.  
  419. ΓòÉΓòÉΓòÉ 6.1.4. OS/2 Window ΓòÉΓòÉΓòÉ
  420.  
  421. The OS/2 Window options opens a new OS/2 command window 
  422.  
  423.  
  424. ΓòÉΓòÉΓòÉ 6.1.5. Lockup ΓòÉΓòÉΓòÉ
  425.  
  426. The Lockup option invokes the OS/2 "lockup" facility and forces the user to 
  427. "log on" 
  428.  
  429.  
  430. ΓòÉΓòÉΓòÉ 6.1.6. Sleep ΓòÉΓòÉΓòÉ
  431.  
  432. The Sleep option places the mobile computer (SL chips) into suspend mode. This 
  433. option is accessible only when APM (Advanced Power Management) in installed. 
  434. Refer to the OS/2 Installation Guide for APM details. 
  435.  
  436.  
  437. ΓòÉΓòÉΓòÉ 6.1.7. Reset Elapsed ΓòÉΓòÉΓòÉ
  438.  
  439. The Reset Elapsed option resets the status line elapsed time to zero. This 
  440. "elapsed" time is the amount of time since PM Patrol started or since last 
  441. "Reset Elapsed". 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ 6.1.8. Refresh ALl ΓòÉΓòÉΓòÉ
  445.  
  446. The Refresh All option samples and refreshes all items being monitored on the 
  447. PM PAtrol main status line. 
  448.  
  449.  
  450. ΓòÉΓòÉΓòÉ 6.1.9. Minimize Windows ΓòÉΓòÉΓòÉ
  451.  
  452. The Minimize Windows option minimizes all visable windows on the OS/2 desktop. 
  453. Convenient for periodically "clearing" the desktop when too many windows are 
  454. active. 
  455.  
  456.  
  457. ΓòÉΓòÉΓòÉ 6.1.10. Restore Windows ΓòÉΓòÉΓòÉ
  458.  
  459. The Restore Windows option restores all minimized windows in the OS/2 Task 
  460. Window or Minimized Folder to the OS/2 desktop. 
  461.  
  462.  
  463. ΓòÉΓòÉΓòÉ 6.1.11. Logger ΓòÉΓòÉΓòÉ
  464.  
  465. The Logger facility provides a robust mechanism for recording all PM Patrol 
  466. monitors to a file. Once logged, the user can "view" the logged data for 
  467. further review. 
  468.  
  469. The log file is ASCII and able to be further manipulated using tools such as 
  470. Rexx, AWK, and GREP. A convenient "field separator" (vertical bar=0xb3) is 
  471. included in the log file for identifying individual fields in the log file 
  472. record. 
  473.  
  474. The PM Patrol Logger is designed with special consideration for performance. 
  475. When logging, the Logger machanism requires very little CPU as PM Patrol 
  476. "buffers" in memory up to 10K worth of logging data before it writes to disk. 
  477. This write operation constitutes 1 physical disk write.  With this method of 
  478. logging, the PM Patrol logging overhead is almost neglegable. The PM Patrol 
  479. Logger can be used in a variety of situations: 
  480.  
  481.  1. Real-time and time critical logging with 1 second samples. 
  482.  
  483.  2. Casual logging with infrequent (1 per minute) samples 
  484.  
  485.  
  486. ΓòÉΓòÉΓòÉ 6.1.11.1. Start/Stop ΓòÉΓòÉΓòÉ
  487.  
  488. The Start/Stop option start or stops the logging activity. 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 6.1.11.2. View Primary Log ΓòÉΓòÉΓòÉ
  492.  
  493. The View Primary Log option allows you to view the contents of the information 
  494. recently logged. The Viewer program can be setup in the "General Configuration" 
  495. section. The default Viewer is the OS/2 system editor "E.EXE". 
  496.  
  497. The name and location of the primary log file is user settable. This is 
  498. specified in the "General Configuration" section under "Logging Options". 
  499.  
  500.  
  501. ΓòÉΓòÉΓòÉ 6.1.11.3. View Backup Log ΓòÉΓòÉΓòÉ
  502.  
  503. The View Backup Log option allows you to view the contents of the information 
  504. logged previously. If the "backup log" option is not enabled, this option is 
  505. not accessable. 
  506.  
  507. The location of the backup log file is the same as the location for the primary 
  508. log file as specified in the PM Patrol "General Configuration". 
  509.  
  510. The name of the backup log file name is always "PMPATROL.BAK". 
  511.  
  512.  
  513. ΓòÉΓòÉΓòÉ 6.1.11.4. Delete All Logs ΓòÉΓòÉΓòÉ
  514.  
  515. The Delete All Logs option allows you to delete any and all PM Patrol log files 
  516. from disk. This includes the primary and backup log files. 
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ 6.2. System ΓòÉΓòÉΓòÉ
  520.  
  521. The System section provides several OS/2 environmental functions 
  522.  
  523.  
  524. ΓòÉΓòÉΓòÉ 6.2.1. Shutdown ΓòÉΓòÉΓòÉ
  525.  
  526. The Shutdown option performs a OS/2 shutdown 
  527.  
  528.  
  529. ΓòÉΓòÉΓòÉ 6.2.2. System Info ΓòÉΓòÉΓòÉ
  530.  
  531. The System Info displays 4 basic types of information: 
  532.  
  533.  1. OS/2 System information displays the basic configuration of OS/2.  Many of 
  534.     the items are static and dont change while OS/2 is operating.  Many of 
  535.     these items are modifiable in the CONFIG.SYS.  Refer to OS/2 help for more 
  536.     detail. 
  537.  
  538.  2. Presentation Manager colors.  These can be modified via the "Color Palette" 
  539.     in the OS/2 "System" folder. 
  540.  
  541.  3. Presentation Manager information displays items specific to PM.  Many of 
  542.     these can be modified in the "Setup" folder of the WorkPlace Shell. 
  543.  
  544.  4. Hardware information includes printer, communication ports, drives, mouse 
  545.     and more. 
  546.  
  547.  
  548. ΓòÉΓòÉΓòÉ 6.2.3. Sytem Level ΓòÉΓòÉΓòÉ
  549.  
  550. The System Level option launches the OS/2 SYSLEVEL.EXE utility and displays the 
  551. current release and CSD level for the OS/2 components installed on your system. 
  552.  
  553.  
  554. ΓòÉΓòÉΓòÉ 6.2.4. Mouse Pointer ΓòÉΓòÉΓòÉ
  555.  
  556. The Mouse Pointer option allows you to change the current mouse pointer type. 
  557. Using the OS/2 Icon Editor, you can create your own POINTER files. 
  558.  
  559. This option was added to provide a bigger pointer for SVGA and XGA systems. On 
  560. XGA systems, if you change the default pointer, the pointer may occationally 
  561. dissappear. This is most likely caused by the IBM OS/2 XGA drivers. 
  562.  
  563. After selecting a new pointer, DO NOT delete, move, or rename this file without 
  564. performing this process as well. OS/2 looks for this at IPL. So put the pointer 
  565. file in a safe place on a not removable media type and backup INI files. 
  566.  
  567. Select "Reset" to reset back to the original pointer. 
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ 6.2.5. Wait Pointer ΓòÉΓòÉΓòÉ
  571.  
  572. The Wait Pointer option allows you to change the current wait pointer type. 
  573. Typically, this is the OS/2 time clock when the system is busy. Using the OS/2 
  574. Icon Editor, you can create your own POINTER files. 
  575.  
  576. This option was added to provide a bigger pointer for SVGA and XGA systems. On 
  577. XGA systems, if you change the default pointer, the pointer may occationally 
  578. dissappear. This is most likely caused by the XGA drivers. 
  579.  
  580. After selecting a new pointer, DO NOT delete, move, or rename this file without 
  581. performing this process as well. OS/2 looks for this at IPL. So put the pointer 
  582. file in a safe place on a not removable media type and backup INI files. 
  583.  
  584. Select "Reset" to reset back to the original pointer. 
  585.  
  586.  
  587. ΓòÉΓòÉΓòÉ 6.3. Settings ΓòÉΓòÉΓòÉ
  588.  
  589. The Settings section provides PM Patrol configuration items 
  590.  
  591.  
  592. ΓòÉΓòÉΓòÉ 6.3.1. Save Settings ΓòÉΓòÉΓòÉ
  593.  
  594. The Save Settings option permanently saves the current PM Patrol settings. This 
  595. includes colors, font, status line position, and options settings (ie. sample 
  596. frequencies, etc) 
  597.  
  598.  
  599. ΓòÉΓòÉΓòÉ 6.3.2. Reset Settings ΓòÉΓòÉΓòÉ
  600.  
  601. The Reset Settings option resets all PM Patrol options, colors, window 
  602. position(s) and options settings to their original defaults 
  603.  
  604.  
  605. ΓòÉΓòÉΓòÉ 6.3.3. Change Settings ΓòÉΓòÉΓòÉ
  606.  
  607. The Change Settings section allows you to change the primary PM Patrol 
  608. configuration items. 
  609.  
  610.  
  611. ΓòÉΓòÉΓòÉ 6.3.3.1. General ΓòÉΓòÉΓòÉ
  612.  
  613. The General configuration is broken-out into the following groups 
  614.  
  615.  1. "Refresh Rates" How often individual monitor items sampled 
  616.  
  617.  2. "Startup Items" Features that get started when PM Patrol is started 
  618.  
  619.  3. "Other Items" Miscellaneous items 
  620.  
  621.  4. "Logging Options" Frequency and duration of logging monitoring items 
  622.  
  623.  5. "Paths" Editor and Viewer programs used by PM Patrol 
  624.  
  625. The following items discuss Refresh Rates: 
  626.  
  627.  1. The Drive Monitor controls how often (seconds) PM Patrol checks what drives 
  628.     are online and how much free disk space resides on each. 
  629.  
  630.  2. The Swap Monitor controls how often (seconds) PM Patrol checks how large 
  631.     the OS/2 swapper file is. 
  632.  
  633.     Note:  If (c)Theseus Swap is enabled, this setting should not be less than 
  634.     60 seconds as this function of (c)Theseus consumes about 1/2 second on 
  635.     486-33Mhz for each each sample. Set this frequency to 300 seconds (5 
  636.     minutes) if using (c)Theseus Swap for ongoing usage. 
  637.  
  638.  3. The RAM Monitor controls how often (seconds) PM Patrol checks free RAM. 
  639.  
  640.  4. The Process Summary controls how often (seconds) PM Patrol enumerates the 
  641.     number of active OS/2 processes, threads, and OS/2 active windows. 
  642.  
  643.  5. The PStat Window controls how often (seconds) PM Patrol refreshes the PStat 
  644.     Window when this window is active and "Auto-Refresh" is enabled. 
  645.  
  646. The following items discuss Startup Items: 
  647.  
  648.  1. Enable PStat Window to have this facility launched when PM Patrol starts. 
  649.  
  650.  2. Enable PStat Auto Refresh to have the PStat window automatically started in 
  651.     "Auto-Refresh" mode when PM Patrol starts. 
  652.  
  653.  3. Enable Logging to have the Logger facility start when PM Patrol starts. 
  654.  
  655. The following items discuss Other Items: 
  656.  
  657.  1. The 15 Min Alarm option enables/disables an audible sound which occurs at 
  658.     each quarter hour.  Use this feature to remind you of passing time. 
  659.  
  660. The following items discuss Logging Options: 
  661.  
  662.  1. The Log Frequency allows you to select the number of seconds at which PM 
  663.     Patrol logs selected monitor items.  Valid values are 1 to 60 seconds (1 
  664.     minute). 
  665.  
  666.  2. The Log Duration allows you to select how long (minutes) to perform 
  667.     logging.  Valid values are 1 minute to 1440 (all day). 
  668.  
  669.     Note:  Specifying 1440 minutes enables continuous logging.  With this 
  670.     enabled, the log files (primary and backup) get "rolled-over" at midnight. 
  671.     The "Notify when Done" option is ignored when continuous logging is 
  672.     enabled. 
  673.  
  674.     Note:  Worst case disk requirement for all day logging with backup is 16MB. 
  675.     1/2 of this when "Backup log File" is not enabled. 
  676.  
  677.     Note:  While continuous logging is active, the primary log file can not be 
  678.     viewed.  The backup log file (from the previous day) is always accessable. 
  679.  
  680.  3. The Fg Color and Bg Color pushbutton items allow you to select the PM 
  681.     Patrol Status Line colors when logging is active.  The default colors 
  682.     reverse the foreground and background colors. 
  683.  
  684.  4. The Backup Log File causes the primary log file to be backed-up each time a 
  685.     "Start Log" is initiated.  With this disabled, the primary log file is 
  686.     overwritten. 
  687.  
  688.  5. The Notify When Done option provides the ability to have PM Patrol pop-up a 
  689.     messsage on the OS/2 Desktop when logging has reached it's completion via 
  690.     the "Log Duration" setting.  This is ignored for "Continuous Logging". 
  691.  
  692.  6. The Log File entry field allows you to specify the location and name of the 
  693.     log file which PM Patrol will use for logging. 
  694.  
  695.     Note:  The backup log file created by PM Patrol will be placed in the same 
  696.     directory as the primary log specified in this field.  The name of the file 
  697.     is always "PMPATROL.BAK". 
  698.  
  699.     Note:  Both the primary and backup log files are ASCII.  Therefore, they 
  700.     can be viewed and otherwise manipulated using such tools as Rexx, AWK, and 
  701.     GREP. 
  702.  
  703. The PM Patrol Logger is designed with special consideration for performance. 
  704. When logging, the Logger machanism requires very little CPU as PM Patrol 
  705. "buffers" in memory up to 10K worth of logging data before it writes to disk. 
  706. This write operation constitutes 1 physical disk write.  With this method of 
  707. logging, the PM Patrol logging overhead is almost neglegable. The PM Patrol 
  708. Logger can be used in a variety of situations: 
  709.  
  710.  1. Real-time and time critical logging with 1 second samples. 
  711.  
  712.  2. Casual logging with infrequent (1 per minute) samples 
  713.  
  714. The following items discuss Paths: 
  715.  
  716.  1. The Viewer identifies which OS/2 program/utility to use for viewing.  PM 
  717.     Patrol uses this for Log viewing and others purposes as they surface in 
  718.     future releases of PM Patrol. 
  719.  
  720.  2. The Editor identifies which OS/2 program/utility to use for editing.  PM 
  721.     Patrol will use this in future releases.  Currently not used in this 
  722.     version. 
  723.  
  724.  
  725. ΓòÉΓòÉΓòÉ 6.3.3.2. Font ΓòÉΓòÉΓòÉ
  726.  
  727. The Font option allows you to set the display font for the PM Patrol status 
  728. line window. You can also use the Font Palette in the OS/2 "System Settings" 
  729. folder by dragging the font to the PM Patrol Status line. 
  730.  
  731.  
  732. ΓòÉΓòÉΓòÉ 6.3.3.3. Colors ΓòÉΓòÉΓòÉ
  733.  
  734. The Colors option allows you to set the foreground and background colors for 
  735. the PM Patrol status line window. 
  736.  
  737. The Propogate option informs PM Patrol to use the color settings selected, 
  738. throughout all PM Patrol windows - as opposed to the current OS/2 color 
  739. definitioins. 
  740.  
  741.  
  742. ΓòÉΓòÉΓòÉ 6.4. Exit ΓòÉΓòÉΓòÉ
  743.  
  744. This option is used to end the PM Patrol program 
  745.  
  746.  
  747. ΓòÉΓòÉΓòÉ 6.5. Help ΓòÉΓòÉΓòÉ
  748.  
  749. The help menu allows quick access to PM Patrol help items including General 
  750. Help for all online help items. 
  751.  
  752.  
  753. ΓòÉΓòÉΓòÉ 6.6. Options Pushbutton Items ΓòÉΓòÉΓòÉ
  754.  
  755. This section describes the Options dialog pushbutton items 
  756.  
  757. The OK button accepts changes made to any PM Patrol Status Line settings and 
  758. closes the Options dialog window. If (c)Theseus Swap is enabled, there will be 
  759. a slight delay while PM Patrol samples this (c)Theseus Swap data. 
  760.  
  761. The Suspend button freezes the Status line display until you resume the display 
  762. or select OK or Cancel. 
  763.  
  764. The Minimize option (arrow pointing down) provides a quick mechanism for 
  765. minimizing ALL visible OS/2 windows on the desktop thus removing the "clutter". 
  766.  
  767. The Restore option (arrow pointing up) provides a quick mechanism for restoring 
  768. ALL minimized windows to the desktop. This is automatically performed when you 
  769. use the PM Patrol "Shutdown" option to shutdown your OS/2 system. 
  770.  
  771.  
  772. ΓòÉΓòÉΓòÉ 6.7. Optional Items ΓòÉΓòÉΓòÉ
  773.  
  774. This section describes the optional items on the Options dialog 
  775.  
  776. The (c)Theseus RAM option enables/disables the use of (c)Theseus for 
  777. determining free RAM(k) and idle RAM(k). This option is accessible only when 
  778. "Memory Monitor" is selected in "Display Monitors". 
  779.  
  780. The (c)Theseus Swap option enables/disables the use of (c)Theseus for 
  781. determining free Swap pages(k) in the system swapper file. This option is 
  782. accessible only when "Swap Monitor" is selected in "Display Monitors". 
  783.  
  784. The Float to Top option enables/disables PM Patrol's ability to force 
  785. visibility of it's windows when other windows overlay it's display. 
  786.  
  787. The CPU Graph option enables/disables a visually graphic display of CPU 
  788. activity. This option is accessible only when "CPU Monitor" is selected in 
  789. "Display Monitors". 
  790.  
  791.  
  792. ΓòÉΓòÉΓòÉ 6.8. Display Monitors ΓòÉΓòÉΓòÉ
  793.  
  794. This section describes the selectable display items. These items are described 
  795. in detail under "Status Line" help. Select which items you want to be displayed 
  796. on the PM Patrol Status Line. 
  797.  
  798.  
  799. ΓòÉΓòÉΓòÉ 6.9. Status Line ΓòÉΓòÉΓòÉ
  800.  
  801. This section describes items displayed on the main PM Patrol status line 
  802.  
  803.  
  804. ΓòÉΓòÉΓòÉ 6.9.1. Current Time ΓòÉΓòÉΓòÉ
  805.  
  806. Display of the current date and time updated every 1 minute 
  807.  
  808.  
  809. ΓòÉΓòÉΓòÉ 6.9.2. Elapsed Time ΓòÉΓòÉΓòÉ
  810.  
  811. Display of the elaped time since PM Patrol started or since last reset found in 
  812. "Utility" menu accessed from the Options dialog or right click the PM Patrol 
  813. status line. This is updated every minute. 
  814.  
  815. Being resettable, the Elapsed time offered by PM Patrol allows you to monitor 
  816. how long you have working on something.  Then reset it when beginning to work 
  817. on something else.  Useful to some. 
  818.  
  819.  
  820. ΓòÉΓòÉΓòÉ 6.9.3. System Up-Time ΓòÉΓòÉΓòÉ
  821.  
  822. Display the total time that OS/2 has been up and running since last boot. 
  823.  
  824.  
  825. ΓòÉΓòÉΓòÉ 6.9.4. Keyboard Status ΓòÉΓòÉΓòÉ
  826.  
  827. The Keyboard Status displays the status of CapsLock, NumLock, and ScrollLock 
  828. keyboard settings. 
  829.  
  830.  
  831. ΓòÉΓòÉΓòÉ 6.9.5. Drives Online ΓòÉΓòÉΓòÉ
  832.  
  833. This item displays the current drive letters for available drives accessable 
  834. from this computer.  Network drives are supported. 
  835.  
  836.  
  837. ΓòÉΓòÉΓòÉ 6.9.6. Drive1 Monitor ΓòÉΓòÉΓòÉ
  838.  
  839. Displays the free space (MB) for a selected drive. To select a different drive 
  840. to monitor you may choose you one of the following methods: 
  841.  
  842.  1. Single click the right mouse button on the PM Patrol Status line and then 
  843.     select the "Drives" menu item.  Select "Monitor" to choose a drive. 
  844.  
  845.  2. Single click on the PM Patrol Status line to get the Options dialog.  Then 
  846.     select the "Utility" menu bar item followed by the "Drives" menu option. 
  847.  
  848.  
  849. ΓòÉΓòÉΓòÉ 6.9.7. Drive2 Monitor ΓòÉΓòÉΓòÉ
  850.  
  851. Displays the free space (MB) for a second selected drive. To select a different 
  852. drive to monitor you may choose you one of the following methods: 
  853.  
  854.  1. Single click the right mouse button on the PM Patrol Status line and then 
  855.     select the "Drives" menu item.  Select "Monitor" to choose a drive. 
  856.  
  857.  2. Single click on the PM Patrol Status line to get the Options dialog.  Then 
  858.     select the "Utility" menu bar item followed by the "Drives" menu option. 
  859.  
  860.  
  861. ΓòÉΓòÉΓòÉ 6.9.8. Swap Monitor ΓòÉΓòÉΓòÉ
  862.  
  863. This display option displays the current size of the OS/2 swapper file. 
  864.  
  865. Optionally, if (c)Theseus Swap is enabled, this will also display the amount of 
  866. free frames (k) inside the active swapper file. 
  867.  
  868. Refer to (c)Theseus documentation for details of free swapper frames for more 
  869. detail on this topic. 
  870.  
  871.  
  872. ΓòÉΓòÉΓòÉ 6.9.9. Memory Monitor ΓòÉΓòÉΓòÉ
  873.  
  874. This displays the amount of free RAM (k) and the largest free block (LFB) of 
  875. memory (k). 
  876.  
  877. Optionally, if (c)Theseus RAM is enabled, this will instead display free memory 
  878. according to (c)Theseus along with the amount of memory (k) that is idle. 
  879.  
  880. Refer to (c)Theseus documentation for details of free memory and idle memory 
  881. for more detail on this topic. 
  882.  
  883.  
  884. ΓòÉΓòÉΓòÉ 6.9.10. Process Summary ΓòÉΓòÉΓòÉ
  885.  
  886. This display item show the number of OS/2 processes and threads in the system. 
  887. This includes PIDs and TIDS of any state; Blocked, Running, and Runnable. 
  888.  
  889. Additionally, the current active number of windows on the desktop are shown. 
  890.  
  891.  
  892. ΓòÉΓòÉΓòÉ 6.9.11. Battery Status ΓòÉΓòÉΓòÉ
  893.  
  894. This item informs the user how much battery power is remaining. 
  895.  
  896. Note:  This option is accessible only if APM is installed via OS/2 and the 
  897. computer is a mobile computer capable of power management (ie 386sl+). 
  898.  
  899. When (and if) the battery status is unknown, PM Patrol displays a question mark 
  900. in replacement of the actual percentage of power remaining. 
  901.  
  902.  
  903. ΓòÉΓòÉΓòÉ 6.9.12. CPU Monitor ΓòÉΓòÉΓòÉ
  904.  
  905. PM Patrol monitors the CPU utilization every second. If the "CPU Graph" has 
  906. been enabled in the Options dialog, then a psudo-graphical display is shown in 
  907. addition to the percentage. 
  908.  
  909. Along with the current CPU load, PM Patrol also maintains a rolling average of 
  910. CPU utilization over the past 1 minute. 
  911.  
  912.  
  913. ΓòÉΓòÉΓòÉ 7. Miscellaneous ΓòÉΓòÉΓòÉ
  914.  
  915. This section discusses various "catch-all" items of interest 
  916.  
  917.  
  918. ΓòÉΓòÉΓòÉ 7.1. Mouse control with PM Patrol ΓòÉΓòÉΓòÉ
  919.  
  920. Single click the left mouse button on the PM Patrol status line to get to PM 
  921. Patrol Options. 
  922.  
  923. Single click the right mouse button on the PM Patrol status line for quick 
  924. access the PM Patrol utilities menu. 
  925.  
  926. Single click the left and right mouse buttons (Chord click) on the PM Patrol 
  927. status line to display the PM Patrol title bar and system menu. This allows you 
  928. to move the PM Patrol status line to a desired position. Chord click again to 
  929. hide the title bar, or select the "System Menu" box on the title bar and then 
  930. select "Hide Controls". 
  931.  
  932. Note:  Don't forget to "Save Settings" once you have positioned the PM Patrol 
  933. status line where you want. 
  934.  
  935.  
  936. ΓòÉΓòÉΓòÉ 8. Caveat Utilitor! ΓòÉΓòÉΓòÉ
  937.  
  938. PM Patrol has been thoroughly tested amongst several configurations. 
  939.  
  940. When properly tuned, PM Patrol causes no system degradations. The overhead for 
  941. PM Patrol is no more than 1-2 percent CPU load (average of 1 minutes) and only 
  942. when resource sampling occurs. 
  943.  
  944. PStat Window monitoring causes minor delays in the form of breif CPU spikes. 
  945. These spikes are normal and can be further controlled in the PM Patrol 
  946. "Configuration" for "Refresh Rates". Use "Auto Refresh" selectively for 386 
  947. class machines. 
  948.  
  949. Several of the PM Patrol sampling threads run at or near "Idle" time priority - 
  950. when there is little or no system activity. 
  951.  
  952. The PM Patrol defaults and minimum allowable setting for "Refresh Rates" 
  953. protects you from system-wide degradation. 
  954.  
  955. Please report any problems, comments, and suggestions to CompuServe ID: 
  956. 72702,2320 
  957.  
  958.  
  959. ΓòÉΓòÉΓòÉ 9. Disclaimer ΓòÉΓòÉΓòÉ
  960.  
  961. This product is supplied "as is", and without any warranties. 
  962.  
  963. WallyWare accepts no responsibility for any loss or damage; whether physical, 
  964. financial, emotional, social, mental, marital, or otherwise that may result 
  965. from the use of this product. 
  966.  
  967.  
  968. ΓòÉΓòÉΓòÉ 10. What's new ΓòÉΓòÉΓòÉ
  969.  
  970. The following items are new in this version of PM Patrol: 
  971.  
  972.  1. Increased the Logger maximum frequency from 5 to 60 seconds (1 minute) for 
  973.     LAN Administation purposes.  Refer to online help for more details, Logger 
  974.     overhead, and how the logger is also designed for real-time monitoring. 
  975.  
  976.  2. Fixed a problem where the Swap and Process Summary refresh spin-button 
  977.     rates were flip-flopped in the "General Configuration" dialog.  Sorry. 
  978.  
  979. The following items were introduced in the prior version of PM Patrol: 
  980.  
  981.  1. This version causes the PM Patrol profile to be initialized due to the 
  982.     addition of new profile data. Sorry for the inconvenience. 
  983.  
  984.  2. Due to very popular demand, PM Patrol now adds the ability to monitor 2 
  985.     disk drives for free space. 
  986.  
  987.  3. Added an "extended Logging" facility providing ability to log all selected 
  988.     monitor items that display on the PM Patrol main status line. The ability 
  989.     to do continuous logging to network drives is supported as well as logging 
  990.     at startup. 
  991.  
  992.  4. Added several customization items for Logging, including status line color 
  993.     while logger is active, notifications, primary and backups options. 
  994.  
  995.  5. Added ability to view and/or delete Logger log files.  Viewer program is 
  996.     user selectable. 
  997.  
  998.  6. Added the ability to monitor total system "up-time".  This compliments the 
  999.     PM Patrol "Elapsed" time which is user resettable. 
  1000.  
  1001.  7. The "AppTime" percentage for PStat Thread monitoring is now calculated to 
  1002.     weigh only against the effort of other threads in the same process (PID). 
  1003.  
  1004.  8. All monitor items have been broken out (ungrouped) to further support the 
  1005.     ability to customize the PM Patrol main status line appearance. 
  1006.  
  1007.  9. The PM Patrol defaults have been realigned toward popular demands. 
  1008.  
  1009. 10. (c)Theseus/2 can be obtained by contacting IBM, OS/2 User Group BBS's, or 
  1010.     WallyWare. 
  1011.  
  1012. 11. (c)SPM/2 can only be obtained by contacting IBM. 
  1013.  
  1014. Note:  The file "HISTORY.TXT" contains a complete list of the PM Patrol 
  1015. enhancements, fixes, and changes throughout previous versions. For you're 
  1016. convenience, this file also contains an accumulative list of outstanding known 
  1017. problems.  None are serious show stoppers.