 |
HP OpenVMS System Management Utilities Reference
Manual
MONITOR PROCESSES
The MONITOR PROCESSES command initiates monitoring of the PROCESSES
class, which displays information about all processes in the system.
In a multifile summary request, the classes CLUSTER and PROCESSES are
ignored. If these classes are the only classes specified on the command
line, MONITOR does not recognize them and displays a "no classes
specified" error message.
Format
MONITOR PROCESSES
Command Qualifiers
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier
Descriptions section.
Classname Qualifiers
/TOPBIO
Specifies that a bar graph listing the top buffered I/O users be
produced instead of the standard display and summary output. Values are
expressed in units of buffered I/Os per second.
/TOPCPU
Specifies that a bar graph listing the top CPU time users be produced
instead of the standard display and summary output. Values are
expressed in units of clock ticks (10 milliseconds) per second.
Prior to OpenVMS Version 7.3, the MONITOR PROCESSES/TOPCPU display
showed only a maximum of 8 processes on one screen. In OpenVMS Version
7.3 and later versions, the choice of which one of three screens is
displayed is determined by the number of CPUs on the system. (See the
examples in this section.)
/TOPDIO
Specifies that a bar graph listing the top direct I/O users be produced
instead of the standard display and summary output. Values are
expressed in units of direct I/Os per second.
/TOPFAULT
Specifies that a bar graph listing the top page faulting processes be
produced instead of the standard display and summary output. Values are
expressed in units of page faults per second.
/TOPRBS (VAX Only)
On OpenVMS VAX systems, specifies that a bar graph listing the top
balance slot faulting processes be produced instead of the standard
display and summary output. Values are expressed in units of balance
slot faults per second.
Description
As illustrated in the examples, the PROCESSES display (and summary)
formats are different from those of all other classes. The PROCESSES
display provides the following information:
| Data Item |
Description |
|
PID
|
Process identifier as assigned by the system, in hexadecimal
|
|
STATE
|
Process's scheduler state (see the description of the MONITOR STATES
command for an explanation and a tabular summary of the STATES codes)
|
|
PRI
|
Current (as opposed to base) priority of the process
|
|
NAME
|
Process name
|
|
PAGES
|
Number of shareable pages and total number of pages currently in use by
the process
|
|
DIOCNT
|
Cumulative direct I/O operations performed by the process since its
creation; not displayed if the process is swapped out
|
|
FAULTS
|
Cumulative page faults since the process was created; not displayed if
the process is swapped out
|
|
CPU TIME
|
Cumulative CPU time used by the process since its creation, in the
format
hours:minutes:seconds
; not displayed if the process is swapped out
|
The top corners of the display contain the number of processes in the
system and the time in days, hours, minutes, and seconds since the
system was last booted. Processes that are swapped out are so noted.
If more processes are in the system than can be displayed on the
terminal screen at once, the display consists of multiple screens.
Screens are presented one at a time at intervals specified with the
/VIEWING_TIME qualifier. The five /TOP bar graph displays provide the
PID and process name of each of the top eight users.
As with the other bar graph displays, examples in the displays of top
users are rounded to the nearest whole number. Up to eight processes
with nonzero values are displayed. To be eligible for inclusion in the
list of top users, a process must be present and swapped in at the
beginning and end of the display interval. This eligibility requirement
also applies to the beginning and ending of the entire period covered
by a summary.
Note that only one of the displays of top users or the regular
PROCESSES display can be selected in a single MONITOR request.
Examples
| #1 |
MONITOR> MONITOR/INPUT=PROCS.DAT/INTERVAL=6 PROCESSES
Process Count: 20 OpenVMS Monitor Utility Uptime: 1 23:26:10
PROCESSES
on node SAMPLE
29-APR-2003 12:39:09
PID STATE PRI NAME PAGES DIOCNT FAULTS CPU TIME
00000081 HIB 16 SWAPPER 0/0 0 0 00:00:15.8
00000102 LEFO 4 SAMPLE1001 87/232 SWAPPED OUT
00000103 COM 4 SAMPLE1101 16/100 7127 51298 00:05:11.0
00000084 HIB 8 ERRFMT 64/174 2750 125 00:00:43.9
00000086 LEF 8 OPCOM 73/272 283 178 00:00:07.7
00000087 HIB 9 JOB_CONTROL 57/293 707 167 00:00:10.5
00000088 HIB 8 CONFIGURE 43/205 22 123 00:00:00.6
0000008A HIB 6 SYMBIONT_0001 5/56 50 617 00:03:15.1
0000008B HIB 8 JNLACP 75/580 15149 4922 00:21:51.1
0000008C HIB 8 NETACP 5/954 11 1057 00:25:06.8
0000008D HIB 5 EVL 7/56 44 34384 00:00:20.5
0000008E HIB 9 REMACP 5/54 13 107 00:00:01.3
00000112 COM 4 SAMPLE1601 45/111 13131 39992 00:06:39.1
0000011E CUR 9 SMITH 89/298 138 830 00:00:07.1
|
|
This example illustrates a PROCESSES display generated from the input
file PROCS.DAT. One line is displayed for each process in the system.
This display shows current values only---average, minimum, and maximum
statistics are not available. Also for swapped-out processes, the words
SWAPPED OUT replace the three rightmost items, because those items are
not available for swapped-out processes. Because this example is a
playback request, the system uptime displayed is that of the system at
the time the MONITOR data was recorded.
Nondisplayable characters in process names are represented by periods.
| #2 |
MONITOR> MONITOR/INPUT=PROCS.DAT PROCESSES/TOPDIO
OpenVMS Monitor Utility
TOP DIRECT I/O RATE PROCESSES
on node SAMPLE
29-APR-2003 16:13:38
0 25 50 75 100
+ - - - - + - - - - + - - - - + - - - - -+
000000C7 SAMPLE0901 25 |**********
| | | | |
00000112 SAMPLE1601 17 |******
| | | | |
00000102 SAMPLE1001 14 |*****
| | | | |
00000103 SAMPLE1101 12 |****
| | | | |
00000080 NULL 12 |****
| | | | |
0000011E SMITH 4 |*
| | | | |
0000008C NETACP 1 |
| | | | |
|
+ - - - - + - - - - + - - - - + - - - - -+
|
|
This example shows that the process SAMPLE0901, with a rate of 25 per
second, was the top consumer of direct I/Os during the most recent
interval between displays.
| #3 |
MONITOR> MONITOR PROCESSES/TOPCPU
OpenVMS Monitor Utility
TOP CPU TIME PROCESSES
on node BRS004
5-JUN-2003 10:47:49.21
0 25 50 75 100
+ - - - - + - - - - + - - - - + - - - - -+
00000121 BATCH_36 6 **
| | | | |
0000012A BATCH_45 6 **
| | | | |
00000117 BATCH_26 6 **
| | | | |
0000011D BATCH_32 5 **
| | | | |
0000011A BATCH_29 5 **
| | | | |
0000012B BATCH_46 5 **
| | | | |
00000125 BATCH_40 5 **
| | | | |
0000011F BATCH_34 5 **
+ - - - - + - - - - + - - - - + - - - - -+
|
|
This example shows a MONITOR PROCESSES/TOPCPU screen display on a
single CPU system.
| #4 |
MONITOR> MONITOR PROCESSES/TOPCPU
OpenVMS Monitor Utility
TOP CPU TIME PROCESSES
on node BRS012
5-JUN-2003 10:48:39.38
0 25 50 75 100
+ - - - - + - - - - + - - - - + - - - - -+
0000012B BATCH_46 7 **
00000128 BATCH_43 6 **
0000012A BATCH_45 5 **
00000125 BATCH_40 5 **
00000123 BATCH_38 5 **
00000121 BATCH_36 5 **
00000129 BATCH_44 5 **
0000011F BATCH_34 5 **
0000011E BATCH_33 5 **
0000011D BATCH_32 5 **
00000117 BATCH_26 5 **
00000127 BATCH_42 5 **
00000120 BATCH_35 5 **
0000011B BATCH_30 5 **
00000119 BATCH_28 5 **
|
|
This example shows s MONITOR PROCESSES/TOPCPU screen display on a
12-CPU system.
| #5 |
MONITOR> MONITOR PROCESSES/TOPCPU
OpenVMS Monitor Utility
TOP CPU TIME PROCESSES
on node BRS016
5-JUN-2003 10:51:10.89
0 25 50 75 100
+ - - - - + - - - - + - - - - + - - - - -+
00000127 BATCH_42 6 **
00000125 BATCH_40 6 **
00000124 BATCH_39 5 **
00000118 BATCH_27 5 **
00000129 BATCH_44 5 **
00000122 BATCH_37 5 **
00000120 BATCH_35 5 **
0000011F BATCH_34 5 **
0000011D BATCH_32 5 **
0000011C BATCH_31 5 **
00000119 BATCH_28 5 **
00000128 BATCH_43 5 **
00000123 BATCH_38 5 **
0000011B BATCH_30 4 *
0000012B BATCH_46 4 *
00000126 BATCH_41 4 *
|
|
This example shows s MONITOR PROCESSES/TOPCPU screen display on a
16-CPU system.
MONITOR RLOCK
The MONITOR RLOCK command initiates monitoring of the RLOCK (dynamic
lock remastering) statistics class.
Format
MONITOR RLOCK
Command Qualifiers
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier
Descriptions section.
Classname Qualifiers
/ALL
Specifies that a table of all available statistics (current, average,
minimum and maximum) is to be included in the display and summary
outputs. For summary output, this qualifier is the default for all
classes; otherwise, it is the default for all classes except CLUSTER,
MODES, PROCESSES, STATES, SYSTEM, and VECTOR.
/AVERAGE
Specifies that a bar graph of average statistics is to be included in
the display and summary outputs.
/CURRENT
Specifies that a bar graph of current statistics is to be included in
the display and summary outputs. The /CURRENT qualifier is the default
for the CLUSTER, MODES, STATES, SYSTEM, and VECTOR classes.
/MAXIMUM
Specifies that a bar graph of maximum statistics is to be included in
the display and summary outputs.
/MINIMUM
Specifies that a bar graph of minimum statistics is to be included in
the display and summary outputs.
Description
You can use the RLOCK class to monitor the dynamic lock remastering
statistics of a node. Because local locking operations are less costly
than remote operations, lock trees are moved from node to node to
improve performance. A lock tree might be moved for any of the
following reasons:
- Another node in the cluster is much more active on the tree than
the current master.
- A node with a higher LOCKDIRWT enqueues a lock to a resource that a
node with a lower LOCKDIRWT masters.
- Only one node in the cluster has locks on this resource and should,
therefore, become the master.
The class RLOCK consists of the following data items, which are
displayed as the rate of occurrences per second:
| Data Item |
Description |
|
Lock Tree Outbound Rate
|
Rate at which lock trees are moved from this node.
|
|
Higher Activity
|
Rate for trees moved due to higher locking activity on another node in
the cluster.
|
|
Higher LOCKDIRWT
|
Rate at which trees are moved to a node with a higher value of the
SYSGEN parameter LOCKDIRWT.
|
|
Sole Interest
|
Rate at which trees are moved to another node because that node is the
only one with locks remaining on the tree.
|
|
Remaster Msg Send Rate
|
Rate at which remaster messages are sent from this node.
|
|
Lock Tree Inbound Rate
|
Rate at which trees are moved to this node.
|
|
Remaster Msg Receive Rate
|
Rate at which remaster messages are received on this node.
|
Example
|
MONITOR> MONITOR RLOCK
DYNAMIC LOCK REMASTERING STATISTICS
on node JYGAL2
30-OCT-2003 12:19:55.27
CUR AVE MIN MAX
Lock Tree Outbound Rate 0.33 0.02 0.00 0.33
(Higher Activity) 0.33 0.02 0.00 0.33
(Higher LCKDIRWT) 0.00 0.00 0.00 0.00
(Sole Interest) 0.00 0.00 0.00 0.00
Remaster Msg Send Rate 2.66 0.25 0.00 2.66
Lock Tree Inbound Rate 0.00 0.01 0.00 0.33
Remaster Msg Receive Rate 0.00 0.09 0.00 1.66
|
|
In this example, the outbound numbers are quite low; in most cases,
these numbers are never very large. Remastering is attempted only once
every 8 seconds; then a maximum of 5 trees are processed at once. The
exception is during orderly shutdown, when the system attempts to force
all trees off the node shutting down.
MONITOR RMS
The MONITOR RMS command initiates monitoring of the OpenVMS Record
Management Services (OpenVMS RMS) statistics class for a specific file.
Format
MONITOR RMS
Command Qualifiers
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier
Descriptions section.
Classname Qualifiers
/ALL
Specifies that a table of all available statistics (current, average,
minimum, and maximum) is to be included in the display and summary
output. For summary output, this qualifier is the default for all
classes; otherwise, it is the default for all classes except CLUSTER,
MODES, PROCESSES, STATES, SYSTEM, and VECTOR.
/AVERAGE
Specifies that a bar graph of average statistics is to be included in
the display and summary outputs.
/CURRENT
Specifies that a bar graph of current statistics is to be included in
the display and summary outputs. The /CURRENT qualifier is the default
for the CLUSTER, MODES, STATES, SYSTEM, and VECTOR classes.
/FILE=(file-name[,...])
Specifies a list of one or more files to which the MONITOR RMS command
applies. If you include a node name as part of the file specification,
MONITOR ignores the node name. Use the /NODE command qualifier to
select specific nodes for MONITOR RMS requests. If you use the /NODE
command qualifier to specify multiple nodes, the file must exist on all
specified nodes. You can list up to 5,000 files. Do not specify
wildcard characters.
/ITEM=(keyword[,...])
Selects one or more data items for inclusion in display and summary
outputs. If you specify two or more keywords, enclose them in
parentheses, and separate them with commas. When the /ITEM qualifier is
omitted, the default is /ITEM=OPERATIONS.
The following table describes /ITEM qualifier keywords:
| Keyword |
Description |
|
OPERATIONS
|
Specifies that RMS basic operations statistics are displayed for the
selected file.
|
|
DATA_RATES
|
Specifies that RMS data rate statistics are displayed for the selected
file.
|
|
LOCKING
|
Specifies that RMS locking statistics are displayed for the selected
file.
|
|
CACHING
|
Specifies that RMS caching statistics are displayed for the selected
file.
|
/MAXIMUM
Specifies that a bar graph of maximum statistics is to be included in
the display and summary outputs.
/MINIMUM
Specifies that a bar graph of minimum statistics is to be included in
the display and summary outputs.
Description
When you enter the MONITOR RMS command, you must use the /FILE
qualifier to specify an input file. MONITOR displays RMS statistics for
the input file that you specify. MONITOR displays statistics only for
the input file if statistics are enabled for the file, and the file is
open. For information about enabling statistics for a file, refer to
the SET FILE command in the HP OpenVMS DCL Dictionary and the OpenVMS Record Management Services Reference Manual.
The MONITOR RMS command generates RMS statistics of the following types:
Basic operations (produced by specifying the OPERATIONS item)
Data rates per operation (produced by specifying the DATA_RATES
item)
File locking (produced by specifying the LOCKING item)
Caching (produced by specifying the CACHING item)
Basic operations statistics consist of the following
data items:
Sequential $Get Call Rate
Keyed $Get Call Rate
RFA $Get Call Rate
Sequential $Find Call Rate
Keyed $Find Call Rate
RFA $Find Call Rate
Sequential $Put Call Rate
Keyed $Put Call Rate
$Read Call Rate
$Write Call Rate
$Update Call Rate
$Delete Call Rate
$Truncate Call Rate
$Extend Call Rate
$Flush Call Rate
Data rate statistics consist of the following data
items:
Total $GET Call Rate
Bytes per $GET
Total $PUT Call Rate
Bytes Per $PUT
Total $UPDATE Call Rate
Bytes per $UPDATE
$READ Call Rate
Bytes per $READ
$WRITE Call Rate
Bytes per $WRITE
$TRUNCATE Call Rate
Blocks per $TRUNCATE
$EXTEND Call Rate
Blocks per $EXTEND
File locking statistics consist of the following data
items:
New ENQ Rate
DEQ Rate
Converted ENQ Rate
Blocking AST Rate
Bucket Split Rate
Multi-Bucket Split Rate
Caching statistics consist of the following data items:
Local Cache Hit Percent
Local Cache Attempt Rate
Global Cache Hit Percent
Global Cache Attempt Rate
Global Buffer Read I/O Rate
Global Buffer Write I/O Rate
Local Buffer Read I/O Rate
Local Buffer Write I/O Rate
Note
Values produced by the MONITOR RMS command do not include I/Os
generated by the recovery mechanisms of RMS Journaling.
|
For more information about OpenVMS RMS, OpenVMS RMS services, and file
applications, refer to the OpenVMS Record Management Services Reference Manual, HP OpenVMS System Services Reference Manual, and the
Guide to OpenVMS File Applications.
Example
|
MONITOR> MONITOR RMS /ITEM=OPERATIONS /FILE=SYS$COMMON:[SYSEXE]SYSUAF.DAT
OpenVMS Monitor Utility
RMS FILE OPERATIONS
on node SAMPLE
29-APR-2003 11:03:06
(Index) _$254$DUA213:[SYS0.SYSEXE]SYSUAF.DAT;2
Active Streams: 17 CUR AVE MIN MAX
$GET Call Rate (Seq) 0.00 0.00 0.00 0.00
(Key) 4.30 2.15 0.00 6.76
(RFA) 0.00 0.00 0.00 0.00
$FIND Call Rate (Seq) 0.00 0.00 0.00 0.00
(Key) 0.00 0.00 0.00 0.00
(RFA) 0.00 0.00 0.00 0.00
$PUT Call Rate (Seq) 0.00 0.00 0.00 0.00
(Key) 0.20 0.14 0.00 0.30
$READ Call Rate 0.00 0.00 0.00 0.00
$WRITE Call Rate 0.00 0.00 0.00 0.00
$UPDATE Call Rate 0.00 0.00 0.00 0.00
$DELETE Call Rate 0.00 0.00 0.00 0.00
$TRUNCATE Call Rate 0.00 0.00 0.00 0.00
$EXTEND Call Rate 0.00 0.00 0.00 0.00
$FLUSH Call Rate 0.00 0.00 0.00 0.00
|
|
This example demonstrates the use of the MONITOR RMS command to
generate basic operations statistics for the file SYSUAF.DAT.
|
