HP OpenVMS System Management Utilities Reference
Manual
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 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 19-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
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 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 19-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
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.
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 19-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
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[,...]
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 19-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 19-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 19-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 19-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 19-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 19-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 19-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 19-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 19-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
This command enables the CREDITS class field SEND and adds it to the
SHOW CLUSTER display.
| #2 |
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.
ADD LOCAL_PORTS
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 19-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
| #1 |
COMMAND> ADD LOCAL_PORTS
|
This command adds LOCAL_PORTS class information to the display. This
information includes all enabled LOCAL_PORTS class fields.
| #2 |
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.
ADD MEMBERS
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 19-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
This command adds MEMBERS class information to the display. This
information includes all enabled MEMBERS class fields.
| #2 |
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.
ADD SYSTEMS
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 19-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
This command adds SYSTEMS class information to the display. This
information includes all enabled SYSTEMS class fields.
| #2 |
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.
| #3 |
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.
| #4 |
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.
DEFINE/KEY
Associates an equivalence string and set of attributes with a key on
the terminal keyboard. The /KEY qualifier is required.
Format
DEFINE/KEY key-name equivalence-string
Parameters
key-name
Specifies the name of the key that you are defining. Use the following
key names when defining keys:
| Key Name |
LK201 |
VT100 |
VT52 |
|
PF1
|
PF1
|
PF1
|
[blue]
|
|
PF2
|
PF2
|
PF2
|
[red]
|
|
PF3
|
PF3
|
PF3
|
[gray]
|
|
PF4
|
PF4
|
PF4
|
- -
|
|
KP0, KP1 to KP9
|
0, 1 to 9
|
0, 1 to 9
|
0, 1 to 9
|
|
PERIOD
|
.
|
.
|
.
|
|
COMMA
|
,
|
,
|
n/a
|
|
MINUS
|
-
|
-
|
n/a
|
|
ENTER
|
Enter
|
ENTER
|
ENTER
|
|
Find (E1)
|
Find
|
- -
|
- -
|
|
Insert Here (E2)
|
Insert Here
|
- -
|
- -
|
|
Remove (E3)
|
Remove
|
- -
|
- -
|
|
Select (E4)
|
Select
|
- -
|
- -
|
|
Prev Screen (E5)
|
Prev Screen
|
- -
|
- -
|
|
Next Screen (E6)
|
Next Screen
|
- -
|
- -
|
|
HELP
|
Help
|
- -
|
- -
|
|
DO
|
Do
|
- -
|
- -
|
|
F17 to F20
|
F17 to F20
|
- -
|
- -
|
equivalence-string
Specifies the string to be processed when you press the key. The string
can be a SHOW CLUSTER command. If the string contains any spaces,
enclose the equivalence string in quotation marks.
Qualifiers
/ECHO (default)
/NOECHO
Determines whether the equivalence string is displayed on your screen
after the key has been pressed. You cannot use /NOECHO with the
/NOTERMINATE qualifier.
/ERASE
/NOERASE (default)
Determines whether the current line is erased before the key
translation is inserted.
/IF_STATE=(state-name,...)
/NOIF_STATE
Specifies a list of one or more states, one of which must take effect
for the key definition to be in effect. If you omit the /IF_STATE
qualifier or use /NOIF_STATE, the current state is used.
/LOCK_STATE
/NOLOCK_STATE (default)
Specifies that the state set by the /SET_STATE qualifier remain in
effect until explicitly changed. If you use the /NOLOCK_STATE
qualifier, the state set by /SET_STATE is in effect only for the next
definable key that you press or for the next read-terminating character
that you type.
The /LOCK_STATE qualifier can be specified only with the /SET_STATE
qualifier.
/LOG (default)
/NOLOG
Controls whether the system displays a message indicating that the key
definition has been successfully created.
/SET_STATE=state-name
/NOSET_STATE (default)
Causes the specified state-name to be set when the key is pressed. The
state name can be any alphanumeric string.
If you omit the SET_STATE qualifier or use /NOSET_STATE, the current
state that was locked remains in effect. If you have not included this
qualifier with a key definition, use the DCL command SET KEY to change
the current state.
/TERMINATE
/NOTERMINATE (default)
Specifies whether the current equivalence string is to be terminated
(that is, processed) when the key is pressed. Pressing Return has the
same effect as using /TERMINATE.
The /NOTERMINATE qualifier allows you to create key definitions that
insert text into command lines, after prompts, or into other text that
you are typing.
Description
The DEFINE/KEY command enables you to assign definitions to the keys on
certain terminals. The terminals include VT52s, the VT100 series, and
terminals with LK201 keyboards, such as the VT200 series.
The equivalence string definition can contain different types of
information. Definitions can consist of SHOW CLUSTER commands. When you
define a key to insert a text string, use the /NOTERMINATE qualifier so
that you can continue typing more data after the string has been
inserted.
In most instances you will want to take advantage of the echo feature.
The default setting is /ECHO. With the /ECHO qualifier set, the key
definition is displayed on the screen each time you press the key.
You can use the /STATE qualifier to increase the number of key
definitions available on your terminal. The same key can be assigned
any number of definitions as long as each definition is associated with
a different state. State names can contain any alphanumeric characters,
dollar signs, and underscores. Generally, you want to create a state
name that is easy to remember and type and, if possible, reminds you of
the types of definitions you created for that state.
Example
|
Command> DEFINE/KEY PF3 "LOCAL_PORT"/NOTERMINATE
|
|
