home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: SysTools
/
SysTools.zip
/
cpumon.zip
/
CPUMONP.HLP
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1994-07-22
|
48KB
|
1,661 lines
ΓòÉΓòÉΓòÉ 1. Copyright Information ΓòÉΓòÉΓòÉ
Copyright (c) BonAmi Software Corporation, 1991-1994. All rights reserved.
For all product information, please contact:
BonAmiSoftwareCorporation
60 Thoreau Street, Suite 219
Concord, Massachusetts 01742
U.S.A.
Telephone: (508) 371-1997
FAX: (508) 371-2333
CompuServe: 70314,513
Internet: 70314.513@compuserve.com
ΓòÉΓòÉΓòÉ 2. Contacting BonAmi ΓòÉΓòÉΓòÉ
For all product information, please contact:
BonAmiSoftwareCorporation
60 Thoreau Street, Suite 219
Concord, Massachusetts 01742
U.S.A.
Telephone: (508) 371-1997
FAX: (508) 371-2333
CompuServe: 70314,513
Internet: 70314.513@compuserve.com
ΓòÉΓòÉΓòÉ 3. Help for Help ΓòÉΓòÉΓòÉ
Most of the menu items have help available. Select General Help for an
overview of CPU Monitor Plus. Select Keys Help for a description of the special
key assignments and combinations used by CPU Monitor Plus.
ΓòÉΓòÉΓòÉ 4. Keys Help ΓòÉΓòÉΓòÉ
The special keys and key-combinations usable in CPU Monitor Plus are:
F1 Display context sensitive help;
Shift-F3 Save current selections and preferences;
Ctrl-0 Display the percent CPU time used by each process;
Ctrl-1 Display all processes;
Ctrl-2 Display the percent CPU idle time;
Ctrl-3 Display all process threads;
Ctrl-4 Display private RAM and CPU utilization values for all processes.
Ctrl-5 Display CPU and Idle utilization on the title bar.
Ctrl-C Modify system defaults and configuration;
Ctrl-D Disable the timed display;
Ctrl-E Enable the timed display;
Ctrl-F Display specific process data fields;
Ctrl-K Kill a specified process;
Ctrl-L Log output to a file;
Ctrl-N Update the display now!
Ctrl-O Modify how the display is ordered;
Ctrl-P Change a thread's priority;
Ctrl-R Display specific RAM data fields;
Ctrl-S Select specific processes and threads to display;
Ctrl-T Start a specified program;
Ctrl-U Suspend a specified thread;
Ctrl-V Select the custom view display.
Ctrl+Insert Copy the display to the clipboard
Ctrl-W Select the custom system view display.
Ctrl-Y Display specific system data fields for CPU, RAM, Disks, and
Communication Ports.
ΓòÉΓòÉΓòÉ 5. About CPU Monitor Plus ΓòÉΓòÉΓòÉ
Thank you for choosing CPU Monitor Plus. The engineers at BonAmi Software
designed CPU Monitor Plus to be the premier OS/2 Performance and Analysis
software.
CPU Monitor Plus includes a bonanza of powerful features:
o Real-time graphical displays that monitor all OS/2, DOS, and Windows
programs;
o CPU Utilization for all processes and threads;
o RAM Utilization including In-Use, Allocated, Private and Shared amounts;
o Full COM Port and Fixed Disk performance data including:
- Hardware utilization;
- Bytes read and written per second;
- Total bytes read and written;
o Nearly 100 OS/2 System metrics and RAM ratio values;
o Swap file, page faults and virtual memory monitored continuously;
o Both predefined and easily customizable displays;
CPU Monitor Plus provides even more features to help monitor and control your
OS/2 computer:
o Stop any OS/2, DOS, and Windows program including invisible, runaway, and
background programs;
o Log all performance data to a file for later analysis;
o Start and stop programs, set execution priorities, suspend and resume
executing individual threads, and more!
Choose one of the topics below for more information on CPU Monitor Plus.
Related Information
o CPU Monitor Plus and OS/2
o CPU Monitor Plus Menu Options
ΓòÉΓòÉΓòÉ 5.1. CPU Monitor Plus & OS/2 ΓòÉΓòÉΓòÉ
Under OS/2, a program, its data, and its threads of execution are collectively
called a process. A process is created when a program is loaded into memory by
the OS/2 system loader (part of the OS/2 kernel).
Threads in a process run independently, each with their own stack and execution
privileges. OS/2 is multitasking in that threads from multiple processes all
compete for and share the computer's CPU, memory, and device resources.
CPU Monitor Plus monitors every important detail of a program's execution
including it's:
o CPU, RAM, Disk and COM Port utilization;
o OS/2 execution priority and state;
o All OS/2 Session, Process and Thread identifiers.
In addition, CPU Monitor Plus monitors the important system activities
including:
o System Busy, Idle and Interrupt activity;
o Real and Virtual memory availability;
o Page Fault rates and Swap File size.
Related Information
o CPU Monitor Plus Menu Options
o About CPU Monitor Plus
ΓòÉΓòÉΓòÉ <hidden> CPU Monitor Plus Menu Options OS/2 ΓòÉΓòÉΓòÉ
Use the File pull-down menu to:
o Log CPU Monitor Plus output to a file;
o Save or reset current display selections and preferences;
o UnInstall CPU Monitor Plus;
Use the Edit pull-down menu to copy the current CPU Monitor Plus display to
the clipboard.
The Commands pull-down menu allows you to:
o Start new OS/2, DOS and Windows programs from CPU Monitor Plus;
o Stop a currently executing process;
o Set the execution priority of individual threads within a process;
o Suspend a currently executing thread;
o Instantaneously examine the current CPU Utilization data.
Use the View pull-down menu to:
o Select specific processes and threads to display;
o Fully customize the CPU Monitor Plus display;
o Choose from several useful predefined displays.
Use the Options pull-down menu to customize, enable and disable the display.
Also use this to set the statistics gathering parameters.
Additional help is available for all menu choices.
To quit CPU Monitor Plus, select Close from the System Menu or the Window/Task
list.
Related Information
o File Menu options
o Edit Menu options
o View Menu options
o Commands Menu options
o Options Menu options
ΓòÉΓòÉΓòÉ 6. File Menu Help ΓòÉΓòÉΓòÉ
Commands available from the File menu are:
o Log output to a file;
o Save current display options;
o Reset selectable display options;
o UnInstall CPU Monitor Plus from OS/2;
ΓòÉΓòÉΓòÉ 6.1. Log File ΓòÉΓòÉΓòÉ
Use Log File to change the file logging status. Select a file for file
logging, or disable file logging. When logging is enabled and a log file has
been selected, CPU Monitor Plus copies the displayed system data to the log
file.
The rate at which new data is appended to the log file is determined by the
display frequency setting. New data is appended each time the screen is
updated. The display frequency rate may be modified via the Set Configuration
dialog.
Note: Data may be logged to at most one file at a time.
File logging can also be automatically enabled when CPU Monitor Plus starts via
a command line switch. See the CPU Monitor Plus User's Guide for details on
using the command line switches.
Log File is selected from the File menu. or with the Ctrl-L hot key.
ΓòÉΓòÉΓòÉ 6.2. Save ΓòÉΓòÉΓòÉ
Use Save to save the current program options and settings. When CPU Monitor
Plus is next started, the saved options will automatically be restored. The
options saved are the current values for:
o Screen colors;
o Display window dimensions;
o Display number base;
o Display font;
o Custom display fields and ordering;
o Display frequency rate;
o Statistics gathering frequency;
o Currently selected display.
Save is selected from the File menu or with the Shift-F3 hot key.
ΓòÉΓòÉΓòÉ 6.3. Reset ΓòÉΓòÉΓòÉ
Use Reset to reset all user selectable settings to their factory defaults. The
following settings are reset:
o Screen colors;
o Display font;
o Custom display fields and ordering;
o Display frequency rate;
o Statistics gathering frequency;
o Default display;
o Log file and logging status;
o Display Enabled;
o Selected processes in customized display.
o Display number base;
Note: Reset does not cause any of the reset settings to be saved. The Save
menu option is required to save these values.
Reset is selected from the File menu.
ΓòÉΓòÉΓòÉ 6.4. UnInstall ΓòÉΓòÉΓòÉ
Select UnInstall to permanently unload CPU Monitor Plus from your system.
UnInstall updates the OS2.INI file and prevents OS/2 from automatically loading
the CPU Monitor Plus dynamic link libraries.
UnInstall will not delete any CPU Monitor Plus files, nor will it update your
CONFIG.SYS file. Any references to the CPU Monitor Plus device drivers in the
CONFIG.SYS file must be removed manually.
The Un-Installation process will be complete once OS/2 has been shut down and
restarted. Of course, CPU Monitor Plus may be reinstalled later at your
convenience.
For more information on the Installation and Un-Installation process, refer to
the CPU Monitor Plus User's Guide.
UnInstall is selected from the File menu.
ΓòÉΓòÉΓòÉ 7. Edit Menu Help ΓòÉΓòÉΓòÉ
Commands available from the Edit menu are:
o Copy the CPU Monitor Plus display to the clipboard.
ΓòÉΓòÉΓòÉ 7.1. Copy to Clipboard ΓòÉΓòÉΓòÉ
Use Copy to copy the current CPU Monitor Plus display to the clipboard. The
clipboard is used to transfer and share information between different programs.
The visible portion of the CPU Monitor Plus display is copied as a bitmap
image. The complete CPU Monitor Plus display, including all scrolled areas, is
copied as unformatted text to the clipboard.
See your OS/2 documentation for additional information on accessing and using
the clipboard.
Copy is selected from the Edit menu. or with the Ctrl-Insert hot key.
ΓòÉΓòÉΓòÉ 8. View Menu Help ΓòÉΓòÉΓòÉ
Commands available from the View menu are:
o Select processes to monitor;
o Set the display order criteria;
o Choose the process data fields, RAM data fields, and System data fields to
include in the display.
In addition, there are several pre-defined and custom display options. They
display:
o Percent CPU time used by each process;
o All processes and process data;
o Percent CPU Idle time;
o All threads and thread data;
o RAM and CPU usage for each processes;
o The title bar showing CPU and idle usage;
o The currently configured custom settings;
o The currently configured system settings.
ΓòÉΓòÉΓòÉ 8.1. Select ΓòÉΓòÉΓòÉ
Use Select to select the specific processes and threads to be displayed. Only
those processes chosen will be included in the display. This option is useful
to focus on certain key processes.
Select is selected from the View menu or with the Ctrl-S hot key.
ΓòÉΓòÉΓòÉ 8.2. Ordering ΓòÉΓòÉΓòÉ
Use Ordering to choose how the individual items in the display are ordered.
Choose ascending or descending ordering based upon:
o Percent CPU Utilization;
o Process ID;
o Process Name;
o Process Priority;
o Session ID;
o Parent's Process ID.
Ordering is selected from the View menu or with the Ctrl-O hot key.
Related Information
o Process Data Fields
ΓòÉΓòÉΓòÉ 8.3. Process Data Fields ΓòÉΓòÉΓòÉ
Use Process Data Fields to select specific process data fields to include in
the Custom View display. The following information can be included:
o Process Name;
o Process ID;
o Parent's Process ID;
o Session ID;
o Thread ID for each thread in the process;
o Process Priority;
o Process Execution State;
o Percent CPU time idle;
o Percent CPU time used by process or thread;
o Total CPU Time used by process or thread.
The customized display combines the above process data fields with any other
selected RAM data fields. System data fields are displayed separately in the
customized System display.
All field choices are preserved even after another display mode is chosen. To
return to the customized display, invoke the Custom View menu item.
The field selections are not automatically saved when CPU Monitor Plus is
terminated. To save these choices, select the Save menu item from the File
menu.
Process Data Fields is selected from the View menu or with the Ctrl-F hot key.
Related Information
o RAM Data Fields
o System Data Fields
o View Menu Item
ΓòÉΓòÉΓòÉ 8.4. RAM Data Fields ΓòÉΓòÉΓòÉ
Use RAM Data Fields to select the specific RAM data fields to include in the
Custom View display. The following information can be included:
o Private In-Use RAM;
o Private Allocated RAM;
o Shared In-Use RAM;
o Shared Allocated RAM;
o Total In-Use RAM;
o Total Allocated RAM;
o RAM use ratios.
The RAM data field choices are combined with the process data field choices in
the Custom View display. System data fields are displayed separately in the
Custom System View display.
All field choices are preserved even after a pre-defined display mode is
chosen. To return to the selected field choices, invoke the Custom View menu
item.
The field choices are not automatically saved when CPU Monitor Plus is
terminated. To save these choices, select the Save menu item from the File
menu.
RAM Data Fields is selected from the View menu or with the Ctrl-R hot key.
Related Information
o Process Data Fields
o System Data Fields
o View Menu Item
ΓòÉΓòÉΓòÉ 8.5. System Data Fields ΓòÉΓòÉΓòÉ
Use System Data Fields to select specific system data fields to include in a
customized display. The following information can be included:
o Communication (COM) Ports activity;
o Fixed disk activity;
o CPU utilization, including idle and interrupt servicing time;
o RAM allocation and virtual memory availability data;
o Paging and swap file activity.
The COM port and Disk drive activity can be displayed using three different
measures: Rate, Total, and Busy. COM port rate and total values are measured
in bytes per second and total bytes transferred. Disk drive rate and total
activity is measured in blocks or sectors (a sector is assumed to be 512
bytes) per second and total blocks or sectors transferred. Busy measures the
percentage of time that the COM port or disk was actually processing data
during the measured interval.
Both the COM port and Disk drive activity can be further expanded into
Reading, Writing and Total (reading + writing) measures.
Three different measures of the CPU activity are available. All are displayed
as percentages over the measured interval. Idle represents the percentage of
time that the CPU would have been available for use. Busy shows the
percentage of time that the CPU was not available for additional work.
Interrupt represents the percentage of time that the CPU was servicing
hardware interrupts. Note that Busy + Idle = 100%. The CPU measures can be
displayed using either bar graphs or decimal percentages.
Four different measures of RAM utilization are available. These may be
displayed in units of bytes, kilobytes or pages (assumed 4096 bytes to a
page). Installed is the total amount of system RAM available to OS/2.
Resident represents the amount of memory currently reserved (and generally
locked) for use by OS/2. In-Use and Free represent the instantaneous measures
of the RAM that was marked in use and free respectively at the time the
measure was taken. Since OS/2 is a virtual memory operating system, these
amounts are constantly changing and should be used only as a general guide to
memory availability. See the CPU Monitor Plus User's Guide for more details.
Two additional measures of Virtual Memory are also available. Swap is the
current size of the OS/2 swap file. Virtual displays the maximum currently
available virtual memory in the system. This number includes free space on
the drive containing the OS/2 swap file plus any free physical RAM.
Paging shows the number of page faults per second and the total number of page
faults.
Note: Individual process data fields and RAM data fields are displayed
separately in the Custom View
All field choices are preserved even after a predefined display mode is
chosen. To return to the selected field choices, invoke the Custom System
View menu item.
The field choices are not automatically saved when CPU Monitor Plus is
terminated. To save these choices, select the Save menu item from the File
menu.
System Data Fields is selected from the View menu or with the Ctrl-Y hot key.
Related Information
o Custom System View
o Process Data Fields
o RAM Data Fields
o View Menu Item
ΓòÉΓòÉΓòÉ 8.6. CPU Time View ΓòÉΓòÉΓòÉ
Use the CPU Time predefined display to view the Percent CPU time used by each
process in decreasing order.
The CPU Time predefined view is selected from the View menu or with the Ctrl-0
hot key.
ΓòÉΓòÉΓòÉ 8.7. Process ID's View ΓòÉΓòÉΓòÉ
Use the Process ID's predefined display to view information for all processes
in Process ID order.
The Process ID's predefined view is selected from the View menu or with the
Ctrl-1 hot key.
ΓòÉΓòÉΓòÉ 8.8. Idle Time View ΓòÉΓòÉΓòÉ
Use the Idle Time predefined display to view the Percent CPU time idle.
The Idle Time predefined view is selected from the View menu or with the Ctrl-2
hot key.
ΓòÉΓòÉΓòÉ 8.9. Threads View ΓòÉΓòÉΓòÉ
Use the Threads predefined display to view information for all threads in
Process and Thread ID order.
The Threads predefined view is selected from the View menu or with the Ctrl-3
hot key.
ΓòÉΓòÉΓòÉ 8.10. Private RAM & CPU Usage View ΓòÉΓòÉΓòÉ
Use the Private RAM predefined display to view the percent CPU time along with
the private allocated and private in-use RAM usage for each process.
The memory totals are displayed as either decimal or hexadecimal numbers,
according to the current number base selection.
The Private RAM predefined view is selected from the View or with menu the
Ctrl-4 hot key.
Related Information
o CPU Monitor Plus Set Configuration
ΓòÉΓòÉΓòÉ 8.11. Title Bar View ΓòÉΓòÉΓòÉ
Check the Title Bar option to have the title bar display CPU utilization
values. The process with the currently highest CPU use and the current CPU idle
time are both displayed. Checking this option again restores the program name
to the menu bar.
Note: You may find it useful to check the Title Bar View and then minimize CPU
Monitor Plus. The minimized icon will continue to display the highest CPU and
idle utilization. Or, instead of minimizing, simply reduce the display window
until only the title bar is shown. Both ways allow CPU Monitor Plus to run on
your desktop while taking up little screen space.
The Title Bar view option is selected from the View menu or with the Ctrl-5 hot
key.
ΓòÉΓòÉΓòÉ 8.12. Custom View ΓòÉΓòÉΓòÉ
Use Custom to select a customized display as specified by the Select, Process
Data Fields, RAM Data Fields and Order dialogs.
The Custom view is selected from the View menu or with the Ctrl-V hot key.
Related Information
o Select processes
o Process data fields
o RAM data fields
o Display ordering
ΓòÉΓòÉΓòÉ 8.13. Custom System View ΓòÉΓòÉΓòÉ
Use Custom System to select a customized display as specified by the System
Data Fields dialog. The following information can be included:
o Communication (COM) Ports activity;
o Fixed disk activity;
o CPU utilization, including idle and interrupt servicing time;
o RAM allocation and virtual memory availability data;
o Paging and swap file activity.
The Custom System view is selected from the View menu or with the Ctrl-W hot
key.
Related Information
o System data fields
o Custom View
o Process data fields
o RAM data fields
ΓòÉΓòÉΓòÉ 9. Commands Menu Help ΓòÉΓòÉΓòÉ
Commands available from the Commands menu are:
o Update the display now!
o Kill a specified process;
o Change a thread's priority;
o Suspend a currently executing thread;
o Start a specified program.
ΓòÉΓòÉΓòÉ 9.1. Update Now! ΓòÉΓòÉΓòÉ
Use Update Now! to force an update of the latest statistics data to the screen.
Update Now! will also update the log file if File Logging is enabled.
Update Now! is selected from the Commands menu or with the Ctrl-N hot key.
Related Information
o Display frequency;
ΓòÉΓòÉΓòÉ 9.2. Kill ΓòÉΓòÉΓòÉ
Use Kill to terminate a selected process. Note that programs may take
preventive action to prevent being terminated. Also, in some cases a selected
process cannot be terminated. When this occurs, a warning message may be
displayed.
Kill is selected from the Commands menu or with the Ctrl-K hot key.
ΓòÉΓòÉΓòÉ 9.3. Priority ΓòÉΓòÉΓòÉ
Use Priority to examine or change the execution priority of a process. Only
those threads and processes belonging to most Presentation Manager application
programs can have their priority changed.
Note that CPU Monitor Plus can also change its own execution priority if
requested.
CPU Monitor Plus can start OS/2, DOS and Windows programs and assign execution
priorities by using the Start dialog or a command line Start File.
Priority is selected from the Commands menu or with the Ctrl-P hot key.
Related Information
o Execution priority information
o Starting programs from CPU Monitor Plus
o Command Line switches
ΓòÉΓòÉΓòÉ <hidden> Priority Information ΓòÉΓòÉΓòÉ
OS/2 supports 4 classes of execution priority with 32 levels within each class.
In increasing order of priority the priority classes are:
o Idle
o Regular
o Foreground (or Fixed High)
o Time Critical
The 32 levels within a priority class are numbered 0-31 with 31 being the
highest priority.
Idle priority is intended for those threads that will execute only when no
other thread requires the CPU. Regular is the default execution priority for
most applications. Foreground priority is intended for a Regular priority
thread that is currently interacting with the user. Time Critical priority is
used for those applications that must respond quickly to system or application
events.
Refer to the CPU Monitor Plus User's Guide for more information on execution
priorities.
Related Information
o Changing execution priority
o Starting programs from CPU Monitor Plus
ΓòÉΓòÉΓòÉ 9.4. Start ΓòÉΓòÉΓòÉ
Use Start to start a program and set the program's execution priority from CPU
Monitor Plus. The started program executes independently from and
asynchronously to CPU Monitor Plus. OS/2, DOS and Windows executable programs
and batch files may be started from CPU Monitor Plus.
Start is selected from the Commands menu or with the Ctrl-T hot key.
Related Information
o Execution priority information
o Command Line switches
ΓòÉΓòÉΓòÉ 9.5. Suspend ΓòÉΓòÉΓòÉ
Use Suspend to suspend a currently executing thread or to restart a thread that
has been suspended. Only those threads and processes belonging to most
Presentation Manager application programs can be suspended and restarted.
Suspend is selected from the Commands menu or with the Ctrl-U hot key.
ΓòÉΓòÉΓòÉ 10. Options Menu Help ΓòÉΓòÉΓòÉ
Commands available from the Options menu are:
o Disable the timed screen update;
o Enable the timed screen update;
o Set Configure for the CPU Monitor Plus display and data collection.
ΓòÉΓòÉΓòÉ 10.1. Set Configuration ΓòÉΓòÉΓòÉ
Use Set Configuration to configure the CPU Monitor Plus display and statistics
collection mode. Configuration parameters include:
o Display color scheme;
o Number base;
o Screen font;
o Display frequency;
o Statistics gathering frequency.
Set Configuration is selected from the Options menu or with the Ctrl-C hot
key.
ΓòÉΓòÉΓòÉ 10.1.1. Color Scheme ΓòÉΓòÉΓòÉ
Use Change Colors to choose between a number of different predefined color
schemes.
The color scheme may be modified in the Set Configuration dialog. Select Set
Configuration from the Options menu or with the Ctrl-C hot key.
ΓòÉΓòÉΓòÉ 10.1.2. Number Base Selection ΓòÉΓòÉΓòÉ
Use Number Base to select either decimal (base 10) or hexadecimal (base 16)
number displays. Hexadecimal values may be useful to correlate CPU Monitor
Plus displays with other OS/2 system and programming information. The default
is to display all numbers as decimal integers.
Note: Percentages and rates are always displayed in decimal integers
regardless of the specified number base.
The number base may be modified in the Set Configuration dialog. Select Set
Configuration from the Options menu or with the Ctrl-C hot key.
ΓòÉΓòÉΓòÉ 10.1.3. Font Selection ΓòÉΓòÉΓòÉ
Use Font Selection to select a different fixed width Courier or System
Monospaced font for the CPU Monitor Plus display.
The display font may be modified in the Set Configuration dialog. Select Set
Configuration from the Options menu or with the Ctrl-C hot key.
ΓòÉΓòÉΓòÉ 10.1.4. Statistics Gathering Frequency ΓòÉΓòÉΓòÉ
Use Statistics Frequency to change the statistics gathering mode and frequency.
There are two different modes of operation:
o Statistics gathering using the CPU Monitor Plus device driver;
o Statistics gathering from CPU Monitor Plus
The Slow, Normal and Fast options specify that statistical data be collected
by the CPU Monitor Plus device driver at a rate of 5, 10 and 32 times per
second respectively. Fast provides the highest level of accuracy for CPU
utilization estimates. Slow and Normal both provide high levels of accuracy
while using less CPU time to gather the data.
The Alternate mode specifies that CPU Monitor Plus itself gather all
statistical information. This method is less accurate than using the CPU
Monitor Plus device driver, since CPU Monitor Plus runs only as a standard
OS/2 application. As such, its own CPU allocation is in contention with all
other applications running on the system.
BonAmi Software recommends using the Slow or Normal gathering frequency for
most environments. Use the Alternate mode to disable all statistics gathering
by the CPU Monitor Plus device driver.
Note: The Alternate mode gathers data at a rate dependent on the display
frequency. In general, shorter display frequencies provide higher accuracy for
the Alternate method. The display frequency rate has little effect when using
one of the device driver modes.
Refer to the CPU Monitor Plus User's Guide for more details on the statistics
gathering options available in CPU Monitor Plus.
The statistics gathering frequency may be modified in the Set Configuration
dialog. Select Set Configuration from the Options menu or with the Ctrl-C hot
key.
ΓòÉΓòÉΓòÉ 10.1.5. Display Frequency ΓòÉΓòÉΓòÉ
Use Display Frequency to change the display update frequency. You may select
any value between 1 and 60 seconds.
Note: When using the CPU Monitor Plus device driver, process statistics are
gathered independently of the display frequency. Different display frequency
rates will influence statistics gathered by CPU Monitor Plus only when the CPU
Monitor Plus device driver is not used.
Refer to the CPU Monitor Plus User's Guide for more details on the statistics
gathering methods used in CPU Monitor Plus.
The display frequency can be automatically set when CPU Monitor Plus starts via
a command line switch. See the CPU Monitor Plus User's Guide for details on
using the command line switches.
The display frequency may be modified in the Set Configuration dialog. Select
Set Configuration from the Options menu or with the Ctrl-C hot key.
ΓòÉΓòÉΓòÉ 10.2. Disable ΓòÉΓòÉΓòÉ
Use Disable to disable the timed display of statistics to the screen. This
will also disable logging output to a file.
Select the Enable menu item to restart the screen display.
Disable is selected from the Options menu or with the Ctrl-D hot key.
ΓòÉΓòÉΓòÉ 10.3. Enable ΓòÉΓòÉΓòÉ
Use Enable to enable the timed display of statistics to the screen. By
default, the display is normally enabled. If the Disable option has been
invoked, Enable will restart the timed display. This will also restart logging
output to a file.
Enable is selected from the Options menu or with the Ctrl-E hot key.
ΓòÉΓòÉΓòÉ <hidden> Log File Help ΓòÉΓòÉΓòÉ
Enter a filename where the CPU Monitor Plus data will be logged. Select:
o Enable to enable data logging;
o Disable will disable data logging.;
o Overwrite will erase the log file if it already exists;
o Append will add log data to the end of an existing file.
Choose OK to confirm the above selections. Cancel will abort any changes
selected. Help displays this text.
If the Log File becomes unavailable or if the file is unable to accommodate
additional data, an error message will be displayed. In these cases, file
logging will be disabled until a new log file is selected.
Note: Data may be logged to at most one file at a time.
File logging can also be automatically enabled when CPU Monitor Plus starts
via a command line switch. See the CPU Monitor Plus User's Guide for details
on using the command line switches.
Related Information
o Command Line switches
ΓòÉΓòÉΓòÉ <hidden> Kill Process Help ΓòÉΓòÉΓòÉ
Select the process that is to be terminated. Press Kill to terminate or press
Cancel to abort any selections. If the Confirm Kill Request Check box is
checked, a confirmation request will be issued before the process is killed.
De-selecting the check box eliminates confirmations.
To efficiently kill a series of processes, double click on each Process Name
instead of pressing the Return key or the Kill push button.
Note that the list of processes is not automatically updated. Press Refresh to
update the list. CPU Monitor Plus retains process information for a period of
time dependent on the current display frequency. Furthermore, be aware that a
process may not terminate immediately.
Some processes take explicit measures to avoid being terminated. In this case,
the process may ignore attempts to kill it and still continue to execute.
Related Information
o CPU Monitor Plus Set Configuration
ΓòÉΓòÉΓòÉ <hidden> Set Configuration Display Help ΓòÉΓòÉΓòÉ
Configure the CPU Monitor Plus display and statistics collection mode. The
following parameters can be set:
Display Frequency
Enter the number of seconds to wait between screen updates. You may select any
value between 1 and 60 seconds.
Note: The CPU Monitor Plus device driver carries out statistics gathering
independently of the display frequency. Nevertheless, the display frequency
influences statistics gathering when CPU Monitor Plus itself collects the
statistics without a device driver.
Refer to the CPU Monitor Plus User's Guide for more details on the statistics
gathering methods used in CPU Monitor Plus.
The display frequency can also be automatically set when CPU Monitor Plus
starts via a command line switch. See the CPU Monitor Plus User's Guide for
details on using the command line switches.
Statistics Gathering Frequency
Enter the desired statistics gathering frequency mode. The Slow, Normal, and
Fast options specify that statistical data be collected by the CPU Monitor Plus
device driver at a rate of 5, 10 and 32 times per second respectively. Fast
provides the highest level of accuracy for CPU utilization estimates. Slow and
Normal both provide high levels of accuracy while using less CPU time to gather
the data.
The Alternate mode specifies that CPU Monitor Plus itself gather all
statistical information. This method is less accurate than using the CPU
Monitor Plus device driver, since CPU Monitor Plus runs only as a standard OS/2
application. As such, its own CPU allocation is in contention with all other
applications running on the system.
BonAmi Software recommends using the Slow or Normal gathering frequency for
most environments. Use the Alternate mode to disables all statistics gathering
by the CPU Monitor Plus device driver.
Note: The Alternate mode gathers data at a rate dependent on the display
frequency. In general, shorter display frequencies provide higher accuracy for
the Alternate method. The display frequency rate has little effect when using
one of the device driver modes.
Number Base
Select either decimal (base 10) or hexadecimal (base 16) number displays.
Hexadecimal values may be useful to correlate CPU Monitor Plus displays with
other OS/2 system and programming information. The default is to display all
numbers as decimal integers.
Note: Percentages and rates are always displayed in decimal integers
regardless of the specified number base.
Font Size
Use this to select a different size fixed width Courier or System Monospaced
font for the CPU Monitor Plus display. Both bold and normal attributes may not
be available for all fonts in all sizes.
Color Scheme
Use this to choose between a number of different predefined color schemes.
Save Configuration Info
Check this to permanently save all configuration information when OK is
pressed. The saved configuration information will be written to the OS2.INI
file and used the next time CPU Monitor Plus is started.
Press OK to accept the entered values. If Save Configuration Info is checked,
all configuration information will be saved. Press Escape or Cancel to abort
any selections. Press Default to choose the factory default settings.
The Save menu option can also be used to save the current configuration
settings.
ΓòÉΓòÉΓòÉ <hidden> Exit Help ΓòÉΓòÉΓòÉ
Press OK to terminate CPU Monitor Plus. If the Save Current Setting check box
is checked the following settings are saved:
o Screen colors;
o Display window dimensions;
o Display number base;
o display font;
o Custom display fields and ordering;
o Display frequency rate;
o Statistics gathering frequency;
o Currently selected display.
Press Cancel to abort any selections and return to CPU Monitor Plus
processing.
ΓòÉΓòÉΓòÉ <hidden> Start Process Help ΓòÉΓòÉΓòÉ
Enter the information necessary to start a program or batch file from CPU
Monitor Plus.
Enter the file name of the program or batch file in the Filename entry. Use
Working Directory and Parameters entries to optionally specify the program's
working directory and parameters values respectively.
Environment variables and DOS session settings are entered in the Environment
entry. Multiple entries must be separated by the two characters: backslash (\)
zero (0). For example, the entries:
DOS_AUTOEXEC=c:\mydir\myauto.bat
IDLE_SENSITIVITY=1
would be entered as:
DOS_AUTOEXEC=c:\mydir\myautoexec.bat\0IDLE_SENSITIVITY=1
Note: DOS session settings that require ON or OFF values may need to be
entered with a 1 or 0 value instead. For example:
DOS_BACKGROUND_EXECUTION=ON
would be entered as:
DOS_BACKGROUND_EXECUTION=1
Select a priority class and priority level to start any OS/2, DOS or Windows
program with that execution priority. For more information on starting Windows
programs, see Starting Windows programs with selected priority.
The Session Type controls how the session is created for the started program.
Foregnd and Backgnd start the program in a separate foreground or background
session respectively. Full Screen and Window run the program in a full screen
or a window. Select Default to allow CPU Monitor Plus to choose whether the
program runs in a full screen or a window.
Note: Not all Session Type options are valid for all programs.
Press Start or double click on an entry in the Files list to start the desired
program. Most OS/2, Windows and DOS executable programs and batch files can be
started.
Press Clear to quickly erase any information already entered. Press Cancel to
abort any selections.
Note: CPU Monitor Plus can start processes automatically via a command line
switch. See the CPU Monitor Plus User's Guide for details on using the command
line switches.
Related Information
o Dynamically changing execution priority
o Automatically starting programs from CPU Monitor Plus
o Starting Windows programs with selected priority
ΓòÉΓòÉΓòÉ <hidden> Start Windows Programs Help ΓòÉΓòÉΓòÉ
Most Windows programs may be started and assigned an initial execution priority
using either one of two methods. Both methods use WIN.COM to start Windows
before launching your application. WIN.COM is usually found in the directory:
c:\os2\mdos\winos2\win.com (Standard OS/2)
c:\windows\win.com (OS/2 for Windows)
The preferred method is to use WIN.COM to start Windows and insert the
application name in the Parameters entry box. For example:, to start the
windows application CALC.EXE, you would enter the following information:
Filename: WIN.COM
Parameters: CALC.EXE
If this method is unable to start the windows application, you will need to
first start WIN.COM and then start your application from within WINDOWS. Your
application will run at the selected priority.
Related Information
o Dynamically changing execution priority
o Starting programs from CPU Monitor Plus
o Automatically starting programs
ΓòÉΓòÉΓòÉ <hidden> Change Priority Help ΓòÉΓòÉΓòÉ
Select the process whose priority is to be changed. The current Priority Class
and Level are displayed for each selected thread. Since OS/2 restricts
changing thread priorities in other processes, only those threads belonging to
most Presentation Manager programs can have their priority changed.
To change a thread's priority, press Set after selecting new Priority Class and
Priority Level values. Press Cancel to abort any selections. Refresh updates
the display for any processes that have recently terminated or started. Be
aware that CPU Monitor Plus retains process information for a period of time
dependent on the current display frequency.
Related Information
o CPU Monitor Plus Set Configuration
o Execution priority information
ΓòÉΓòÉΓòÉ <hidden> Display Process Data Fields Help ΓòÉΓòÉΓòÉ
Select the data fields to include in the Custom View display. Each of the
fields is described below.
o Process ID is the unique identifier for every process.
o Process Name is the name assigned to the current process. More than one
program with the same name or more than one instance of the same program may
be simultaneously loaded for execution; use the Process ID to distinguish
between these programs.
o Process Priority has a two-part value. The first digit is the priority
class. OS/2 gives a task with a higher priority class preference over a
lower priority class. The priority classes from lowest to highest are:
- 1: Idle Priority
- 2-7: Regular and Foreground Priority
- 8: Time Critical Priority
Each priority class has 32 levels, 0 the lowest priority and 31 the
highest (0 to 1F in hexadecimal).
Be aware that OS/2 normally adjusts each task's priority within a class
dynamically, to insure that every task gets some CPU time.
Note: The Foreground (or fixed high) priority class actually has a
higher priority than the Regular class. This design allows the current
screen group to respond more favorably to an interactive user.
o All Threads displays all the threads for each process.
o State displays the execution state of a process or thread. It may be Ready
if the process or thread is ready or currently executing. If the thread is
not Ready, it may be Blocked or Frozen.
o Session ID is the session or screen group identifier.
o Parent's ID displays the parent's process identifier for each thread or
process.
o Total CPU Time displays the cumulative CPU time used by a process as
recorded by CPU Monitor Plus. Any time used by the process when CPU Monitor
Plus was not enabled is not included.
CPU Utilization values are displayed as specified below:
o CPU Utilization will display a bar graph or decimal number representing the
percent CPU time used by the process or thread during the last display
period.
o Idle Time displays the estimated percentage of the time that the CPU was
idle during the last display period.
Numeric fields are displayed in the current number base, either decimal or
hexadecimal. Percentages and rates are always displayed in decimal. The
number base is changed using the Set Configuration dialog.
Press OK to enable the display with the new field selections. Press Cancel to
abort any selections. Press Default to choose the factory default settings.
Related Information
o Process data fields
o RAM data fields
o Display Frequency
o Set Configuration
o Custom View
ΓòÉΓòÉΓòÉ <hidden> Display RAM Data Fields Help ΓòÉΓòÉΓòÉ
Select the RAM information to include in the Custom View display. The
individual RAM Data Fields may be displayed in bytes, kilobytes or pages, where
one page equals 4096 bytes (on 80386 and 80486 CPU's). The data fields are:
o Private In Use displays the amount of Private RAM currently marked present
by OS/2 for a process;
o Shared In Use displays the amount of Shared RAM currently marked present by
OS/2 for a process;
o Total In Use displays the sum of Private and Shared RAM currently marked
present by OS/2 for a process;
o Private Allocated displays the amount of Private RAM currently allocated by
OS/2 for a process;
o Shared Allocated displays the amount of Shared RAM currently allocated by
OS/2 for a process;
o Total Allocated displays the sum of Private and Shared RAM currently
allocated by OS/2 for a process;
The Ratios Currently Selected entries are ratios of individual RAM data
fields. Total Available RAM is the total amount of RAM available for OS/2
applications. Total Installed RAM is the amount of RAM installed on the
computer, as reported by OS/2. Each selected ratio can be displayed as either
a bar graph or a decimal percent.
For the RAM Utilization Ratios press:
o Add to add the current "Ratio Top / Ratio Bottom" pair to the Ratios
Currently Selected list; selection.
o Remove to remove the current ratio selection from the list;
o Clear to remove all entries from the list.
Press OK to accept all selections for the Custom display. Press Default to
choose the factory default settings.
Related Information
o Process data fields
o RAM data fields
o Custom View
ΓòÉΓòÉΓòÉ <hidden> Display System Data Fields Help ΓòÉΓòÉΓòÉ
Select the data fields to include in the Custom System View display.
The COM port and Disk drive activity can be displayed using three different
measures: Rate, Total, and Busy. COM port rate and total values are measured
in bytes per second and total bytes transferred. Disk drive rate and total
activity is measured in blocks or sectors (a sector is assumed to be 512 bytes)
per second and total blocks or sectors transferred. Busy measures the
percentage of time that the COM port or disk was actually processing data
during the measured interval.
Both the COM port and Disk drive activity can be further expanded into Reading,
writing and total (reading + writing) measures.
Three different measures of the CPU activity are available. All are displayed
as percentages over the measured interval. Idle represents the percentage of
time that the CPU would have been available for use. Busy shows the percentage
of time that the CPU was not available for additional work. Interrupt
represents the percentage of time that the CPU was servicing hardware
interrupts. Note that Busy + Idle = 100%. The CPU measures can be displayed
using either bar graphs or decimal percentages.
Four different measures of RAM utilization are available. These may be
displayed in units of bytes, kilobytes or pages (assumed 4096 bytes to a page).
Installed is the total amount of system RAM available to OS/2. Resident
represents the amount of memory currently reserved (and generally locked) for
use by OS/2. In-Use and Free represent the instantaneous measures of the RAM
that was marked in use and free respectively at the time the measure was taken.
Since OS/2 is a virtual memory operating system, these amounts are constantly
changing and should be used only as a general guide to memory availability.
See the CPU Monitor Plus User's Guide for more details.
Two additional measures of Virtual Memory are also available. Swap is the
current size of the OS/2 swap file. Virtual displays the maximum currently
available virtual memory in the system. This number includes free space on the
drive containing the OS/2 swap file plus any free physical RAM.
Paging shows the number of page faults per second and the total number of page
faults.
Note: Individual Process data fields and RAM data fields are displayed
separately in the Custom View
All field choices are preserved even after a pre-defined display mode is
chosen. To return to the selected field choices, invoke the Custom System View
menu item.
The field choices are not automatically saved when CPU Monitor Plus is
terminated. To save these choices, select the Save menu item from the File
menu.
System Data Fields is selected from the View menu or with the Ctrl-Y hot key.
Press OK to accept all selections for the Custom System display. Press Default
to choose the factory default settings. Use Clear to erase all selections.
Related Information
o Custom System View
o Process Data Fields
o RAM Data Fields
o View Menu Item
ΓòÉΓòÉΓòÉ <hidden> Display Order Help ΓòÉΓòÉΓòÉ
Select how the display is to be ordered. The display is arranged in either
ascending or descending order based on one of the following fields:
o Process Name;
o Process ID;
o Session ID;
o Parent's Process ID;
o CPU Time used;
o Process Priority.
Press OK to select the new display order. Press Cancel to abort any
selections.
ΓòÉΓòÉΓòÉ <hidden> Select Process Help ΓòÉΓòÉΓòÉ
Select specific processes and threads to include in the display. Only those
items selected will appear in the display.
Press OK to include the selected processes in the display. Press Cancel to
abort any new selections. Press Reset to quickly clear any selected entries.
Note: To display data for all processes, make sure that no entries in the
Process List are selected.
ΓòÉΓòÉΓòÉ <hidden> Suspend Thread Help ΓòÉΓòÉΓòÉ
Select the process and thread to be suspended or resumed. If the state for a
thread is displayed as 'Suspend', then that thread is currently suspended.
'Normal' indicates that the thread is not suspended.
Since OS/2 places restrictions on suspending threads in other processes, only
those threads belonging to most Presentation Manager programs can be suspended
or resume executing.
Press Refresh to update the display for any processes that have recently
terminated or started. Be aware that CPU Monitor Plus retains process
information for a period of time dependent on the current display frequency.
Press Set to change the execution state for the selected thread. Press Cancel
to return to the CPU Monitor Plus display.
Warning: It may NOT be possible to resume a process whose sole 'Message Loop'
thread has been suspended. In many programs, the first thread (Thread 1) has
the responsibility for dispatching all messages for that process in a message
loop. This thread is referred to as the message loop thread. Therefore, if
you choose to suspend Thread 1 in any process, a warning will be displayed.
Suspended threads may sometimes be identified by a "Frozen" entry in CPU
Monitor Plus' "State" column. "State" is included in the Custom View display
via the Fields menu item.
Related Information
o CPU Monitor Plus Set Configuration
ΓòÉΓòÉΓòÉ <hidden> Installation Help ΓòÉΓòÉΓòÉ
Use the CPU Monitor Plus Setup program to install CPU Monitor Plus in your
system. Setup performs the following operations:
o Initializes the CPU Monitor Plus executable file;
o Copies the program files to your hard disk;
o Updates the CONFIG.SYS and OS2.INI files.
CPU Monitor Plus can perform some installation functions itself. These are
limited to updating the OS2.INI file to automatically load the CPU Monitor
Plus dynamic link libraries. This feature may be useful if you reinstall CPU
Monitor Plus after having previously selected UnInstall.
To allow CPU Monitor Plus to install itself, select YES when prompted to
continue with the installation. CPU Monitor Plus will then backup and update
the OS2.INI system file. The CONFIG.SYS file is not updated, nor are any
files copied to the hard disk.
After installation is complete, the computer should then be restarted to
enable all CPU Monitor Plus functions.
Note: Part of the installation process requires that the CPU Monitor Plus
help file, dynamic link libraries, and device drivers be referenced from the
CONFIG.SYS file. These functions are only performed by the Setup program.
Refer to the CPU Monitor Plus User's Guide for more information.
To permanently unload CPU Monitor Plus from your system, select the UnInstall
menu item from the File menu. The Un-Installation process will be complete
after the computer has been restarted. CPU Monitor Plus may be reinstalled
later at your convenience.
ΓòÉΓòÉΓòÉ <hidden> Installation Error Help ΓòÉΓòÉΓòÉ
CPU Monitor Plus was unable to complete the installation process. If you press
OK to continue, some CPU Monitor Plus functions will be unavailable.
ΓòÉΓòÉΓòÉ <hidden> Installation Error Help ΓòÉΓòÉΓòÉ
CPU Monitor Plus was unable to backup the system OS2.INI file. Since CPU
Monitor Plus makes changes to OS2.INI, it first makes a backup copy called
OS2INI.BA. This backup file is put in the same directory where OS2.INI was
found.
At this point, you may still continue installing CPU Monitor Plus. However, in
the very unlikely event that the OS2.INI file becomes corrupt, CPU Monitor Plus
will not have created the OS2INI.BA backup.
Select YES to continue with the installation process. Select NO to abort the
installation.
ΓòÉΓòÉΓòÉ <hidden> Initialization Error Help ΓòÉΓòÉΓòÉ
CPU Monitor Plus has not been completely installed. As a result, some CPU
Monitor Plus functions may not operate correctly.
Use the Setup program to best install CPU Monitor Plus. If you have previously
run Setup, you may also try to install using CPU Monitor Plus. Restart CPU
Monitor Plus and press 'Yes' when asked to install. Then restart OS/2 to
complete the installation process.
Note: Part of the installation process requires that the CPU Monitor Plus help
file, dynamic link libraries, and device drivers be referenced from the
CONFIG.SYS file. These functions are only performed by the Setup program.
Refer to the CPU Monitor Plus User's Guide for more information.
ΓòÉΓòÉΓòÉ <hidden> Initialization Error Help ΓòÉΓòÉΓòÉ
CPU Monitor Plus has not been completely installed. As a result, some CPU
Monitor Plus functions may not operate correctly.
Use the Setup program to best install CPU Monitor Plus. If you have previously
run Setup, you may also try to install using CPU Monitor Plus. Restart CPU
Monitor Plus and press 'Yes' when asked to install. Then restart OS/2 to
complete the installation process.
Note: Part of the installation process requires that the CPU Monitor Plus help
file, dynamic link libraries, and device drivers be referenced from the
CONFIG.SYS file. These functions are only performed by the Setup program. You
may choose to do these manually as in the following example:
Example:
device=C:\CPUMONP\CPUMONP.SYS
device=C:\CPUMONP\CPPVDD.SYS
Refer to the CPU Monitor Plus User's Guide for more information.
ΓòÉΓòÉΓòÉ <hidden> UnInstallation Help ΓòÉΓòÉΓòÉ
To permanently remove CPU Monitor Plus from your system, select YES when
prompted to Un-Install.
UnInstall updates the OS2.INI file to permanently remove all CPU Monitor Plus
startup information. UnInstall does not update the CONFIG.SYS file. After
Un-Installing, CPU Monitor Plus will be completely removed once the computer
has been restarted.
Note: Part of the installation process requires that the CPU Monitor Plus
device drivers, dynamic link libraries, and help file be referenced from the
CONFIG.SYS file. These references are not removed by UnInstall. Refer to the
CPU Monitor Plus User's Guide for more information.
CPU Monitor Plus may be installed later at your convenience.
ΓòÉΓòÉΓòÉ <hidden> Log File Error Help ΓòÉΓòÉΓòÉ
If the log file becomes unavailable or if the file is unable to accommodate
additional data, an error message will be displayed. In these cases, file
logging will be disabled until a new log file is selected.
Note: Data may be logged to at most one file at a time.
ΓòÉΓòÉΓòÉ <hidden> Kill Process Error Help ΓòÉΓòÉΓòÉ
The selected process no longer exists. Choose another process to kill or
select Cancel to return to CPU Monitor Plus.
Note: The list of processes in the Kill Process dialog box is not
automatically updated. Press Refresh at any time to update the display for
processes that have recently started or terminated. Be aware that CPU Monitor
Plus retains process information for a period of time dependent on the current
display frequency.
ΓòÉΓòÉΓòÉ <hidden> Kill Process Confirmation Help ΓòÉΓòÉΓòÉ
The specified process is to be terminated. Press OK to kill the process.
Press CANCEL to abort.
ΓòÉΓòÉΓòÉ <hidden> Change Priority Error Help ΓòÉΓòÉΓòÉ
CPU Monitor Plus is unable to determine the priority for the selected process.
This may occur if the selected process has terminated. Choose another process
or press Cancel to return to CPU Monitor Plus.
Note: The list of processes in the Change Priority dialog box is not
automatically updated. Press Refresh at any time to update the display for
processes that have recently started or terminated. Be aware that CPU Monitor
Plus retains process information for a period of time dependent on the current
display frequency.
ΓòÉΓòÉΓòÉ <hidden> Suspend Thread Error Help ΓòÉΓòÉΓòÉ
CPU Monitor Plus is unable to determine the execution state for the selected
process and thread. This may occur if the selected process or thread has
terminated. Choose another thread or press Cancel to return to CPU Monitor
Plus.
Note: The list of processes in the Suspend Thread dialog box is not
automatically updated. Press Refresh at any time to update the display for
processes and threads that have recently started or terminated. Be aware that
CPU Monitor Plus retains process information for a period of time dependent on
the current display frequency.
ΓòÉΓòÉΓòÉ <hidden> Clipboard Warning Help ΓòÉΓòÉΓòÉ
CPU Monitor Plus was unable to completely copy the current display to the
clipboard. Data at the end of the display may have been lost. The maximum
number of characters that can be copied is approximately 65,535 bytes.
Retry the copy when the current display contains less information. You can
reduce the quantity of information displayed by using the Fields and Select
dialogs.
ΓòÉΓòÉΓòÉ <hidden> Configuration Error Help ΓòÉΓòÉΓòÉ
The Fast, Normal and Slow Gather Frequencies are only available if the CPU
Monitor Plus device driver has been installed.
Refer to the CPU Monitor Plus User's Guide for information on installing CPU
Monitor Plus.
ΓòÉΓòÉΓòÉ <hidden> Configuration Error Help ΓòÉΓòÉΓòÉ
At installation time, CPU Monitor Plus tries to find an installed fixed pitch
Courier or System Monospaced font to match your screen resolution.
This error message indicates that CPU Monitor Plus was unable to find any
matching font for your screen resolution.
Check to be sure that you have installed OS/2 Courier and System Monospaced
fonts to match your screen resolution.
ΓòÉΓòÉΓòÉ 11. Command Line Switches ΓòÉΓòÉΓòÉ
The following command line switches are available:
o /START=<fname>
o /LOG=<fname>
o /FREQUENCY=<seconds>
o /DOSINT=<ROM-BIOS interrupt>
For /START, <fname> is the name of a file containing the program names to be
started.
For /LOG, <fname> is the name of the file where logging information will be
written.
For /FREQUENCY, <seconds> is the number of seconds (1 to 60) between screen
updates.
For /DOSINT, <ROM-BIOS interrupt> is the hexadecimal interrupt used to
communicate with the CPU Monitor Plus Virtual Device Driver (VDD). This value
must match any command line value used with the vdd. For example:
CPUMONP /DOSINT=44
Must match the value used when the vdd is loaded from the CONFIG.SYS file as
shown below:
device=c:\cpumonp\cppvdd.sys /DOSINT=44
When no command line switches are used, the default for this value is 45
(hexadecimal).
Note: No spaces are allowed between the equals sign ('=') and the value in a
command line switch. Spaces are required between each command line parameter.
For example:
CPUMONP /FREQUENCY=5 /LOG=C:\mylog.log /START=C:\bastart.ba
will do the following:
o Sets the initial display frequency to 5 seconds.
o Enables file logging to the file C:\MYLOG.LOG.
o Starts the programs as specified in the file C:\START.BA.
Once CPU Monitor Plus is running, data logging may be changed by selecting the
Log menu item. Additional programs may be started via the Start menu item.
The display frequency may be changed via the Set Configuration menu item.
See the CPU Monitor Plus User's Guide for more details on using the command
line switches.
Related Information
o Command line start file format
ΓòÉΓòÉΓòÉ 11.1. Start File Format Help ΓòÉΓòÉΓòÉ
By starting CPU Monitor Plus with the following parameter or command line
switch
/START=<startup filename>
CPU Monitor Plus will automatically start a series of programs as specified in
the startup file.
The startup file format must be strictly followed. The only valid commands in
the startup file are:
o WORK: used to set the working directory.
o PARAM: used to specify any command line parameters.
o MODE: used to start the program in a Foreground or Background session.
o ENVIRON: used to set any environment strings and DOS session settings.
o SESSION: used to select a full screen or windowed session.
o PRIOCLASS: used to set the priority class.
o PRIOLEVEL: used to set the priority level.
o FILE: used to specify the path and filename for the program to be started.
The following are permitted values for commands in the start file:
o MODE: FOREGROUND, BACKGROUND
o SESSION: FULL SCREEN, WINDOW, DEFAULT
o PRIOCLASS: IDLE, REGULAR, FOREGROUND, CRITICAL
o PRIOLEVEL: 0 to 31
When the FILE: command is encountered, the following actions occur:
1. The current directory is set as per the last WORK: command.
2. Any command line parameters from the last PARAM: command are included.
3. Any environment strings from the last ENVIRON: command are set.
4. The session type is selected as per the last SESSION: and MODE: commands.
5. The program indicated in the FILE: is started with execution priority as
specified in the PRIOCLASS: and PRIOLEVEL: commands.
An example of a startup file entry is:
WORK: e:\wp51
PARAM: mydoc.txt
MODE: FOREGROUND
ENVIRON: DOS_AUTOEXEC=c:\mydir\myauto.bat\0IDLE_SENSITIVITY=2
SESSION: DEFAULT
PRIOCLASS: REGULAR
PRIOLEVEL: 0
FILE: e:\wp51\wp.exe
Note: Multiple ENVIRON: entries must be separated by the two characters:
backslash (\) zero (0). For example, the entries:
DOS_AUTOEXEC=c:\mydir\myauto.bat
IDLE_SENSITIVITY=1
should be entered as:
DOS_AUTOEXEC=c:\mydir\myautoexec.bat\0IDLE_SENSITIVITY=1
Note: DOS session settings that require ON or OFF values may need to be
entered with a 1 or 0 value instead. For example:
DOS_BACKGROUND_EXECUTION=ON
would be entered as:
DOS_BACKGROUND_EXECUTION=1
Related Information
o Starting programs from CPU Monitor Plus
o Changing execution priorities
o Command line parameters
Also, see the CPU Monitor Plus User's Guide for more details on using the
command line switches.