HP OpenVMS Systems Documentation

Content starts here

OpenVMS System Management Utilities Reference Manual


Previous Contents Index

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-2000 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 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, 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-2000 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-2000 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.


Previous Next Contents Index