OpenVMS System Management Utilities Reference Manual

Document revision date: 19 July 1999

OpenVMS System Management Utilities Reference Manual

Contents

Index

ADD CLUSTER

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

Format

ADD CLUSTER

Parameters

None.

Qualifier

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

Description

The ADD CLUSTER command adds CLUSTER class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the CLUSTER class. By default, the CLUSTER class includes CL_EXPECTED_VOTES (number of cluster votes expected), CL_QUORUM (cluster quorum), CL_VOTES (cluster votes), QF_VOTE (quorum disk contributes a vote), CL_MEMBERS (current cluster members), FORMED (when quorum was formed), and LAST_TRANSITION (last change in cluster membership). For a list of valid CLUSTER class fields, see the ADD (Field) command.
Use the ADD CLUSTER command with the REMOVE CLUSTER command to turn the display of CLUSTER class information on and off. If you remove the CLUSTER 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 CLUSTER class and add new CLUSTER class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.

Examples

#1
COMMAND> ADD CLUSTER

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

#2
COMMAND> REMOVE CLUSTER COMMAND> ADD CL_QUORUM COMMAND> REMOVE CLUSTER . . . COMMAND> ADD CLUSTER

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

ADD CONNECTIONS

Adds all currently enabled CONNECTIONS class fields to the SHOW CLUSTER display. Optionally, the command adds connections according to state or name.

Format

ADD CONNECTIONS [/qualifier[,...]]

Parameters

None.

Qualifier

/ALL
Specifies that all fields in this class are added to the display.
/NAME=ALL
Restores processes removed from the display with the command REMOVE CONNECTIONS/NAME=local-process-name.
/NAME=local-process-name
Adds the connection associated with the specified local process name, as displayed in the LOC_PROC_NAME field of the CONNECTIONS class.
A local process name can contain up to 16 characters. If the name is abbreviated, SHOW CLUSTER adds all local process names matching the abbreviation.
/TYPE=ALL
Specifies that all types of connections on each circuit are displayed. For a listing of the possible states a connection can be in, see the description of the CON_STATE field in the ADD (Field) command. By default, the ADD CONNECTIONS command without any qualifiers displays all types of connections.
/TYPE=OPEN

/TYPE=NOOPEN
Controls whether connections in the open state or the nonopen state are added to the SHOW CLUSTER display.

Description

The ADD CONNECTIONS command adds CONNECTIONS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the CONNECTIONS class. By default, the LOC_PROC_NAME (local process name) and CON_STATE (connection state) fields are enabled. For a list of valid CONNECTIONS class fields, see the ADD (Field) command.
Use the ADD CONNECTIONS command together with the REMOVE CONNECTIONS command to turn the display of CONNECTIONS class information on and off. If you remove the CONNECTIONS 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 CONNECTIONS class and add new CONNECTIONS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.

Examples

#1
COMMAND> ADD CONNECTIONS

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

#2
COMMAND> ADD CONNECTIONS/NAME=(MSCP$DISK,VMS$VMScluster)

This command adds all connections associated with the process MSCP$DISK and the process VMS$VMScluster to the SHOW CLUSTER display.

#3
COMMAND> ADD CONNECTIONS/TYPE=OPEN

This command adds all open connections to the SHOW CLUSTER display.

#4
COMMAND> REMOVE CONNECTIONS COMMAND> ADD SCS_STATE COMMAND> REMOVE CONNECTIONS . . . COMMAND> ADD CONNECTIONS

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

ADD COUNTERS

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

Format

ADD COUNTERS

Parameters

None.

Qualifier

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

Description

The ADD COUNTERS command adds COUNTERS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the COUNTERS class. By default, the DGS_SENT (datagrams sent), DGS_RCVD (datagrams received), MSGS_SENT (messages sent), and MSGS_RCVD (messages received) fields are enabled. For a list of valid COUNTERS class fields, see the ADD (Field) command.
Use the ADD COUNTERS command together with the REMOVE COUNTERS command to turn the display of COUNTERS class information on and off. If you remove the COUNTERS 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 COUNTERS class and add new COUNTERS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.

