═══ 1. Installation ═══ To install PM Patrol, run INSTALL.CMD from the distribution diskette. This will install all necessary files and create a subdirectory called PMP. The installation procedure also creates the PM Patrol desktop folder. You may move this into another folder if you wish. To have PM Patrol start at system bootup, create a 'Shadow' copy of the PM Patrol icon in the PM Patrol folder and specify the 'Startup' folder as the target folder. Refer to the OS/2 Workplace Shell user guide for any additional help. PM Patrol will not utilize Theseus until Theseus is installed. If the 'Theseus RAM' and 'Theseus Swap' check box in the 'Options' dialog in PM Patrol is greyed-out, Then Theseus is not installed correctly. PM Patrol does not require (c)SPM/2, just Version 2 of Theseus and the following Theseus files installed if Theseus is to be used: 1. THESEUS2.SYS device driver in the CONFIG.SYS 2. THESEUS0.DLL accessible via LIBPATH in CONFIG.SYS Thesues comes highly recommended. It provides an enormous suite of information. It is not, however, for the average user. Note: Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available on many OS/2 BBS services. Refer to "Obtaining Theseus" section for obtaining Theseus/2. ═══ 2. Registration ═══ PM Patrol is developed by WallyWare. If this proves useful and you wish to continue using PM Patrol, you can receive regular updates and support by submitting the registration form and $15.00 to: Dave Wallenberg Attn: WallyWare 2210 Kingston Drive Wheaton IL, 60187 USA Compuserve ID 72702,2320 ═══ 3. Support ═══ PM Patrol is currently supported primarily via CompuServe on the "OS2BVEN" forum with the "Shareware" section. Although, many other OS2 user group BBSs are updated regularly with the latest PM Patrol versions. Feel free to leave messsages via CompuServe ID: 72702,2320 Additional support for PM Patrol and other WallyWare software can be obtained by calling 708/574-0998 (extension 4626) and leaving voice mail for me. All mail sources are checked daily. ═══ 4. Production Information ═══ This section describes what PM Patrol is and what it offers ═══ 4.1. What is It? ═══ PM Patrol is a performance and resource monitoring tool for OS/2 v2.1 and up. The display items, frequency of resource samples, and preferences are user selectable allowing complete customization. Always accessible, PM Patrol extents the OS/2 desktop by providing several utility items and system-wide control items. The goal of PM Patrol attempts to enhance the desktop and provide insight into OS/2 activities. Data sampled is capable of being logged for further review. The appearance of PM Control has maintained the attitude that the tool should be visible, yet not use valuable desktop space. As a result, the main status line is displayed at the bottom of the display (as default). ═══ 4.2. What does it do for me? ═══ PM Patrol enables you see at a glance some critical system resource items. It can also play a valuable role in software testing and performance measurements. The data can be logged for further review. Captured as text, the logged data can be manipulated using tools such as Rexx, AWK, and GREP. PM Patrol can take advantage of (c)Thesues/2 from IBM to allow even more granualarity of monitoring resources. Note: Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available on many OS/2 BBS services. ═══ 4.3. Why do I need it? ═══ You may desire the ability to monitor: 1. Inconspicuous display of current Date and Time 2. Elapsed time (user resettable) 3. Total system up-time 4. Process, thread, semaphore, DLL, drivers, and shared memory activity 5. Process and thread load compared to other active OS/2 activities 6. Complete drive summary and detailed information 7. Disk Drives online (including network drives) 8. Free space for selected drives (up to 2 drives including network drives) 9. OS/2 swap activity (with support for IBM Theseus for free swap pages) 10. Identify system levels for OS/2 component installed 11. OS/2 memory activity (with support for IBM Theseus) 12. Active number of OS/2 processes, threads, and desktop windows 13. CPU utilization (current vs. rolling average over last 1 minute) 14. Battery status for mobile computers 15. Changing the mouse and wait pointers in OS/2 16. Graphical views of memory and CPU usage 17. Several utility items and more Note: Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available on many OS/2 BBS services. PM Patrol contains a growing number of utility functions such as: 1. Robust monitoring of OS/2 processes and threads (PStat Window) 2. Sumary and detailed information of drives 3. Summary and detailed information of OS/2 configuration 4. Find files (to be available soon) 5. Identify system levels for OS/2 component installed 6. Minimize all visible windows 7. Restore all minimized windows 8. System shutdown 9. Lockup system 10. Suspending power for mobile computers (sleep mode) 11. Suspending the monitor display 12. Starting an OS/2 window session 13. Changing type of mouse and wait pointers for all display types 14. And more. ═══ 4.4. Who done it? ═══ (c)PM Patrol was developed by WallyWare. WallyWare develops OS/2 and UNIX utility based software. ═══ 5. How do I ? ═══ This section describes how to do things in PM Patrol that may not be obvious. ═══ 5.1. Set fonts ═══ You can also select "Font" from the PM Patrol "Options" dialog and select a font for the PM Patrol main status line. Or, use the Font Pallete in the OS/2 "Setup" folder by dropping a font on the PM Patrol status line. Select "Save Settings" from the PM Patrol "Options" dialog to store changes permanently. Note: PM Patrol supports two fonts. One for the main status line. The other font is accessed through any of the listbox dialogs. The listbox font allows you to select a "Fixed Size" font for displays such as "PStat Window". ═══ 5.2. Set Colors ═══ Use the "Colors" dialog. This can be accessed via the PM Patrol Setting option on the "Options" dialog. You can control both foreground and background RGB colors with this mechanism. Or, use the Color Pallete in the OS/2 "Setup" folder by dropping a color selection on the PM Patrol status line. Select "Save Settings" from the PM Patrol "Options" dialog to store changes permanently. ═══ 5.3. Move the Status line ═══ The following steps identify how to move the status line and then saving that position for future use: 1. Single click with both mouse buttons (Chord click) on the PM Patrol status line. This will enable the title bar to the status line. 2. Select the title bar and hold the mouse button while dragging the status line to the desired position. 3. Chord click the status line again (or select "Hide Controls" from the System Menu box) to hide the title bar. 4. Select "Save Settings" from the PM Patrol "Options" dialog to save the position permanently. Select "Save Settings" from the PM Patrol "Options" dialog to store changes permanently. ═══ 5.4. Obtaining (c)Theseus/2 ═══ Theseus is available on several BBSs. Make sure you get the latest version. If you have trouble locating (c)Theseus/2, WallyWare can help. Theseus is shipped with SPM/2 which can be puchased from IBM for OS/2. ═══ 6. Features ═══ This section describes various feations of PM Patrol. ═══ 6.1. Utility ═══ The Utility section provides a growing number of utility items. This section will, along with monitor items, grow extensively. Currently, there are some options that are unavailable and planned for the next release ═══ 6.1.1. Drives ═══ The Drives options provides the ability to switch drives that are online and you wish to monitor, format(full and fast), check, view summary and detail information for a particular drive. ═══ 6.1.1.1. Monitor ═══ The Monitor option provides the ability to switch drives that are online that you may want to monitor on the PM patrol status line. After selecting this options, another listbox pops up for you to select a drive. ═══ 6.1.1.2. Drive Info ═══ The Drive Info option provides the ability to view summary and detail level information for a selected drive. Summary level data displays volume specifics as well as media format and device type. Summary level data displays a wealth of information. Detail level data allows you to display file allocations for a given "file mask". A popup dialog box is supplied for the file mask you desire. ═══ 6.1.1.3. Check Disk ═══ Check disk launches the PMCHKDSK utility shipped with OS/2. This also maps user files, directory space, and extended attributes. ═══ 6.1.1.4. Format Disk ═══ Format disk launches the PMFORMAT utility shipped with OS/2. ═══ 6.1.1.5. Fast Format ═══ Fast Format performs a very fast format for diskettes (drives A or B) that are ALREADY formatted. This is much faster, and easier, than manually deleting files off a diskette. You'll be surprised how often this proves useful. Fast Format also allows you to specify a new volume label name. ═══ 6.1.2. PStat Window ═══ The PStat Window (Process Status) option provides the ability to monitor OS/2 internal process, thread, semaphore, shared memory, and modules that are active. Processes (PIDs) can be "killed" by selecting "Kill" from the "Action" menu. The data displayed in the Process Load window is as follows: Press Escape to exit the window and terminate PStat monitoring. 1. "PID" Process ID (displayed as a hex value) 2. "Thd" Number of threads in the PID 3. "SType" Session type 4. "Act" Identifies an active process with an "*" in this column. Active is defined as containing 1 or more threads in a "Running" or "Ready" state. 5. "SysTime" Amount of time PID (all threads) spends in the OS/2 kernal along with the percent of "SysTime" compared to TOTAL system-wide "SysTime". 6. "Name" Name of the executable The data displayed in the PStat Summary is as follows: Press Escape to exit the window and terminate PStat monitoring. 1. "PID" Process ID (displayed as a hex value) 2. "PPID" Parent Process ID (displayed as a hex value) 3. "SID" Session ID (displayed as a hex value) 4. "SType" Session type 5. "Thd" Number of threads in the PID 6. "Sem" Number of semaphores used by the PID 7. "Mod" Number of modules (DLLs) used by the PID 8. "Shr" Number of shared memory references used by PID 9. "MMT" Memory Model Type (16 or 32 bit) 10. "Name" Name of the executable The data displayed in the Thread status window is for a given PID and has the following attributes: Press Escape to go back to PStat Load window. 1. "TID" Thread ID (displayed as a hex value) 2. "Slot" Slot ID for the TID (displayed as a hex value) 3. "Blk ID" Block identifier for a blocked TID (displayed as a hex value) 4. "Pri" Current priority for the TID. This displays both priority class along with the current priority level (display in hex) within the class. 5. "SysTime" Amount of time thread spends in the OS/2 kernal along with the percent of "SysTime" compared to TOTAL system-wide "SysTime". 6. "AppTime" Amount of time application time for the thread along with the percentage of "AppTime" compared to "AppTime" for all threads in the same PID. This is relative to other threads getting time slices in the same PID. 7. "State" Identifies what state the thread is in; Blocked, Frozen, Running, and Ready. The data displayed in the Shared Memory Status has the following attributes: Press Escape to exit the window and terminate PStat monitoring. 1. "HMem" Handle to memory allocation (displayed as a hex value) 2. "Sel" Selector to memory (displayed as a hex value) 3. "Refs" Number of references to the memory 4. "Name" Name of the memory used for obtaining addressability The data displayed in the Module Status has the following attributes: Modules include DLLs, Executables, drivers, fonts, and more. Press Escape to exit the window and terminate PStat monitoring. 1. "HMod" Handle to the module (displayed as a hex value) 2. "MMT" Memory Model Type (16 or 32 bit) 3. "Refs" Number of references to the module 4. "Name" Name of the module The data displayed in the Semaphore Status has the following attributes: Press Escape to exit the window and terminate PStat monitoring. 1. "Own" Owning thread of semaphore (displayed as a hex value) 2. "Indx" Index of semaphore (displayed as a hex value) 3. "Flag" Semaphore bit-mapped flags (displayed as a hex value) 4. "Refs" Number of references to semaphore by other programs 5. "Reqs" Number of requests for semaphore by other programs 6. "Name" Name of semaphore used to obtain access to semaphore by programs ═══ 6.1.3. Find Files ═══ The Find option will be available in a future release and will provide the ability to find files of various attributes along with duplicate files across multiple drives. This will be displayed in a "Container" format. ═══ 6.1.4. OS/2 Window ═══ The OS/2 Window options opens a new OS/2 command window ═══ 6.1.5. Lockup ═══ The Lockup option invokes the OS/2 "lockup" facility and forces the user to "log on" ═══ 6.1.6. Sleep ═══ The Sleep option places the mobile computer (SL chips) into suspend mode. This option is accessible only when APM (Advanced Power Management) in installed. Refer to the OS/2 Installation Guide for APM details. ═══ 6.1.7. Reset Elapsed ═══ The Reset Elapsed option resets the status line elapsed time to zero. This "elapsed" time is the amount of time since PM Patrol started or since last "Reset Elapsed". ═══ 6.1.8. Refresh ALl ═══ The Refresh All option samples and refreshes all items being monitored on the PM PAtrol main status line. ═══ 6.1.9. Minimize Windows ═══ The Minimize Windows option minimizes all visable windows on the OS/2 desktop. Convenient for periodically "clearing" the desktop when too many windows are active. ═══ 6.1.10. Restore Windows ═══ The Restore Windows option restores all minimized windows in the OS/2 Task Window or Minimized Folder to the OS/2 desktop. ═══ 6.1.11. Logger ═══ The Logger facility provides a robust mechanism for recording all PM Patrol monitors to a file. Once logged, the user can "view" the logged data for further review. The log file is ASCII and able to be further manipulated using tools such as Rexx, AWK, and GREP. A convenient "field separator" (vertical bar=0xb3) is included in the log file for identifying individual fields in the log file record. The PM Patrol Logger is designed with special consideration for performance. When logging, the Logger machanism requires very little CPU as PM Patrol "buffers" in memory up to 10K worth of logging data before it writes to disk. This write operation constitutes 1 physical disk write. With this method of logging, the PM Patrol logging overhead is almost neglegable. The PM Patrol Logger can be used in a variety of situations: 1. Real-time and time critical logging with 1 second samples. 2. Casual logging with infrequent (1 per minute) samples ═══ 6.1.11.1. Start/Stop ═══ The Start/Stop option start or stops the logging activity. ═══ 6.1.11.2. View Primary Log ═══ The View Primary Log option allows you to view the contents of the information recently logged. The Viewer program can be setup in the "General Configuration" section. The default Viewer is the OS/2 system editor "E.EXE". The name and location of the primary log file is user settable. This is specified in the "General Configuration" section under "Logging Options". ═══ 6.1.11.3. View Backup Log ═══ The View Backup Log option allows you to view the contents of the information logged previously. If the "backup log" option is not enabled, this option is not accessable. The location of the backup log file is the same as the location for the primary log file as specified in the PM Patrol "General Configuration". The name of the backup log file name is always "PMPATROL.BAK". ═══ 6.1.11.4. Delete All Logs ═══ The Delete All Logs option allows you to delete any and all PM Patrol log files from disk. This includes the primary and backup log files. ═══ 6.2. System ═══ The System section provides several OS/2 environmental functions ═══ 6.2.1. Shutdown ═══ The Shutdown option performs a OS/2 shutdown ═══ 6.2.2. System Info ═══ The System Info displays 4 basic types of information: 1. OS/2 System information displays the basic configuration of OS/2. Many of the items are static and dont change while OS/2 is operating. Many of these items are modifiable in the CONFIG.SYS. Refer to OS/2 help for more detail. 2. Presentation Manager colors. These can be modified via the "Color Palette" in the OS/2 "System" folder. 3. Presentation Manager information displays items specific to PM. Many of these can be modified in the "Setup" folder of the WorkPlace Shell. 4. Hardware information includes printer, communication ports, drives, mouse and more. ═══ 6.2.3. Sytem Level ═══ The System Level option launches the OS/2 SYSLEVEL.EXE utility and displays the current release and CSD level for the OS/2 components installed on your system. ═══ 6.2.4. Mouse Pointer ═══ The Mouse Pointer option allows you to change the current mouse pointer type. Using the OS/2 Icon Editor, you can create your own POINTER files. This option was added to provide a bigger pointer for SVGA and XGA systems. On XGA systems, if you change the default pointer, the pointer may occationally dissappear. This is most likely caused by the IBM OS/2 XGA drivers. After selecting a new pointer, DO NOT delete, move, or rename this file without performing this process as well. OS/2 looks for this at IPL. So put the pointer file in a safe place on a not removable media type and backup INI files. Select "Reset" to reset back to the original pointer. ═══ 6.2.5. Wait Pointer ═══ The Wait Pointer option allows you to change the current wait pointer type. Typically, this is the OS/2 time clock when the system is busy. Using the OS/2 Icon Editor, you can create your own POINTER files. This option was added to provide a bigger pointer for SVGA and XGA systems. On XGA systems, if you change the default pointer, the pointer may occationally dissappear. This is most likely caused by the XGA drivers. After selecting a new pointer, DO NOT delete, move, or rename this file without performing this process as well. OS/2 looks for this at IPL. So put the pointer file in a safe place on a not removable media type and backup INI files. Select "Reset" to reset back to the original pointer. ═══ 6.3. Settings ═══ The Settings section provides PM Patrol configuration items ═══ 6.3.1. Save Settings ═══ The Save Settings option permanently saves the current PM Patrol settings. This includes colors, font, status line position, and options settings (ie. sample frequencies, etc) ═══ 6.3.2. Reset Settings ═══ The Reset Settings option resets all PM Patrol options, colors, window position(s) and options settings to their original defaults ═══ 6.3.3. Change Settings ═══ The Change Settings section allows you to change the primary PM Patrol configuration items. ═══ 6.3.3.1. General ═══ The General configuration is broken-out into the following groups 1. "Refresh Rates" How often individual monitor items sampled 2. "Startup Items" Features that get started when PM Patrol is started 3. "Other Items" Miscellaneous items 4. "Logging Options" Frequency and duration of logging monitoring items 5. "Paths" Editor and Viewer programs used by PM Patrol The following items discuss Refresh Rates: 1. The Drive Monitor controls how often (seconds) PM Patrol checks what drives are online and how much free disk space resides on each. 2. The Swap Monitor controls how often (seconds) PM Patrol checks how large the OS/2 swapper file is. Note: If (c)Theseus Swap is enabled, this setting should not be less than 60 seconds as this function of (c)Theseus consumes about 1/2 second on 486-33Mhz for each each sample. Set this frequency to 300 seconds (5 minutes) if using (c)Theseus Swap for ongoing usage. 3. The RAM Monitor controls how often (seconds) PM Patrol checks free RAM. 4. The Process Summary controls how often (seconds) PM Patrol enumerates the number of active OS/2 processes, threads, and OS/2 active windows. 5. The PStat Window controls how often (seconds) PM Patrol refreshes the PStat Window when this window is active and "Auto-Refresh" is enabled. The following items discuss Startup Items: 1. Enable PStat Window to have this facility launched when PM Patrol starts. 2. Enable PStat Auto Refresh to have the PStat window automatically started in "Auto-Refresh" mode when PM Patrol starts. 3. Enable Logging to have the Logger facility start when PM Patrol starts. The following items discuss Other Items: 1. The 15 Min Alarm option enables/disables an audible sound which occurs at each quarter hour. Use this feature to remind you of passing time. The following items discuss Logging Options: 1. The Log Frequency allows you to select the number of seconds at which PM Patrol logs selected monitor items. Valid values are 1 to 60 seconds (1 minute). 2. The Log Duration allows you to select how long (minutes) to perform logging. Valid values are 1 minute to 1440 (all day). Note: Specifying 1440 minutes enables continuous logging. With this enabled, the log files (primary and backup) get "rolled-over" at midnight. The "Notify when Done" option is ignored when continuous logging is enabled. Note: Worst case disk requirement for all day logging with backup is 16MB. 1/2 of this when "Backup log File" is not enabled. Note: While continuous logging is active, the primary log file can not be viewed. The backup log file (from the previous day) is always accessable. 3. The Fg Color and Bg Color pushbutton items allow you to select the PM Patrol Status Line colors when logging is active. The default colors reverse the foreground and background colors. 4. The Backup Log File causes the primary log file to be backed-up each time a "Start Log" is initiated. With this disabled, the primary log file is overwritten. 5. The Notify When Done option provides the ability to have PM Patrol pop-up a messsage on the OS/2 Desktop when logging has reached it's completion via the "Log Duration" setting. This is ignored for "Continuous Logging". 6. The Log File entry field allows you to specify the location and name of the log file which PM Patrol will use for logging. Note: The backup log file created by PM Patrol will be placed in the same directory as the primary log specified in this field. The name of the file is always "PMPATROL.BAK". Note: Both the primary and backup log files are ASCII. Therefore, they can be viewed and otherwise manipulated using such tools as Rexx, AWK, and GREP. The PM Patrol Logger is designed with special consideration for performance. When logging, the Logger machanism requires very little CPU as PM Patrol "buffers" in memory up to 10K worth of logging data before it writes to disk. This write operation constitutes 1 physical disk write. With this method of logging, the PM Patrol logging overhead is almost neglegable. The PM Patrol Logger can be used in a variety of situations: 1. Real-time and time critical logging with 1 second samples. 2. Casual logging with infrequent (1 per minute) samples The following items discuss Paths: 1. The Viewer identifies which OS/2 program/utility to use for viewing. PM Patrol uses this for Log viewing and others purposes as they surface in future releases of PM Patrol. 2. The Editor identifies which OS/2 program/utility to use for editing. PM Patrol will use this in future releases. Currently not used in this version. ═══ 6.3.3.2. Font ═══ The Font option allows you to set the display font for the PM Patrol status line window. You can also use the Font Palette in the OS/2 "System Settings" folder by dragging the font to the PM Patrol Status line. ═══ 6.3.3.3. Colors ═══ The Colors option allows you to set the foreground and background colors for the PM Patrol status line window. The Propogate option informs PM Patrol to use the color settings selected, throughout all PM Patrol windows - as opposed to the current OS/2 color definitioins. ═══ 6.4. Exit ═══ This option is used to end the PM Patrol program ═══ 6.5. Help ═══ The help menu allows quick access to PM Patrol help items including General Help for all online help items. ═══ 6.6. Options Pushbutton Items ═══ This section describes the Options dialog pushbutton items The OK button accepts changes made to any PM Patrol Status Line settings and closes the Options dialog window. If (c)Theseus Swap is enabled, there will be a slight delay while PM Patrol samples this (c)Theseus Swap data. The Suspend button freezes the Status line display until you resume the display or select OK or Cancel. The Minimize option (arrow pointing down) provides a quick mechanism for minimizing ALL visible OS/2 windows on the desktop thus removing the "clutter". The Restore option (arrow pointing up) provides a quick mechanism for restoring ALL minimized windows to the desktop. This is automatically performed when you use the PM Patrol "Shutdown" option to shutdown your OS/2 system. ═══ 6.7. Optional Items ═══ This section describes the optional items on the Options dialog The (c)Theseus RAM option enables/disables the use of (c)Theseus for determining free RAM(k) and idle RAM(k). This option is accessible only when "Memory Monitor" is selected in "Display Monitors". The (c)Theseus Swap option enables/disables the use of (c)Theseus for determining free Swap pages(k) in the system swapper file. This option is accessible only when "Swap Monitor" is selected in "Display Monitors". The Float to Top option enables/disables PM Patrol's ability to force visibility of it's windows when other windows overlay it's display. The CPU Graph option enables/disables a visually graphic display of CPU activity. This option is accessible only when "CPU Monitor" is selected in "Display Monitors". ═══ 6.8. Display Monitors ═══ This section describes the selectable display items. These items are described in detail under "Status Line" help. Select which items you want to be displayed on the PM Patrol Status Line. ═══ 6.9. Status Line ═══ This section describes items displayed on the main PM Patrol status line ═══ 6.9.1. Current Time ═══ Display of the current date and time updated every 1 minute ═══ 6.9.2. Elapsed Time ═══ Display of the elaped time since PM Patrol started or since last reset found in "Utility" menu accessed from the Options dialog or right click the PM Patrol status line. This is updated every minute. Being resettable, the Elapsed time offered by PM Patrol allows you to monitor how long you have working on something. Then reset it when beginning to work on something else. Useful to some. ═══ 6.9.3. System Up-Time ═══ Display the total time that OS/2 has been up and running since last boot. ═══ 6.9.4. Keyboard Status ═══ The Keyboard Status displays the status of CapsLock, NumLock, and ScrollLock keyboard settings. ═══ 6.9.5. Drives Online ═══ This item displays the current drive letters for available drives accessable from this computer. Network drives are supported. ═══ 6.9.6. Drive1 Monitor ═══ Displays the free space (MB) for a selected drive. To select a different drive to monitor you may choose you one of the following methods: 1. Single click the right mouse button on the PM Patrol Status line and then select the "Drives" menu item. Select "Monitor" to choose a drive. 2. Single click on the PM Patrol Status line to get the Options dialog. Then select the "Utility" menu bar item followed by the "Drives" menu option. ═══ 6.9.7. Drive2 Monitor ═══ Displays the free space (MB) for a second selected drive. To select a different drive to monitor you may choose you one of the following methods: 1. Single click the right mouse button on the PM Patrol Status line and then select the "Drives" menu item. Select "Monitor" to choose a drive. 2. Single click on the PM Patrol Status line to get the Options dialog. Then select the "Utility" menu bar item followed by the "Drives" menu option. ═══ 6.9.8. Swap Monitor ═══ This display option displays the current size of the OS/2 swapper file. Optionally, if (c)Theseus Swap is enabled, this will also display the amount of free frames (k) inside the active swapper file. Refer to (c)Theseus documentation for details of free swapper frames for more detail on this topic. ═══ 6.9.9. Memory Monitor ═══ This displays the amount of free RAM (k) and the largest free block (LFB) of memory (k). Optionally, if (c)Theseus RAM is enabled, this will instead display free memory according to (c)Theseus along with the amount of memory (k) that is idle. Refer to (c)Theseus documentation for details of free memory and idle memory for more detail on this topic. ═══ 6.9.10. Process Summary ═══ This display item show the number of OS/2 processes and threads in the system. This includes PIDs and TIDS of any state; Blocked, Running, and Runnable. Additionally, the current active number of windows on the desktop are shown. ═══ 6.9.11. Battery Status ═══ This item informs the user how much battery power is remaining. Note: This option is accessible only if APM is installed via OS/2 and the computer is a mobile computer capable of power management (ie 386sl+). When (and if) the battery status is unknown, PM Patrol displays a question mark in replacement of the actual percentage of power remaining. ═══ 6.9.12. CPU Monitor ═══ PM Patrol monitors the CPU utilization every second. If the "CPU Graph" has been enabled in the Options dialog, then a psudo-graphical display is shown in addition to the percentage. Along with the current CPU load, PM Patrol also maintains a rolling average of CPU utilization over the past 1 minute. ═══ 7. Miscellaneous ═══ This section discusses various "catch-all" items of interest ═══ 7.1. Mouse control with PM Patrol ═══ Single click the left mouse button on the PM Patrol status line to get to PM Patrol Options. Single click the right mouse button on the PM Patrol status line for quick access the PM Patrol utilities menu. Single click the left and right mouse buttons (Chord click) on the PM Patrol status line to display the PM Patrol title bar and system menu. This allows you to move the PM Patrol status line to a desired position. Chord click again to hide the title bar, or select the "System Menu" box on the title bar and then select "Hide Controls". Note: Don't forget to "Save Settings" once you have positioned the PM Patrol status line where you want. ═══ 8. Caveat Utilitor! ═══ PM Patrol has been thoroughly tested amongst several configurations. When properly tuned, PM Patrol causes no system degradations. The overhead for PM Patrol is no more than 1-2 percent CPU load (average of 1 minutes) and only when resource sampling occurs. PStat Window monitoring causes minor delays in the form of breif CPU spikes. These spikes are normal and can be further controlled in the PM Patrol "Configuration" for "Refresh Rates". Use "Auto Refresh" selectively for 386 class machines. Several of the PM Patrol sampling threads run at or near "Idle" time priority - when there is little or no system activity. The PM Patrol defaults and minimum allowable setting for "Refresh Rates" protects you from system-wide degradation. Please report any problems, comments, and suggestions to CompuServe ID: 72702,2320 ═══ 9. Disclaimer ═══ This product is supplied "as is", and without any warranties. WallyWare accepts no responsibility for any loss or damage; whether physical, financial, emotional, social, mental, marital, or otherwise that may result from the use of this product. ═══ 10. What's new ═══ The following items are new in this version of PM Patrol: 1. Increased the Logger maximum frequency from 5 to 60 seconds (1 minute) for LAN Administation purposes. Refer to online help for more details, Logger overhead, and how the logger is also designed for real-time monitoring. 2. Fixed a problem where the Swap and Process Summary refresh spin-button rates were flip-flopped in the "General Configuration" dialog. Sorry. The following items were introduced in the prior version of PM Patrol: 1. This version causes the PM Patrol profile to be initialized due to the addition of new profile data. Sorry for the inconvenience. 2. Due to very popular demand, PM Patrol now adds the ability to monitor 2 disk drives for free space. 3. Added an "extended Logging" facility providing ability to log all selected monitor items that display on the PM Patrol main status line. The ability to do continuous logging to network drives is supported as well as logging at startup. 4. Added several customization items for Logging, including status line color while logger is active, notifications, primary and backups options. 5. Added ability to view and/or delete Logger log files. Viewer program is user selectable. 6. Added the ability to monitor total system "up-time". This compliments the PM Patrol "Elapsed" time which is user resettable. 7. The "AppTime" percentage for PStat Thread monitoring is now calculated to weigh only against the effort of other threads in the same process (PID). 8. All monitor items have been broken out (ungrouped) to further support the ability to customize the PM Patrol main status line appearance. 9. The PM Patrol defaults have been realigned toward popular demands. 10. (c)Theseus/2 can be obtained by contacting IBM, OS/2 User Group BBS's, or WallyWare. 11. (c)SPM/2 can only be obtained by contacting IBM. Note: The file "HISTORY.TXT" contains a complete list of the PM Patrol enhancements, fixes, and changes throughout previous versions. For you're convenience, this file also contains an accumulative list of outstanding known problems. None are serious show stoppers.