HP OpenVMS Systems Documentation

HP OpenVMS System Management Utilities Reference Manual

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.

Qualifiers

/ALL

Specifies that all fields in this class are to be 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 Table 22-4. 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 to be 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 following CONNECTIONS class fields are enabled:

LOC_PROC_NAME---local process name
CON_STATE---connection state

For a list of all CONNECTIONS class fields, see Table 22-4.

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

COMMAND> ADD CONNECTIONS
      

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

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.

COMMAND> ADD CONNECTIONS/TYPE=OPEN
      

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

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.

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 to be 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 following COUNTERS fields are enabled:

DGS_SENT---datagrams sent
DGS_RCVD---datagrams received
MSGS_SENT---messages sent
MSGS_RCVD---messages received

For a list of all COUNTERS class fields, see Table 22-5.

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

COMMAND> ADD COUNTERS
      

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

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.

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 to be 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 all CREDITS class fields, see Table 22-6.

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

COMMAND> ADD CREDITS
      

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

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.

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

Format

ADD ERRORS

Parameters

None.

Qualifier

/ALL

Specifies that all fields in this class are to 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 all ERRORS class fields, see Table 22-7.

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

COMMAND> ADD ERRORS
      

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

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.

Enables the display of specific fields of SHOW CLUSTER information.

Format

ADD field-name[,...]

CIRCUITS

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.

See Table 22-2 for a table containing the fields in the CIRCUITS class.

CLUSTER

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.

See Table 22-3 for a table containing the fields in the CLUSTER class.

CONNECTIONS

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.

See Table 22-4 for a table containing the fields in the CONNECTIONS class.

COUNTERS

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.

See Table 22-5 for a table containing the fields in the COUNTERS class.

CREDITS

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

See Table 22-6 for a table containing the fields in the CREDITS class.

ERRORS

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

See Table 22-7 for a table containing the fields in the ERRORS class.

LOCAL_PORTS

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.

See Table 22-8 for a table containing the fields in the LOCAL_PORTS class.

MEMBERS

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

See Table 22-9 for a table containing the fields in the MEMBERS class.

SYSTEMS

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

See Table 22-10 for a table containing the fields in the SYSTEMS class.

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 to be 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 following fields are enabled:

NAME
LP_STATUS---port status
PORT_NUM---port number
DGS_FREE---free datagrams queued
MSGS_FREE---free messages queued
OPEN_CIRCS---open circuits
FORM_CIRCS---formative circuits

For a list of all LOCAL_PORTS class fields, see Table 22-8.

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 to be 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, only the STATUS field is enabled. For a list of all MEMBERS class fields, see Table 22-9.

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.

Adds all currently enabled SYSTEMS class fields to the SHOW CLUSTER display for all active systems or for selected systems.

Format

ADD SYSTEMS [/qualifier[,...]]

Parameters

None.

Qualifiers

/ALL

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

/ID=ALL

Restores the display after selectively removing systems by ID.

/ID=system-id

Specifies, by system identification number, systems to be added to the SHOW CLUSTER display. The system-id can be any identification number displayed in the SYS_ID field of the SYSTEMS class. When using a hexadecimal value for an identifier, precede the number with the characters %X.

The /ID qualifier affects all information displayed about the specified system, not just information in the SYSTEMS class display.

/NODE=ALL

Restores the display after selectively removing systems by node name.

/NODE=node-name

Specifies, by node name, systems to be added to the SHOW CLUSTER display. The node-name can be any node displayed in the NODE field of the SYSTEMS class, and it can be enclosed in quotation marks. The /NODE qualifier affects all information displayed about the specified node, not just information in the SYSTEMS class display.

/TYPE=ALL

Restores the display after selectively removing systems by type.

/TYPE=hardware-type

Specifies, by hardware type, systems to be added to the SHOW CLUSTER display. You can specify any of the types shown in the HW_TYPE field, and you must enclose the type in quotation marks; for example, "VAX 8800". Because the quoted text may be abbreviated, it is possible, for example, to add VAXstation II and VAXstation 2000 systems with a single command. Multiple types may be specified if enclosed in parentheses and separated by commas. Hardware types are not case sensitive.

The /TYPE qualifier affects all information displayed about the specified hardware type, not just information in the SYSTEMS class display.

Description

The ADD SYSTEMS command adds SYSTEMS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the SYSTEMS class. By default, the following fields are enabled:

NODE
SOFTWARE

For a list of all SYSTEMS class fields, see Table 22-10.

Use the ADD SYSTEMS command with the REMOVE SYSTEMS command to turn the display of SYSTEMS class information on and off. If you remove the SYSTEMS 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 SYSTEMS class and add new SYSTEMS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.

Examples

COMMAND> ADD SYSTEMS
      

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

COMMAND> ADD SYSTEMS/NODE=(PISHTA,ELF)
      

This command adds the nodes PISHTA and ELF to the SHOW CLUSTER display, reporting all currently enabled information about the nodes.

COMMAND> ADD SYSTEMS/TYPE=("VAX 8800","MicroVAX 2000")
      

This command adds all VAX 8800 and MicroVAX 2000 processors to the SHOW CLUSTER display, reporting all currently enabled information about those hardware types.

COMMAND> REMOVE SYSTEMS
COMMAND> ADD SYS_ID
COMMAND> REMOVE SYSTEMS
   .
   .
   .
COMMAND> ADD SYSTEMS
      

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