Digital PDFs

AA-Z430B-TE

April 1986

96 pages

Original

6.0MB

view download

OCR Version

8.6MB

view download

Document:	VAX/VMS Show Cluster Utility
Order Number:	AA-Z430B-TE
Revision:	000
Pages:	96
Original Filename:	aa-z430b-te.pdf

OCR Text

VAX/VMS
Show Cluster Utility
Reference Manual
Order Number: AA-Z430B-TE

April 1986
This reference manual describes how to use the Show Cluster Utility to
monitor and display VAXcluster activity and performance.

Revision/Update Information:

This is a revised manual.

Software Version:

VAX/VMS Version 4.4

digital equipment corporation
maynard, massachusetts

April

1986

The information in this document is subject to change without notice and should

not be construed as a commitment by Digital Equipment Corporation. Digital

Equipment Corporation assumes no responsibility for any errors that may appear
in this document.

The software described in this document is furnished under a license and may be
used or copied only in accordance with the terms of such license.
No responsibility is assumed for the use or reliability of software on equipment

that is not supplied by Digital Equipment Corporation or its affiliated companies.
Copyright ©1986 by Digital Equipment Corporation
All Rights Reserved.

The postpaid READER'S COMMENTS form on the last page of this document
requests the user’s critical evaluation to assist in preparing future documentation.

The following are trademarks of Digital Equipment Corporation:
UNIBUS

DIBOL

DEC

EduSystem

DEC/CMS

VAX

DEC/MMS

IAS

VAXcluster

DECsystem—10

PDP

DECSYSTEM-20
DECUS

PDT
RSTS

MASSBUS

DECnet

dligli[tla]l]

RSX

DECwriter

VMS

ZK-3031

HOW TO ORDER ADDITIONAL DOCUMENTATION
DIRECT MAIL ORDERS

USA & PUERTO RICO"

CANADA

INTERNATIONAL

Digital Equipment Corporation

Digital Equipment

Digita Equipment Corporation

03061

Kanata, Ontario K2K 2A6

or approved distributor

P.O. Box CS2008
Nashua, New Hampshire

of Canada Ltd.
100 Herzberg Road
Attn:

Direct Order Desk

PSG Business Manager
c/o Digital’s local subsidiary

In Continental USA and Puerto Rico call 800-258-1710.
In New Hampshire, Alaska, and Hawail call 603-884-6660.
In Canada call 800-267-6215.

*Any prepaid order from Puerto Rico must be placed with the local Digital subsidiary (809-754-7575).
Internal orders should be placed through the Software Distribution Center (SDC), Digital Equipment

Corporation, Westminster, Massachusetts 01473.
This document was

composition and m:
Donald E. Knuth at
Society.

ropared using an in-house documentation produciion systom. Al pose
by
eloped
-up was performed by TeX, the typesetting
anford University. TeX is a registered trademark of the American Mathematical

PREFACE

SHOW CLUSTER Contents

NEW AND CHANGED FEATURES

FORMAT

SHCL-1

COMMAND SUMMARY

SHCL-2

DESCRIPTION

SHCL-3

INVOKING AND TERMINATING SHOW CLUSTER

SHCL-3

SHOW CLUSTER REPORT

SHCL-3

CONTROLLING THE DISPLAY

SHCL-5

3.1

Entering Commands

SHCL-6

3.2

Keypad

SHCL-6

3.3

Changing the Updating Interval

SHCL-7

3.4

Adding Information

SHCL-8

3.5

Formatting the Display

SHCL-9

3.5.1

Removing Data

SHCL-9

35.2

Modifying Field and Screen Size

SHCL-9

353

Moving a Window

SHCL-10

354

Scrolling a Window

SHCL-10

355

Panning the Display

SHCL-11

3.6

Refreshing the Screen

SHCL-11

3.7

Receiving Broadcast and Error Messages

SHCL-12

CREATING A STARTUP INITIALIZATION FILE

SHCL-12

Using Command Procedures

SHCL-13

4.1

SHOW CLUSTER Contents

—_——-

COMMAND QUALIFIERS

SHCL-15

/BEGINNING=TIME

SHCL-16

/CONTINUOUS

SHCL-17

/ENDING=TIME

SHCL-18

/INTERVAL-SECONDS

SHCL-19

/OUTPUT=FILE-SPEC

SHCL-20

COMMANDS

SHCL-21

@ (EXECUTE PROCEDURE)

SHCL-22

ADD CIRCUITS

SHCL-23

ADD CLUSTER

SHCL-25

ADD CONNECTIONS

SHCL-26

ADD COUNTERS

SHCL-28

ADD CREDITS

SHCL-29

ADD ERRORS

SHCL-30

ADD (FIELD)

SHCL-31

ADD LOCAL_PORTS

SHCL-41

ADD MEMBERS

SHCL-42

ADD SYSTEMS

SHCL-43

DEFINE/KEY

SHCL-45

DESELECT

SHCL-48

EXIT

SHCL-49

HELP

SHCL-50

INITIALIZE

SHCL-51

MOVE

SHCL-52

PAN

SHCL-54

REFRESH

SHCL-55

REMOVE CIRCUITS

SHCL-56

REMOVE CLUSTER

SHCL-57

REMOVE CONNECTIONS

SHCL-58

REMOVE COUNTERS

SHCL-59

SHOW CLUSTER Contents

REMOVE CREDITS

SHCL-60

REMOVE ERRORS

SHCL-61

REMOVE (FIELD)

SHCL-62

REMOVE LOCAL_PORTS

SHCL-63

REMOVE MEMBERS

SHCL-64

REMOVE SYSTEMS

SHCL-65

SAVE

SHCL-67

SCROLL

SHCL-69

SELECT

SHCL-70

SET AUTO_POSITIONING

SHCL-71

SET (FIELD)

SHCL-72

SET FUNCTION

SHCL-73

SET INTERVAL

SHCL-74

SET SCREEN

SHCL-75

WRITE

SHCL-76

—

INDEX

Preface

Intended Audience
This manual is intended for VAXcluster users, system managers, and others

who routinely monitor cluster activity and performance.

Structure of This Document
This document is composed of four major sections.

The Format Section is an overview of the Show Cluster Utility and is intended
as a quick reference guide. The format summary contains the DCL command
that invokes the Show Cluster Utility, listing all command qualifiers and
parameters. The usage summary describes how to invoke and exit from the
Show Cluster Utility, how to direct output, and any restrictions that apply
to the use of this utility. The command summary lists all commands and

qualifiers that can be used within the Show Cluster environment.
The Description Section explains how to use the Show Cluster Utility.

The Qualifier Section describes each DCL command qualifier. Qualifiers
appear in alphabetical order.
The Command Section describes each Show Cluster Utility command,

qualifiers and parameters. This section also gives examples for command
use. Commands appear in alphabetical order.

Associated Documents
For related information about this utility, see the Guide to VAXclusters.

vii

Preface

Conventions Used in This Document
Convention

A symbo! with a one- to three-character
abbreviation indicates that you

press a key

on the terminal, for example,
CTRL/x

The phrase CTRL/x indicates that you

must press the key labeled CTRL while
you simultaneously press another key,

for example, CTRL/C, CTRL/Y, CTRL/O.
In examples, this control key sequence

is shown as “x, for example, °C, Y, "0,
because that is how the system echoes
control key sequences.

$ SHOW TIME

05-JUN-1982 11:66:22

Command -examples show all output lines
or prompting characters that the system

prints or displays in the black letters. All
user-entered commands are show in red
letters.

$ TYPE MYFILE.DAT

Vertical series of periods, or ellipsis, mean
either that not all the data that the system

would display in response to the particular
command is shown or that not all the data
a user would enter is shown.
file-spec, . ..

Horizontal ellipsis indicates that additional

parameters, values, or information can be
entered.

[logical-name]

Square brackets indicate that the enclosed

item is optional. (Square brackets are
not, however, optional in the syntax of a
directory name in a file specification or in
the syntax of a substring specification in an

assignment statement.)
quotation marks
apostrophes

The term quotation marks is used to refer

to double quotation marks ("). The term

apostrophe (') is used to refer to a single
quotation mark.

New and Changed Features
The Show Cluster Utility for Version 4.4 contains the following new features:
¢

New commands:

DEFINE/KEY
DESELECT

MOVE
PAN

REFRESH

SAVE
SCROLL
SELECT
SET FUNCTION
SET AUTO_POSITIONING

WRITE

One display report instead of two. (Consequently, the SHOW command

is now obsolete.)

Definable keys and a default keypad.

Three display windows, each containing related classes. Each window can
be manipulated independently.

Command procedures can be nested up to 16 levels deep.

SHOW CLUSTER

SHOW CLUSTER
The VAX/VMS Show Cluster Utility (SHOW CLUSTER) monitors
nodes in a VAXcluster and displays information about cluster
activity and performance. SHOW CLUSTER information covers
approximately 100 fields of data, which appear in three windows.
You can customize the appearance of the display and output, or

use default displays for access to often-needed data. You can use
SHOW CLUSTER interactively or with command procedures and
user-defined default settings.

FORMAT

SHOW CLUSTER
Command Qualifiers

Defauits

/BEGINNING=time

None.

/CONTINUOUS

/ENDING=time

/INTERVAL=seconds

/OUTPUT=file-spec

None.

/INTERVAL=15

/OUTPUT=SYS$OUTPUT

Command Parameters
None.

usage summary

Invoking
To invoke the Show Cluster Utility, specify the following command:
$ SHOW CLUSTER

If you specify the command without any qualifiers, SHOW CLUSTER displays
a single cluster report and then returns control to the DCL level. To invoke a
continuous SHOW CLUSTER display, specify the following command:
$ SHOW CLUSTER/CONTINUOUS

If you request a continuous display, you can then control report output with
SHOW CLUSTER commands.
Exiting
By default, SHOW CLUSTER displays a single cluster report and then returns
control to the DCL level. If you specify the /CONTINUOUS qualifier, cluster

reports are displayed continuously. To exit from a continuous display and
return to the DCL level, either specify the EXIT command or press CTRL/Z

or CTRL/C.

Directing Output
You can direct SHOW CLUSTER output to a file or device other than to
SYS$OUTPUT by specifying the /OUTPUT qualifier with the SHOW
CLUSTER command. For more information, see the description of the

/OUTPUT qualifier.
Privileges/Restrictions
None.

SHCL-1

SHOW CLUSTER

commands

Syntax

command [/qualifier], . . . ]] [parameter] [/qualifier[, . . . ]]

SHOW CLUSTER Commands

@ (Execute Procedure)
ADD CIRCUITS
JALL

