SHOW CLUSTER

From VSI OpenVMS Wiki
Jump to: navigation, search

SHOW CLUSTER is a utility that monitors and displays cluster activity and performance.

If specified without qualifiers, the SHOW CLUSTER command displays a cluster report and exits. To show the report in real time and tune the display, invoke SHOW CLUSTER with SHOW CLUSTER/CONTINUOUS.

Classes

The following classes of information are available in SHOW CLUSTER:

Classes Elements Description
CIRCUITS

Contains information about the virtual circuits on a system:

┌───────────────────────────────────────────────────────────────┐
│                           CIRCUITS                            │
├───────┬────────┬───────┬─────────┬───────┬──────┬──────┬──────┤
│ LPORT │ RP_TYP │ RPORT │ CIR_STA │ CABLE │ PRIO │ MGT_ │ LD_C │
├───────┼────────┼───────┼─────────┼───────┼──────┼──────┼──────┤
│ PEA0  │ LAN    │       │ OPEN    │       │    0 │    0 │    0 │
│ PEA0  │ LAN    │       │ OPEN    │       │    0 │    0 │ 2000 │
└───────┴────────┴───────┴─────────┴───────┴──────┴──────┴──────┘
┌───────────────────────────────────────────────────────────┐
│                          CIRCUITS                         │
├──────────┬─────────┬───────┬──────────┬──────────┬────────┤
│  REM_STA │ NUM_CON │ SCS_W │ RP_REVIS │ RP_FUNCT │ RP_OWN │
├──────────┼─────────┼───────┼──────────┼──────────┼────────┤
│  ENAB    │       0 │     0 │      106 │ 83FF0180 │      0 │
│  ENAB    │       4 │     0 │      106 │ 83FF0180 │      0 │
└┴─────────┴─────────┴───────┴──────────┴──────────┴────────┘
 
CABLE_STATUS Status of the CI circuit paths A and B. Possible displays are:
- Paths A and B are bad.
A- Path A is good.
-B Path B is good.
A-B Paths A and B are good.
CROSSED Cables are crossed.
LPORT_NAME Device name of the local port associated with the circuit (PAA0, PAB0, PEA0)
MGT_PRIORITY Priority value assigned to the circuit by management action.
NUM_CONNECTIONS Number of connections on the circuit between the local and remote systems.
PRIORITY Circuit's current priority, which is the sum of the management priorities assigned to the circuit and the associated local port.
REM_STATE State of the remote port. Possible displays are:
DISAB Remote port is disabled.
ENAB Remote port is enabled.
M_DISAB Remote port is in maintenance mode and is disabled.
M_ENAB Remote port is in maintenance mode and is enabled.
M_UNINIT Remote port is in maintenance mode and has not been initialized.
UNINIT Remote port has not been initialized.
RP_FUNCTIONS Function mask of the remote port.
RPORT_NUM Port number of the remote port associated with the circuit. The field applies only to CI.
RP_OWNER Port number of the remote port owner.
RP_REVISION Hardware or microcode revision number of the remote port.
RP_TYPE Type of remote port associated with the circuit. Examples of some possible types might include: CIMNA, KFMSA, SHAC, SII, BVPSSP (a BVP storage systems port), CI780, CI750, CIBCA-A and CIBCA-B, RF and TF devices (for example RF73 or TF85), HSC devices (for example, HSC65 or HSC90), Ethernet, PASSTH (port is in passthrough mode), and so on.
SCS_WAITERS Number of connections waiting to send SCS control messages on the virtual circuit.
CLUSTER

Contains general information about the cluster:

┌──────────────────────────────────────────────────────────────────────────────────────────────┐
│                                            CLUSTER                                           │
├────────┬───────────┬──────────┬─────────┬────────────┬───────────────────┬───────────────────┤
│ CL_EXP │ CL_QUORUM │ CL_VOTES │ QF_VOTE │ CL_MEMBERS │       FORMED      │  LAST_TRANSITION  │
├────────┼───────────┼──────────┼─────────┼────────────┼───────────────────┼───────────────────┤
│      3 │         2 │        3 │ YES     │          2 │  6-MAR-2019 11:22 │ 27-MAR-2019 04:27 │
└────────┴───────────┴──────────┴─────────┴────────────┴───────────────────┴───────────────────┘
┌───────────────────────────────────┐
│              CLUSTER              │
├─────────────────┬────────┬────────┤
│     QD_NAME     │ CL_QDV │ MEMSEQ │
├─────────────────┼────────┼────────┤
│                 │      0 │      0 │
└─────────────────┴────────┴────────┘
 
CL_EXPECTED_VOTES The number of votes the cluster has ever seen (or could see), as determined by the connection manager. The value is based on the maximum value of CL_EXPECTED_VOTES, the value for EXPECTED_VOTES that is specified by each node, and the sum of the cluster votes (CL_VOTES). CL_QUORUM is derived from CL_EXPECTED_VOTES.
CL_MEMBERS Number of processors participating in the cluster.
CL_QDVOTES Number of votes contributed by the quorum disk.
CL_QUORUM The number of votes that must be present for the cluster to function and permit user activity. CL_QUORUM is equal to (CL_EXPECTED_VOTES + 2) divided by 2.
CL_VOTES Total number of votes contributed by all members of the cluster at any point in time.
FORMED Time at which the cluster was formed, expressed as dd-mmm-yy hh:mm.
LAST_TRANSITION Last time at which a system left or joined the cluster, expressed as dd-mmm-yy hh:mm.
MEMSEQ Membership state sequence number, which changes whenever a node joins or leaves the cluster.
QD_NAME Full device name of the quorum disk.
QF_VOTE Indicates whether or not the quorum disk is contributing any votes towards the cluster quorum.
CONNECTIONS

Contains information about the connection established over a virtual circuit:

┌─────────────────────────────────────────────────────────────────────────────────┐
│                                   CONNECTIONS                                   │
├──────────────────┬──────────────────┬─────────┬───────────┬───────────┬─────────┤
│   LOC_PROC_NAME  │   REM_PROC_NAME  │ CON_STA │ LOC_CONID │ REM_CONID │ SCS_STA │
├──────────────────┼──────────────────┼─────────┼───────────┼───────────┼─────────┤
│ SCS$DIRECTORY    │        ?         │ LISTEN  │  A62A0000 │         0 │ CLEAR   │
│ MSCP$TAPE        │        ?         │ LISTEN  │  A62A0001 │         0 │ CLEAR   │
│ MSCP$DISK        │        ?         │ LISTEN  │  A62A0002 │         0 │ CLEAR   │
│ VMS$SDA_AXP      │        ?         │ LISTEN  │  A62A0003 │         0 │ CLEAR   │
│ VMS$VAXcluster   │        ?         │ LISTEN  │  A62A0004 │         0 │ CLEAR   │
│ SCA$TRANSPORT    │        ?         │ LISTEN  │  A62A0005 │         0 │ CLEAR   │
│ SCA$TRANSPORT    │ SCA$TRANSPORT    │ OPEN    │  A62D0008 │  A63A0009 │ CLEAR   │
│ VMS$DISK_CL_DRVR │ MSCP$DISK        │ OPEN    │  A62A0009 │  A62E0008 │ CLEAR   │
│ MSCP$DISK        │ VMS$DISK_CL_DRVR │ OPEN    │  A62B0006 │  A65F0007 │ CLEAR   │
│ VMS$VAXcluster   │ VMS$VAXcluster   │ OPEN    │  A62A0007 │  A62D0006 │ CLEAR   │
└──────────────────┴──────────────────┴─────────┴───────────┴───────────┴─────────┘
 
CON_STATE The state of the connection. Possible displays are:
ACCP_SENT Accept request has been sent.
CLOSED Connection is closed.
CON_ACK Connect request has been sent and acknowledged.
CON_REC Connect request has been received.
CON_SENT Connect request has been sent.
DISC_ACK Disconnect request is acknowledged.
DISC_MTCH Disconnect request is matched.
DISC_REC Disconnect request has been received.
DISC_SENT Disconnect request has been sent.
LISTEN Connection is in the listen state.
OPEN Connection is open.
REJ_SENT Reject has been sent.
VC_FAIL Virtual circuit has failed.
LOC_CONID Identification number of the local side of the connection.
LOC_PROC_NAME Name of the local process associated with the connection.
REM_CONID Identification number of the remote side of the connection. This information does not apply for connections in the LISTEN state.
REM_PROC_NAME name of the remote process associated with the connection. This information does not apply for connections in the LISTEN state.
SCS_STATE SCS send blocked state. If the connection is waiting to send an SCS control block message, the SCS send blocked state indicates what kind of message it is waiting to send. Possible displays are:
ACCP_PEND Waiting to send an accept request.
CLEAR Not blocked.
CON_PEND Waiting to send a connection request.
CR_PEND Waiting to send credit.
DCR_PEND Waiting to send credit in preparation for a disconnect.
DISC_PEND Waiting to send a disconnect request.
REJ_PEND Waiting to send a reject request.
COUNTERS

Displays the counts for the total accumulated traffic over a connection for the life of the connection:

┌──────────────────────────────────────────────────┐
│                     COUNTERS                     │
├───────┬───────┬───────┬────────┬────────┬────────┤
│ DGS_S │ DGS_R │ DGS_D │ MSGS_S │ MSGS_R │ BLKS_S │
├───────┼───────┼───────┼────────┼────────┼────────┤
│     0 │     0 │     0 │     26 │     35 │      0 │
│     0 │     0 │     0 │  18196 │  18196 │      0 │
│     0 │     0 │     0 │  18200 │  18188 │      0 │
│     0 │     0 │     0 │  53316 │  47627 │      1 │
└───────┴───────┴───────┴────────┴────────┴────────┘
┌────────────────────────────────────────────────┐
│                    COUNTERS                    │
├────────┬──────┬───────┬─────────┬──────┬───────┤
│ BLKS_R │ KB_S │ KB_RC │ KB_MAPP │ CR_W │ BDT_W │
├────────┼──────┼───────┼─────────┼──────┼───────┤
│      0 │    0 │     0 │       4 │    0 │     0 │
│      0 │    0 │     0 │       0 │    0 │     0 │
│      0 │    0 │     0 │       0 │    1 │     0 │
│     11 │    1 │    39 │     109 │    0 │     0 │
└────────┴──────┴───────┴─────────┴──────┴───────┘
 
BDT_WAITS Number of times this connection had to wait for a buffer descriptor.
BLKS_REQ Number of block-request data commands initiated to block transfer data from the remote system to the local system.
BLKS_SENT Number of block-send data commands initiated to block-transfer data from the local system to the remote system.
CR_WAITS Number of times this connection had to wait for send credit.
DGS_DSCRD Number of application datagrams discarded by the port driver.
DGS_RCVD Number of application datagrams received by the local system over the connection from the remote system and given to SYSAP.
DGS_SENT Number of application datagrams sent over the connection.
KB_MAPPED Number of kilobytes of data mapped for block transfer.
KB_RCVD Number of kilobytes of data received by the local system from the remote system through request-data commands.
KB_SENT Number of kilobytes of data sent from the local system to the remote system through send-data commands.
MSGS_RCVD Number of application datagram messages received over the connection.
MSGS_SENT Number of application datagram messages sent over the connection.
CREDITS

Displays the send and receive credit counts for each connection:

│──────────────────────────────────────────────┐
│                    CREDITS                   │
├──────┬───────┬─────┬────────┬────────┬───────┤
│ SEND │ MIN_S │ REC │ PEND_R │ INIT_R │ MIN_R │
├──────┼───────┼─────┼────────┼────────┼───────┤
│    5 │     0 │   6 │      0 │      6 │     0 │
│   31 │     2 │  10 │      0 │     10 │     1 │
│   10 │     1 │  32 │      0 │     32 │     2 │
│   32 │     0 │  31 │      1 │     32 │     0 │
└──────┴───────┴─────┴────────┴────────┴───────┘
 
INIT_REC Initial receive credit extended to the remote system when the connection was made.
MIN_REC Minimum receive credit (minimum send credit required by the remote system).
MIN_SEND Minimum send credit.
PEND_REC Receive credit not yet extended to the remote system.
RECEIVE Receive credit (send credit held by the remote system).
SEND Current send credit.
ERRORS

Displays a running count of the errors on each port along with the current number of reinitialization attempts remaining and the maximum number of times reinitialization can be attempted:

┌────────────────────────┐
│         ERRORS         │
├───────┬───────┬────────┤
│ ERT_C │ ERT_M │ NUM_ER │
├───────┼───────┼────────┤
│    50 │    50 │      0 │
└───────┴───────┴────────┘
 
ERT_COUNT Number of port reinitialization attempts remaining.
ERT_MAX Total number of times a recovery from fatal port errors can be attempted by shutting down all virtual circuits and connections and reinitializing the port.
NUM_ERRORS Number of errors that have been logged on the port since the system was booted. This number includes errors encountered in reinitialization attempts as well as recoverable errors, such as virtual circuit failure. This is the same error count as that displayed by the DCL command SHOW DEVICE.
LOCAL_PORTS

Displays information about the port interface on the local system:

┌──────────────────────────────────────────────────────────────┐
│                          LOCAL_PORTS                         │
├────────────┬─────┬────────┬──────┬────────┬──────────────────┤
│ BUFF_DESCR │ DGS │ DG_OVR │ CMDS │ DGI_MA │   COUNTER_OWNER  │
├────────────┼─────┼────────┼──────┼────────┼──────────────────┤
│       8192 │   0 │    592 │    0 │      0 │        ?         │
└────────────┴─────┴────────┴──────┴────────┴──────────────────┘
┌──────────────────────────────────────────────────────────────┐
│                          LOCAL_PORTS                         │
├────────┬───────┬──────┬──────┬────────┬────────────┬─────────┤
│ LP_STA │ LB_ST │ LP_P │ LP_L │ FORM_C │ FREE_BUFF_ │ LOG_MAP │
├────────┼───────┼──────┼──────┼────────┼────────────┼─────────┤
│ ONLINE │       │    0 │   10 │      0 │        128 │       0 │
└────────┴───────┴──────┴──────┴────────┴────────────┴─────────┘
┌─────────────────────────────────────────────────────────┐
│                       LOCAL_PORTS                       │
├──────┬────────┬────────┬─────┬──────┬────────┬──────────┤
│ NAME │ LP_TYP │ OPEN_C │ MSG │ POOL │ MSG_HD │ MAX_PORT │
├──────┼────────┼────────┼─────┼──────┼────────┼──────────┤
│ PEA0 │ LAN    │      2 │   0 │    0 │     32 │      255 │
└──────┴────────┴────────┴─────┴──────┴────────┴──────────┘

┌───────────────────────┐
│      LOCAL_PORTS      │
├──────┬──────┬─────────┤
│ PORT │ RSPS │ PRT_MAP │
├──────┼──────┼─────────┤
│    0 │    0 │       0 │
└──────┴──────┴─────────┘
  
BUFF_DESCR Number of buffer descriptors in use.
CMDS_QUEUED Total number of messages, datagrams, and port commands queued for transmission at all priorities by the port.
COUNTER_OWNER Name of the process currently using the port traffic counters.
DGI_MAP A 16-bit bit map displayed as four hexadecimal digits. Each bit in the map represents a port in the cluster from which datagram reception has been disabled.
DG_OVRHD_SIZE Number of bytes of port header, SCS header, and DECnet header in a datagram.
DGS_FREE Number of free datagram buffers currently queued for receive commands.
FORM_CIRCS Number of formative circuits (circuits in the process of opening) from the port.
FREE_BUFF Number of CI buffer descriptors free for use.
LB_STATUS Loopback status of each cable from the port to the star coupler. The field applies only to CI. Possible displays are:
A-B Loopback tests pass on paths A and B.
A-# Loopback tests pass on path A.
#-B Loopback tests pass on path B.
#-# Loopback tests failed on paths A and B.
N/A Loopback tests are not being done.
LOG_MAP A 16-bit bit map displayed as four hexadecimal digits. Each bit in the map represents a port in the cluster for which an error was logged. Errors are logged when data provided by the configuration database on the local system conflicts with data provided by the remote system. When a conflict is discovered and an error is logged, virtual circuits to the remote system can no longer be established.
LP_LD_CLASS Hard-coded capacity value of the port, based on the megabits/second rate of the interconnect of the port.
LP_PRIORITY Management priority assigned to the port.
LP_STATUS Status of the local port. The port is either online or offline.
LP_TYPE Device type of the port (CI780, CI750).
MAX_PORT Largest port number to which a virtual circuit open is attempted.
MSGS_FREE Number of free message buffers currently queued for receives commands.
MSG_HDR_SIZE Number of bytes of port header and SCS header in a message.
NAME Device name of the local port.
OPEN_CIRCS Number of virtual circuits open from the port.
POOL_WAITERS Number of processes waiting for nonpaged pool resources for message buffers.
PORT_NUM Port number assigned to the port.
PRT_MAP A 16-bit bit map displayed as three hexadecimal digits. Each bit in the map represents a port in the cluster that has been recognized by the host system.
RSPS_QUEUED Total number of responses of all kinds received from the port but not yet processed.
MEMBERS

Displays information about the systems that are actively participating in the cluster:

┌─────────────────────────────────────────────────────────────────────────┐
│                                 MEMBERS                                 │
├───────┬───────┬────────┬───────┬────────┬────────┬─────────┬────────────┤
│ PROTO │ WARMC │ CNX_ST │ VOTES │ EXPECT │ QUORUM │ QF_SAME │ QF_WATCHER │
├───────┼───────┼────────┼───────┼────────┼────────┼─────────┼────────────┤
│  30.0 │     0 │        │     1 │      1 │      1 │ YES     │ YES        │
│  30.0 │    12 │ OPEN   │     1 │      1 │      1 │ YES     │ YES        │
└───────┴───────┴────────┴───────┴────────┴────────┴─────────┴────────────┘
┌─────────────────────────────────────────────────────────────────────────────────┐
│                                     MEMBERS                                     │
├────────┬────────┬────────┬────────┬───────┬───────┬─────────┬───────────────────┤
│  CSID  │ SEND_S │ RCVD_S │ DIR_WT │ UNACK │ ACK_L │  STATUS │  TRANSITION_TIME  │
├────────┼────────┼────────┼────────┼───────┼───────┼─────────┼───────────────────┤
│  10010 │      0 │      0 │      0 │     0 │     0 │ MEMBER  │ 27-MAR-2019 04:27 │
│  1000E │  53307 │  47609 │      0 │     2 │    25 │ MEMBER  │ 25-MAR-2019 11:03 │
└────────┴────────┴────────┴────────┴───────┴───────┴─────────┴───────────────────┘

┌────────────────────┐
│       MEMBERS      │
├──────────┬─────────┤
│ RECNXINT │ SW_VERS │
├──────────┼─────────┤
│       20 │       6 │
│       20 │       6 │
└──────────┴─────────┘
 
ACK_LM Maximum number of OpenVMS Cluster messages the remote system can receive before sending an acknowledgment.
ACKR_SQ Sequence number of the last acknowledgment received over the cluster connection.
CNX_STATE State of the cluster connection. Possible displays are:
ACCEPT Initial connection is accepted.
CLOSED Connection is closed.
CONNECT Initial connection is being accepted.
DEAD No connection is possible.
DISCONNECT Disconnection is in progress.
NEW No attempt to make a connection has been made yet.
OPEN Connection is open.
REACCEPT Connection is accepting the reconnect request.
RECONNECT Connection is attempting to reconnect.
WAIT Timeout is in progress.
CSID Cluster system identification number. This number is unique over the life of the cluster. Unlike SYS_ID, this identification number may change when the system reboots.
DIR_WT Lock manager distributed directory weight.
EXPECTED_VOTES Maximum number of votes that an individual node can encounter. Used as an initial estimate for computing CL_EXPECTED_VOTES. The cluster manager sets this number using the EXPECTED_VOTES system parameter. It is possible for this field to display a number smaller than the EXPECTED_VOTES parameter setting if the REMOVE_NODE option was used to shut down a cluster member or the SET CLUSTER/EXPECTED_VOTES DCL command was used since this node was last rebooted. The dynamic value for EXPECTED_VOTES used clusterwide is the CL_EXPECTED_VOTES field, which is described in CLUSTER Class Fields.
PROTOCOL Protocol version number and ECO level of the connection management software.
QDVOTES Number of votes the remote system recommends be contributed by the quorum disk. Normally, the cluster manager sets this number using the system parameter QDSKVOTES.
QF_ACTIVE Indicates whether the remote system's quorum file is accessible.
QF_SAME Indicates whether the local and remote systems agree about which disk is the quorum disk.
QF_WATCHER Remote system has an active connection to the quorum disk and can verify its connection for members unable to access the disk directly.
QUORUM Derived from EXPECTED_VOTES and calculated by the connection manager. It represents an initial value for the minimum number of votes that must be present for this node to function. The dynamic QUORUM value is the CL_QUORUM field, which is described in the CLUSTER class category in CLUSTER Class Fields.
RCVD_SQ Sequence number of the last message received over the OpenVMS Cluster connection.
RECNXINTERVAL Displays the time (in seconds) that the connection manager will wait before timing out the corresponding connection. It is the maximum of the value contained in the system parameter RECNXINTERVAL on the local node and the amount of time it would take for the connection manager on the remote node to discover that the connection is broken.
SEND_SQ Sequence number of the next message to be sent over the OpenVMS Cluster connection.
STATUS Status of the node in the cluster. Possible displays are:
BRK_MEM System is a member of the cluster, but the connection manager has lost communication with it.
BRK_NEW System has just booted, but has not yet joined the cluster and the connection manager has lost communication with it.
BRK_NON Connection manager has lost communication with the system and the system is no longer a member of the cluster.
BRK_REM Connection manager has lost communication with the system, and the system has been removed from the cluster.
NEW System has just booted, but has not yet joined the cluster. If this system would normally be a member of the cluster and is displaying NEW in this field, you can expect that the display will eventually change to MEMBER.
NON System is not a member of the cluster.
REMOVED System has been removed from the cluster.
SW_VERS Indicator of the software version running on the node.
TRANSITION_TIME Time of the system's last change in membership status. (See the STATUS field.)
UNACKED Number of unacknowledged OpenVMS Cluster messages received by the remote system.
VOTES Number of votes the remote node contributes toward quorum. Normally, the cluster manager sets this number with the system parameter VOTES.
WARMCDRPS Number of CDRPs on the CDRP free queue.
SYSTEMS

Contains information about the systems in the cluster:

┌───────────────────────────────────────────────────────────────────────────────┐
│                                   SYSTEMS                                     │
├────────┬──────────┬──────────────────────────┬────────────────────────────────┤
│  NODE  │  SYS_ID  │          HW_VERS         │             HW_TYPE            │
├────────┼──────────┼──────────────────────────┼────────────────────────────────┤
│ SMAN44 │     1068 │ 000000000000000000000040 │ HP rx2660  (1.59GHz/9.0MB)     │
│ SMAN45 │     1069 │ 000000000000000000000040 │ HP rx2660  (1.59GHz/9.0MB)     │
└────────┴──────────┴──────────────────────────┴────────────────────────────────┘

┌──────────────────────────────────────────────────────────┐
│                        SYSTEMS                           │
┬───────────────┬─────────┬──────┬───────┬─────────────────┤
│ SOFTWARE      │ NUM_CIR │ DG_S │ MSG_S │   INCARNATION   │
├───────────────┼─────────┼──────┼───────┼─────────────────┤
│ VMS V8.4-2L1  │       1 │  576 │   216 │  B3C7DDF72F9D00 │
│ VMS V8.4-2L1  │       1 │  576 │   216 │  B3C682BBCC8B80 │
└───────────────┼─────────┼──────┼───────┼─────────────────┤
 
DG_SIZE Maximum number of bytes of application data in datagrams sent over the circuit.
HW_TYPE System hardware type (for example, VAXstation 3100 or HS70). (Enclose the system type between double quotation marks.)
HW_VERS Hardware configuration and revision levels of the remote system.
INCARNATION Unique 16-digit hexadecimal number established when the system is booted.
INCN_TIME Incarnation number expressed as a time (dd-mmm-yy hh:mm).
MSG_SIZE Maximum number of bytes of application data in messages sent over the circuit.
NODE Node name of the remote system. Normally, the cluster manager sets the node name using the system parameter SCSNODE. The node name should be the same as the DECnet node name. (Note that SCSNODE cannot be more than six characters.)
NUM_CIRCUITS Number of virtual circuits between the local system and remote systems.
SOFTWARE Name and version of the operating system currently running on the remote system.
SYS_ID Identification number of the remote system. Normally, the cluster manager sets this number using the system parameters SCSSYSTEMID and SCSSYSTEMIDH. This number should be the same as the DECnet node number.

See also