|
OpenVMS System Management Utilities Reference
Manual
H.4.2.15 SCS Class Record
The SCS class record contains data describing SCS (System
Communications Services) activity for all SCS connections in the
system, on a per-node basis. The SCS class record has a record type of
15; its size depends on the number of nodes being monitored. The size,
in bytes, is calculated by adding the size of the class header, the
class prefix, and the data blocks contained in the record. This is
shown in the following formula:
13 + 8 + (56 * the value of MNR_CMP$L_ELTCT)
|
Figure H-22 illustrates the format of the SCS class record.
Figure H-22 SCS Class Record Format
The following table describes the fields in the data block for the SCS
class record.
Field |
Symbolic Offset |
Contents |
Node Name
|
MNR_SCS$T_NODENAME
|
Name of remote cluster node (counted ASCII string) (8 bytes,I)
|
Datagrams Sent
|
MNR_SCS$L_DGSENT
|
Count of datagrams sent to the remote node (longword,C)
|
Datagrams Received
|
MNR_SCS$L_DGRCVD
|
Count of datagrams received from the remote node (longword,C)
|
Datagrams Discarded
|
MNR_SCS$L_DGDISCARD
|
Count of datagrams discarded by the CI port driver (longword,C)
|
Sequenced Messages Sent
|
MNR_SCS$L_MSGSENT
|
Count of sequenced messages sent to the remode node (longword,C)
|
Seqenced Messages Received
|
MNR_SCS$L_MSGRCVD
|
Count of sequenced messages received from the remote node (longword,C)
|
Block Transfer
Send-data commands
|
MNR_SCS$L_SNDATS
|
Count of block transfer send-data commands initiated on the local node,
targeted for the remote node (longword,C)
|
Kilobytes Sent by
Send-data commands
|
MNR_SCS$L_KBYTSENT
|
Count of kilobytes sent as a result of send-data commands (longword,C)
|
Block Transfer Request-
data commands
|
MNR_SCS$L_REQDATS
|
Count of block transfer request-data commands initiated on the local
node, targeted for the remote node (longword,C)
|
Kilobytes Received by
Request-data commands
|
MNR_SCS$L_KBYTREQD
|
Count of kilobytes received as a result of request-data commands
(longword,C)
|
Block Transfer
Kilobytes Mapped
|
MNR_SCS$L_KBYTMAPD
|
Count of kilobytes mapped for block transfers (longword,C)
|
Connections Queued For
Send Credit
|
MNR_SCS$L_QCRCNT
|
Count of times connections are queued for send credits (longword,C)
|
Connections Queued For
Buffer Descriptor
|
MNR_SCS$L_QBDTCNT
|
Count of times connections are queued for buffer descriptors
(longword,C)
|
H.4.2.16 STATES Class Record
The STATES class record contains data describing the number of
processes in each of the scheduler states. The STATES class record has
a record type of 1 and a size of 69 bytes.
Figure H-23 illustrates the format of the STATES class record.
Figure H-23 STATES Class Record Format
The following table describes the fields in the data block for the
STATES class record.
Field |
Symbolic Offset |
Contents |
Collided
Page Wait
|
MNR_STA$L_COLPG
|
Number of processes in collided page wait (longword,L)
|
Misc
Resource Wait
|
MNR_STA$L_MWAIT
|
Number of processes in miscellaneous resource wait (longword,L)
|
Common Event
Flag Wait
|
MNR_STA$L_CEF
|
Number of processes in common event flag wait (longword,L)
|
Page Fault
Wait
|
MNR_STA$L_PFW
|
Number of processes in page fault wait (longword,L)
|
Local Event Flag,
Inswapped
|
MNR_STA$L_LEF
|
Number of processes in local event flag wait, inswapped (longword,L)
|
Local Event Flag,
Outswapped
|
MNR_STA$L_LEFO
|
Number of processes in local event flag wait, outswapped (longword,L)
|
Hibernate,
Inswapped
|
MNR_STA$L_HIB
|
Number of processes in hibernate wait, inswapped (longword,L)
|
Hibernate,
Outswapped
|
MNR_STA$L_HIBO
|
Number of processes in hibernate wait, outswapped (longword,L)
|
Suspended,
Inswapped
|
MNR_STA$L_SUSP
|
Number of processes in suspended wait, inswapped (longword,L)
|
Suspended,
Outswapped
|
MNR_STA$L_SUSPO
|
Number of processes in suspended wait, outswapped (longword,L)
|
Free Page
Wait
|
MNR_STA$L_FPG
|
Number of processes in free wait (longword,L)
|
Compute State,
Inswapped
|
MNR_STA$L_COM
|
Number of processes in compute state, inswapped (longword,L)
|
Compute State,
Outswapped
|
MNR_STA$L_COMO
|
Number of processes in compute state, outswapped (longword,L)
|
Current
|
MNR_STA$L_CUR
|
Number of current processes (longword,L)
|
H.4.2.17 SYSTEM Class Record
The SYSTEM class record contains data describing the overall operation
of the three major system components (CPU, memory, I/O). The SYSTEM
class record has a record type of 17 and a size of 49 bytes. Note that
when the SYSTEM class is recorded, the PROCESSES, STATES, and MODES
classes are also recorded, even if not explicitly requested.
Figure H-24 illustrates the format of the SYSTEM class record.
Figure H-24 SYSTEM Class Record Format
The following table describes the fields in the data block for the
SYSTEM class record.
Field |
Symbolic Offset |
Contents |
CPU Busy
|
MNR_SYS$L_BUSY
|
Count of clock ticks (10-millisecond units) spent in all CPU modes
since system was booted (longword,C)
|
Other States
|
MNR_SYS$L_OTHSTAT
|
Number of processes in states other than LEF, LEFO, HIB, HIBO, COM,
COMO, PFW, and MWAIT (longword,L)
|
Process Count
|
MNR_SYS$L_PROCS
|
Number of processes in system (longword,L)
|
Page Faults
|
MNR_SYS$L_FAULTS
|
Count of page faults for all working sets (longword,C)
|
Read I/Os
|
MNR_SYS$L_PREADIO
|
Count of read I/Os resulting from disk page faults (longword,C)
|
Free Page Count
|
MNR_SYS$L_FREECNT
|
Number of pages currently on free-page list (longword,L)
|
Modified Page Count
|
MNR_SYS$L_MFYCNT
|
Number of pages currently on modified-page list (longword,L)
|
Direct I/Os
|
MNR_SYS$L_DIRIO
|
Count of direct I/O operations (longword,C)
|
Buffered I/Os
|
MNR_SYS$L_BUFIO
|
Count of buffered I/O operations (longword,C)
|
H.4.2.18 TIMER Class Record
The TIMER class record contains data that is useful to the OpenVMS
executive when monitoring timer queue entries (TQEs). The TIMER class
record has a record type of 26 and a size of 29 bytes.
Figure H-25 illustrates the format of the TIMER class record.
Figure H-25 TIMER Class Record Format
The following table describes the contents of each of the TIMER class
record fields.
Field |
Symbolic Offset |
Contents |
Total TQEs
|
MNR_TMR$L_TQE_TOTAL
|
Count of all TQEs processed per second.
|
SYSUB TQEs
|
MNR_TMR$L_TQE_SYSUB
|
Count of SYSUB TQEs processed per second.
|
Timer TQEs
|
MNR_TMR$L_TQE_TIMER
|
Count of timer requests made by users per second.
|
Wakeup TQEs
|
MNR_TMR$L_TQE_WAKEUP
|
Count of wakeup timer requests made by users per second.
|
H.4.2.19 TRANSACTION Class Record
The TRANSACTION class record contains data describing the operations of
the DECdtm transaction manager. The TRANSACTION class has a record type
of 22 and a size of 69 bytes. Figure H-26 illustrates the format of
the TRANSACTION class record.
Figure H-26 TRANSACTION Class Record Format
The following table describes the contents of each of the TRANSACTION
class record fields.
Field |
Symbolic Offset |
Contents |
Starts
|
MNR_TRA$L_STARTS
|
Count of transactions started. The number of times that calls on the
local node to $START_TRANS have completed successfully (longword, C).
|
Prepares
|
MNR_TRA$L_PREPARES
|
Count of transactions that have been prepared (longword, C).
|
One Phase Commits
|
MNR_TRA$L_ONE_PHASE
|
Count of one-phase commit events initiated (longword, C).
|
Commits
|
MNR_TRA$L_COMMITS
|
Count of transactions committed. This is the combined total of
one-phase and two-phase commits (longword, C).
|
Aborts
|
MNR_TRA$L_ABORTS
|
Count of transactions aborted. Combined total of planned and unplanned
aborts (longword, C).
|
Ends
|
MNR_TRA$L_ENDS
|
Count of transactions ended. The number of times that calls on the
local node to $END_TRANS have completed successfully (longword, C).
|
Branches
|
MNR_TRA$L_BRANCHS
|
Count of transaction branches started on the local node (longword, C).
|
Adds
|
MNR_TRA$L_ADDS
|
Count of transaction branches added on the local node (longword, C).
|
0-1 Transactions
|
MNR_TRA$L_BUCKETS1
|
Count of transactions with a duration of less than 1 second (longword,
C).
|
1-2 Transactions
|
MNR_TRA$L_BUCKETS2
|
Count of transactions with a duration of 1 to 2 (1.99) seconds
(longword, C).
|
2-3 Transactions
|
MNR_TRA$L_BUCKETS3
|
Count of transactions with a duration of 2 to 3 seconds (longword, C).
|
3-4 Transactions
|
MNR_TRA$L_BUCKETS4
|
Count of transactions with a duration of 3 to 4 seconds (longword, C).
|
4-5 Transactions
|
MNR_TRA$L_BUCKETS5
|
Count of transactions with a duration of 4 to 5 seconds (longword, C).
|
5+ Transactions
|
MNR_TRA$L_BUCKETS6
|
Count of transactions with a duration greater than 5 seconds (longword,
C).
|
H.4.2.20 VBS Class Record (VAX Only)
On VAX systems, the VBS class record contains statistics on the
operation of the virtual balance slot (VBS) mechanism. The VBS class
record has a record type of 24 and a size of 21 bytes.
Figure H-27 illustrates the format of a VBS class record.
Figure H-27 VBS Class Record Format (VAX Only)
The following table describes the fields in the data block for the VBS
class record.
Field |
Symbolic Offset |
Contents |
VBS Faults
|
MNR_VBS$L_VRBS_TRAN
|
Count of faults from virtual balance slots to real balance slots
(longword, C)
|
VBS Clock Ticks
|
MNR_VBS$L_VCPUTICKS
|
Count of virtual balance slot clock ticks (10-millisecond units)
(longword, C)
|
H.4.2.21 VECTOR Class Record
The VECTOR class record contains data describing the time during which
vector consumers have been scheduled on a vector-present processor. Its
record type number is 23. A VECTOR class record is of variable length
and depends on the number of active processors in the system. Assuming
all processors are active, MONITOR calculates the size of the record by
adding the size of the class header, the class prefix, and the data
blocks contained in the record. This is shown in the following formula:
13 + 8 + (5 * MNR_SYI$B_VPCPUS)
|
Figure H-28 illustrates the format of the VECTOR class record.
Figure H-28 VECTOR Class Record Format
The following table describes the contents of each of the VECTOR class
record fields.
Field |
Symbolic Offset |
Contents |
CPU ID
|
MNR_VEC$B_CPUID
|
Identification of the processor from which the data has been collected
(byte, I)
|
Ticks
|
MNR_VEC$L_TICKS
|
Number of 10-millisecond clock ticks in which a vector consumer has
been scheduled on this processor (longword, C)
|
To support the VECTOR class, MONITOR uses the items MNR_SYI$B_VPCPUS
and MNR_SYI$L_VPCONF in the system information record. See the table in
Section H.3.2 for details on these items.
Appendix I SHOW CLUSTER Keypad Commands
SHOW CLUSTER provides a predefined keypad that you can use to enter
selected commands. You can add, remove, or reposition windows, scroll
their contents, or change the interval at which the display is updated.
You can also customize the keypad by redefining the default functions
of individual keys.
I.1 Using the Keypad
By default, the numeric keypad is defined as shown in Figure I-1.
Figure I-1 SHOW CLUSTER Default Keypad
Shading over a keypad command indicates that you must press the GOLD
key and then the keypad key.
The following table describes each keypad command you can use with the
Show Cluster utility. In this table, KPn refers to the keypad
key labeled with the number n. For example, KP2 refers to the
keypad key labeled with the number 2. All commands shown on the keypad
are also discussed in the Command Section of Chapter 19.
Command |
Key or Key Sequence |
Description |
ADD
|
KP4
|
Modifies the current display by including the field or class that you
specify after the ADD command.
|
DESELECT
|
GOLD-Period
|
Terminates a window selection.
|
GOLD
|
PF1
|
When pressed before another keypad key, specifies the second key's
alternate function (the bottom function on the keypad diagram).
|
HELP
|
PF2
|
Displays information about using the editing keypad.
|
INIT
|
PF4
|
Resets the display using the original default values for field names,
class names, and field widths.
|
REFRESH
|
PF3
|
Refreshes the screen display. Clears and redraws the screen, deleting
any extraneous characters or messages that might have appeared on the
screen but are not part of the SHOW CLUSTER display. (Performs the same
function as Ctrl/W.)
|
REMOVE
|
KP5
|
Modifies the current display by removing the field or class that you
specify after the REMOVE command.
|
SAVE
|
KP2
|
Allows you to save the current display to a startup initialization file
or a command procedure that you can then use to restore the display at
a later time.
|
SELECT
|
Period
|
Designates which window to scroll or move.
|
SET
|
KP1
|
Changes any of several options including the number of columns in the
display, the number of seconds between updates, the functions of the
arrow keys, the auto positioning of windows, and the characteristics of
a particular field.
|
SET AUTO_POS OFF
|
KP6
|
Disables the automatic positioning of windows on the screen.
|
SET AUTO_POS ON
|
GOLD-KP6
|
Enables the Show Cluster utility to automatically position windows on
the screen. This is the default setting.
|
SET FUNCTION
EDIT
|
Hyphen
|
Redefines the arrow keys to restore line-mode editing.
|
SET FUNCTION
MOVE
|
KP9
|
Redefines the arrow keys to move a selected window to a specified
position on the display screen. For example, the UP, DOWN, RIGHT, and
LEFT arrow keys are redefined as MOVE UP 1, MOVE DOWN 1, MOVE RIGHT 1,
and MOVE LEFT 1, respectively.
|
SET FUNCTION
PAN
|
KP7
|
Redefines the arrow keys to rotate the display. For example, the UP,
DOWN, RIGHT, and LEFT arrow keys are redefined as PAN UP 1, PAN DOWN 1,
PAN RIGHT 1, and PAN LEFT 1, respectively.
|
SET FUNCTION
SCROLL
|
KP8
|
Resets the arrow keys to scroll the screen display. For example, if you
press the SET FUNCTION SCROLL key, the UP, DOWN, RIGHT, and LEFT arrow
keys are redefined as SCROLL UP 1, SCROLL DOWN 1, SCROLL RIGHT 1, and
SCROLL LEFT 1, respectively.
|
WRITE
|
KP3
|
Outputs the current display to either a file name that you specify, or
to the default output file name SHOW_CLUSTER.LIS.
|
I.2 Redefining the Keypad Keys
Use the DEFINE/KEY command to change the definition of a key. See the
DEFINE/KEY command in the Command Section of Chapter 19 for more
information.
I.3 Redefining the Arrow Keys
By default, the SHOW CLUSTER arrow keys are set to the EDIT function.
This means that you can perform command line editing at the command
prompt that is similar to DCL line-mode editing. For example, the left
arrow key moves the cursor to the left, or the up arrow key recalls the
previous command. See the OpenVMS User's Manual for information about DCL
line-mode editing.
The SET FUNCTION keys, shown in the second row of the keypad, redefine
the arrow keys to perform a specified function. You can reset the arrow
keys from EDIT to PAN, SCROLL, or MOVE with the SET FUNCTION command.
For example, if you press the SET FUNCTION SCROLL key, the up, down,
right, and left arrow keys are redefined as SCROLL UP 1, SCROLL DOWN 1,
SCROLL RIGHT 1, and SCROLL LEFT 1, respectively. (See the Command
Section of Chapter 19 for information about specific commands.)
Note
If you set the function to PAN, SCROLL, or MOVE, the arrow keys are no
longer defined to perform DCL line-mode editing. Only one function can
be enabled at a time. To restore line-mode editing once it has been
changed to another function, enter the command SET FUNCTION EDIT.
|
|