home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR24
/
PMP207.ZIP
/
PMPATROL.HLP
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1994-01-29
|
30KB
|
1,017 lines
ΓòÉΓòÉΓòÉ 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.