![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF){kind=logo}
![[HR]](../../IMAGES/REDBAR.GIF)
The MONITOR MSCP_SERVER command initiates monitoring of the mass storage control protocol (MSCP) server class.
MONITOR MSCP_SERVER
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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
Selects average statistics to be displayed in a bar graph for display and summary output./CURRENT
Selects current statistics to be displayed in a bar graph for display and summary output. The /CURRENT qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM, and VECTOR classes./MAXIMUM
Selects maximum statistics to be displayed in a bar graph for display and summary output./MINIMUM
Selects minimum statistics to be displayed in a bar graph for display and summary output.
The MSCP server class consists of several data items that can be useful in tuning the MSCP server. These data items are:
- Server I/O Request Rate---The rate at which remote processors request I/O transfers.
- Read Request Rate---The rate at which remote processors request Read I/O transfers.
- Write Request Rate---The rate at which remote processors request Write I/O transfers.
- Extra Fragment Rate---The rate at which the server issues extra fragments. One or more extra fragments are created when, due to buffering constraints, the MSCP server issues multiple I/Os in order to fulfill a single I/O request. For example, if the MSCP server breaks up a 64-block request into 4 fragments of 16 blocks, 3 extra fragments are created.
- Fragmented Request Rate---The rate at which fragmented requests occur. A fragmented request is a transfer request that the server fragments due to buffering constraints. For example, one fragmented request occurs when the server splits a 36-block request into 3 fragments of 16 blocks, 16 blocks, and 4 blocks. In this example, the server creates two extra fragments.
- Buffer Wait Rate---The rate at which "buffer waits" occur in the server. A buffer wait occurs when a request must wait for MSCP buffer memory.
- Request Size Rates---A histogram that displays the rate of requests for various block sizes.
MONITOR> MONITOR MSCP_SERVER
OpenVMS Monitor Utility
MSCP SERVER STATISTICS
on node GLOBBO
29-APR-1996 09:51:43
CUR AVE MIN MAX
Server I/O Request Rate 0.00 0.71 0.00 6.22
Read Request Rate 0.00 0.54 0.00 6.22
Write Request Rate 0.00 0.16 0.00 6.16
Extra Fragment Rate 0.00 0.00 0.00 0.00
Fragmented Request Rate 0.00 0.00 0.00 0.00
Buffer Wait Rate 0.00 0.00 0.00 0.00
Request Size Rates 1 0.00 0.07 0.00 0.98
(Blocks) 2-3 0.00 0.03 0.00 0.65
4-7 0.00 0.03 0.00 0.65
8-15 0.00 0.10 0.00 1.63
16-31 0.00 0.46 0.00 5.51
32-63 0.00 0.00 0.00 0.00
64+ 0.00 0.00 0.00 0.00
This example demonstrates use of the MONITOR MSCP_SERVER command to generate MSCP statistics on node GLOBBO.
The MONITOR PAGE command initiates monitoring of the PAGE class.
MONITOR PAGE
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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
Selects average statistics to be displayed in a bar graph for display and summary output./CURRENT
Selects current statistics to be displayed in a bar graph for display and summary output. The /CURRENT qualifier is the default for the CLUSTER, MODES, STATES, SYSTEM, and VECTOR classes./MAXIMUM
Selects maximum statistics to be displayed in a bar graph for display and summary output./MINIMUM
Selects minimum statistics to be displayed in a bar graph for display and summary output.
The PAGE class includes the following data items:
- Page Fault Rate---Rate of page faults for all working sets
- Page Read Rate---Rate of pages read from disk as a result of page faults
- Page Read I/O Rate---Rate of read I/O operations from disk as a result of page faults
- Page Write Rate---Rate at which pages were written to the page file
- Page Write I/O Rate---Rate of write I/O operations to the page file
- Free List Fault Rate---Rate at which pages were read from the free-page list as a result of page faults
- Modified List Fault Rate---Rate of pages read from the modified-page list as a result of page faults
- Demand Zero Fault Rate---Rate at which zero-filled pages were allocated as a result of page faults
- Global Valid Fault Rate---Rate of page faults for pages that are not in the process's working set, but are in physical memory and are indicated as valid pages in the systemwide global page tables
- Writes In Progress Fault Rate---Rate of pages read that were in the process of being written back to disk when faulted
- System Fault Rate---Rate of page faults for pages in system space
- Free List Size---Number of pages on the free-page list
- Modified List Size---Number of pages on the modified-page list
MONITOR> MONITOR PAGE
OpenVMS Monitor Utility
PAGE MANAGEMENT STATISTICS
on node SAMPLE
29-APR-1996 22:22:44
CUR AVE MIN MAX
Page Fault Rate 26.82 18.27 9.66 26.82
Page Read Rate 3.97 2.65 1.33 3.97
Page Read I/O Rate 1.32 0.99 0.66 1.32
Page Write Rate 0.00 0.00 0.00 0.00
Page Write I/O Rate 0.00 0.00 0.00 0.00
Free List Fault Rate 13.90 10.96 8.00 13.90
Modified List Fault Rate 5.62 2.99 0.33 5.62
Demand Zero Fault Rate 4.63 2.65 0.66 4.63
Global Valid Fault Rate 1.32 0.66 0.00 1.32
Wrt In Progress Fault Rate 0.00 0.00 0.00 0.00
System Fault Rate 2.31 1.99 1.66 2.31
Free List Size 3164.00 3176.00 3164.00 3188.00
Modified List Size 155.00 131.00 107.00 155.00
This example shows that the current rate of pages read per read I/O operation is approximately 3 per second (Page Read Rate divided by Page Read I/O Rate). Note that while the page fault rate is currently at the highest point of the monitoring session, the majority of the pages are faulted from memory, not from disk.
The MONITOR PROCESSES command initiates monitoring of the PROCESSES class, which displays information on 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.
MONITOR PROCESSES
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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./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 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.
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:
- 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
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-1996 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
MONITOR> MONITOR/INPUT=PROCS.DAT PROCESSES/TOPDIO
OpenVMS Monitor Utility
TOP DIRECT I/O RATE PROCESSES
on node SAMPLE
29-APR-1996 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 |
| | | | |
|
+ - - - - + - - - - + - - - - + - - - - -+
The MONITOR RMS command initiates monitoring of the OpenVMS Record Management Services (OpenVMS RMS) statistics class for a specific file.
MONITOR RMS
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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
Selects average statistics to be displayed in a bar graph for display and summary output./CURRENT
Selects current statistics to be displayed in a bar graph for display and summary output. 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 output. 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
Selects maximum statistics to be displayed in a bar graph for display and summary output./MINIMUM
Selects minimum statistics to be displayed in a bar graph for display and summary output.
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 only displays statistics for the input file if statistics is enabled for the file, and the file is open. For information about enabling statistics for a file, see 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, see the OpenVMS Record Management Services Reference Manual, OpenVMS System Services Reference Manual, and the Guide to OpenVMS File Applications.
MONITOR> MONITOR RMS /ITEM=OPERATIONS /FILE=SYS$COMMON:[SYSEXE]SYSUAF.DAT
OpenVMS Monitor Utility
RMS FILE OPERATIONS
on node SAMPLE
29-APR-1996 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.
The MONITOR SCS command initiates monitoring of the System Communications Services (SCS) class.
MONITOR SCS
/qualifier[,...]
One or more qualifiers as described in the Command Qualifier Descriptions section.
/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
Selects average statistics to be displayed in a bar graph for display and summary output./CURRENT
Selects current statistics to be displayed in a bar graph for display and summary output. 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 output. 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
Selects maximum statistics to be displayed in a bar graph for display and summary output./MINIMUM
Selects minimum statistics to be displayed in a bar graph for display and summary output./PERCENT
/NOPERCENT (default)
Controls whether statistics are expressed as percent values in display and summary output. The /PERCENT qualifier is applicable only to the DISK, MODES, SCS, and STATES classes.
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:
- 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.
MONITOR> MONITOR SCS
OpenVMS Monitor Utility
SCS STATISTICS
on node CURLEY
29-APR-1996 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
Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]
6048P036.HTM OSSG Documentation 26-NOV-1996 12:43:13.31Copyright © Digital Equipment Corporation 1996. All Rights Reserved.