Removes CREDITS class information from the SHOW CLUSTER display.

Format

REMOVE CREDITS

Parameters

None.

Qualifiers

None.

Description

The REMOVE CREDITS command removes CREDITS class information from the SHOW CLUSTER display. CREDITS class information includes data for all currently enabled fields in the CREDITS class.

For a list of valid CREDITS class fields, see Table 22-6.

Example

COMMAND> REMOVE CREDITS
      

This command removes all currently enabled CREDITS class fields from the SHOW CLUSTER display.

Removes ERRORS class information from the SHOW CLUSTER display.

Format

REMOVE ERRORS

Parameters

None.

Qualifiers

None.

Description

The REMOVE ERRORS command removes ERRORS class information from the SHOW CLUSTER display. ERRORS class information includes data for all currently enabled fields in the ERRORS class.

For a list of valid ERRORS class fields, see Table 22-7.

Example

COMMAND> REMOVE ERRORS
      

This command removes all currently enabled ERRORS class fields from the SHOW CLUSTER display.

Disables the display of specific fields of SHOW CLUSTER information.

Format

REMOVE field-name[,...]

Parameter

field-name

Specifies one or more fields of information to be removed from the display of a particular class. If you specify more than one field name, insert a comma between each one.

For a list of valid field names, see Section 22.1.

Qualifiers

None.

Examples

COMMAND> REMOVE SOFTWARE
      

This command removes the SYSTEMS class SOFTWARE field from the display.

COMMAND> REMOVE SOFTWARE,RP_TYPE,CON_STATE
      

This command removes the SOFTWARE, RP_TYPE, and CON_STATE fields from the SHOW CLUSTER display.

Removes LOCAL_PORTS class information from the SHOW CLUSTER display.

Format

REMOVE LOCAL_PORTS

Parameters

None.

Qualifiers

None.

Description

The REMOVE LOCAL_PORTS command removes LOCAL_PORTS class information.

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

Example

COMMAND> REMOVE LOCAL_PORTS
      

This command removes all currently enabled LOCAL_PORTS class fields from the LOCAL_PORTS display.

Removes MEMBERS class information from the SHOW CLUSTER display.

Format

REMOVE MEMBERS

Parameters

None.

Qualifiers

None.

Description

The REMOVE MEMBERS command removes MEMBERS class information from the SHOW CLUSTER display. MEMBERS class information includes data for all actively participating members of the cluster.

For a list of valid MEMBERS class fields, see Table 22-9.

Example

COMMAND> REMOVE MEMBERS
      

This command removes all currently enabled MEMBERS class fields from the SHOW CLUSTER display.

Removes SYSTEMS class information from the SHOW CLUSTER display.

Format

REMOVE SYSTEMS [/qualifier[,...]]

Parameters

None.

Qualifiers

/ID=ALL

Removes all systems information from the SHOW CLUSTER display. The qualifier clears the display so that you can selectively add systems with the command ADD SYSTEMS/ID=system-id.

/ID=system-id

Specifies, by system identification number, systems to be removed from the SHOW CLUSTER display. The system identification number can be any system identification as displayed in the SYS_ID field of the SYSTEMS class of the CLUSTER report.

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

/NODE=ALL

Removes all systems information from the SHOW CLUSTER display. The qualifier clears the display so that you can selectively add systems with the command ADD SYSTEMS/NODE=node-name.

/NODE=node-name

Specifies, by node name, systems to be removed from the SHOW CLUSTER display. The /NODE qualifier affects all information displayed about the specified node, not just information in the SYSTEMS class display.

/TYPE=ALL

Removes all systems information from the SHOW CLUSTER display. The qualifier clears the display so that you can selectively add systems with the command ADD SYSTEMS/TYPE=hardware-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 remove 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 REMOVE SYSTEMS command removes SYSTEMS class information from the SHOW CLUSTER display. SYSTEMS class information includes data for all currently enabled fields in the SYSTEMS class.

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

Examples

COMMAND> REMOVE SYSTEMS
      

This command removes all currently enabled SYSTEMS class fields from the SHOW CLUSTER display.

COMMAND> REMOVE SYSTEMS/ID=(1976,206)
      

This command removes systems with the identifier of 1976 or 206 from the SHOW CLUSTER display.

COMMAND> REMOVE SYSTEMS/TYPE="VAX 8800"
      

This command removes all VAX 8800 systems from the SHOW CLUSTER display.

Allows you to build a startup initialization file or a command procedure that creates the current display. You can then use the initialization file or the command procedure to restore the display at a later time.

Format

SAVE [file-spec]

Parameter

file-spec

Names the file specification of the command file. The file name defaults to SHOW_CLUSTER.COM. You can edit the file because it is an ASCII file.

Qualifiers

None.

Description

The SAVE command allows you to build a startup initialization file or a command procedure that you can use in subsequent SHOW CLUSTER sessions. To use the SAVE command, perform the following steps:

1. Customize the display to meet your needs by using SHOW CLUSTER commands.
2. Enter the SAVE command. By default, the command procedure created is named SHOW_CLUSTER.COM. If you want a name that is different from the default, specify the alternate name on the SAVE command line. You save a startup initialization file as an .INI file.
3. Edit the file to improve its efficiency and document it.

The file that results from the SAVE commmand is an ASCII file. The SAVE command inserts an INITIALIZE command as the first line of the file. In this way, the initialization file or the command procedure always starts with the default display.

The SAVE command might not enter SHOW CLUSTER commands into the file in the same order in which you entered them. You might need to edit the file and correct the sequence of commands. Also, the commands that the SAVE command builds are restricted to one record, so a particular command procedure might not be as efficient as possible. For example, the SAVE command processes ADD class, ADD class /ALL, and ADD (Field) commands separately. It does not combine an ADD class and an ADD (Field) command to produce the command ADD class, field.

Additionally, the SAVE command does not use the REMOVE (Field) command. For example, the following command sequence adds all fields in the CIRCUITS class and then removes one field from the CIRCUITS class:

Command> ADD CIRCUITS/ALL Command> REMOVE RP_TYPE

Instead of removing one field from a class, the SAVE command produces a file with commands that add every field in the CIRCUITS class except RP_TYPE:

ADD LPORT_NAME,RPORT_NUM,RP_OWNER,NUM_CONNECTIONS,CIR_STATE ADD REM_STATE,CABLE_STATUS,RP_REVISION,RP_FUNCTIONS,SCS_WAITERS

Example

Command> ADD CLUSTER
Command> REMOVE SOFTWARE
Command> SAVE
      

The first two commands in the command sequence customize the SHOW CLUSTER display. The third command, SAVE, creates a command file, SHOW_CLUSTER.COM, which contains the following commands:

INITIALIZE ADD CLUSTER REMOVE SYSTEMS ADD NODE

Scrolls a window.

Format

SCROLL direction value

Parameters

direction

Direction in which a window is to be scrolled. If you do not enter a direction for this parameter, SHOW CLUSTER prompts you for one. You must specify one of the following keywords:

UP
DOWN
RIGHT
LEFT

value

Number of fields or lines a window is to be scrolled. You must specify a numeric value from 1 to 511. If you do not enter a number for this parameter, SHOW CLUSTER prompts you for one.

Qualifiers

None.

Description

The SCROLL command provides a means of quickly scanning through a window by field (horizontally) and by line (vertically). You can scroll windows independently. Note, however, that if AUTO_POSITIONING is set to ON, other windows in the display may change position as you scroll the selected window.

To scroll a window when it is the only one in the display, enter the SCROLL command. When the display has multiple windows, you must first select a window by entering the SELECT command. The selected window becomes highlighted. Enter SCROLL commands either at the command line or by pressing the arrow keys. Entering the command SET FUNCTION SCROLL redefines the up, down, right, and left arrow keys as SCROLL UP 1, SCROLL DOWN 1, SCROLL RIGHT 1, and SCROLL LEFT 1, respectively.

Use the vertical and horizontal lines of the window fields as indicators of the current position of the display. Note that the window headings remain stationary as lines of data are scrolled vertically.

Example

Command> SELECT SCS
Command> SCROLL UP 10
Command> DESELECT
      

This command sequence scrolls the SCS window up 10 lines.

Designates which window to scroll, move, or pan.

Format

SELECT [window-name]

Parameter

window-name

The name of the selected window. You can specify one of the following window names: SCS, LOCAL_PORTS, or CLUSTER.

Qualifiers

None.

Description

When the SHOW CLUSTER display contains more than one window, you must indicate which window you want to work with---either by entering a SELECT command at the command line prompt or by pressing the SELECT key on the default keypad.

If you press the SELECT key on the keypad or enter the SELECT command without specifying the window name, SHOW CLUSTER selects a window for you. Pressing the SELECT key repeatedly cycles through the windows in the order in which they were initially added to the screen. Each subsequent SELECT command terminates the previous one. The currently selected window becomes highlighted. When the last window in the cycle has been selected, pressing the SELECT key another time begins the cycle again.

Use the SELECT command to identify a window to be moved, panned, or scrolled. Once the display is correct, terminate the window operation by entering a DESELECT command or by selecting another window. For more information, see the SET FUNCTION, SCROLL, PAN, and MOVE commands.

Example

Command> SELECT LOCAL_PORTS
      

This command selects the LOCAL_PORTS window. You can then perform a MOVE or SCROLL operation on the selected window.

Enables or disables the automatic positioning of windows within a display.

Format

SET AUTO_POSITIONING keyword

Parameter

keyword

Specifies whether windows are automatically positioned in a display. By default, SHOW CLUSTER operates with AUTO_POSITIONING enabled. Valid keywords are as follows:

ON
OFF

Qualifiers

None.

Description

By default, SHOW CLUSTER automatically positions windows based on their sizes and the order in which they were originally added to the display. With AUTO_POSITIONING set to ON, windows do not overlap, but they may extend partially or fully beyond the physical limits of the terminal screen. Setting AUTO_POSITIONING to OFF allows you to position the window manually within the display.

Entering a MOVE command implicitly disables AUTO_POSITIONING. When you use MOVE commands to position a selected window, the windows are allowed to overlap.

Setting AUTO_POSITION to ON reestablishes the previous positions of windows.

Example

Command> SET AUTO_POSITIONING OFF
Command> ADD LOCAL_PORTS
Command> SELECT SCS
Command> MOVE DOWN 8
Command> DESELECT
      

This command sequence disables AUTO_POSITIONING to add the LOCAL_PORTS window at the top of the screen. The following commands move the SCS window below the LOCAL_PORTS window, where it is in full view.

Modifies the characteristics of particular fields within the display.

Format

SET field-name /qualifier[,...]

Parameter

field-name

Specifies the name of the field to be modified in the display. For a list of field names, see Section 22.1.

Qualifiers

/WIDTH=field-width

Specifies the number of columns used to display the specified field. This qualifier shrinks the display to allow room for more fields or expands it to make it easier to read.

Minimum, maximum, and default values for field widths are set up internally. If you specify a field width of 0, the field is set to its minimum width. If you specify a field width that is larger than the internal maximum width, the field is set to its maximum width.

Note If the field width is too narrow to display a particular numeric field, asterisks are displayed in place of the data. If the width is too narrow to display a character-string field, the character string is truncated on the "right".

/FORMAT=radix

Specifies the display format used to display the specified field. You can specify either of the following radix values:

DECIMAL for decimal format
HEXADECIMAL for hexadecimal format

A hexadecimal display for a field uses fewer columns than a decimal display.

The hardware version field (HW_VERSION) is always displayed in 24 hexadecimal digits.

Example

COMMAND> SET SYSID/FORMAT=HEXADECIMAL
      

The SET command in this example changes the format of the SYSID field to a hexadecimal display.

Enables one of the following SHOW CLUSTER functions: EDIT, MOVE, PAN, or SCROLL.

Format

SET FUNCTION function-name

Parameter

function-name

Specifies the SHOW CLUSTER function to be enabled. By default, the EDIT function is enabled. Functions include the following ones:

EDIT
MOVE
PAN
SCROLL

Qualifiers

None.

Description

The SET FUNCTION command redefines the arrow keys to perform the specified function. By default, the function is set to EDIT, which allows you to use the arrow keys to recall a previously entered command or perform DCL line-mode editing at the command prompt. (For more information about DCL line-mode editing, see the OpenVMS User's Manual.)

To enable one of the SHOW CLUSTER functions, either enter the specific SET FUNCTION command at the command prompt, or press the appropriate SET FUNCTION key on the keypad. Only one function can be enabled at a time.

Note Setting the function to MOVE implicitly disables AUTO_POSITIONING. Also, once you use the SET FUNCTION command, the arrow keys are no longer defined to perform DCL line-mode editing. Only one function can be enabled at a time using the SET FUNCTION command.

Example

Command> SET FUNCTION MOVE
      

This command redefines the arrow keys to automatically move a selected window 1 space in any direction. For example, the up, down, right, and left arrow keys are redefined as MOVE UP 1, MOVE DOWN 1, MOVE RIGHT 1, and MOVE LEFT 1, respectively. Note that you must use the DESELECT command to complete the MOVE function.

Changes the interval time between display updates. The interval time is the amount of time that display information remains on the screen before it is updated. By default, the display updates every 15 seconds, unless you use the /INTERVAL qualifier on the SHOW CLUSTER command. If you use the /INTERVAL qualifier, the time specified becomes the default.

Format

SET INTERVAL= seconds

Parameter

seconds

The number of seconds between display updates.

Qualifiers

None.

Example

COMMAND> SET INTERVAL=5
      

This command changes the display interval time to 5 seconds.