[Digital logo]
[HR]

OpenVMS System Management Utilities Reference Manual


Previous | Contents

/ENDING=time

Specifies the time that the SHOW CLUSTER session is to end. You can specify an absolute time, a delta time, or a combination of the two. Observe the syntax rules for time values described in the OpenVMS User's Manual.

Use this qualifier with the /BEGINNING and /OUTPUT qualifiers to run SHOW CLUSTER without direct user intervention.


Format

/ENDING =time


PARAMETER

time

You can specify time as an absolute time expressed as [dd-mmm-yyyy[:]][hh:mm:ss.cc], or a delta time expressed as [dddd-][hh:mm:s.cc], or a combination of the two. Observe the syntax rules for time values described in the OpenVMS User's Manual.

Example

$ SHOW CLUSTER/CONTINUOUS/ENDING=31-DEC-1995:15:30

In this example, SHOW CLUSTER begins a continuous display now and ends the display at 3:30 P.M. on December 31, 1995.


/INTERVAL=seconds

Specifies the number of seconds that display information remains on the screen before it is updated. By default, the interval time is 15 seconds.

Format

/INTERVAL =seconds


PARAMETER

seconds

The number of seconds between display updates.

Example

$ SHOW CLUSTER/INTERVAL=5

In this example, SHOW CLUSTER displays a continuous report that is updated every 5 seconds.


/OUTPUT=file-spec

Directs the output from SHOW CLUSTER to the specified file instead of the current SYS$OUTPUT device.

SHOW CLUSTER output is always in printable file format, regardless of the file or device type specified. Output can be up to 132 columns wide and can be sent to any file, terminal, or print device.

You can also direct output to a file with the WRITE command.


Format

/OUTPUT =file-spec


PARAMETER

file-spec

The name of the file or device to which SHOW CLUSTER output is directed. The default file name is SHOW_CLUSTER.LIS.

You can direct output to a device other than SYS$OUTPUT by specifying a valid device name.


Example

$ SHOW CLUSTER/OUTPUT=[OMALLEY]CLUSTER

In this example, SHOW CLUSTER produces one report and directs it to the file CLUSTER.LIS;1 in the directory OMALLEY.

18.4 SHOW CLUSTER Commands

Once you start a continuous SHOW CLUSTER display session, you can use SHOW CLUSTER commands to control the session. Table 18-3 describes each command.

Table 18-3 SHOW CLUSTER Command Summary
Command Name Description
@ (Execute Procedure) Executes a command procedure file that contains SHOW CLUSTER commands.
ADD CIRCUITS Adds all currently enabled CIRCUITS class fields to the SHOW CLUSTER display.
ADD CLUSTER Adds all currently enabled CLUSTER class fields to the SHOW CLUSTER display.
ADD CONNECTIONS Adds all currently enabled CONNECTIONS class fields to the SHOW CLUSTER display. Optionally, the command adds connections according to state or name.
ADD COUNTERS Adds all currently enabled COUNTERS class fields to the SHOW CLUSTER display.
ADD CREDITS Adds all currently enabled CREDITS class fields to the SHOW CLUSTER display.
ADD ERRORS Adds all currently enabled ERRORS class fields to the SHOW CLUSTER display.
ADD (Field) Enables the display of specific fields of SHOW CLUSTER information.
ADD LOCAL_PORTS Adds all currently enabled LOCAL_PORTS class fields to the SHOW CLUSTERS display.
ADD MEMBERS Adds all currently enabled MEMBERS class fields to the SHOW CLUSTER display.
ADD SYSTEMS Adds all currently enabled SYSTEMS class fields to the SHOW CLUSTER display for all active systems or for selected systems.
DEFINE/KEY Associates an equivalence string and set of attributes with a key on the terminal keyboard.
DESELECT Terminates the selection of a previously selected window.
EXIT Terminates the SHOW CLUSTER display and returns control to the DCL command level.
HELP Provides online help information for using SHOW CLUSTER commands, parameters, and qualifiers. Press Ctrl/Z to exit.
INITIALIZE Resets the display using the original default values for field names, class names, and field widths. It also restores any systems that were removed from the display by the REMOVE SYSTEMS command.
MOVE Moves a selected window to a specified position.
PAN Exhibits a wide display area, a part at a time, as though being unrolled.
REFRESH Clears the screen, removes extraneous characters, and updates all fields.
REMOVE CIRCUITS Removes CIRCUITS class information from the SHOW CLUSTER display.
REMOVE CLUSTER Removes CLUSTER class information from the SHOW CLUSTER display.
REMOVE CONNECTIONS Removes CONNECTIONS class information from the SHOW CLUSTER display.
REMOVE COUNTERS Removes COUNTERS class information from the SHOW CLUSTER display.
REMOVE CREDITS Removes CREDITS class information from the SHOW CLUSTER display.
REMOVE ERRORS Removes ERRORS class information from the SHOW CLUSTER display.
REMOVE (Field) Disables the display of specific fields of SHOW CLUSTER information.
REMOVE LOCAL_PORTS Removes LOCAL_PORTS class information from the SHOW CLUSTER display.
REMOVE MEMBERS Removes MEMBERS class information from the SHOW CLUSTER display.
REMOVE SYSTEMS Removes SYSTEMS class information from the SHOW CLUSTER display.
SAVE Allows you to build a startup initialization file or a command procedure that creates the current display so you can restore the display at a later time.
SCROLL Scrolls a window.
SELECT Designates which window to scroll or move.
SET AUTO_POSITIONING Enables or disables the automatic positioning of windows within a display.
SET (Field) Modifies the characteristics of particular fields within the display.
SET FUNCTION Enables one of the following SHOW CLUSTER functions: EDIT, MOVE, PAN, or SCROLL.
SET INTERVAL Changes the interval time between display updates. The default interval time is 15 seconds.
SET SCREEN Sets the terminal to a display of up to 511 columns.
WRITE Outputs the current display to a file that can be printed on a hardcopy device.


