 |
HP OpenVMS System Management Utilities Reference
Manual
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, see 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, see 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.
MONITOR SCS
The MONITOR SCS command initiates monitoring of the System
Communications Services (SCS) class.
Format
MONITOR SCS
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.
/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=KB_MAP.
The following table describes /ITEM qualifier keywords:
| Keyword |
Description |
|
ALL
|
Specifies that statistics on all data items collected for the disks are
displayed on successive screens.
|
|
BUFFER_DESCRIPTOR
|
Specifies that statistics on the queued-for-buffer-descriptor (on the
local node) rate are displayed for each node.
|
|
D_DISCARD
|
Specifies that datagram discard rate statistics are displayed for each
node.
|
|
D_RECEIVE
|
Specifies that datagram receive rate statistics are displayed for each
node.
|
|
D_SEND
|
Specifies that datagram send rate statistics are displayed for each
node.
|
|
KB_MAP
|
Specifies that kilobyte map rate statistics are displayed for each node.
|
|
KB_REQUEST
|
Specifies that kilobyte request (via request datas) rate statistics are
displayed for each node.
|
|
KB_SEND
|
Specifies that kilobyte send (via send datas) rate statistics are
displayed for each node.
|
|
M_RECEIVE
|
Specifies that message receive rate statistics are displayed for each
node.
|
|
M_SEND
|
Specifies that message send rate statistics are displayed for each node.
|
|
REQUEST_DATA
|
Specifies that request data (initiated on the local node) rate
statistics are displayed for each node.
|
|
SEND_CREDIT
|
Specifies that queued-for-send-credit (on the local node) rate
statistics are displayed for each node.
|
|
SEND_DATA
|
Specifies that send data (initiated on the local node) rate statistics
are displayed for each node.
|
/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.
/PERCENT
/NOPERCENT (default)
Controls whether statistics are expressed as percent values in display
and summary outputs. The /PERCENT qualifier is applicable only to the
DISK, MODES, SCS, and STATES classes.
Description
The SCS class is a component class. Data items for this class are
collected for each node in the cluster. The SCS class consists of the
following data items:
| Data Item |
Description |
|
Datagram Send Rate
|
Rate at which datagrams are sent to another node.
|
|
Datagram Receive Rate
|
Rate at which datagrams are received from another node.
|
|
Datagram Discard Rate
|
Rate at which datagrams are discarded.
|
|
Message Send Rate
|
Rate at which sequenced messages are sent to another node. Sequenced
messages are exchanged between nodes to communicate with mass storage
control protocol (MSCP) disks and the lock manager.
|
|
Message Receive Rate
|
Rate at which sequenced messages are received from another node.
Sequenced messages are exchanged between nodes to communicate with MSCP
disks and the lock manager.
|
|
Send Data Rate
|
Rate at which block send datas are initiated on the local node.
|
|
Kbytes Send Rate
|
Rate at which kilobytes are sent, as a result of send datas initiated
on the local node.
|
|
Request Data Rate
|
Rate at which request datas are initiated on the local node.
|
|
Kbytes Request Rate
|
Rate at which kilobytes are received, as a result of request datas
initiated on the local node.
|
|
Kbytes Map Rate
|
Rate at which kilobytes are mapped for block transfers. This is a rough
measure of the data transfer rate between the local node and a remote
node. Before any transfer can take place, a buffer must be mapped. The
size of the accumulated buffers that were mapped is displayed by the
Kbytes Map Rate. If request datas or send datas are initiated on the
local or a remote node, then the Kbytes Map Rate reflects the number of
kilobytes actually transferred between the two nodes.
|
|
Send Credit Queued Rate
|
Rate at which connections are queued for a send credit. A connection is
queued for a send credit whenever all of the buffers that were
allocated by the remote node have been used.
|
|
Buffer Descriptor Queued Rate
|
Rate at which connections are queued for a buffer descriptor. A
connection is queued for a buffer descriptor whenever all of the buffer
descriptors have been allocated by the local node. You can increase the
number of buffer descriptors allocated on the local system by adjusting
the system parameter SCSBUFFCNT.
|
Example
|
MONITOR> MONITOR SCS
OpenVMS Monitor Utility
SCS STATISTICS
on node CURLEY
29-APR-2003 10:21:46
Kbytes Map Rate CUR AVE MIN MAX
CURLEY 0.00 0.00 0.00 0.00
MOE 0.00 0.00 0.00 0.00
LARRY 0.00 0.00 0.00 0.00
SHEMP 5.64 3.81 1.98 5.64
|
|
The command in this example requests that kilobyte map rate statistics
collected for SCS be displayed for each node in the cluster. The
display shows block transfer map activity between the node CURLEY and
the hierarchical storage controller (HSC) SHEMP. Note that each node in
the cluster is identified by its SCS node name.
MONITOR STATES
The MONITOR STATES command initiates monitoring of the PROCESS STATES
class, which shows the number of processes in each of the 14 scheduler
states.
Format
MONITOR STATES
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.
/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.
/PERCENT
/NOPERCENT (default)
Controls whether statistics are expressed as percent values in display
and summary outputs. The /PERCENT qualifier is applicable only to the
DISK, MODES, SCS, and STATES class names.
Description
The STATES class shows the number of processes in each of the 14
scheduler states. The following table describes these scheduler states:
| Scheduler State |
Description |
|
Collided Page Wait (COLPG)
|
Waiting for a faulted page in transition.
|
|
Mutex & Miscellaneous Resource Wait (MWAIT)
|
Waiting for the availability of a mutual exclusion semaphore or a
dynamic resource. The following table contains a summary of Mutex and
Miscellaneous Resource Wait states and identifying codes, as they
appear in the PROCESSES class display:
| MWAIT |
Reason for Wait |
|
MUTEX
|
Mutual exclusion semaphore
|
|
RWAST
|
AST wait (wait for system or special kernel AST)
|
|
RWBRK
|
Breakthrough (wait for broadcast message)
|
|
RWCAP
|
CPU capability required
|
|
RWCLU
|
Cluster state transition wait
|
|
RWCSV
|
Cluster server
|
|
RWIMG
|
Image activation lock
|
|
RWLCK
|
Lock database
|
|
RWMBX
|
Mailbox full
|
|
RWMPB
|
Modified page writer busy
|
|
RWMPE
|
Modified page list empty
|
|
RWNPG
|
Nonpaged dynamic memory
|
|
RWPAG
|
Paged dynamic memory
|
|
RWPGF
|
Page file full
|
|
RWQUO
|
Job quota
|
|
RWSCS
|
System Communications Services wait
|
|
RWSNP
|
System snapshot
|
|
RWSWP
|
Swap file space
|
|
|
Common Event Flag Wait (CEF)
|
Waiting for a combination of event flags to be set in a common event
block.
|
|
Page Fault Wait (PFW)
|
Waiting for a page to be read as a result of a page fault; resident
processes.
|
|
Local Event Flag Wait (LEF)
|
Waiting for one or more local event flags to be posted; resident
processes.
|
|
Local Event Flag (Outswapped) (LEFO)
|
Waiting for one or more local event flags to be posted; outswapped
processes.
|
|
Hibernate (HIB)
|
Hibernating, or process has executed a hibernate request; resident
processes.
|
|
Hibernate (Outswapped) (HIBO)
|
Hibernating, or process has executed a hibernate request; outswapped
processes.
|
|
Suspended (SUSP)
|
Process has executed a suspend request; resident processes.
|
|
Suspended (Outswapped) (SUSPO)
|
Process has executed a suspend request; outswapped processes.
|
|
Free Page Wait (FPW)
|
Waiting for a free page of memory.
|
|
Compute (COM)
|
Ready to use the processor; resident processes.
|
|
Compute (Outswapped) (COMO)
|
Ready to use the processor; outswapped processes.
|
|
Current Process (CUR)
|
Using the processor.
|
The data items can also be displayed as percentages of all processes.
Note that the Current Process is always the process running MONITOR,
because MONITOR is running when each measurement is made.
For performance reasons, MONITOR does not synchronize the scanning of
process state data structures with operating system use of those
structures. It is therefore possible that MONITOR will display certain
anomalous state indications.
Example
|
$ MONITOR/INPUT/SUMMARY/NODISPLAY -
_$/BEGINNING=29-APR-2003:13:00 -
_$/ENDING=29-APR-2003:14:00 STATES/PERCENT/ALL
$ TYPE MONITOR.SUM
OpenVMS Monitor Utility
PROCESS STATES (%)
on node SAMPLE From: 29-APR-2003 13:00:00
SUMMARY To: 29-APR-2003 14:00:00
CUR% AVE% MIN% MAX%
Collided Page Wait 0.0 0.0 0.0 0.0
Mutex & Misc Resource Wait 0.0 0.0 0.0 0.0
Common Event Flag Wait 0.0 0.0 0.0 0.0
Page Fault Wait 4.3 1.4 0.0 4.3
Local Event Flag Wait 34.7 31.7 34.7 42.8
Local Evt Flg (Outswapped) 0.0 9.0 0.0 19.4
Hibernate 43.4 40.7 43.4 52.1
Hibernate (Outswapped) 0.0 4.3 0.0 15.4
Suspended 0.0 0.0 0.0 0.0
Suspended (Outswapped) 0.0 0.0 0.0 0.0
Free Page Wait 0.0 0.0 0.0 0.0
Compute 13.0 7.3 4.3 13.0
Compute (Outswapped) 0.0 0.8 0.0 3.2
Current Process 1.0 1.0 1.0 1.0
PLAYBACK SUMMARIZING
|
|
The commands in this example generate and display a PROCESS STATES
summary. Note that since use of the Return key is not permitted within
a single MONITOR command following the MONITOR> prompt, the MONITOR
command is entered at DCL level. The summary shows that, on the
average, 14.1 percent of processes were swapped out for the summarized
period. Note that the summary was requested for data covering only the
hour between 1 P.M. and 2 P.M., although the input file could have
contained data covering a longer period.
|