JTYPE=ALL
/TYPE=[NOJOPEN

ADD CLUSTER
JALL

ADD CONNECTIONS
JALL
JTYPE=ALL

JTYPE=[NOJOPEN
ADD COUNTERS
JALL

ADD CREDITS
JALL
ADD ERRORS
JALL
ADD (Field)

ADD LOCAL_PORTS
JALL

ADD MEMBERS
JALL

ADD SYSTEMS
JALL
/ID=system-id

/NODE=node-name
/TYPE=hardware-type

DEFINE/KEY
/INOJECHO
/INOJERASE

/INOJIF_STATE
/INOJLOCK_STATE
/[NOJLOG
/INOJSET_STATE
/INOJTERMINATE

DESELECT
EXIT

HELP
INITIALIZE
MOVE direction value
PAN direction value

REFRESH
REMOVE CIRCUITS
JTYPE=ALL

JTYPE=[NOJOPEN
REMOVE CLUSTER

REMOVE CONNECTIONS
JTYPE=ALL

JTYPE=[NOJOPEN
REMOVE COUNTERS
REMOVE CREDITS
REMOVE ERRORS
REMOVE (Field)

SHCL-2

SHOW CLUSTER
Description

REMOVE LOCAL _PORTS

REMOVE MEMBERS
REMOVE SYSTEMS

/ID=system-id
/NODE=node-name
/TYPE=hardware-type

SAVE [file-spec]
SCROLL direction value
SELECT [window-name]
SET AUTO_POSITIONING (ON,OFF)
SET (Field)
/WIDTH=field-name-width
/FORMAT=radix
SET FUNCTION function-name
SET INTERVAL
SET SCREEN
WRITE ([file-spec]
JALL

DESCRIPTION

The Show Cluster Utility allows you to monitor the activity and performance
of a VAXcluster. SHOW CLUSTER collects information from the systems
communications services (SCS) database, the connection management
database, and the CI (computer interconnect) port database, and outputs
it to your terminal or to a specified device or file.

Invoking and Terminating SHOW CLUSTER
You invoke the Show Cluster Utility at the DCL command level by specifying
the DCL command SHOW CLUSTER. By default, SHOW CLUSTER displays
a single report on your terminal and returns control to the DCL command
level.

If you specify the /CONTINUOUS qualifier, SHOW CLUSTER displays data
continuously, and updates the display at specific intervals. If you initiate a

continuous display you can then control report output with Show Cluster
Utility commands.

To terminate a continuous display and return to the DCL command level,
specify the SHOW CLUSTER command EXIT. You can also terminate a
display session at any time by pressing CTRL/Z or CTRL/C. To interrupt
SHOW CLUSTER, press CTRL/Y.

SHOW CLUSTER Report
The SHOW CLUSTER report provides over 100 fields of data. However,
because data alone does not necessarily communicate meaningful information,

the Show Cluster Utility provides a framework in which to manipulate the
data so that it becomes useful information. This framework consists of fields,
classes, and windows.

You can reference each of the fields of data by a unique name. For example,
the field containing the number of datagrams received by a local system is

named DGS_RCVD. Using the field name, you can selectively remove or add
a field from the SHOW CLUSTER report.

SHCL-3

SHOW CLUSTER
Description

Since many of the fields contain related information, SHOW CLUSTER
groups related fields into classes. For example, SHOW CLUSTER groups
the number of datagrams sent (DGS_SENT field), the number of datagrams
received (DGS_RCVD field), the number of messages sent (MSGS_.SENT
field), and the number of messages received (MSG_RCVD field) into the
COUNTERS class. Using the class name, you can selectively add or remove
an entire class from the SHOW CLUSTER report.
The third type of informational grouping that SHOW CLUSTER provides is
the window. SHOW CLUSTER gathers data from
®

SCS database

Connection management database

CI port database

Because the data gathered from each source is related, SHOW CLUSTER
uses that organization to group data. The SHOW CLUSTER report consists

of three windows: SCS, CLUSTER and LOCAL _PORTS. The SCS window
primarily contains data collected from the SCS database with the exception of
the MEMBERS class data, which is collected from the connection management

database. The CLUSTER window contains data collected from the connection
management database, and the LOCAL_PORTS window contains data
collected from the CI port database. For example, the COUNTERS class
is one class of information gathered from the SCS database that SHOW
CLUSTER displays in the SCS window.

Each window is a separate entity, and you can manipulate it independently

of the other two. In practical terms, this means that you can add, remove,
move, or scroll the window.
The following diagram shows the relationship among fields, classes, and
windows in the SHOW CLUSTER report.

WINDOW

MEMBERS

CLASS

STATUS

FIELD

DARBY | VMS V4.4 | MEMBER
DOOLEY | HSC V110

DATA
ITEM

SYSTEMS
NODE

| SOFTWARE|

ALICAT

| VMS V4.4 | MEMBER

MISHA

| VMS v4.4 | MEMBER

2K-4998 86

The following tables show which classes are contained in each of the three
‘windows.

SHCL-4

SHOW CLUSTER
Description

SCS Window
Classes

MEMBERS

Contains information about the systems actively participating
in the cluster.

SYSTEMS

Contains information about systems in the cluster.

CIRCUITS

Contains information about the virtual circuits on systems in
the cluster.

CONNECTIONS

Contains information about the connections established over
a virtual circuit in the cluster.

COUNTERS

Contains counts of the total accumulated traffic over a
connection for the life of the connection.

CREDITS

Contains information about the send and receive credit
counts for connections in the cluster.

Connection
Management
Window Class
CLUSTER

Contains general information about the cluster.

CI Port Window
Classes

ERRORS

Contains information about errors on the local system's Ci
interface to the cluster.

LOCAL_PORTS

Contains information about the local system's Cl interface to
the cluster.

For a description of the fields in each class, see the description of the ADD
(Field) command.

Controlling the Display
In addition to providing you with data about a cluster, SHOW CLUSTER

also provides you with mechanisms to control the display of data. The
mechanisms include:

SHOW CLUSTER commands

Default keypad which can also be redefined

Initialization file to format display

Command procedures to control display

Some of the operations that you can perform include:

Changing the interval at which the display is updated

Adding information to the display

Changing the format of the display

SHCL-5

SHOW CLUSTER
Description

Moving a window

Scrolling a window

Panning the display

The following sections describe how to perform these operations.

3.1

Entering Commands
The Show Cluster Utility allows you to customize the display of data
within fields, classes, and windows by issuing various commands durin;

a continuous session. The Command Section describes the available SHOW

CLUSTER commands in detail.
When you first enter the continuous SHOW CLUSTER environment, no
command prompt is visible on the display screen. As soon as you enter a
command from the terminal keyboard, the two bottom lines of the display are
erased and the following SHOW CLUSTER prompt appears:
COMMAND>

SHOW CLUSTER uses the two bottom lines for displaying commands, error
messages, and broadcast messages.
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 resumes until another command is entered. By default,
updating takes place at 15-second intervals. If no new command is entered
within 15 seconds, the information in the two bottom lines is restored with
two more lines of data from the original display.
By default, SHOW CLUSTER is set to EDIT function. This means that you

can perform DCL line-mode editing at the command prompt (for example,
using the LEFT arrow key to move the cursor to the left, or the UP arrow key
to recall the previous command). See the VAX/VMS DCL Concepts Manual for
information on DCL line-mode editing.
Note: Once you set the function to PAN, SCROLL, or MOVE, the arrow keys
are redefined, and DCL line-mode editing is disabled. PAN, SCROLL, and
MOVE are described in Section 3.5 and in the Command Section.
To enable editing again once it has been disabled, issue the command SET
FUNCTION EDIT.

3.2

Keypad
SHOW CLUSTER provides a predefined keypad that you can use to enter
selected commands. By default, the numeric keypad is defined as follows:
(Shading over a keypad command indicates that you must press the GOLD
key and then the keypad key.)

SHCL-6

SHOW CLUSTER
Description

INIT

REFRESH

HELP

GOLD

)

PFa

PF3

PF2

(PF1

SETFUNCTION | ser Funcrion | SET Funcrion | ser Fruncrio

ADD

SET AUTO_POS

’

OFF

5
2

ser

REMOVE

EDIT

MOVE

SCROLL

SET AUTO_POS

3
save

wite

0
saigcr

DESELECT

21)

If you press a SET FUNCTION key, the arrow keys are redefined to perform
the specified function. For example, if you press the SET FUNCTION

SCROLL key, the 1, | , —, and — arrow keys are redefined as SCROLL UP
1, SCROLL DOWN 1, SCROLL RIGHT 1, and SCROLL LEFT 1, respectively.
(See the Command Section for information on specific commands.)

Note: If you set the function to PAN, SCROLL, or MOVE, the arrow keys are
no longer defined to perform DCL line-mode editing. Only one function

can be enabled at a time. To restore line-mode editing, once it has been

changed to another function, issue the command SET FUNCTION EDIT.

You can also use the DEFINE/KEY command to change the definition of
a key. See DEFINE/KEY command in the Command Section for more
information.

3.3

Changing the Updating Interval
You can change the interval at which SHOW CLUSTER updates the data in
the display. By default, the display is updated every 15 seconds, with the
changed data displayed in reverse video. To change the rate at which data is
updated, you use the SET INTERVAL command. See SET INTERVAL in the
Command Section for more information.

You can also change the updating interval by issuing the following command
at the DCL level:

SHOW CLUSTER/INTERVAL=seconds

SHCL-7

SHOW CLUSTER
Description

Adding Information
When you invoke SHOW CLUSTER, the resulting display contains a subset

of the total information available. By default, the SHOW CLUSTER display
consists of the SCS window, containing the following information:

VIEW OF CLUSTER FROM SYSTEM ID 1209 NODE DARBY

SYSTEMS

15-APR-1986 15:11:34

MEMBERS

NODE

[SOFTWARE|

STATUS

DARBY

| VMS V4.4 |

MEMBER

I SCS WINDOW

DOOLEY | HSC V110

ALICAT

| VMS V4.4 |

MEMBER

MISHA

| VMS V4.4 |

MEMBER

WAVYNE | VMS V4.4 |

MEMBER

PHENIX

| HSC V110

UPARK

[ HsC xsJs

TOONA

| VMS V4.4 |

MEMBER
2K 499986

You add additional fields and/or classes with the ADD command. To
specify a particular field, use the appropriate field name as specified in
the description of the ADD (Field) command in the Command Section. To

specify a particular class, use the appropriate ADD command as specified in
the Command Section.

If you add a field or class that is not in the SCS window, SHOW CLUSTER
displays the new window containing the specified class. The following

diagrams display the default classes and fields of the LOCAL .PORTS
CLUSTER windows:

LOCAL_PORTS

and

| LOCAL PORTS WINDOW

2|1>2|

[y
2K 500086

CLUSTER
CL_Q

|CL_V |

QD_NAME | QF.V
NO

(-CLUSTER WINDOW
FORMED

LAST_TRANSITION

15-APR-86 09:38 | 30-MAR-86 14:39
2K 5001 86

SHCL-8

SHOW CLUSTER
Description

Note: The AUTO_POSITIONING function may place one window below
another in such a way that it does not appear within the limits of your

current display. See the next section for information on viewing data that
extends beyond the limits of the display.

3.5

Formatting the Display
Because the Show Cluster Utility allows you to include additional fields
and classes, you may produce displays that overflow the physical limits of
the terminal screen. However, you can manipulate the fields, classes, and
windows to customize a display to meet your needs. This can be achieved by
any of the following methods:

3.5.1

Removing data by class, field, or type

Modifying field widths and formats

Modifying the screen size

Moving a window

Scrolling a window

Panning the display

Removing Data

You may want to remove certain fields or classes to reduce the width of the
display to fit the limits of your screen. Also, certain fields or classes may
not be important for your particular needs. You can also remove data of a
particular type, to reduce the length of the display.

You use the REMOVE command to remove fields, classes, or certain types
of data. To remove a particular field, use the appropriate field name in

the command, REMOVE field-name. See the ADD (Field) command

description for a list of valid field names. To remove a particular class,
use the appropriate class name in the command, REMOVE class-name. To

remove certain types of data, use the appropriate /TYPE=keyword qualifier

with the REMOVE CIRCUITS, REMOVE CONNECTIONS, or REMOVE
SYSTEMS command. See the REMOVE commands in the Command Section
for appropriate class names and keywords.

3.5.2

Maodifying Field and Screen Size

Another way you make the display fit the physical limits of the screen is

to change the width of certain fields in the display. 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 area, you can adjust

the field width with the SET (Field) command. See the SET (Field) command
in the Command Section for a description of how to adjust field widths.
SHOW CLUSTER also allows you to adjust the size of the terminal screen.

1f the terminal is DIGITAL compatible, you can set the screen to a width of
up to 512 columns by specifying an appropriate value to the SET SCREEN
command. See the SET SCREEN command in the Command Section for
more details.

SHCL-9

SHOW CLUSTER
Description

3.5.3

Moving a Window
By default, SHOW CLUSTER operates with AUTO_POSITIONING ON. This
means that it automatically arranges the windows to take best advantage of
the available display space. However, you may want to position windows
manually by overriding the default. Setting AUTO_POSITIONING to OFF
allows windows to be repositioned manually.
To reposition a window, you must first select the window to be repositioned.
You use the command SELECT window-name to specify the window name:

SCS, CLUSTER, or LOCAL _PORTS. As an alternative, you can repeatedly
press the SELECT key on the keypad to cycle from one window to the next.

The selected window appears highlighted.
To move a selected window, you either enter MOVE commands at the

command prompt, or use the arrow keys defined as MOVE commands.
Issuing the command SET FUNCTION MOVE redefines the 1, | , — , and «

arrow keys as MOVE UP 1, MOVE DOWN 1, MOVE RIGHT 1, MOVE LEFT
1, respectively.

Note: The SET FUNCTION MOVE command implicitly sets AUTO—
POSITIONING to OFF.
When you issue a MOVE command, the window changes position by column
(horizontally), or by line (vertically). For example, entering the command
MOVE LEFT 5 moves the window 5 columns to the left. An empty frame
appears around the new window position. When you are satisfied with the

position of the window, you issue the DESELECT command, which moves
the window to the new position. Entering another SELECT command before
the previous MOVE operation has been deselected also moves the window to
its new position.

In summary, you follow these steps to move a window:

Set AUTO_POSITIONING to OFF.

Select a window using the SELECT command.

Position the window frame by using MOVE commands.

Terminate the MOVE operation by entering the DESELECT command or
another SELECT command.

Note: If you attempt to issue MOVE commands with AUTO_POSITIONING

ON, the window will revert to its original position when you issue the
DESELECT command.

For more information, see the SELECT, SET FUNCTION, and DESELECT
commands in the Command Section.

354

Scrolling a Window
The SCROLL command provides a means of quickly scanning through
a window without changing the selection of information displayed in
the window. Scrolling scans a window by field (horizontally) and by
line (vertically). The window headings remain stationary when you scroll
vertically.
To scroll the view of a window, you must first select a window by issuing
the SELECT command. The selected window is highlighted. You scroll a

selected window either by entering SCROLL commands at the command
prompt, or by using the arrow keys defined as SCROLL commands. Issuing
the command SET FUNCTION SCROLL redefines the
, | , — , and «

SHCL-10

SHOW CLUSTER
Description

arrow keys as SCROLL UP 1, SCROLL DOWN 1, SCROLL RIGHT 1, and
SCROLL LEFT 1, respectively.

To issue the SCROLL command at the command prompt, use the format:
SCROLL direction value

See the SET FUNCTION and SCROLL commands in the Command Section
for more information.

355

Panning the Display

The PAN command allows you to view the entire display from a perspective

similar to that of a video camera. Panning changes your view of the display

by column (horizontally) or by line (vertically). Window headings also move

out of view as the windows contained within the display are panned beyond
the limits of the screen.

Similar to the effect of panning a video camera, the display seems to move in

the opposite direction to which you are panning. For example, the command
PAN UP 5 moves the display five lines down; the command PAN RIGHT 5
moves the display five columns to the left.

To pan the display, either enter PAN commands at the command prompt, or

use the arrow keys defined as PAN commands. Issuing the command SET
FUNCTION PAN redefines the 1, | , — , and « arrow keys as PAN UP 1,
PAN DOWN 1, PAN RIGHT 1, and PAN LEFT 1, respectively.

Note: Only one function can be enabled at a time. To restore line-mode editing
once the function has been changed to PAN, SCROLL, or MOVE, issue
the command SET FUNCTION EDIT.

To issue the PAN command at the command prompt, use the format:
PAN direction value

See the SET FUNCTION and PAN commands in the Command Section for
more information.

3.6

Refreshing the Screen
Normally a continuous display is updated or refreshed according to the
specified interval time. The Show Cluster Utility scans the software databases,
extracts and stores data for each field, displays any new or changed data, and

updates the time. On DIGITAL compatible terminals, reverse video highlights
any changed data.

You can refresh the screen at any time by one of the following methods:
*

Modifying the format of the display with the ADD, REMOVE,

Using the REFRESH command

Pressing CTRL/W

INITIALIZE, or SET command

SHCL-11

SHOW CLUSTER
Description

3.7

Receiving Broadcast and Error Messages
When you receive a broadcast message during a continuous SHOW CLUSTER

session, the message appears at the bottom of the display screen. A multiline
message fills as many lines of the display as it needs.

The last broadcast message remains on the screen until you acknowledge its

receipt by entering input from the terminal in one of the following ways:

Pressing the RETURN key

Refreshing the screen by pressing CTRL/W

Issuing a command

If you receive more than one broadcast message, SHOW CLUSTER waits
until the next update interval to display the next message.

Creating a Startup Initialization File
To override report defaults before the display begins, you can create a

startup initialization file, which the utility executes when it is invoked.

In order for a startup file to execute before the display begins, you must

assign the logical name SHOW_CLUSTERSINIT to the file name of the
procedure. When invoked, SHOW CLUSTER searches for the file defined

by SHOW_CLUSTERSINIT and, if it is found, executes the procedure before
beginning the display. If SHOW_CLUSTERSINIT is not defined or does
not include a directory specification, SHOW CLUSTER searches the current

default directory. The following example shows how to assign SHOW_.
CLUSTERSINIT to a startup initialization procedure file:
DEFINE SHOW_CLUSTER$INIT DEVA: [JONES]SHCINI

In this example, SHOW CLUSTER looks for DEVA:[JONES]SHCINLINI when
it starts up.

The easiest way to create an initialization file is to follow these steps:

Define SHOW_CLUSTERSINIT as device:[directory]SHCINI

Customize the display using SHOW CLUSTER commands during a
continuous SHOW CLUSTER session

Enter the command
COMMAND> SAVE SHOW_CLUSTERSINIT:.INI

You must specify SHOW_CLUSTERSINIT:.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.

You can edit the file that the SAVE command creates to include comments or

to improve its efficiency. For more information, see the SAVE command in
the Command Section.

SHCL-12

SHOW CLUSTER
Description

The following startup procedure causes SHOW CLUSTER to delete the
default MEMBERS class information and add three fields from the CIRCUITS
class:
!

18tartup Initialization File
!
!

INITIALIZE
REMOVE MEMBERS

ADD CIR_STATE,REM_STATE,CABLE_STATUS
SET SCREEN=132

You can also create an initialization file in the same manner as a command
procedure. Section 4.1 describes the rules for creating a command procedure.
1f you use an initialization file in noncontinuous mode and the initialization
file contains a SET SCREEN command that changes the screen size, SHOW
CLUSTER sets the screen to the specified size for one update interval and
then resets the screen to the original size.

4.1

Using Command Procedures
You can also create command procedures that contain SHOW CLUSTER
commands. Such files let you modify display characteristics without having
to enter commands interactively. Command procedures can be used during

a continuous SHOW CLUSTER display session to perform a series of

commands, for example, customizing the output of the display. Any valid
SHOW CLUSTER commands can be used. Command procedures can be
nested 16 levels deep. Note that command procedures cannot be run from a
batch job.

Each line in a command procedure is interpreted as a command unless the
line begins with an exclamation point (!), in which case the line is treated
as a comment. Comments are also valid at the ends of lines containing
commands; everything to the right of an exclamation point is considered a
comment.
P

Include the SHOW CLUSTER command INITIALIZE as the first command
in the file. The INITIALIZE command ensures that the report is in a known
state before any commands are executed to modify it.
Note:

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.

The following command procedure customizes a report display:
!

1 Include only mode field from the default display; show votes
! and quorum for each node and for cluster as a whole.
!
INITIALIZE

REMOVE SOFTWARE, STATUS
ADD VOTES, QUORUM, CL_VOTES, CL_QUORUM

This command procedure removes the SOFTWARE and STATUS fields from
the report display and adds fields that provide information about cluster

quorum and votes.

SHCL-13

SHOW CLUSTER
Description

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 the command procedure saved in

the default directory under the file name SYSMOD.COM:

COMMAND> @SYSMOD

In this example, since the file type is omitted, the default file type COM is

assumed.

SHCL-14

SHOW CLUSTER
Command Qualifiers

COMMAND

QUALIFIERS

This section describes the qualifiers that can be used with the DCL command
SHOW CLUSTER to invoke the Show Cluster Utility:
/BEGINNING=time

/CONTINUOUS

/ENDING=time

/INTERVAL=seconds

/OUTPUT=file-spec

SHCL-15

SHOW CLUSTER
/BEGINNING = time

/BEGINNING = time
Specifies the time that the SHOW CLUSTER session is to begin.
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

VAX/VMS DCL Concepts Manual.

If you specify a future time, your process is placed in a state of

hibernation until the specified time. You should use this qualifier

with the /OUTPUT and /ENDING qualifiers to run SHOW CLUSTER

without direct user intervention.

_
s e s
_m

FORMAT

/BEGINNING=time
time
You can specify time as an absolute time expressed as [dd-mmm-yyyy[:]]

[hh:mmuss.cc], or a delta time expressed as [dddd-]Jfhh:mm:ss.cc), or a

combination of the two. Observe the syntax rules for time values described in

the VAX/VMS DCL Concepts Manual.

EXAMPLES

g oo CLUSTER/BEGINNING=04- JUL-1986:20:30
In this example, specifying an absolute time, the Show Cluster Utility

produces a single display at 8:30 P.M. on July 4, 1986.

§ SHOW CLUSTER/CONTINUOUS/BEGINNING=04-JUL-1986:21:30

In this example, specifying an absolute time, the Show Cluster Utility begins
a continuous display at 9:30 P.M. on July 4, 1986.

$ SHOW CLUSTER/BEGINNING=7-:30

In this example, specifying a delta time, the Show Cluster Utility produces a
single display seven days and 30 minutes from now.

SHCL-16

SHOW CLUSTER
/CONTINUOUS

/CONTINUOUS
Controls whether SHOW CLUSTER runs as a continuously updating
display. If you omit the qualifier, SHOW CLUSTER produces a single
display and returns control to the DCL command level.
Running SHOW CLUSTER in the continuous mode allows you to use
SHOW CLUSTER commands to control the display.
e

FORMAT

/CONTINUOUS

EXAMPLE
§

SHOW CLUSTER/CONTINUOUS

In this example the Show Cluster Utility begins to display a continuous report
that is updated every 15 seconds.

SHCL-17

SHOW CLUSTER
/ENDING = time

JENDING = 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
VAX/VMS DCL Concepts Manual.

You should use this qualifier with the /BEGINNING and /OUTPUT

qualifiers to run SHOW CLUSTER without direct user intervention.
_

FORMAT

/ENDING=time
time
You can specify time as an absolute time expressed as [dd-mmm-

yyyy[:llhh:mm:ss.cc], or a delta time expressed as [dddd-][hh:mm:ss.cc], or a
combination of the two. Observe the syntax rules for time values described in
the VAX/VMS DCL Concepts Manual.

EXAMPLE
§ SHOW CLUSTER/CONTINUOUS/ENDING=04-JUL-1986:16:30

In this example, the Show Cluster Utility begins a continuous display now
and ends the display at 3:30 P.M. on July 4, 1986.

SHCL-18

SHOW CLUSTER
/INTERVAL = seconds

/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.

If you use an initialization file in noncontinuous mode and the
initialization file contains a SET SCREEN command that changes
the screen size, SHOW CLUSTER sets the screen to the specified
size for one update interval and then sets the screen to the original
size.

FORMAT

/INTERVAL=seconds
seconds

The number of seconds between display updates.
_

EXAMPLE
$ SHOW CLUSTER/INTERVAL=

In this example the Show Cluster Utility displays a continuous report that is
updated every five seconds.

SHCL-19

SHOW CLUSTER
JOUTPUT = file-spec

/OUTPUT = file-spec
Directs the output from SHOW CLUSTER to the specified file instead

of the current SYSSOUTPUT device. You can also direct output to
a particular device if the device name specified is valid; if it is not,

SHOW CLUSTER assumes it is a file name.

When you use the /OUTPUT qualifier, SHOW CLUSTER output
is always in printable file format, regardless of the device type
specified. The output can be up to 132 columns wide and can be

directed to any file, terminal, or print device.
You can also direct output a file with the WRITE command. See
the Command Section for more detail.
D

FORMAT

/OUTPUT=file-spec

file-spec
The name of the file to which SHOW CLUSTER output is directed. The

default file name is SHOW_CLUSTER.LIS.

EXAMPLES
a

$ SHOW CLUSTER/QUTPUT=[OMALLEY] CLUSTER
In this example the Show Cluster Utility produces one report and directs it to
the file CLUSTER.LIS;1 in the directory OMALLEY.

$ SHOW CLUSTER/OUTPUT=[WARREN] CLUSTER.RPT; 1
In this example the Show Cluster Utility produces one report and directs it to

the file CLUSTER.RPT;1 in the directory WARREN.

SHCL-20

SHOW CLUSTER
Commands

COMMANDS

Once you initiate a continuous SHOW CLUSTER display session, you can use
SHOW CLUSTER commands to control the session. This section describes
each of the SHOW CLUSTER commands.

SHCL-21

SHOW CLUSTER
@ (Execute Procedure)

@ (Execute Procedure)
Executes a command procedure file that contains SHOW CLUSTER
commands.

FORMAT

file-spec

command

file-spec

parameters

Specifies the name of the file that contains the commands to be executed.

command

None.

If you omit the file type, the default file type COM is used. No wildcard
characters are allowed in the file specification.

qualifiers

e
—

DESCRIPTION

The execute procedure (@) command allows you to execute a set of SHOW
CLUSTER commands that is contained in a file. For example, a 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_CLUSTERSINIT. If SHOW_CLUSTERSINIT is
not defined or does not include a directory specification, the utility looks for
the command procedure in the current default directory.

EXAMPLE
COMMAND> GMYFILE

The command in this example executes the command procedure
MYFILE.COM. Because no file type is specified, the file type defaults to

COM.

SHCL-22

SHOW CLUSTER
ADD CIRCUITS

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], . . . ]|

command

None.

parameters

command
qualifiers

/ALL

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

JTYPE=ALL

Specifies that all types of circuits be included in the display, including
formative, open, and closing circuits. By default, the ADD CIRCUITS
command without any qualifiers displays all types of circuits.

/TYPE=OPEN

/TYPE=NOOPEN

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

display.
B

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.

You 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 original fields are once again displayed.
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
0

coouwn> wop crrcurrs
This command adds CIRCUITS class information to the display. This

information includes all types of circuits for all enabled CIRCUITS class
fields.

SHCL-23

SHOW CLUSTER
ADD CIRCUITS

cowunn> Aop crrcurrs/TYPE=OPEN
This command adds all open circuits to the SHOW CLUSTER display.

commm> revove crrcurts

COMMAND> ADD RP_OWNER
COMMAND> REMOVE CIRCUITS

COMMAND> ADD CIRCUITS
The ADD CIRCUITS command 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 RE_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 RE_OWNER field is displayed.

SHCL-24

SHOW CLUSTER
ADD CLUSTER

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

FORMAT

ADD CLUSTER

command

None.

parameters

command
qualifier

/ALL
Specifies that all fields in this class be 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_QUORUM (cluster quorum), CL_VOTES (cluster votes), QD_NAME
(quorum disk name), QE_VOTE (quorum disk contributes a vote), FORMED
(when quorum was formed), LAST_TRANSITION (last change in cluster

membership). For a list of valid CLUSTER class fields, see the ADD (Field)
command.

You use the ADD CLUSTER command together 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 original fields are once again displayed. 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
COMMAND> ADD CLUSTER

This command adds CLUSTER class information to the display. This
information includes all enabled CLUSTER class fields.
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 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.

SHCL-25

SHOW CLUSTER
ADD CONNECTIONS

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

FORMAT

ADD CONNECTIONS [/qualifier], . . . ]|

command

None.

parameters

command

qualifiers

/ALL

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

/TYPE=ALL

Specifies that all types of connections on each circuit are displayed. By default
the ADD CONNECTIONS command without any qualifiers, displays all types
of connections.

/TYPE=OPEN
/TYPE=NOOPEN
Controls whether either open connections or nonopen connections are added
to the SHOW CLUSTER display.

DESCRIPTION information to the SHOW CLUSTER display. This information includes

The ADD CONNECTIONS command adds CONNECTIONS class

data for all currently enabled fieldsin 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.

You 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 original fields
are once again displayed. 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

comun> aop comections
This command adds CONNECTIONS class information to the display. This
information includes all enabled CONNECTIONS class fields.

cowuno> aop comnecTzons/TYpE-opEN
This command adds all Open connections to the SHOW CLUSTER display.

SHCL-26

SHOW CLUSTER
ADD CONNECTIONS

COMMAND> REMOVE CONNECTIONS
COMMAND> ADD SCS_STATE
COMMAND> REMOVE CONNECTIONS

COMMAND> ADD CONNECTIONS
The ADD CONNECTIONS command adds CONNECTIONS class
information to the SHOW CLUSTER display. The first command 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.

SHCL-27

SHOW CLUSTER
ADD COUNTERS

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

FORMAT

ADD COUNTERS

command

None.

parameters

command

qualifier

JALL

Specifies that all fields in this class 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 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.
You 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 original fields are once again
displayed. 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

cowuwns oo coonrers

This command adds COUNTERS class information to the display. This
information includes all enabled COUNTERS class fields.

COMMAND> ADD MSGS_SENT
COMMAND> REMOVE COUNTERS

COMMAND> ADD COUNTERS

The ADD COUNTERS command in this example 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.

SHCL-28

SHOW CLUSTER
ADD CREDITS

ADD CREDITS
Adds all currently enabled CREDITS class fields to the SHOW

CLUSTER display.

FORMAT

ADD CREDITS

command

None.

parameters

command
qualifier

/ALL

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

You 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 original fields are once again displayed. 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
‘COMMAND> ADD CREDITS

This command adds CREDITS class information to the display. This
information includes all enabled CREDITS class fields.
COMMAND> REMOVE CREDITS
COMMAND> ADD MIN_REC
COMMAND> REMOVE CREDITS

COMMAND> ADD CREDITS

The ADD CREDITS command in this example 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.

SHCL-29

SHOW CLUSTER
ADD ERRORS

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

FORMAT

ADD ERRORS

command

None.

parameters

command

/ALL

qualifier

Specifies that all fields in this class be added to the display. By default, ADD

ERRORS, used without any 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.
You 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 original fields are once again displayed. 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

cowu> a0 mmrors
This command adds ERRORS class information to the display. This

information includes all enabled ERRORS class fields.

comuw> Rexove Errors

COMMAND> ADD ERT_MAX
COMMAND> REMOVE ERRORS

COMMAND> ADD ERRORS
The ADD ERRORS command in this example 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.

SHCL-30

SHOW CLUSTER
ADD (Field)

ADD (Field)
Enables the display of specific fields of SHOW CLUSTER
information.

FORMAT

ADD field-name], . . . ]

command

field-name

parameters

Specifies one or more of the following fields of information to be added to the

display of a particular class.

CIRCUITS Class
Field Name

CABLE_STATUS

Description

Status of the circuit paths A and B. Crossed cables
are also noted. Possible displays:

CIR_STATE

Paths A and B are bad.

A-

Path A is good.

-B

Path B is good.

A-B

Paths A and B are good.

CROSSED

The cables are crossed.

The state of the virtual circuit. Possible displays:
CLOSED

The circuit is closed.

OPEN

The circuit is opened.

ST_REC

The circuit has a start received.

ST_SENT

The circuit has a start sent.

VC_FAIL

A virtual circuit failure is in
progress.

LPORT_NAME

The VAX/VMS device name of the local port
associated with the circuit (PAAO, PABO).

NUM_CONNECTIONS

The number of connections on the circuit between
the local and remote system.

REM_STATE

State of the remote port. Possible displays:
DISAB

The remote port is disabled.

ENAB

The remote port is enabled.

M_DISAB

The remote port is in maintenance
mode and is disabled.

M_ENAB

The remote port is in maintenance
mode and is enabled.

M_UNINIT

The remote port is in maintenance
mode and has not been initialized.

UNINIT

The remote port has not been
initialized.

SHCL-31

SHOW CLUSTER
ADD (Field)

Field Name

Description

RP_FUNCTIONS

Function mask of the remote port.

RPORT_NUM

The port number of the remote port associated
with the circuit.

RP_OWNER

Port number of the remote port owner.

RP_REVISION

Hardware and/or microcode revision number of the
remote port.

RP_TYPE

The type of the remote port associated with the
circuit. Possible displays:

C1780

The remote port is a CI780.

CI750

The remote port is a CI750.

HSC50

The remote port is an HSC50.

CINT

The remote port is a Cl node
tester.

PASSTH

The remote port is in passthrough
mode.

SCS_WAITERS

The number of connections waiting to send SCS
control messages on the virtual circuit.

CLUSTER Class
Field Name

Description

CL_QDVOTES

The number of quorum votes contributed by the
quorum disk.

CL_QUORUM

The maximum quorum of all current members plus

any previous CL_QUORUM value.
CL_VOTES

The total number of votes held by all cluster

members.
FORMED

The time at which the cluster was formed,

expressed as dd-mmm-yy hh:mm.
LAST_TRANSITION

The last time at which a system left or joined the
cluster, expressed as dd-mmm-yy hh:mm.

MEMSEQ

The membership state sequence number.

QD_NAME

The full device name of the quorum disk.

QF_VOTE

Indicates whether or not the quorum disk is
contributing any votes towards the cluster quorum.

SHCL-32

SHOW CLUSTER
ADD (Field)

CONNECTIONS Class
Field Name

Description

CON_STATE

The state of the connection. Possible displays:
ACCP_SENT

An accept request has been sent.

CLOSED

The connection is closed.

CON_ACK

A connect request has been sent

and acknowledged.

CON_REC

A connect request has been
received.

CON_SENT

DISC_ACK

A connect request has been sent.

A disconnect request is
acknowledged.

DISC_MTCH

DISC_REC

A disconnect request is matched.

A disconnect request has been
received.

DISC_SENT

A disconnect request has been
sent.

LISTEN

The connection is in the listen
state.

LOC_CONID

OPEN

The connection is open.

REJ_SENT

A reject has been sent.

VC_FAIL

A virtual circuit has failed.

Identification number of the local side of the
connection.

LOC_PROC_NAME

The name of the local process associated with the

connection.
REM_CONID

Identification number of the remote side of the
connection. This information does not apply for
connections in the listen state.

REM_PROC_NAME

The name of the remote process associated with
the connection. This information does not apply
for connections in the listen state.

SCS_STATE

SCS send blocked state. If the connection is

waiting to send an SCS control block message,
the SCS send blocked state indicates what kind of
message it is waiting to send. Possible displays:
ACCP_PEND

Waiting to send an accept request.

CLEAR

Not blocked.

CON_PEND

Waiting to send a connection
request.

CR_PEND

Waiting to send credit.

DCR_PEND

Waiting to send credit in
preparation for a disconnect.

DISC_PEND

Waiting to send a disconnect
request.

REJ_PEND

Waiting to send a reject request.

SHCL-33

SHOW CLUSTER
ADD (Field)

COUNTERS Class
Field Name

BDT_WAITS

Description

The number of times this connection had to wait
for a buffer descriptor.

BLKS_REQ

The number of block-request data commands
initiated to block transfer data from the remote
system to the local system.

BLKS_SENT

The number of block-send data commands.
initiated to block-transfer data from the local
system to the remote system .

CR_WAITS

The number of times this connection had to wait
for send credit.

DGS_DSCRD

The number of application datagrams discarded by
PADRIVER.

DGS_RCVD

The number of application datagrams received by
the local system over the connection from the
remote system and given to SYSAP.

DGS_SENT

The number of application datagrams sent over the
connection.

KB_MAPPED

The number of kilobytes of data mapped for block
transfer.

KB_RCVD

The number of kilobytes of data received by the
local system from the remote system through
request-data commands.

KB_SENT

The number of kilobytes of data sent from the local
system to the remote system through send-data
commands.

MSGS_RCVD

The number of application datagram messages
received over the connection.

MSGS_SENT

The number of application datagram messages
sent over the connection.

CREDITS Class
Field Name

Description

INIT_REC

The initial receive credit extended to the remote
system when the connection was made.

MIN_REC

The minimum receive credit (minimum send credit
required by the remote system).

MIN_SEND

The minimum send credit.

PEND_REC

The receive credit not yet extended to the remote
system.

RECEIVE

The receive credit (send credit held by the remote
system).

SEND

SHCL-34

The current send credit.

SHOW CLUSTER
ADD (Field)

ERRORS Class
Field Name

Description

ERT_COUNT

The number of port reinitialization attempts
remaining.

ERT_MAX

The total number of times a recovery from fatal
port errors can be attempted by shutting down all
virtual circuits and connections and reinitializing the
port.

NUM_ERRORS

The number of errors that have been logged on the
port since the system was booted. This number
includes errors encountered in reinitialization
attempts as well as recoverable errors, such as

virtual circuit failure. This is the same error count
as that displayed by the DCL command SHOW

DEVICE.

LOCAL _PORTS

class

Field Name

Description

BUFF_DESCR

The number of buffer descriptors in use.

CMDS_QUEUED

The total number of messages, datagrams, and
port commands queued for transmission at all

priorities by the port.

COUNTER_OWNER

The name of the process currently using the port
traffic counters.

DGI-MAP

A 16-bit bit map displayed as four hexadecimal
digits. Each bit in the map represents a port in the
cluster from which datagram reception has been
disabled.

DG_OVRHD_SIZE

The number of bytes of port header, SCS header,
and DECnet header in a datagram.

DGS_FREE

The number of free datagram buffers currently
queued for receive commands.

FORM_CIRCS

The number of formative circuits (circuits in the

FREE_BUFF

The number of Cl buffer descriptors free for use.

process of opening) from the port.

LB_STATUS

The loopback status of each cable from the port to

the star coupler. Possible displays:
A-B

Loopback tests pass on paths A
and B.

A-

Loopback tests pass on path A.

-B

Loopback tests pass on path B.

Loopback tests failed on paths A

and B.
N/A

Loopback tests are not being done.

SHCL-35

SHOW CLUSTER
ADD (Field)

Field Name

Description

LOG_MAP

A 16-bit bit map displayed as four hexadecimal
digits. Each bit in the map represents a port in the
cluster for which an error was logged. Errors are
logged when data provided by the configuration
database on the local system conflicts with data
provided by the remote system. When a conflict is
discovered and an error is logged, virtual circuits to
the remote system can no longer be established.

LP_STATUS

The status of the local port. Possible displays:
OFFLINE

The port is off line.

ONLINE

The port is on line.

LP_TYPE

The device type of the port (CI780, CI750, HSC).

MAX_PORT

The largest port number to which a virtual circuit
open is attempted.

MSGS_FREE

The number of free message buffers currently
queued for receives commands.

MSG_HDR_SIZE

The number of bytes of port header and SCS
header in a message.

NAME

The VAX/VMS device name of the local port.

OPEN_CIRCS

The number of virtual circuits open from the port.

POOL_WAITERS

The number of processes waiting for nonpaged
pool resources for message buffers.

PORT_NUM

The port number assigned to the port.

PRT_MAP

A 16-bit bit map displayed as three hexadecimal
digits. Each bit in the map represents a port in

the cluster that has been recognized by the host
system.

RSPS_QUEUED

The total number of responses of all kinds received
from the port but not yet processed.

MEMBERS Class

SHCL-36

Field Name

Description

ACK_LIM

The maximum number of VAXcluster messages
the remote system can receive before sending an
acknowledgment reply.

ACKR_SQ

The sequence number of the last acknowledgment
received over the VAXcluster connection.

SHOW CLUSTER
ADD (Field)

Field Name

Description

CNX_STATE

The state of the VAXcluster connection. Possible
displays:
ACCEPT

The initial connection is accepted.

CLOSED

The connection is closed.

CONNECT

The initial connection is being
accepted.

DEAD

No connection is possible.

DISCONNECT

A disconnection is in progress.

NEW

No attempt to make a connection
has been made yet.

OPEN

The connection is open.

REACCEPT

The connection is accepting the
reconnect request.

RECONNECT

The connection is attempting to
reconnect.

WAIT
CcsiD

A ti_msoul is in progress.

The cluster system identification number.

This

number is unique over the life of the cluster. Unlike
SYS_ID, this identification number may change
when the system reboots.

DIR_WT

The lock manager distributed directory weight.

PROTOCOL

The protocol version number and ECO level of the
connection management software.

QDVOTES

The number of votes the remote system
recommends be contributed by the quorum disk.
Normally, the cluster manager sets this number

using the SYSGEN parameter QDSKVOTES.
QF_ACTIVE

Indicates whether the remote system’s quorum file
is accessible.

QF_SAME

Indicates whether the local and remote systems
agree about which disk is the quorum disk.

QUORUM

The recommended quorum value set for the
remote system. Normally, the cluster manager
sets the recommended quorum value for a node

using the SYSGEN parameter QUORUM.
RCVD_SQ

The sequence number of the last message received
over the VAXcluster connection.

SEND_SQ

The sequence number of the next message to be
sent over the VAXcluster connection.

SHCL-37

SHOW CLUSTER
ADD (Field)

Field Name
STATUS

Description
The status of the node in the cluster. Possible
displays:

blank

The system is not being considered
as a cluster member.

BRK_MEM

The system is a member of the
cluster, but the connection manager

has lost communication with it.

BRK_NEW

The system has just booted, but
has not yet joined the cluster and
the connection manager has lost
communication with it.

BRK_NON

The connection manager has lost
communication with the system
and the system is no longer a
member of the cluster.

BRK_REM

The connection manager has lost
communication with the system,

and the system has been removed
from the cluster.

MEMBER

The system is participating in
the cluster. (A default SYSGEN
parameter allows a 90-second
delay before a failing system is
removed from cluster membership

status.)
NEW

The system has just booted, but
has not yet joined the cluster. If

this system would normally be
a member of the cluster and is

displaying NEW in this field, you
can expect that the display will
eventually change to MEMBER.

NON

The system is not a member of the
cluster.

REMOVED
TRANSITION_TIME

The system has been removed
from the cluster.

The time of the system’s last change in

membership status (see the STATUS field).
UNACKED

The number of unacknowledged VAXcluster
messages received by the remote system.

VOTES

The number of votes the remote node contributes
toward quorum. Normally, the cluster manager
sets this number with the SYSGEN parameter
VOTES.

'WARMCDRPS

SHCL-38

The number of CDRPs on the CDRP free queue.

SHOW CLUSTER
ADD (Field)

SYSTEMS Class (for CLUSTER report)
Field Name

Description

DG_SIZE

The maximum number of bytes of application data

HW_TYPE

The system hardware type (V780, V785, V750,

HW_VERS

The revision level of the computer interconnect

in datagrams sent over the circuit.

HS50).

hardware on the remote system.

INCARNATION

A unique 16-digit hexadecimal number established

INCN_TIME

The incarnation number expressed as a time

when the system is booted.
(dd-mmm-yy hh:mm).
MSG_SIZE

The maximum number of bytes of application data
in messages sent over the circuit.

NODE

The node name of the remote system. Normally,
the cluster manager sets the node name using the

SYSGEN parameter SCSNODE. The node name
should be the same as the DECnet node name.
NUM_CIRCUITS

The number of virtual circuits between the local
system and remote systems.

SOFTWARE

The name and version of the operating system

SYS_ID

The identification number of the remote system.

currently running on the remote system.

Normally, the cluster manager sets this number
using the SYSGEN parameters SCSSYSTEMID and

SCSSYSTEMIDH. This number should be the same
as the DECnet node number.

If you specify more than one field name, insert a comma between each one
and the next.

command
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.
To remove a field from the SHOW CLUSTER display, use the REMOVE
(Field) command.

EXAMPLES

COMMAND> ADD SEND
This command enables the CREDITS class field SEND and adds it to the
SHOW CLUSTER display.

SHCL-39

SHOW CLUSTER
ADD (Field)

comunn> app 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.

SHCL-40

SHOW CLUSTER
ADD LOCAL_PORTS

ADD LOCAL_PORTS
Adds all currently enabled LOCAL _PORTS
CLUSTER display.

FORMAT

ADD LOCAL_PORTS

command

None.

class fields to the SHOW

parameters

command

qualifier

/ALL

Specifies that all fields in this class 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

NAME, STATUS, PORT_NUM (port number), DGS_FREE (free datagrams

queued), and MSGS_FREE (free messages queued),OPEN_CIRCS (open
circuits), FORM_CIRCS (formative circuits) fields are enabled. For a list of

valid LOCAL _PORTS

class fields, see the ADD (Field) command.

You use the ADD LOCAL _PORTS command together 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 original fields
are once again displayed. 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.
e
—

EXAMPLES

]

COMMAND> ADD LOCAL_PORTS
This command adds LOCAL _PORTS
information includes all enabled

class information to the display. This

LOCAL _PORTS

class fields.

COMMAND> REMOVE LOCAL_PORTS

COMMAND> ADD LB_STATUS
COMMAND> REMOVE LOCAL_PORTS

COMMAND>

ADD LOCAL_PORTS

The ADD LOCAL _PORTS command in this example 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.

SHCL—41

SHOW CLUSTER
ADD MEMBERS

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

FORMAT

ADD MEMBERS

command

None.

parameters

command
qualifier

/ALL

DESCRIPTION

The ADD MEMBERS command adds MEMBERS class information to the

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

SHOW CLUSTER display. This information includes data for all currently
enabled fields in the MEMBERS class. By default, the STATUS field is
enabled. For a list of valid MEMBERS class fields, see the ADD (Field)
command.

You use the ADD MEMBERS command together 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 original fields are once again displayed.
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
0

comwms> o wpisers
The command in this example adds MEMBERS class information to the
display. This information includes all enabled MEMBERS class fields.
COMMAND> REMOVE MEMBERS
COMMAND> ADD VOTES
COMMAND> REMOVE MEMBERS

COMMAND> ADD MEMBERS

The ADD MEMBERS command in this example 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.

SHCL-42

SHOW CLUSTER
ADD SYSTEMS

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

FORMAT

ADD SYSTEMS [/qualifier], . . . ]|

command

None.

parameters

command

qualifier

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

/ID = system-id
Specifies, by system identification number, systems to be added to the SHOW
CLUSTER display. The system-id number can be any system-id as displayed
in the SYSID field of the SYSTEMS class.
The /ID qualifier affects all information displayed about the specified system,

not just information in the SYSTEMS class display.

/NODE=node-name

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

/TYPE=hardware-type
Specifies, by hardware type, systems to be added to the SHOW CLUSTER
display. You can specify any of the following hardware types:
®

V750 for VAX-11/750 systems

V780 for VAX-11/780 systems

V785 for VAX-11/785 systems

HS50 for HSC50 systems

8200 for VAX 8200 systems

8600 for VAX 8600 systems

The /TYPE qualifier affects all information displayed about the specified
hardware type, not just information in the SYSTEMS class display.
L
]

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 NODE and SOFTWARE
fields are enabled. For a list of valid SYSTEMS class fields, see the ADD
(Field) command.

SHCL-43

SHOW CLUSTER
ADD SYSTEMS

You use the ADD SYSTEMS command together 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 original fields are once again displayed. 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

comunos a0 svstans
This command adds SYSTEMS class information to the display. This
information includes all enabled SYSTEMS class fields.

comumms ADD SYSTEMS/NODE=MISHA
This command adds the node MISHA to the SHOW CLUSTER display
reporting all currently enabled information about the node.

conmms REMOVE SYSTEMS
(COMMAND> ADD SYS_ID

COMMAND> REMOVE SYSTEMS

COMMAND> ADD SYSTEMS

The ADD SYSTEMS command in this example 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.

SHCL-44

SHOW CLUSTER
DEFINE/KEY

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

command

key-name

parameter

Specifies the name of the key that you are defining. Use the following key
names when defining keys:

Key Name

LK201

VT100-Type

VT52

PF1

[blue]

PF2

[red]

PF3

PF4

PF3

PF4

[gray]

KPO, KP1 through KPS

0O, 1 through 9

0, 1through9

0O, 1 through 9

PERIOD

COMMA

n/a

MINUS

n/a

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

F17 through F20

PF4

You cannot redefine the arrow keys or the function keys 1 through 14.

equivalence-string

Specifies the string which is 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.

SHCL-45

SHOW CLUSTER
DEFINE/KEY

command
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 /IE_STATE qualifier or use
/NOIE_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 only be specified 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, you can use the SET KEY command 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.

SHCL-46

SHOW CLUSTER
DEFINE/KEY

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.
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 will want to create a state name that is easy to
remember and type and, if possible, one that might remind you of the types

of definitions you created for that state.
o

—————

EXAMPLE
COMMAND>

DEFINE/KEY PF3 "LOCAL_PORT"/NOTERMINATE

The DEFINE/KEY command defines the PF3 key on the keypad to output the

"LOCAL _PORT"” text string. This key could be used with the ADD key to
form the ADD LOCAL _PORT command.

SHCL-47

SHOW CLUSTER
DESELECT

DESELECT
Terminates the selection of a previously selected window.

FORMAT

DESELECT

command

None.

parameters

command
qualifiers

None.

e
—

EXAMPLE
COMMAND> SELECT
COMMAND> MOVE RIGHT 10

COMMAND> DESELECT

In this example, the SELECT command selects a window and highlights it. A
MOVE operation is then performed on the selected window. The DESELECT

command terminates the selection and moves the window to its new position.
If you enter another SELECT command, it automatically deselects and moves
the previously selected window.

SHCL-48

SHOW CLUSTER
EXIT

EXIT
Terminates the SHOW CLUSTER display and returns control to the
DCL command level. You can also type CTRL/C or CTRL/Z to exit
at any time.

FORMAT

EXIT

command

None.

parameters

command

None.

qualifiers

EXAMPLE
COMMAND> EXIT

This command terminates the SHOW CLUSTER display and returns control
to the DCL command level.

SHCL—49

SHOW CLUSTER
HELP

HELP
Provides online help information for using the SHOW CLUSTER
commands, parameters, and qualifiers.

FORMAT

HELP [keyword . .. ]

command

keyword

parameter

Specifies the command, parameter, or qualifier for which help information is
to be displayed. If you omit the keyword, HELP displays a list of available
help topics, and prompts you for a particular keyword.

command
qualifiers

None.

EXAMPLES
0

coswm> wewe mirtiaize
The command in this example displays help information about the SHOW
CLUSTER command, INITIALIZE.

comum> weee rieras
The command in this example displays help information about the valid field
names that can be specified with the ADD, REMOVE, and SET commands.

SHCL-50

SHOW CLUSTER
INITIALIZE

INITIALIZE
Resets the display using the 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.

FORMAT

INITIALIZE

command

None.

parameters

command
qualifiers

None.

EXAMPLE
COMMAND> INITIALIZE

This command resets the current display to the default display and restores
any systems that were removed from the display.

SHCL-51

SHOW CLUSTER
MOVE

MOVE
Moves a selected window to a specified position.

FORMAT

MOVE

direction value

command

direction

parameter

Direction in which the window is to be moved. 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 columns or lines the window is to be moved. You must specify a

numeric value from 1 to 512. If you do not enter a number for this parameter,
SHOW CLUSTER prompts you for one.

command

None.

qualifiers
R

DESCRIPTION

The MOVE command allows you to manually reposition a window on
the display screen.

You must first issue the command SET AUTO_

POSITIONING OFF, which disables the default automatic positioning
of windows. Then select a window to be moved by using the SELECT
command.

To move a selected window, you either enter MOVE commands at the
command prompt, or use the arrow keys defined as MOVE commands.

Issuing the command SET FUNCTION MOVE redefines the T, | , — , and «
arrow keys as MOVE UP 1, MOVE DOWN 1, MOVE RIGHT 1, and MOVE

LEFT 1, respectively.
Note: The SET FUNCTION MOVE command implicitly sets AUTO_
POSITIONING to OFF.

When you issue a MOVE command, the window changes position by column
(horizontally), or by line (vertically). An empty frame appears around the
new window position. When you are satisfied with the position of the
window, issue the DESELECT command, which moves the window to the

new position. Entering another SELECT command before the previous
window has been deselected also moves the window to its new position.

SHCL-52

SHOW CLUSTER
MOVE

EXAMPLE
COMMAND> SET AUTO_POSITIONING OFF

COMMAND> SELECT CLUSTER
COMMAND> MOVE RIGHT 10
COMMAND> DESELECT

This command sequence moves the CLUSTER window ten columns to the
right.

SHCL-53

SHOW CLUSTER
PAN

PAN
Pans the display screen.

FORMAT

PAN

direction value

command

direction

parameter

Direction in which the display is to be panned. 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 columns or lines the display is to be panned. You must specify a
numeric value from 1 to 512. If you do not enter a number for this parameter,
SHOW CLUSTER prompts you for one.

command

None.

qualifiers

DESCRIPTION

PAN commands pan the entire display by column (horizontally) and by line
(vertically). The PAN command functions in a way similar to the panning
of a video camera. By issuing PAN commands, a portion of the display that
extends beyond the limits of the screen can be brought into view.
The display moves in the opposite direction from that specified by the PAN
command. In other words, a PAN LEFT 10 command moves the display
10 columns to the right, similar to the effect of panning a camera over a
landscape.
To pan the display, either enter PAN commands at the command prompt, or

use the arrow keys defined as PAN commands. Issuing the command SET
FUNCTION PAN redefines the T, | , — , and — arrow keys as PAN UP 1,
PAN DOWN 1, PAN RIGHT 1, and PAN LEFT 1, respectively.
Note: If you set the function to PAN, the arrow keys are no longer defined to

perform DCL line-mode editing. Only one function can be enabled at a
time.

EXAMPLE
COMMAND> PAN DOWN 10

This command sequence pans the display ten lines.

SHCL-54

SHOW CLUSTER
REFRESH

REFRESH
Clears the screen, removes extraneous characters, and updates all
fields. Entering CTRL/W has the same effect as typing REFRESH.

FORMAT

REFRESH

command

None.

parameters

command

None.

qualifiers

EXAMPLE
COMMAND> REFRESH

This command clears the screen, removes extraneous characters, and updates
all fields.

SHCL-55

SHOW CLUSTER
REMOVE CIRCUITS

REMOVE CIRCUITS
Removes CIRCUITS class information from the SHOW CLUSTER
display.

FORMAT

REMOVE CIRCUITS [/qualifier], . . . ]

command

None.

parameters

command

qualifiers

/TYPE=ALL
Specifies that all types of circuits on each system be removed from the

display, including formative, open, and closing circuits. If you specify the
REMOVE CIRCUITS command without any qualifiers, all types of circuits are

removed from the display by default.

/TYPE=OPEN
/TYPE=NOOPEN
Controls whether either open circuits or nonopen circuits are removed from

the display.

DESCRIPTION

The REMOVE CIRCUITS command removes CIRCUITS class information

from the SHOW CLUSTER display. CIRCUITS class information includes
data for all currently enabled fields in the CIRCUITS class. For a list of valid

CIRCUITS class fields, see the ADD (Field) command.

EXAMPLES

coowms revove cracurts
This command removes all currently enabled CIRCUITS class fields from the
display.

coowm> revove crrourrs/TYPE-OPEN
This command removes all open circuits from the display.

SHCL-56

SHOW CLUSTER
REMOVE CLUSTER

REMOVE CLUSTER
Removes CLUSTER class information from the SHOW CLUSTER
display.

FORMAT

REMOVE CLUSTER

command

None.

parameters

command
qualifiers

None.

DESCRIPTION

The REMOVE CLUSTER command removes CLUSTER class information

from the SHOW CLUSTER display. CLUSTER class information includes
data for all currently enabled fields in the CLUSTER class. For a list of valid
CLUSTER class fields, see the ADD (Field) command.

EXAMPLE
COMMAND> REMOVE CLUSTER

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

SHCL-57

SHOW CLUSTER
REMOVE CONNECTIONS

REMOVE CONNECTIONS
Removes CONNECTIONS class information from the SHOW

CLUSTER display.

FORMAT

REMOVE CONNECTIONS [/qualifier], . . . ]|

command

None.

parameters

command
qualifiers

/TYPE=ALL
Specifies that all types of connections on each circuit be removed from

the SHOW CLUSTER display. If you specify the ADD CONNECTIONS
command without any qualifiers, all connections are removed from the

display by default.

/TYPE=OPEN
/TYPE=NOOPEN
Controls whether either open connections or nonopen connections are
removed from the SHOW CLUSTER display.

DESCRIPTION

The REMOVE CONNECTIONS command removes CONNECTIONS
class information from the SHOW CLUSTER display. CONNECTIONS
class information includes data for all currently enabled fields in the
CONNECTIONS class. For a list of valid CONNECTIONS class fields,
see the ADD (Field) command.

EXAMPLES

cows revove comecrions
The command in this example removes all currently enabled CONNECTIONS
class fields from the SHOW CLUSTER display.

coewms REvOVE convECTIONS/TYPE-OPEN
The command in this example removes all OPEN connections from the
SHOW CLUSTER display.

SHCL-58

SHOW CLUSTER
REMOVE COUNTERS

REMOVE COUNTERS
Removes COUNTERS class information from the SHOW CLUSTER
display.

FORMAT

REMOVE COUNTERS

command

None.

parameters

command

None.

qualifiers

S
—

DESCRIPTION The REMOVE COUNTERS command removes COUNTERS class information
from the SHOW CLUSTER display. COUNTERS class information includes
data for all currently enabled fields in the COUNTERS class. For a list of
valid COUNTERS class fields, see the ADD (Field) command.

EXAMPLE
COMMAND> REMOVE COUNTERS

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

SHCL-59

SHOW CLUSTER
REMOVE CREDITS

REMOVE CREDITS
Removes CREDITS class information from the SHOW CLUSTER

display.

FORMAT

REMOVE CREDITS

command

None.

parameters

None.

command
qualifiers
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 the ADD (Field) command.

EXAMPLE
COMMAND> REMOVE CREDITS

This command removes all currently enabled CREDITS class fields from the

SHOW CLUSTER display.

SHCL-60

SHOW CLUSTER
REMOVE ERRORS

REMOVE ERRORS
Removes ERRORS class information from the SHOW CLUSTER

display.

FORMAT

REMOVE ERRORS

command

None.

parameters

command

None.

qualifiers

—
O

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 the ADD (Field) command.

EXAMPLE
COMMAND> REMOVE ERRORS

This command removes all currently enabled ERRORS class fields.

SHCL-61

SHOW CLUSTER
REMOVE (Field)

REMOVE (Field)
Disables the display of specific fields of SHOW CLUSTER

information.
R

FORMAT

REMOVE

——————————————

field-name], . . . ]

command

field-name

parameter

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 and the next. For a list of valid field names, see the ADD
(Field) command description.

command

None.

qualifiers
o

EXAMPLES
COMMAND> REMOVE SOFTWARE

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

comums reove SOFTWARE, RP_TYPE, CON_STATE
The command in this example removes the SOFTWARE, RP_TYPE, and

CON_STATE fields from the SHOW CLUSTER display.

SHCL-62

SHOW CLUSTER
REMOVE LOCAL_PORTS

REMOVE LOCAL_PORTS
Removes LOCAL _PORTS
CLUSTER display.

class information from the SHOW

FORMAT

REMOVE LOCAL _PORTS

command

None.

parameters

command
qualifiers

None.

DESCRIPTION The REMOVE LOCAL_PORTS command removes LOCAL _PORTS class
information. For a list of valid LOCAL _PORTS

class fields, see the ADD

(Field) command.

EXAMPLE
COMMAND> REMOVE LOCAL_PORTS

This command removes all currently enabled LOCAL _PORTS
from the LOCAL _PORTS display.

class fields

SHCL-63

SHOW CLUSTER
REMOVE MEMBERS

REMOVE MEMBERS
Removes MEMBERS class information from the SHOW CLUSTER
display.

FORMAT

REMOVE MEMBERS

command

None.

parameters

command
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 the ADD (Field) command.

EXAMPLE
COMMAND> REMOVE MEMBERS

This command removes all currently enabled MEMBERS class fields from the

