Document revision date: 19 July 1999

CREDITS Class

The CREDITS class displays the send and receive credit counts for each connection.

Field Name	Description
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 Class

The ERRORS class displays a count of the errors on each port, along with information about the feasibility of reinitializing a port.

Field Name	Description
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 Class

The LOCAL_PORTS class displays information about the local system interface to the cluster, such as the name, number, and status of each port, and the number of entries in the queues associated with each port.

Field Name	Description
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 as follows: 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_STATUS	Status of the local port. The port is either on line or off line.
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 Class

The MEMBERS class contains information about active systems in the cluster, such as their identification numbers and membership status.

Field Name	Description
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 as follows: 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 ever encounters. Used as an initial estimate for computing CL_EXPECTED_VOTES. The cluster manager sets this number using the system parameter EXPECTED_VOTES. 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 the CLUSTER class category of ADD (Field).
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 of ADD (Field).
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 as follows: blank System is not being considered as a cluster member. 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. MEMBER System is participating in 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 Class

The SYSTEMS class lists information about all systems in the cluster, such as their identification numbers, node names, hardware types, and software versions.

Field Name	Description
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.
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.

Qualifiers

None.

Description

The ADD (Field) command enables and adds specific fields of information to a SHOW CLUSTER display. When you add a field for a class that is not currently being displayed, the class heading of that field is added to the display. The qualifier /ALL on any ADD (Class) command adds all fields in the class to the display.

To remove a field from the SHOW CLUSTER display, enter the REMOVE (Field) command.

Examples

COMMAND> ADD SEND
      

This command enables the CREDITS class field SEND and adds it to the SHOW CLUSTER display.

COMMAND> ADD REM_STATE,REM_CONID,LOC_CONID
      

This command enables the CIRCUITS class field REM_STATE and the CONNECTIONS class fields REM_CONID and LOC_CONID, and adds them to the SHOW CLUSTER display.

Adds all currently enabled LOCAL_PORTS class fields to the SHOW CLUSTER display.

Format

ADD LOCAL_PORTS

Parameters

None.

Qualifier

/ALL

Specifies that all fields in this class are added to the display.

Description

The ADD LOCAL_PORTS command adds LOCAL_PORTS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the LOCAL_PORTS class. By default, the NAME, LP_STATUS (port status), PORT_NUM (port number), DGS_FREE (free datagrams queued), MSGS_FREE (free messages queued), OPEN_CIRCS (open circuits), and FORM_CIRCS (formative circuits) fields are enabled. For a list of valid LOCAL_PORTS class fields, see the ADD (Field) command.

Use the ADD LOCAL_PORTS command with the REMOVE LOCAL_PORTS command to turn the display of LOCAL_PORTS class information on and off. If you remove the LOCAL_PORTS class from the display and add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the LOCAL_PORTS class and add new LOCAL_PORTS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.

Examples

COMMAND> ADD LOCAL_PORTS
      

This command adds LOCAL_PORTS class information to the display. This information includes all enabled LOCAL_PORTS class fields.

COMMAND> REMOVE LOCAL_PORTS
COMMAND> ADD LB_STATUS
COMMAND> REMOVE LOCAL_PORTS
   .
   .
   .
COMMAND> ADD LOCAL_PORTS
 

 
 
      

The ADD LOCAL_PORTS command in this example sequence adds LOCAL_PORTS class information to the SHOW CLUSTER display. The first command removes the LOCAL_PORTS class from the display. The second command, ADD LB_STATUS, adds the LOCAL_PORTS class field LB_STATUS to the display. As a result, all other LOCAL_PORTS class fields are disabled. When the LOCAL_PORTS class is removed and added again, only the LB_STATUS field is displayed.

Adds all currently enabled MEMBERS class fields to the SHOW CLUSTER display.

Format

ADD MEMBERS

Parameters

None.

Qualifier

/ALL

Specifies that all fields in this class are added to the display.

Description

The ADD MEMBERS command adds MEMBERS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the MEMBERS class. By default, the STATUS field is enabled. For a list of valid MEMBERS class fields, see the ADD (Field) command.

Use the ADD MEMBERS command with the REMOVE MEMBERS command to turn the display of MEMBERS class information on and off. If you remove the MEMBERS class from the display and add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the MEMBERS class and add new MEMBERS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.

Examples

COMMAND> ADD MEMBERS
      

This command adds MEMBERS class information to the display. This information includes all enabled MEMBERS class fields.

COMMAND> REMOVE MEMBERS
COMMAND> ADD VOTES
COMMAND> REMOVE MEMBERS
   .
   .
   .
COMMAND> ADD MEMBERS
      

The ADD MEMBERS command in this example sequence adds MEMBERS class information to the SHOW CLUSTER display. The first command removes the MEMBERS class from the display. The second command, ADD VOTES, adds the MEMBERS class field VOTES to the display. As a result, all other MEMBERS class fields are disabled. When the MEMBERS class is removed and added again, only the VOTES field is displayed.

	privacy and legal statement
6048PRO_058.HTML