home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR24
/
PMP203.ZIP
/
PMPATROL.INF
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1993-12-21
|
21KB
|
687 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 CONFIG.SYS device driver
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 including IBM's PCC BBS.
ΓòÉΓòÉΓòÉ 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
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 to me via my 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. I will
soon have Internet access and will be able to be reached there as well.
I check all mail sources daily.
ΓòÉΓòÉΓòÉ 4. How do I ? ΓòÉΓòÉΓòÉ
This section describes how to do things in PM Patrol that may not be obvious.
ΓòÉΓòÉΓòÉ 4.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 "Process Status".
ΓòÉΓòÉΓòÉ 4.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.
ΓòÉΓòÉΓòÉ 4.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.
ΓòÉΓòÉΓòÉ 4.4. Obtaining (c)Theseus/2 ΓòÉΓòÉΓòÉ
Theseus is available on several BBSs. Make sure you get the latest version.
Theseus is shipped with SPM/2 which can be puchased from IBM for OS/2
ΓòÉΓòÉΓòÉ 5. Production Information ΓòÉΓòÉΓòÉ
This section describes what PM Patrol is and what it offers
ΓòÉΓòÉΓòÉ 5.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 recorded to the OS/2 clipboard 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).
ΓòÉΓòÉΓòÉ 5.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 captured for further review. Captured as text, display item
data can be manipulated using tools such as Rexx, AWK, and GREP.
Data from OS/2 resources sampled is highly reliable. Including support for IBM
Theseus.
Note: Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available
on many OS/2 BBS services including IBM's PCC BBS
ΓòÉΓòÉΓòÉ 5.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. Process, thread, semaphore, DLL, drivers, and shared memory activity
4. Process and thread load compared to other active OS/2 activities
5. Complete drive summary and detailed information
6. Disk Drives online (including network drives)
7. Free space for a selected drive (including network drives)
8. OS/2 swap activity (with support for IBM Theseus)
9. Identify system levels for OS/2 component installed
10. OS/2 memory activity (with support for IBM Theseus)
11. Active number of OS/2 processes, threads, and desktop windows
12. CPU utilization (current vs. rolling average over last 1 minute)
13. Battery status for mobile computers
14. 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 including IBM's PCC BBS
PM Patrol contains a growing number of utility functions such as:
1. Robust monitoring and capture of OS/2 processes and threads
2. Sumary and detailed information of drives
3. Summary and detailed information of OS/2 configuration
4. Identify system levels for OS/2 component installed
5. Minimize all visible windows
6. Restore all minimized windows
7. System shutdown
8. Lockup system
9. Suspending power for mobile computers
10. Suspending display
11. Starting an OS/2 window session
12. Changing the size of the mouse for standard VGA displays
13. And more.
ΓòÉΓòÉΓòÉ 5.4. Who done it? ΓòÉΓòÉΓòÉ
(c)PM Patrol was developed by WallyWare.
WallyWare develops OS/2 and UNIX software with absolutely no interest in
DOS/Windows. Why promote a bad idea?
ΓòÉΓòÉΓòÉ 6. Options ΓòÉΓòÉΓòÉ
This section describes items in the Options dialog
ΓòÉΓòÉΓòÉ 6.1. Menu Bar Items ΓòÉΓòÉΓòÉ
This section describes menu bar items in the Options dialog.
ΓòÉΓòÉΓòÉ 6.1.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.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.2. Process Info ΓòÉΓòÉΓòÉ
The Process Info 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 is as follows: Press Escape to exit the
dialog.
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 Process Status is as follows: Press Escape to exit
the dialog.
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 is for a given PID and has the
following attributes: Press Escape to go back to Process Information.
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 thread spends in the application along with the
percentage of "AppTime" compared to TOTAL system-wide "AppTime" for all
applications. This is relative to other active applications getting time
slices.
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 dialog.
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
dialog.
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 dialog.
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.1.3. Find ΓòÉΓòÉΓòÉ
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.1.4. Clip Manager ΓòÉΓòÉΓòÉ
The Clip Manager option will be available in the next release and will provide
multiple clip boards
ΓòÉΓòÉΓòÉ 6.1.1.5. Recorder ΓòÉΓòÉΓòÉ
The Recorder starts/stops the recording mechanism in PM Patrol to capture the
main status line information to the OS/2 clipboard for further review
ΓòÉΓòÉΓòÉ 6.1.1.6. OS/2 Window ΓòÉΓòÉΓòÉ
The OS/2 Window options opens a new OS/2 command window
ΓòÉΓòÉΓòÉ 6.1.2. System ΓòÉΓòÉΓòÉ
The System section provides several OS/2 environmental functions
ΓòÉΓòÉΓòÉ 6.1.2.1. Lockup ΓòÉΓòÉΓòÉ
The Lockup option invokes the OS/2 "lockup" facility and forces the user to
"log on"
ΓòÉΓòÉΓòÉ 6.1.2.2. Shutdown ΓòÉΓòÉΓòÉ
The Shutdown option performs a OS/2 shutdown
ΓòÉΓòÉΓòÉ 6.1.2.3. 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.2.4. 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.
The Mouse Size option allows users of standard VGA to specify the size of the
mouse. This is not available for SVGA, XGA, etc.
ΓòÉΓòÉΓòÉ 6.1.3. Settings ΓòÉΓòÉΓòÉ
The Settings section provides PM Patrol configuration items
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)
The Restore Defaults option resets all PM Patrol options, colors, window
position(s) and options settings to their original defaults
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".
The Font option allows you to set the display font for all PM Patrol windows.
This can also be accomplished by using the Font Palette in OS/2 the "System
Settings" folder and dragging the font to the PM Patrol Status line.
ΓòÉΓòÉΓòÉ 6.1.4. Exit ΓòÉΓòÉΓòÉ
This option is used to end the PM Patrol program
ΓòÉΓòÉΓòÉ 6.1.5. Help ΓòÉΓòÉΓòÉ
The help menu allows quick access to PM Patrol help items including General
Help for all online help items.
ΓòÉΓòÉΓòÉ 6.2. 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 Cancel button resets any PM Patrol settings to their original status prior
to entering the Options dialog. This allows you to temporarily change settings
while the Options dialog is visible.
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.3. 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 Utilization" is selected in "Display Items".
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 Utilization" is selected in "Display Items".
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 Utilization" is selected in
"Display Items".
The 15 Min Timer option enables/disables an audible sound which occurs at each
quarter hour. Use this feature to remind you of passing time.
ΓòÉΓòÉΓòÉ 6.4. Display Items ΓòÉΓòÉΓòÉ
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.5. Sample Frequencies ΓòÉΓòÉΓòÉ
This section describes the frequency of which PM Patrol items are sampled and
refreshed on the main Status Line.
The Drive Frequency controls how often (seconds) PM Patrol checks what drives
are online and how much free disk space resides on each.
The Swap Frequency 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 1-2 seconds for each each
sample. Set this frequency to 300 seconds (5 minutes) when using (c)Theseus
Swap.
The RAM Frequency controls how often (seconds) PM Patrol checks free RAM.
The Process Frequency controls how often (seconds) PM Patrol enumerates the
number of active OS/2 processes, threads. and OS/2 windows.
The Clip Size controls how much memory (k) is used to hold information when
"Recording" the PM Patrol Status Line. The maximum is 64k which equates to
about 10-13 minutes of data.
ΓòÉΓòÉΓòÉ 7. Status Line ΓòÉΓòÉΓòÉ
This section describes items displayed on the main PM Patrol status line
ΓòÉΓòÉΓòÉ 7.1. Current Date and Time ΓòÉΓòÉΓòÉ
Display of the current date and time updated every 1 minute
ΓòÉΓòÉΓòÉ 7.2. Elapsed time ΓòÉΓòÉΓòÉ
Display of the elaped time since PM Patrol started or since last reset found in
"Settings" of the Options dialog. This is updated every minute.
Note: This display item is associated with the Current Data and Time display
option in the Options dialog. Unless the Current Date and Time display item is
selected, the elapsed time will not display.
ΓòÉΓòÉΓòÉ 7.3. Keyboard Status ΓòÉΓòÉΓòÉ
The Keyboard Status displays the status of CapsLock, NumLock, and ScrollLock
keyboard settings.
ΓòÉΓòÉΓòÉ 7.4. Drives Utilization ΓòÉΓòÉΓòÉ
The Drives online displays all disk drives accessible and then shows how much
free space (MB) is available for the selected drive. To select a different
drive to monitor choose one of the following methods:
1. Single clock the right mouse button on the PM Patrol Status line and then
double click on the desired 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.
ΓòÉΓòÉΓòÉ 7.5. Swap Utilization ΓòÉΓòÉΓòÉ
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 space (k) inside the swapper file.
Refer to (c)Theseus documentation for details of free swapper frames for more
detail on this topic.
ΓòÉΓòÉΓòÉ 7.6. Memory Utilization ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.7. Process Status ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 7.8. 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.
ΓòÉΓòÉΓòÉ 7.9. CPU Utilization ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 8. Miscellaneous ΓòÉΓòÉΓòÉ
This section discusses various "catch-all" items of interest
ΓòÉΓòÉΓòÉ 8.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 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.
Note: Don't forget to "Save Settings" once you have positioned the PM Patrol
status line where you want.
ΓòÉΓòÉΓòÉ 9. 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 2-3 percent CPU load and only when resource sampling
occurs for the Status Line.
Process Status 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.
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 my CompuServe mail
box. The ID is: 72702,2320
ΓòÉΓòÉΓòÉ 10. 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.