SHOW CLUSTER display.

SHCL-64

SHOW CLUSTER
REMOVE SYSTEMS

REMOVE SYSTEMS
Removes SYSTEMS class information from the SHOW CLUSTER

display.

FORMAT

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

command

None.

parameters

command
qualifiers

/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 SYSID 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=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=hardware-type

Specifies, by hardware type, systems to be removed from the SHOW
CLUSTER display. You can specify any of the following hardware types:

V750 for VAX~11/750 systems

V780 for VAX-11/780 systems

V785 for VAX-11/785 systems

HS50 for HSC50 systems

8200 for VAX 8200 systems

8600 for VAX 8600 systems

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 the ADD (Field) command.

SHCL-65

SHOW CLUSTER
REMOVE SYSTEMS

EXAMPLES

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

comuns revove svsens/TrpE-v7s0
This command removes all VAX-11/780 systems from the SHOW CLUSTER
display.

SHCL-66

SHOW CLUSTER
SAVE

SAVE
Allows you to build a command procedure based on the current

display. You can then use the command procedure to format
subsequent displays.

FORMAT
command

SAVE [file-spec]

file-spec

parameter

File specification of the command file. The file name defaults to SHOW_
CLUSTER.COM. Since the file is an ASCII file, you can edit it.

command

None.