@ (Execute Procedure)

Executes a command procedure file that contains SHOW CLUSTER commands.

Format

@ file-spec


PARAMETER

file-spec

Specifies the name of the file that contains the commands to be executed. If you omit the file type, the default file type .COM is used. No wildcard characters are allowed in the file specification.

QUALIFIERS

None.

DESCRIPTION

The execute procedure (@) command allows you to execute a set of SHOW CLUSTER commands that are contained in a file. For example, a command procedure file might contain a set of commands to customize a SHOW CLUSTER display. You can use any valid SHOW CLUSTER commands in the command procedure.

You can nest command procedures up to 16 levels deep.

SHOW CLUSTER looks for the command procedure in the directory specified by the logical name SHOW_CLUSTER$INIT. If SHOW_CLUSTER$INIT is not defined or does not include a directory specification, the utility looks for the command procedure in the current default directory.


Example

COMMAND> @MYFILE

This command executes the command procedure MYFILE.COM. Because no file type is specified, the file type defaults to .COM.


ADD CIRCUITS

Adds all currently enabled CIRCUITS class fields to the SHOW CLUSTER display. The CIRCUITS class contains information about the virtual circuits on systems in the cluster.

Format

ADD CIRCUITS [/qualifier[,...]]


PARAMETERS

None.

QUALIFIER

/ALL

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

/TYPE=ALL

Specifies that all types of circuits be included in the display, including formative, open, and closing circuits.

/TYPE=OPEN

/TYPE=NOOPEN

Controls whether either open circuits or nonopen circuits are added to the display.

DESCRIPTION

The ADD CIRCUITS command adds CIRCUITS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the CIRCUITS class. By default, the RPORT_NUM (remote port number), RP_TYPE (remote port type), and CIR_STATE (circuit state) fields are enabled. For a list of valid CIRCUITS class fields, see the ADD (Field) command.

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

Examples

  1. COMMAND> ADD CIRCUITS 
    

    This command adds CIRCUITS class information to the display. This information includes all types of circuits for all enabled CIRCUITS class fields.
  2. COMMAND> ADD CIRCUITS/TYPE=OPEN 
    

    This command adds all open circuits to the SHOW CLUSTER display.
  3. COMMAND> REMOVE CIRCUITS 
    COMMAND> ADD RP_OWNER 
    COMMAND> REMOVE CIRCUITS 
       .
       .
       .
    COMMAND> ADD CIRCUITS 
    

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

ADD CLUSTER

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

Format

ADD CLUSTER


PARAMETERS

None.

QUALIFIER

/ALL

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

DESCRIPTION

The ADD CLUSTER command adds CLUSTER class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the CLUSTER class. By default, the CLUSTER class includes CL_EXPECTED_VOTES (number of cluster votes expected), CL_QUORUM (cluster quorum), CL_VOTES (cluster votes), QF_VOTE (quorum disk contributes a vote), CL_MEMBERS (current cluster members), FORMED (when quorum was formed), and LAST_TRANSITION (last change in cluster membership). For a list of valid CLUSTER class fields, see the ADD (Field) command.

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

Examples

  1. COMMAND> ADD CLUSTER 
    

    This command adds CLUSTER class information to the display. This information includes all enabled CLUSTER class fields.
  2. COMMAND> REMOVE CLUSTER 
    COMMAND> ADD CL_QUORUM 
    COMMAND> REMOVE CLUSTER 
       .
       .
       .
    COMMAND> ADD CLUSTER 
    

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

ADD CONNECTIONS

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.

QUALIFIER

/ALL

Specifies that all fields in this class are 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 the ADD (Field) command. 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 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 LOC_PROC_NAME (local process name) and CON_STATE (connection state) fields are enabled. For a list of valid CONNECTIONS class fields, see the ADD (Field) command.

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

  1. COMMAND> ADD CONNECTIONS 
    

    This command adds CONNECTIONS class information to the display. This information includes all enabled CONNECTIONS class fields.
  2. 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.
  3. COMMAND> ADD CONNECTIONS/TYPE=OPEN 
    

    This command adds all open connections to the SHOW CLUSTER display.
  4. 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.

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 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 DGS_SENT (datagrams sent), DGS_RCVD (datagrams received), MSGS_SENT (messages sent), and MSGS_RCVD (messages received) fields are enabled. For a list of valid COUNTERS class fields, see the ADD (Field) command.

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

  1. COMMAND> ADD COUNTERS 
    

    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 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 valid CREDITS class fields, see the ADD (Field) command.

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

  1. COMMAND> ADD CREDITS 
    

    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.

QUALIFIERS

/ALL

Specifies that all fields in this class 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 valid ERRORS class fields, see the ADD (Field) command.

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

  1. COMMAND> ADD ERRORS 
    

    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.


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  6048P045.HTM
  OSSG Documentation
  26-NOV-1996 12:43:26.76

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal