 |
HP OpenVMS System Management Utilities Reference
Manual
REMOVE CREDITS
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
This command removes all currently enabled CREDITS class fields from
the SHOW CLUSTER display.
REMOVE ERRORS
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
This command removes all currently enabled ERRORS class fields from the
SHOW CLUSTER display.
REMOVE (Field)
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
| #1 |
COMMAND> REMOVE SOFTWARE
|
This command removes the SYSTEMS class SOFTWARE field from the display.
| #2 |
COMMAND> REMOVE SOFTWARE,RP_TYPE,CON_STATE
|
This command removes the SOFTWARE, RP_TYPE, and CON_STATE fields from
the SHOW CLUSTER display.
REMOVE LOCAL_PORTS
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.
REMOVE MEMBERS
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
This command removes all currently enabled MEMBERS class fields from
the SHOW CLUSTER display.
REMOVE SYSTEMS
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
| #1 |
COMMAND> REMOVE SYSTEMS
|
This command removes all currently enabled SYSTEMS class fields from
the SHOW CLUSTER display.
| #2 |
COMMAND> REMOVE SYSTEMS/ID=(1976,206)
|
This command removes systems with the identifier of 1976 or 206 from
the SHOW CLUSTER display.
| #3 |
COMMAND> REMOVE SYSTEMS/TYPE="VAX 8800"
|
This command removes all VAX 8800 systems from the SHOW CLUSTER display.
SAVE
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:
- Customize the display to meet your needs by using SHOW CLUSTER
commands.
- 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.
- 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
|
SCROLL
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.
Note
If you set the function to SCROLL, 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> SELECT SCS
Command> SCROLL UP 10
Command> DESELECT
|
This command sequence scrolls the SCS window up 10 lines.
SELECT
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.
SET AUTO_POSITIONING
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.
SET (Field)
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.
SET FUNCTION
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.
SET INTERVAL
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
This command changes the display interval time to 5 seconds.
|