qualifiers

e
——

DESCRIPTION

The SAVE command allows you to build a command procedure that you can
use in subsequent SHOW CLUSTER sessions. To use the SAVE command:
1

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.

The file that results from the SAVE command is an ASCII file. You can

edit the file to add comments or to improve its efficiency. In some cases, a
particular command procedure may not be as efficient as possible because the
commands that the SAVE command builds are restricted to one record. 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 in the circuit class:

ADD CIRCUITS/ALL
RENMOVE RP_TYPE

Subsequently using 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
, NUN_CONNECTIONS, CIR_STATE
ADD REM_STATE,CABLE_STATUS,RP_REVISION,RP_FUNCTIONS,SCS_WAITERS

SHCL-67

SHOW CLUSTER
SAVE

EXAMPLE
COMMAND> ADD CLUSTER

COMMAND> REMOVE SOFTWARE
COMMAND> SAVE

The first two commands 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

SHCL-68

SHOW CLUSTER
SCROLL

Scrolls a selected window.

FORMAT

SCROLL direction value

command

direction

parameter

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 512. If you do not enter a number for this parameter,

SHOW CLUSTER prompts you for one.

command
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, you must first select a window by issuing the SELECT
command. The selected window is highlighted. You issue SCROLL

commands either by entering them at the command line or by pressing
the arrow keys. Issuing the command SET FUNCTION SCROLL redefines
the t, |, —, and « 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 5CS
COMMAND> SCROLL UP 10
COMMAND> DESELECT

This command sequence scrolls the SCS window up ten lines.

SHCL-69

SHOW CLUSTER
SELECT

SELECT
Selects a window to be scrolled or moved.
e
——

FORMAT
command

SELECT [window-name]

window-name

parameter

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

command

None.

qualifiers

DESCRIPTION

You select a window either byissuing 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 issue 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 is highlighted. When the last window in the cycle has been selected,
pressing the SELECT key another time begins the cycle again.
You use the SELECT command to identify a window to be moved or scrolled.
By default, no window is selected and the function is set to EDIT. For more
information, see the SET FUNCTION, SCROLL, and MOVE commands.

EXAMPLE
COMMAND> SELECT LOCAL_PORTS

This command sequence selects the

LOCAL _PORTS window. You can then

perform a MOVE or SCROLL operation on the selected window.

SHCL-70

SHOW CLUSTER
SET AUTO_POSITIONING

SET AUTO_POSITIONING
Enables or disables the automatic positioning of windows within a

display.

FORMAT

SET AUTO_POSITIONING

keyword

command

keyword

parameter

Specifies whether or not windows are automatically positioned within a

display. By default, SHOW CLUSTER operates with AUTO_POSITIONING
enabled. Valid keywords are:
ON

OFF

None.

command
qualifiers
DESCRIPTION

By default, SHOW CLUSTER automatically positions windows based on their
size 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 control the position

of a window within the display. When you use MOVE commands to
position a selected window manually, the windows are allowed to overlap.
For additional information on moving windows, see the MOVE and SET
FUNCTION commands and Section 3.5.3.

Note: Setting the function to MOVE implicitly disables AUTO_POSITIONING.

EXAMPLE
COMMAND> SET AUTO_POSITIONING OFF

COMMAND> SELECT CLUSTER
COMMAND> MOVE RIGHT &
COMMAND> MOVE DOWN

COMMAND> DESELECT

This command sequence disables AUTO_POSITIONING, selects the
CLUSTER window, and moves it to a new position in the display.

SHCL-71