Examples

#1
COMMAND> ADD COUNTERS

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

#2
COMMAND> REMOVE COUNTERS COMMAND> ADD MSGS_SENT COMMAND> REMOVE COUNTERS . . . COMMAND> ADD COUNTERS

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

ADD CREDITS

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

Format

ADD CREDITS

Parameters

None.

Qualifier

/ALL
Specifies that all fields in this class are added to the display. By default, the ADD CREDITS command, used without any qualifiers, displays all the CREDITS class fields.

Description

The ADD CREDITS command adds CREDITS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the CREDITS class. By default, all CREDITS class fields are enabled. For a list of valid CREDITS class fields, see the ADD (Field) command.
Use the ADD CREDITS command together with the REMOVE CREDITS command to turn the display of CREDITS class information on and off. If you remove the CREDITS class from the display and then add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the CREDITS class and add new CREDITS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.

Examples

#1
COMMAND> ADD CREDITS

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

#2
COMMAND> REMOVE CREDITS COMMAND> ADD MIN_REC COMMAND> REMOVE CREDITS . . . COMMAND> ADD CREDITS

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

ADD ERRORS

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

Format

ADD ERRORS

Parameters

None.

Qualifiers

/ALL
Specifies that all fields in this class be added to the display. By default, ADD ERRORS, used without any field qualifiers, displays all the fields in the ERRORS class.

Description

The ADD ERRORS command adds ERRORS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the ERRORS class. By default, all ERRORS class fields are enabled. For a list of valid ERRORS class fields, see the ADD (Field) command.
Use the ADD ERRORS command together with the REMOVE ERRORS command to turn the display of ERRORS class information on and off. If you remove the ERRORS 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 ERRORS class and add new ERRORS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.

Examples

#1
COMMAND> ADD ERRORS

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

#2
COMMAND> REMOVE ERRORS COMMAND> ADD ERT_MAX COMMAND> REMOVE ERRORS . . . COMMAND> ADD ERRORS

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

ADD (Field)

Enables the display of specific fields of SHOW CLUSTER information.

Format

ADD field-name[,...]

Parameters

field-name
Specifies one or more of the following fields of information to be added to the display of a particular class.
CIRCUITS Class

The CIRCUITS class contains information about the virtual circuits on a system, such as the local port name, the remote port type and number, the number of connections on the circuit, and the circuit state.

Field Name Description

CABLE_STATUS Status of the circuit paths A and B. Crossed cables are also noted. The field applies only to the CI. Possible displays are as follows:

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

CIR_STATE State of the virtual circuit. Possible displays are as follows:

CLOSED Circuit is closed.

OPEN Circuit is open.

ST_REC Circuit has a start received.

ST_SENT Circuit has a start sent.

VC_FAIL Virtual circuit failure is in progress.

LPORT_NAME Device name of the local port associated with the circuit (PAA0, PAB0, PEA0).

NUM_CONNECTIONS Number of connections on the circuit between the local and remote systems.

REM_STATE State of the remote port. Possible displays are as follows:

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 Class

The CLUSTER class contains general information about the cluster, such as the time it was formed, the last time a system joined or left the cluster, and the cluster quorum.

Field Name Description

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 Class

The CONNECTIONS class contains information about connections established over a virtual circuit, such as the names of the local and remote processes, and the state of the connection.

Field Name Description

CON_STATE The state of the connection. Possible displays are as follows:

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 as follows:

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 Class

The COUNTERS class displays statistics on connection traffic, such as the number of application datagrams or the number of application messages that have been sent or received.

Field Name Description

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.

Previous Next Contents Index

privacy and legal statement

6048PRO_057.HTML

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

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