 |
OpenVMS System Management Utilities Reference
Manual
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
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
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
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
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.
|
|