SHOW CLUSTER
SET (Field)

SET (Field)
Modifies the characteristics of particular fields within the display.

FORMAT

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

command

field-name

parameter

Specifies the name of the field to be modified in the display. For a list of field
names, see the ADD (Field) command.

command

qualifiers

/WIDTH = field-width

Specifies the number of columns used to display the specified field. This

qualifier lets you shrink the display to allow room for more fields or expand
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.
Changing the field format, however, does not change the field width until
you specify the next SET (Field) command.
The hardware version field (HW_VERSION) is always displayed in 24
hexadecimal digits.

EXAMPLE
COMMAND> SET SYSID/FORMAT=HEXADECIMAL

This command sets the format of the SYSID field to a hexadecimal display.

SHCL-72

SHOW CLUSTER
SET FUNCTION

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

FORMAT

SET FUNCTION

command

function-name
Specifies the SHOW CLUSTER function to be enabled. By default, the EDIT

parameter

function-name

function is enabled. Functions include:
EDIT

MOVE
PAN

SCROLL

None.

command

qualifiers
e

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 issued command or perform DCL
line-mode editing at the command prompt. (See the VAX/VMS DCL Concepts
Manual for more information on DCL line-mode editing.)
To enable one of the SHOW CLUSTER functions, you either issue 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.
=

EXAMPLE
COMMAND> SET FUNCTION MOVE
COMMAND> SELECT SCS
COMMAND> MOVE RIGHT 10
COMMAND> DESELECT

COMMAND> SET FUNCTION SCROLL

This command sequence sets the function to MOVE and moves the SCS

window 10 columns to the right. The window is then deselected, and the
function is set to SCROLL. The arrow keys are now redefined to function as

SCROLL commands.

SHCL-73

SHOW CLUSTER
SET INTERVAL

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 on the
SHOW CLUSTER command, the time specified becomes the default.

FORMAT

SET INTERVAL=seconds

command

seconds

parameter

The number of seconds between display updates.

command

None.

qualifiers

EXAMPLE
COMMAND> SET INTERVAL=5

This command changes the display interval time to five seconds.

SHCL-74

SHOW CLUSTER
SET SCREEN

SET SCREEN
Sets the terminal to a display of up to 512 columns. This command
can be used only on a DIGITAL-compatible terminal.

FORMAT
command

SET SCREEN=screen-width
screen-width

parameter

Specifies the width of the screen display. You can specify a value up to 512.

command

None.

qualifiers

EXAMPLE
COMMAND> SET SCREEN=132

This command sets the screen width to 132 columns.

SHCL-75

SHOW CLUSTER
WRITE

WRITE
Outputs the current display to a file which can be printed on a
hardcopy device.

FORMAT

WRITE [file-spec]

command

file-spec

parameter

File specification of the printable output file. By default, the output filename
is SHOW_CLUSTER.LIS.

command
qualifiers

/ALL
Indicates that the output file should contain a display consisting of all
classes and all fields. Because SHOW CLUSTER may not currently have
the information necessary to display all the possible fields when you specify
/ALL qualifier, a display update occurs prior to the output of the file. As a
result, the output file may differ from the display currently on the terminal
screen.

You should use the /ALL qualifier to produce an output file or hardcopy file
when reporting a cluster-related problem to DIGITAL.

EXAMPLE
COMMAND> WRITE/ALL

This command creates a file, SHOW_CLUSTER.LIS, which contains all

possible SHOW CLUSTER fields. SHOW_CLUSTER.LIS can be printed on a
hardcopy device.

SHCL-76

Index
/CONTINUOUS qualifier ® SHCL-17

COUNTERS class ® SHCL-34
CREDITS class ® SHCL-34

ADD (Field) command ® SHCL-31 to SHCL-40
CIRCUITS class ® SHCL-31 to SHCL-32

CLUSTER class® SHCL-32

CTRL/C command ® SHCL-3
CTRL/Y command ® SHCL-3
CTRL/Z command ® SHCL-3

CONNECTIONS class ® SHCL-33
COUNTERS class ® SHCL-34
CREDITS class ® SHCL-34
description ® SHCL-39
ERRORS class ® SHCL-35

Data field ® SHCL-4

examples ® SHCL-39
LOCAL _PORTS class ® SHCL-35 to SHCL-36
MEMBERS class ® SHCL-36 to SHCL-38
SYSTEMS class ® SHCL-39
ADD CIRCUITS command ® SHCL-23
ADD CLUSTER command ® SHCL-25

ADD CONNECTIONS command ® SHCL-26

DEFINE/KEY command ® SHCL-45
DESELECT command ® SHCL-48

Display
controlling ® SHCL-5 to SHCL-14
formatting considerations
® SHCL-9 to SHCL-11
refreshing the screen® SHCL-11

ADD COUNTERS command ® SHCL-28
ADD CREDITS command ® SHCL-29
ADD ERRORS command ® SHCL-30
ADD LOCAL _PORTS command ® SHCL-41
ADD MEMBERS command ® SHCL-42
ADD SYSTEMS command ® SHCL-43

AUTO_POSITIONING command ® SHCL-10

/ENDING qualifier ® SHCL-18
ERRORS class ® SHCL-35
Execute Procedure (@) command ® SHCL-22
usage summary ® SHCL-14
EXIT command ® SHCL-49

/BEGINNING qualifier * SHCL-16
Broadcast message ® SHCL-12

HELP command ¢ SHCL-60

C
CIRCUITS class ® SHCL-31 to SHCL-32
Class of data

Initialization file

description ® SHCL-4

creating® SHCL-12 to SHCL-13

CLUSTER class ® SHCL-32

default file type ® SHCL-12

Command procedure

SHOW_CLUSTERSINIT ® SHCL-12 to SHCL-13

default file type ® SHCL-14

INITIALIZE command ® SHCL-51

description ® SHCL-13 to SHCL-14

/INTERVAL qualifier ® SHCL-19

example ® SHCL-13
nesting® SHCL-13

SHOW_CLUSTERSINIT

SHCL-13

CONNECTIONS class ® SHCL-33

Index—1

SCROLL command ® SHCL-10, SHCL-69

SELECT command ® SHCL-70
SET (Field) command ® SHCL-72

LOCAL _PORTS class ® SHCL-35 to SHCL-36

SET AUTO_POSITIONING command ® SHCL-71

SET FUNCTION command
® SHCL-73
SET INTERVAL command ® SHCL-74
SET SCREEN command ® SHCL-75

SHOW_CLUSTERSINIT
See Initialization file
MEMBERS class
® SHCL-36 to SHCL-38

MOVE command ® SHCL-562

SHOW CLUSTER
command ® SHCL-1

controlling the display
® SHCL-5 to SHCL-14
creating a command procedure
® SHCL-13 to
SHCL-14

creating an initialization file® SHCL-12 to SHCL13

/OUTPUT qualifier * SHCL-20

directing output® SHCL-1
entering commands ® SHCL-6
exiting ® SHCL-1
format ® SHCL-1

formatting the display
® SHCL-11

invoking ® SHCL-1, SHCL-3
PAN command ® SHCL-11, SHCL-54

modifying display size ® SHCL-9
moving a window ® SHCL-10
privileges
® SHCL-1
prompt® SHCL-6

receiving broadcast messages® SHCL-12
report® SHCL-3 to SHCL-5

Qualifier

SHOW CLUSTER command® SHCL-14 to SHCL20

® SHCL-1
restrictions
terminating ® SHCL-3
viewing the display ® SHCL-11

SHOW CLUSTER command
® SHCL-20 to SHCL-76
/BEGINNING qualifier ® SHCL-16

/CONTINUOUS qualifier * SHCL-17
/ENDING qualifier* SHCL-18

REFRESH command ® SHCL-565
REMOVE (Field) command ® SHCL-62

REMOVE CIRCUITS command ® SHCL-56
REMOVE CLUSTER command ® SHCL-57
REMOVE CONNECTIONS command ® SHCL-58

REMOVE COUNTERS command ® SHCL-59
REMOVE CREDITS command ® SHCL-60

/INTERVAL qualifier® SHCL-19

JOUTPUT qualifier * SHCL-20

Startup initialization file ® SHCL-12 to SHCL-13
creating ® SHCL-12 to SHCL-13
default file type ® SHCL-12

® SHCL-13
example
SYSTEMS class ® SHCL-39

REMOVE ERRORS command ® SHCL-6
1

REMOVE LOCAL _PORTS command ® SHCL-63
REMOVE MEMBERS command ® SHCL-64

REMOVE SYSTEMS command ® SHCL-65

W
WRITE command ® SHCL-76

S
SAVE command ® SHCL-67

Index—2

VAX/VMS

Show Cluster Utility
Reference Manual
AA-Z430B-TE
L
]

“EADER'S

COMMENTS

Note: This form is for document comments only. DIGITAL will use comments
submitted on this form at the company’s discretion. If you require a written reply

and are eligible to receive one under Software Performance Report (SPR) service,
submit your comments on an SPR form.

Did you find this manual understandable, usable, and well organized? Please make suggestions for
improvement.

Did you find errors in this manual? If so, specify the error and the page number.

Please indicate the type of user/reader that you most nearly represent:

O
O
O
O

Assembly language programmer
Higher-level language programmer
Occasional programmer (experienced)
User with little programming experience

O Student programmer
O Other (please specify)

Name

Date

Organization
Street

City

State

Zip Code.
or Country

—

DoNotTear-Fold Hereand Tape —

—

— —

—

No Postage

— |

Necessary | |

if Mailed in the | |

United States

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO.33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

SSG PUBLICATIONS ZK1-3/J35
DIGITAL EQUIPMENT CORPORATION
110 SPIT BROOK ROAD
NASHUA, NEW HAMPSHIRE 03062-2698

—

Do Not Tear - Fold Here

—

Cut Along Dotted Line

—

VAX/VMS

Show Cluster Utility
Reference Manual
AA-Z430B-TE
e
—

READER’'S
COMMENTS

Note: This form is for document comments only. DIGITAL will use comments
submitted on this form at the company’s discretion. If you require a written reply
and are eligible to receive one under Software Performance Report (SPR) service,
submit your comments on an SPR form.

Did you find this manual understandable, usable, and well organized?

Please make suggestions for

improvement.

Did you find errors in this manual? If so, specify the error and the page number.

Please indicate the type of user/reader that you most nearly represent:

O
O
O
O
O
O

Assembly language programmer
Higher-level language programmer
Occasional programmer (experienced)
User with little programming experience
Student programmer
Other (please specify)

Name

Date

Organization
Street
City

State

Zip Code.
or Country

—

Do Not Tear- Fold Here and Tape

—

—_—_——

—

= =

No Postage
Necessary
if Mailed in the
United States

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO.33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

SSG PUBLICATIONS ZK1-3/J35
DIGITAL EQUIPMENT CORPORATION
110 SPIT BROOK ROAD
NASHUA, NEW HAMPSHIRE 03062-2698

Wl blhadbedd
o b bbbl bl
—

Do Not Tear- Fold Here

Cut Along Dotted Line

—

NOTES