HP OpenVMS System Manager's Manual, Volume 2:... |
OpenVMS Cluster Considerations |
|
|
| |
The following sections describe the Show Cluster utility and explain how to perform these tasks:
| Task | Section |
|---|---|
|
Begin to use
SHOW CLUSTER commands
|
Beginning to Use SHOW CLUSTER Commands
|
|
Add information
to a report
|
Adding Information to a Report
|
|
Control the
display of data
|
Controlling the Display of Data
|
|
Format the
display of data
|
Formatting the Display of Data
|
|
Create a startup
initialization file
|
Creating a Startup Initialization File
|
|
Use command procedures containing
SHOW CLUSTER commands
|
Using Command Procedures Containing SHOW CLUSTER Commands
|
Understanding SHOW CLUSTER ![]()
You can display SHOW CLUSTER information on your terminal
screen or send it to a device or a file. You can use SHOW CLUSTER
interactively, with command procedures, or with an initialization
file in which you define default settings. Because this utility
is installed with the CMKRNL privilege, SHOW CLUSTER requires no
special privilege.
SHOW CLUSTER information includes approximately 100 fields of data. You can customize the appearance of SHOW CLUSTER reports or define reports for access to often-needed data.
SHOW CLUSTER reports are organized by classes and fields:
You can add fields or classes to the default SHOW CLUSTER report. If you add a field or class to a report in a continuous display, SHOW CLUSTER automatically adds the new data to the display.
SHOW CLUSTER Default Display shows a sample default SHOW CLUSTER report. The default report has two classes of information: SYSTEMS and MEMBERS. Below each class name are columns of fields that are associated with each class of information.
|
Figure 1 SHOW CLUSTER Default Display |
![]() |
Fields in Default SHOW CLUSTER Report briefly describes the fields shown in SHOW CLUSTER Default Display.
Over time, you can determine the most valuable classes and fields of data for your SHOW CLUSTER reports; you can then create a startup initialization file that establishes your default report formats. You can also build command procedures to use while running SHOW CLUSTER interactively. In this way, you can quickly reformat the report to show the data that is relevant for your installation. Startup initialization files and command procedures are explained later in this chapter.
Because SHOW CLUSTER information includes many fields of data, the report can quickly extend beyond screen limits. Therefore, SHOW CLUSTER provides mechanisms to help you control the display of data, including the following mechanisms:
These mechanisms are described in detail in the HP OpenVMS System Management Utilities Reference Manual: M--Z.
Beginning to Use SHOW CLUSTER Commands ![]()
To use the Show Cluster utility, enter the SHOW CLUSTER command.
If you specify the command without any qualifiers, however, SHOW
CLUSTER simply displays a default report like that shown in
SHOW CLUSTER Default Display and then displays the
DCL prompt.
In a continuous display, on the other hand, you can enter SHOW CLUSTER commands to control report output. You can, for example, add classes or fields to, or remove classes or fields from, reports. To invoke a continuous display, in which you can enter SHOW CLUSTER commands, use the /CONTINUOUS qualifier on the SHOW CLUSTER command. (SHOW CLUSTER command qualifiers are described in Using SHOW CLUSTER Qualifiers.)
To invoke a continuous display of default SHOW CLUSTER report information, enter the following command:
SHOW CLUSTER then displays a default report. By default, SHOW CLUSTER updates the display every 15 seconds, with the changed data displayed in reverse video. After the default report, SHOW CLUSTER displays the following prompt:$SHOW CLUSTER/CONTINUOUS
Command>(If the report extends below the limit of your terminal screen
and you do not see the Command> prompt, you can press Return
to display the prompt.)The following sections contain instructions for performing beginning SHOW CLUSTER tasks:
| Task | Section |
|---|---|
|
Viewing information
that is off the screen
|
Viewing Information That Is Off the Screen
|
|
Exiting from
a continuous display
|
Exiting from a Continuous Display
|
|
Using SHOW CLUSTER qualifiers
|
Using SHOW CLUSTER Qualifiers
|
Viewing Information That Is Off the Screen ![]()
The
PAN command allows you to view the entire display by shifting your
view of the display by column (horizontally) or by line (vertically).
| Report headings also move out of view as the reports in the display are panned beyond the limits of the screen. The SCROLL command, which is explained in Scrolling a Report, preserves the headings as you scroll information. To use the SCROLL command, you must take the additional step of selecting a report if you have more than one report on the screen. |
To pan the display, perform one of the following actions:
The command in this example moves the display down 10 lines.Command>PAN DOWN 10
This command redefines the arrow keys as follows:Command>SET FUNCTION PAN
| Arrow Key | Redefinition |
|---|---|
|
UP ARROW KEY
|
PAN UP 1
|
|
DOWN ARROW
KEY
|
PAN DOWN 1
|
|
Æ
|
PAN RIGHT 1
|
![]() |
PAN LEFT 1
|
You can then use the arrow keys to move up, down, right, and
left in the display.![]()
Refer to the SET FUNCTION and PAN commands in HP OpenVMS System Management Utilities Reference Manual: M--Z for
details.
By default, the SHOW CLUSTER arrow keys are set to the EDIT function. This means that, at the command prompt, you can perform command line editing that is similar to DCL line-mode editing. For example, the left arrow key moves the cursor to the left, and the up arrow key recalls the previous command. Refer to the OpenVMS User's Manual for information about DCL line-mode editing.
When you use the SET FUNCTION command, you reset the function keys. After that, the arrow keys are redefined and DCL line-mode editing is disabled.
To reset the arrow keys, enter the following command:
Command>SET FUNCTION EDIT
Exiting from a Continuous Display ![]()
To exit from a continuous display, perform one of the following
actions:
| Enter EXIT after the Command> prompt. |
| Press Ctrl/Z. |
| Press Ctrl/Y. |
Using SHOW CLUSTER Qualifiers ![]()
SHOW CLUSTER Qualifiers briefly describes
the qualifiers you can use with the SHOW CLUSTER command. The HP OpenVMS System Management Utilities Reference Manual: M--Z contains
reference information about these SHOW CLUSTER qualifiers.
In a continuous display, SHOW CLUSTER updates the display every 15 seconds by default. You can change this interval by using the /INTERVAL qualifier.
In this example, SHOW CLUSTER updates reports every 5 seconds, displaying changed data in reverse video.$SHOW CLUSTER/CONTINUOUS/INTERVAL=5
Adding
Information to a Report ![]()
When you use the SHOW CLUSTER command, the resulting report
is only part of the total information available. As shown in
SHOW CLUSTER Default Display, the default classes
displayed are MEMBERS and SYSTEMS.
Classes of Information Available in SHOW CLUSTER Reports briefly describes all the classes you can display
in SHOW CLUSTER reports. Refer to the HP OpenVMS System Management Utilities Reference Manual: M--Z
for
details about these classes.
The following example shows how to add the CLUSTER class to a SHOW CLUSTER display:
SHOW CLUSTER Display with CLUSTER Report shows the display that results from entering the ADD CLUSTER command. CLUSTER class is displayed below the default SHOW CLUSTER display.Command>ADD CLUSTER
|
Figure 2 SHOW CLUSTER Display with CLUSTER Report |
![]() |
For descriptions of the fields in the CLUSTER class, refer to the SHOW CLUSTER section of the HP OpenVMS System Management Utilities Reference Manual: M--Z.
Controlling the Display of Data ![]()
Using SHOW CLUSTER
commands, you can remove fields or classes from a display, remove
broadcast messages from the screen, and refresh the screen display
at any time. The following sections explain how to perform these
operations.
Entering Commands to Display Data ![]()
SHOW CLUSTER allows
you to customize the display of data during a continuous session
by entering various commands. The HP OpenVMS System Management Utilities Reference Manual: M--Z
describes
SHOW CLUSTER commands in detail.
Updating of the continuous display stops as soon as you enter input from the terminal keyboard. When you press the Return key after entering a command, updating of the display resumes until you enter another command.
By default, updating takes place at 15-second intervals. If you do not enter a new command within 15 seconds, the command prompt disappears, and two more lines of data take its place.
Removing Broadcast Messages ![]()
When you receive a system
broadcast message during a continuous SHOW CLUSTER session, the
message appears at the bottom of the screen. A multiline message
fills as many lines of the screen as it needs.
The last broadcast message you receive remains on the screen until you acknowledge it by entering input from the terminal in one of the following ways:
If you receive more than one broadcast message, SHOW CLUSTER waits until the next update interval to display the next message.
SHOW CLUSTER also displays error messages at the bottom of the screen. For an explanation of the error messages, refer to OpenVMS System Messages: Companion Guide for Help Message Users .
Refreshing the Screen ![]()
Ordinarily, a continuous display is updated or refreshed according
to the default or specified interval time. SHOW CLUSTER scans the
software databases, extracts and stores data for each field, displays
any new or changed data, and updates the time. On HP and HP-compatible
terminals, reverse video highlights any changed data.
You can refresh the screen at any time by one of the following methods:
Formatting the Display of Data ![]()
Because SHOW CLUSTER
allows you to include additional fields and classes, you can produce
reports that overflow the physical limits of the terminal screen.
However, you can use a number of methods to modify the display to
meet your needs:
| Formatting Method | For More Information |
|---|---|
|
Remove data
from reports
|
Removing Information from a Report
|
|
Modify field
and screen size
|
Modifying Field and Screen Size
|
|
Move a report
|
Moving a Report
|
|
Scroll a report
|
Scrolling a Report
|
Removing Information from a Report ![]()
You can remove certain fields or classes to reduce the width
of a report to fit the limits of your screen. Also, certain fields
or classes might not be important for your particular needs. You
can also remove particular types of data to reduce the length of
the report.
Use the REMOVE command to remove fields or entire classes. To remove a field or class, use the appropriate qualifier with the REMOVE command. refer to the REMOVE commands in the SHOW CLUSTER section of the HP OpenVMS System Management Utilities Reference Manual: M--Z for appropriate class names and qualifiers.
The command in this example removes the SOFTWARE field from the SHOW CLUSTER report shown in SHOW CLUSTER Default Display.Command>REMOVE SOFTWARE
The command in this example removes the MEMBERS class from the SHOW CLUSTER report shown in SHOW CLUSTER Default Display.Command>REMOVE MEMBERS
Modifying Field and Screen Size ![]()
To make a report
fit the physical limits of the screen, you can change the width
of certain fields in the report. For example, if SHOW CLUSTER provides
a field width that can contain any possible value and the values your
cluster generates do not require that much space, you can adjust
the field width with the SET (Field) command.
SHOW CLUSTER also allows you to adjust the size of the terminal screen. If the terminal is HP-compatible and supports a wide report, you can set the screen to a width of up to 511 columns by specifying an appropriate value to the SET SCREEN command.
The command in this example sets the width of the TRANSITION_TYPE field to 10, which removes the time of day from the field but leaves the date.Command>SET TRANSITION_TYPE/WIDTH=10
The command in this example sets the screen width to 132.Command>SET SCREEN=132
Refer to the HP OpenVMS System Management Utilities Reference Manual: M--Z for more details about using the SET (Field) and SET SCREEN commands.
Moving a Report ![]()
By default, SHOW
CLUSTER operates with AUTO_POSITIONING ON. This means that the utility automatically
arranges the reports to take best advantage of the available display
space. However, you can position reports manually with the MOVE
command, which implicitly sets AUTO_POSITIONING to OFF.
If you have multiple reports in your display, you must first select the report to be repositioned. You use the SELECT window-name command to specify the report name; for example:
To select any report except the default SCS report,
you must first add the class to the display if it is not already
displayed; for example:
|
To move a report, perform either of the following actions:
This command redefines the arrow keys as follows:Command>SET FUNCTION MOVE
| Arrow Key | Redefinition |
|---|---|
|
UP ARROW KEY
|
MOVE UP 1
|
|
DOWN ARROW
KEY
|
MOVE DOWN 1
|
|
MOVE RIGHT 1
|
|
MOVE LEFT 1
|
When you enter a MOVE command, the display changes position
by column (horizontally) or by line (vertically). For example, entering
the command MOVE LEFT 5 moves the display 5 columns to the left. An
empty frame appears around the new position of the report.![]()
When you are satisfied with the position of the report, enter
the DESELECT command, which moves the report to the new position.
Entering another SELECT command before the previous MOVE operation
has been deselected also moves the report to its new position.
The following lists explains the commands in the example:Command>SELECT CLUSTERCommand>MOVE RIGHT 10Command>DESELECT
For more information, refer to the SELECT, SET FUNCTION, and DESELECT commands in the HP OpenVMS System Management Utilities Reference Manual: M--Z .
To reset the arrow keys, enter the following command:
Command>SET FUNCTION EDIT
Scrolling a Report ![]()
The
SCROLL command provides a means of quickly scanning through a report
without losing column headings. Scrolling scans a display by field
(horizontally) and by line (vertically). The report headings remain stationary
when you scroll vertically.
When the display has more than one report, you must first select a report by entering the SELECT command. The selected report is highlighted.
To scroll a display, perform either of the following actions:
This command redefines the arrow keys as follows:Command>SET FUNCTION SCROLL
| Arrow Key | Redefinition |
|---|---|
|
UP ARROW KEY
|
SCROLL UP 1
|
|
DOWN ARROW
KEY
|
SCROLL DOWN 1
|
|
SCROLL RIGHT 1
|
|
SCROLL LEFT 1
|
The commands in this example first select the SCS report (which is then highlighted), and then set the arrow keys to scroll functions. Refer to the SET FUNCTION and SCROLL commands in the HP OpenVMS System Management Utilities Reference Manual: M--Z for more information.Command>SELECT SCSCommand>SET FUNCTION SCROLL
To reset the arrow keys, enter the following command:
Command>SET FUNCTION EDIT
Creating
a Startup Initialization File ![]()
To customize
the SHOW CLUSTER display, you can create a startup initialization
file, which the utility executes when you enter it. SHOW CLUSTER
takes the original default display, and adds or removes whatever
classes or fields you specify. The resulting display becomes your
default startup format. A startup initialization file resembles
the following example:
! !Startup Initialization File ! ! INITIALIZE REMOVE MEMBERS ADD RP_REVISION,RP_TYPE,SYS_ID SET SCREEN=132This startup procedure deletes the MEMBERS class information from the default display. The procedure also adds the RP_REVISION and RP_TYPE fields from the CIRCUITS class and the SYS_ID field from the SYSTEMS class. The last line of the procedure sets the screen size to 132 columns.
To create an initialization file, follow these steps:
DEFINE SHOW_CLUSTER$INIT DEVA:[JONES]SHCINIWhen invoked, SHOW CLUSTER searches for the file defined by SHOW_CLUSTER$INIT. In this example, SHOW CLUSTER looks for DEVA:[JONES]SHCINI.INI when it starts up. If the initialization file is found, SHOW CLUSTER executes the procedure before beginning the display.
You must specify SHOW_CLUSTER$INIT.INI, because the SAVE command creates a file with a file type of .COM by default. SHOW CLUSTER looks for an .INI file when it searches for a startup initialization file.Command>SAVE SHOW_CLUSTER$INIT.INI
You can edit the file that the SAVE command creates to include comments or to improve its efficiency. For more information, refer to the SAVE command in the HP OpenVMS System Management Utilities Reference Manual: M--Z.
Instead of having SHOW CLUSTER build an initialization file, you can build one yourself in the same way you build a command procedure. The next section provides guidelines for creating a command procedure.
Using
Command Procedures Containing SHOW CLUSTER Commands ![]()
You can create
command procedures that contain SHOW CLUSTER commands. Such files
let you modify display characteristics without having to enter commands
interactively. You can use command procedures during a continuous
SHOW CLUSTER session to perform a series of commands, for example,
to customize the output of the display.
The following list contains guidelines for writing command procedures that contain SHOW CLUSTER commands:
| Do not include an EXIT command at the end of the command
procedure. The EXIT command terminates SHOW CLUSTER and erases the
SHOW CLUSTER display before you can see it. Also, do not run SHOW CLUSTER command procedures from a batch job. |
! ! Include only the node field from the default display; show votes ! and quorum for each node and for the cluster as a whole. ! INITIALIZE REMOVE SOFTWARE,STATUS ADD VOTES,QUORUM,CL_VOTES,CL_QUORUMThis command procedure removes the SOFTWARE and STATUS fields from the report and adds fields that provide information about the cluster quorum and votes.
To execute a command procedure during a continuous SHOW CLUSTER session, specify the execute procedure (@) command, along with the file name of the command procedure. The default file type for command procedure files is .COM.
The following command executes a command procedure named SYSMOD.COM:
In this example, the default file type .COM is assumed because the file type is omitted.Command>@SYSMOD
For more information about creating command procedures, refer to the SAVE command in HP OpenVMS System Management Utilities Reference Manual: M--Z.
|
|