HP OpenVMS Systems Documentation

Content starts here HP OpenVMS System Management Utilities Reference Manual

HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index


Chapter 20
Show Cluster Utility

20.1 SHOW CLUSTER Description

The OpenVMS Show Cluster utility (SHOW CLUSTER) monitors nodes in an OpenVMS Cluster and displays information about cluster-specific activity and performance. SHOW CLUSTER collects information from the System Communications Services (SCS) database, the connection management database, and the port database.

Table 20-1 shows the classes of data output by SHOW CLUSTER.

Table 20-1 Classes of SHOW CLUSTER Information
Class Description
CIRCUITS Describes information about the virtual circuits on a system, such as the local port name, the remote port type and number, the number of connections on the circuit, and the circuit state.
CLUSTER Displays general OpenVMS Cluster information, such as the time the cluster was formed, the last time a system joined or left the cluster, and the cluster quorum.
CONNECTIONS Describes connections established over a virtual circuit, such as the names of the local and remote processes, and the state of the connection.
COUNTERS Displays accumulated statistics on connection traffic, such as the number of application datagrams, and the number of application messages that have been sent or received.
CREDITS Displays the send and receive credits for each connection.
ERRORS Displays a count of errors that have occurred on each port, along with information related to reinitializing those ports.
LOCAL_PORTS Describes the local system interface to the OpenVMS Cluster, such as the name, number, and status of each port, and the number of entries in the queues associated with each port.
MEMBERS Contains node-specific information, such as each node's identification numbers, quorum status, and connection status.
SYSTEMS Lists information about all systems in the OpenVMS Cluster, such as the node identification numbers, node names, hardware types, and software versions.

Each class contains a number of fields of data. Table 20-2 through Table 20-10 list the fields of data in each class.

Table 20-2 CIRCUITS Class Fields
Field Name Description
CABLE_STATUS Status of the CI circuit paths A and B. Crossed cables are also noted. The field applies only to the CI. Possible displays are as follows:
- 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 Cables are crossed.
CIR_STATE State of the virtual circuit. Possible displays are as follows:
CLOSED Circuit is closed.
OPEN Circuit is open.
ST_REC Circuit has a start received.
ST_SENT Circuit has a start sent.
VC_FAIL Virtual circuit failure is in progress.
LD_CLASS The circuit's current capacity rating.
LPORT_NAME Device name of the local port associated with the circuit (PAA0, PAB0, PEA0).
MGT_PRIORITY Priority value assigned to the circuit by management action.
NUM_CONNECTIONS Number of connections on the circuit between the local and remote systems.
PRIORITY Circuit's current priority, which is the sum of the management priorities assigned to the circuit and the associated local port.
REM_STATE State of the remote port. Possible displays are as follows:
DISAB Remote port is disabled.
ENAB Remote port is enabled.
M_DISAB Remote port is in maintenance mode and is disabled.
M_ENAB Remote port is in maintenance mode and is enabled.
M_UNINIT Remote port is in maintenance mode and has not been initialized.
UNINIT Remote port has not been initialized.
RP_FUNCTIONS Function mask of the remote port.
RPORT_NUM Port number of the remote port associated with the circuit. The field applies only to CI.
RP_OWNER Port number of the remote port owner.
RP_REVISION Hardware or microcode revision number of the remote port.
RP_TYPE Type of remote port associated with the circuit. Examples of some possible types might include: CIMNA, KFMSA, SHAC, SII, BVPSSP (a BVP storage systems port), CI780, CI750, CIBCA-A and CIBCA-B, RF and TF devices (for example RF73 or TF85), HSC devices (for example, HSC65 or HSC90), Ethernet, PASSTH (port is in passthrough mode), and so on.
SCS_WAITERS Number of connections waiting to send SCS control messages on the virtual circuit.

Table 20-3 CLUSTER Class Fields
Field Name Description
CL_EXPECTED_VOTES The number of votes the cluster has ever seen -- or could see, as determined by the connection manager. The value is based on the maximum value of CL_EXPECTED_VOTES, the value for EXPECTED_VOTES that is specified by each node, and the sum of the cluster votes (CL_VOTES). CL_QUORUM is derived from CL_EXPECTED_VOTES.
CL_MEMBERS Number of processors participating in the cluster.
CL_QDVOTES Number of votes contributed by the quorum disk.
CL_QUORUM The number of votes that must be present for the cluster to function and permit user activity. CL_QUORUM is equal to (CL_EXPECTED_VOTES + 2) divided by 2.
CL_VOTES Total number of votes contributed by all members of the cluster at any point in time.
FORMED Time at which the cluster was formed, expressed as dd-mmm-yy hh:mm.
LAST_TRANSITION Last time at which a system left or joined the cluster, expressed as dd-mmm-yy hh:mm.
MEMSEQ Membership state sequence number, which changes whenever a node joins or leaves the cluster.
QD_NAME Full device name of the quorum disk.
QF_VOTE Indicates whether or not the quorum disk is contributing any votes towards the cluster quorum.

Table 20-4 CONNECTIONS Class Fields
Field Name Description
CON_STATE The state of the connection. Possible displays are as follows:
ACCP_SENT Accept request has been sent.
CLOSED Connection is closed.
CON_ACK Connect request has been sent and acknowledged.
CON_REC Connect request has been received.
CON_SENT Connect request has been sent.
DISC_ACK Disconnect request is acknowledged.
DISC_MTCH Disconnect request is matched.
DISC_REC Disconnect request has been received.
DISC_SENT Disconnect request has been sent.
LISTEN Connection is in the listen state.
OPEN Connection is open.
REJ_SENT Reject has been sent.
VC_FAIL Virtual circuit has failed.
LOC_CONID Identification number of the local side of the connection.
LOC_PROC_NAME 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 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 are as follows:
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.

Table 20-5 COUNTERS Class Fields
Field Name Description
BDT_WAITS Number of times this connection had to wait for a buffer descriptor.
BLKS_REQ Number of block-request data commands initiated to block transfer data from the remote system to the local system.
BLKS_SENT Number of block-send data commands initiated to block-transfer data from the local system to the remote system.
CR_WAITS Number of times this connection had to wait for send credit.
DGS_DSCRD Number of application datagrams discarded by the port driver.
DGS_RCVD Number of application datagrams received by the local system over the connection from the remote system and given to SYSAP.
DGS_SENT Number of application datagrams sent over the connection.
KB_MAPPED Number of kilobytes of data mapped for block transfer.
KB_RCVD Number of kilobytes of data received by the local system from the remote system through request-data commands.
KB_SENT Number of kilobytes of data sent from the local system to the remote system through send-data commands.
MSGS_RCVD Number of application datagram messages received over the connection.
MSGS_SENT Number of application datagram messages sent over the connection.

Table 20-6 CREDITS Class Fields
Field Name Description
INIT_REC Initial receive credit extended to the remote system when the connection was made.
MIN_REC Minimum receive credit (minimum send credit required by the remote system).
MIN_SEND Minimum send credit.
PEND_REC Receive credit not yet extended to the remote system.
RECEIVE Receive credit (send credit held by the remote system).
SEND Current send credit.

Table 20-7 ERRORS Class Fields
Field Name Description
ERT_COUNT Number of port reinitialization attempts remaining.
ERT_MAX 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 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.

Table 20-8 LOCAL_PORTS Class Fields
Field Name Description
BUFF_DESCR Number of buffer descriptors in use.
CMDS_QUEUED Total number of messages, datagrams, and port commands queued for transmission at all priorities by the port.
COUNTER_OWNER 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 Number of bytes of port header, SCS header, and DECnet header in a datagram.
DGS_FREE Number of free datagram buffers currently queued for receive commands.
FORM_CIRCS Number of formative circuits (circuits in the process of opening) from the port.
FREE_BUFF Number of CI buffer descriptors free for use.
LB_STATUS Loopback status of each cable from the port to the star coupler. The field applies only to CI. Possible displays are as follows:
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.
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_LD_CLASS Hard-coded capacity value of the port, based on the megabits/second rate of the interconnect of the port.
LP_PRIORITY Management priority assigned to the port.
LP_STATUS Status of the local port. The port is either on line or off line.
LP_TYPE Device type of the port (CI780, CI750).
MAX_PORT Largest port number to which a virtual circuit open is attempted.
MSGS_FREE Number of free message buffers currently queued for receives commands.
MSG_HDR_SIZE Number of bytes of port header and SCS header in a message.
NAME Device name of the local port.
OPEN_CIRCS Number of virtual circuits open from the port.
POOL_WAITERS Number of processes waiting for nonpaged pool resources for message buffers.
PORT_NUM 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 Total number of responses of all kinds received from the port but not yet processed.

Table 20-9 MEMBERS Class Fields
Field Name Description
ACK_LM Maximum number of OpenVMS Cluster messages the remote system can receive before sending an acknowledgment.
ACKR_SQ Sequence number of the last acknowledgment received over the cluster connection.
CNX_STATE State of the cluster connection. Possible displays are as follows:
ACCEPT Initial connection is accepted.
CLOSED Connection is closed.
CONNECT Initial connection is being accepted.
DEAD No connection is possible.
DISCONNECT Disconnection is in progress.
NEW No attempt to make a connection has been made yet.
OPEN Connection is open.
REACCEPT Connection is accepting the reconnect request.
RECONNECT Connection is attempting to reconnect.
WAIT Timeout is in progress.
CSID 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 Lock manager distributed directory weight.
EXPECTED_VOTES Maximum number of votes that an individual node can encounter. Used as an initial estimate for computing CL_EXPECTED_VOTES.

The cluster manager sets this number using the EXPECTED_VOTES system parameter. It is possible for this field to display a number smaller than the EXPECTED_VOTES parameter setting if the REMOVE_NODE option was used to shut down a cluster member or the SET CLUSTER/EXPECTED_VOTES DCL command was used since this node was last rebooted.

The dynamic value for EXPECTED_VOTES used clusterwide is the CL_EXPECTED_VOTES field, which is described in Table 20-3.

PROTOCOL Protocol version number and ECO level of the connection management software.
QDVOTES Number of votes the remote system recommends be contributed by the quorum disk. Normally, the cluster manager sets this number using the system 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.
QF_WATCHER Remote system has an active connection to the quorum disk and can verify its connection for members unable to access the disk directly.
QUORUM Derived from EXPECTED_VOTES and calculated by the connection manager. It represents an initial value for the minimum number of votes that must be present for this node to function. The dynamic QUORUM value is the CL_QUORUM field, which is described in the CLUSTER class category in Table 20-3.
RCVD_SQ Sequence number of the last message received over the OpenVMS Cluster connection.
RECNXINTERVAL Displays the time (in seconds) that the connection manager will wait before timing out the corresponding connection. It is the maximum of the value contained in the system parameter RECNXINTERVAL on the local node and the amount of time it would take for the connection manager on the remote node to discover that the connection is broken.
SEND_SQ Sequence number of the next message to be sent over the OpenVMS Cluster connection.
STATUS Status of the node in the cluster. Possible displays are as follows:
blank System is not being considered as a cluster member.
BRK_MEM System is a member of the cluster, but the connection manager has lost communication with it.
BRK_NEW System has just booted, but has not yet joined the cluster and the connection manager has lost communication with it.
BRK_NON Connection manager has lost communication with the system and the system is no longer a member of the cluster.
BRK_REM Connection manager has lost communication with the system, and the system has been removed from the cluster.
MEMBER System is participating in the cluster.
NEW 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 System is not a member of the cluster.
REMOVED System has been removed from the cluster.
SW_VERS Indicator of the software version running on the node.
TRANSITION_TIME Time of the system's last change in membership status. (See the STATUS field.)
UNACKED Number of unacknowledged OpenVMS Cluster messages received by the remote system.
VOTES Number of votes the remote node contributes toward quorum. Normally, the cluster manager sets this number with the system parameter VOTES.
WARMCDRPS Number of CDRPs on the CDRP free queue.

Table 20-10 SYSTEMS Class Fields
Field Name Description
DG_SIZE Maximum number of bytes of application data in datagrams sent over the circuit.
HW_TYPE System hardware type (for example, VAXstation 3100 or HS70). (Enclose the system type between double quotation marks.)
HW_VERS Hardware configuration and revision levels of the remote system.
INCARNATION Unique 16-digit hexadecimal number established when the system is booted.
INCN_TIME Incarnation number expressed as a time (dd-mmm-yy hh:mm).
MSG_SIZE Maximum number of bytes of application data in messages sent over the circuit.
NODE Node name of the remote system. Normally, the cluster manager sets the node name using the system parameter SCSNODE. The node name should be the same as the DECnet node name. (Note that SCSNODE cannot be more than six characters.)
NUM_CIRCUITS Number of virtual circuits between the local system and remote systems.
SOFTWARE Name and version of the operating system currently running on the remote system.
SYS_ID Identification number of the remote system. Normally, the cluster manager sets this number using the system parameters SCSSYSTEMID and SCSSYSTEMIDH. This number should be the same as the DECnet node number.

You can customize the SHOW CLUSTER display to include the information most important to your needs by dynamically adding and removing classes and fields. For example, if you add a field that belongs to the CLUSTER class or the LOCAL_PORTS class, SHOW CLUSTER adds the new column of information to the display.

By default, the SHOW CLUSTER display includes the NODE and SOFTWARE fields of the SYSTEMS class and the STATUS field of the MEMBERS class. Figure 20-1 presents a sample customized SHOW CLUSTER display in which the HW_TYPE, VOTES, and TRANSITION_TIME fields have been added to the default SHOW CLUSTER display.

Figure 20-1 Sample SHOW CLUSTER Report


Because SHOW CLUSTER information covers approximately 100 fields of data, the display can quickly extend beyond screen limits. Therefore, the utility provides mechanisms to help you control the display of data. These mechanisms include the following ones:

  • SHOW CLUSTER qualifiers
  • SHOW CLUSTER commands
  • A default keypad, which can be redefined
  • An initialization file to format the display
  • Command procedures to control the display

SHOW CLUSTER has a number of qualifiers and commands, and a definable keypad that allow you to customize the display. You can rearrange the position of windows, scroll their contents, or change the interval at which the display is updated. This chapter contains reference information for the SHOW CLUSTER qualifiers and commands. Appendix I describes how to use the keypad.

Over time, as you determine the most valuable classes and fields of data for the SHOW CLUSTER report, you can create a startup initialization file that establishes your default report format. You can also build command procedures and define a keypad to use while running SHOW CLUSTER interactively.

By customizing SHOW CLUSTER output, you can display only data that is relevant to your installation. Creating the initialization file SHOW_CLUSTER$INIT:SHOW_CLUSTER.INI is described in HP OpenVMS System Manager's Manual, Volume 2: Tuning, Monitoring, and Complex Systems.

By customizing the SHOW CLUSTER keypad, you can redefine default keypad functions to be more site specific. Using SHOW CLUSTER keypad commands is described in Appendix I.

20.2 SHOW CLUSTER Usage Summary

The Show Cluster utility (SHOW CLUSTER) monitors the activity and performance of an OpenVMS Cluster system, and outputs the information to your default terminal or to a specified device or file.

Format

SHOW CLUSTER [/qualifier[,...]]


Parameters

None.

Description

To invoke SHOW CLUSTER, enter 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, enter the following command:


$ SHOW CLUSTER/CONTINUOUS

In a continuous display, you can control report output with SHOW CLUSTER commands. 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.

To exit from a continuous display and return to the DCL level, enter the EXIT command or press Ctrl/Z. To exit from SHOW CLUSTER without erasing the screen, press Ctrl/C. To interrupt SHOW CLUSTER, press Ctrl/Y.

20.3 SHOW CLUSTER Qualifiers

This section describes and provides examples of the SHOW CLUSTER qualifiers. The following table describes the qualifiers:

Qualifier Description
/BEGINNING=time Specifies the time that the SHOW CLUSTER session is to begin.
/CONTINUOUS Controls whether SHOW CLUSTER runs as a continuously updating display.
/ENDING=time Specifies the time that the SHOW CLUSTER session is to end.
/INTERVAL=seconds Specifies the number of seconds that display information remains on the screen before it is updated.
/OUTPUT=file-spec Directs the output from SHOW CLUSTER to the specified file instead of the current SYS$OUTPUT device.

/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 OpenVMS User's Manual.

If you specify a future time, your process is placed in a state of hibernation until the specified time. Use this qualifier with the /OUTPUT and /ENDING qualifiers to run SHOW CLUSTER without direct user intervention.


Format

/BEGINNING =time


Parameter

time

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

Examples

#1

$ SHOW CLUSTER/BEGINNING=31-OCT-2002:20:30
      

In this example, specifying an absolute time, SHOW CLUSTER produces a single display at 8:30 P.M. on October 31, 2002.

#2

$ SHOW CLUSTER/CONTINUOUS/BEGINNING=31-OCT-2002:21:30
      

In this example, specifying an absolute time, SHOW CLUSTER begins a continuous display at 9:30 P.M. on October 31, 2002.

#3

$ SHOW CLUSTER/BEGINNING=7-:30
      

In this example, specifying a delta time, SHOW CLUSTER produces a single display 7 days and 30 minutes from now.

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


Format

/CONTINUOUS


Example


$ SHOW CLUSTER/CONTINUOUS
      

In this example, SHOW CLUSTER begins to display a continuous report that is updated every 15 seconds.

/ENDING=time

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

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


Format

/ENDING =time


Parameter

time

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

Example


$ SHOW CLUSTER/CONTINUOUS/ENDING=31-OCT-2002:15:30
      

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

/INTERVAL=seconds

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

Format

/INTERVAL =seconds


Parameter

seconds

The number of seconds between display updates.

Example


$ SHOW CLUSTER/INTERVAL=5
      

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

/OUTPUT=file-spec

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

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

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


Format

/OUTPUT =file-spec


Parameter

file-spec

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

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


Example


$ SHOW CLUSTER/OUTPUT=[OMALLEY]CLUSTER
      

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

20.4 SHOW CLUSTER Commands

Once you start a continuous SHOW CLUSTER display session, you can use SHOW CLUSTER commands to control the session. The following table describes each command:

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

@ (Execute Procedure)

Executes a command procedure file that contains SHOW CLUSTER commands.

Format

@ file-spec


Parameter

file-spec

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

Qualifiers

None.

Description

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

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


Example


COMMAND> @MYFILE
      

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

ADD CIRCUITS

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

Format

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


Parameters

None.

Qualifiers

/ALL

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

/TYPE=ALL

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

/TYPE=OPEN

/TYPE=NOOPEN

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

Description

The ADD CIRCUITS command adds CIRCUITS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the CIRCUITS class. By default, the following fields are enabled:
RPORT_NUM---remote port number
RP_TYPE---remote port type
CIR_STATE---circuit state

For a list of all CIRCUITS class fields, see Table 20-2.

Use the ADD CIRCUITS command together with the REMOVE CIRCUITS command to turn the display of CIRCUITS class information on and off. If you remove the CIRCUITS class from the display and add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the CIRCUITS class and add new CIRCUITS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.


Examples

#1

COMMAND> ADD CIRCUITS
      

This command adds CIRCUITS class information to the display. This information includes all types of circuits for all enabled CIRCUITS class fields.

#2

COMMAND> ADD CIRCUITS/TYPE=OPEN
      

This command adds all open circuits to the SHOW CLUSTER display.

#3

COMMAND> REMOVE CIRCUITS
COMMAND> ADD RP_OWNER
COMMAND> REMOVE CIRCUITS
   .
   .
   .
COMMAND> ADD CIRCUITS
      

The ADD CIRCUITS command in this example sequence adds CIRCUITS class information to the SHOW CLUSTER display. The REMOVE CIRCUITS command removes the CIRCUITS class from the display.

The ADD RP_OWNER command adds the CIRCUITS class field RP_OWNER to the display. As a result, all other CIRCUITS class fields are disabled. When the CIRCUITS class is removed and added again, only the RP_OWNER field is displayed.

ADD CLUSTER

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

Format

ADD CLUSTER


Parameters

None.

Qualifier

/ALL

Specifies that all fields in this class are to 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 the following fields:
CL_EXPECTED_VOTES---number of cluster votes expected
CL_QUORUM---cluster quorum
CL_VOTES---cluster votes
QF_VOTE---quorum disk contributes a vote
CL_MEMBERS---current cluster members
FORMED---when quorum was formed
LAST_TRANSITION---last change in cluster membership

For a list of all CLUSTER class fields, see Table 20-3.

Use the ADD CLUSTER command with the REMOVE CLUSTER command to turn the display of CLUSTER class information on and off. If you remove the CLUSTER class from the display and add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the CLUSTER class and add new CLUSTER class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.


Examples

#1

COMMAND> ADD CLUSTER
      

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

#2

COMMAND> REMOVE CLUSTER
COMMAND> ADD CL_QUORUM
COMMAND> REMOVE CLUSTER
   .
   .
   .
COMMAND> ADD CLUSTER

      

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

ADD CONNECTIONS

Adds all currently enabled CONNECTIONS class fields to the SHOW CLUSTER display. Optionally, the command adds connections according to state or name.

Format

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


Parameters

None.

Qualifiers

/ALL

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

/NAME=ALL

Restores processes removed from the display with the command REMOVE CONNECTIONS/NAME=local-process-name.

/NAME=local-process-name

Adds the connection associated with the specified local process name, as displayed in the LOC_PROC_NAME field of the CONNECTIONS class.

A local process name can contain up to 16 characters. If the name is abbreviated, SHOW CLUSTER adds all local process names matching the abbreviation.

/TYPE=ALL

Specifies that all types of connections on each circuit are displayed. For a listing of the possible states a connection can be in, see the description of the CON_STATE field in Table 20-4. By default, the ADD CONNECTIONS command without any qualifiers displays all types of connections.

/TYPE=OPEN

/TYPE=NOOPEN

Controls whether connections in the open state or the nonopen state are to be added to the SHOW CLUSTER display.

Description

The ADD CONNECTIONS command adds CONNECTIONS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the CONNECTIONS class.

By default, the following CONNECTIONS class fields are enabled:

LOC_PROC_NAME---local process name
CON_STATE---connection state

For a list of all CONNECTIONS class fields, see Table 20-4.

Use the ADD CONNECTIONS command together with the REMOVE CONNECTIONS command to turn the display of CONNECTIONS class information on and off. If you remove the CONNECTIONS class from the display and add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the CONNECTIONS class and add new CONNECTIONS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.


Examples

#1

COMMAND> ADD CONNECTIONS
      

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

#2

COMMAND> ADD CONNECTIONS/NAME=(MSCP$DISK,VMS$VMScluster)
      

This command adds all connections associated with the process MSCP$DISK and the process VMS$VMScluster to the SHOW CLUSTER display.

#3

COMMAND> ADD CONNECTIONS/TYPE=OPEN
      

This command adds all open connections to the SHOW CLUSTER display.

#4

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

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

ADD COUNTERS

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

Format

ADD COUNTERS


Parameters

None.

Qualifier

/ALL

Specifies that all fields in this class are to 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 following COUNTERS fields are enabled:

DGS_SENT---datagrams sent
DGS_RCVD---datagrams received
MSGS_SENT---messages sent
MSGS_RCVD---messages received

For a list of all COUNTERS class fields, see Table 20-5.

Use the ADD COUNTERS command together with the REMOVE COUNTERS command to turn the display of COUNTERS class information on and off. If you remove the COUNTERS class from the display and add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the COUNTERS class and add new COUNTERS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.


Examples

#1

COMMAND> ADD COUNTERS
      

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

#2

COMMAND> REMOVE COUNTERS
COMMAND> ADD MSGS_SENT
COMMAND> REMOVE COUNTERS
   .
   .
   .
COMMAND> ADD COUNTERS
      

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

ADD CREDITS

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

Format

ADD CREDITS


Parameters

None.

Qualifier

/ALL

Specifies that all fields in this class are to 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 all CREDITS class fields, see Table 20-6.

Use the ADD CREDITS command together with the REMOVE CREDITS command to turn the display of CREDITS class information on and off. If you remove the CREDITS class from the display and then add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the CREDITS class and add new CREDITS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.


Examples

#1

COMMAND> ADD CREDITS
      

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

#2

COMMAND> REMOVE CREDITS
COMMAND> ADD MIN_REC
COMMAND> REMOVE CREDITS
   .
   .
   .
COMMAND> ADD CREDITS
      

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

ADD ERRORS

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

Format

ADD ERRORS


Parameters

None.

Qualifier

/ALL

Specifies that all fields in this class are to be added to the display. By default, ADD ERRORS, used without any field qualifiers, displays all the fields in the ERRORS class.

Description

The ADD ERRORS command adds ERRORS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the ERRORS class.

By default, all ERRORS class fields are enabled. For a list of all ERRORS class fields, see Table 20-7.

Use the ADD ERRORS command together with the REMOVE ERRORS command to turn the display of ERRORS class information on and off. If you remove the ERRORS class from the display and add it again without changing any fields, all of the same fields are displayed again. If, however, you remove the ERRORS class and add new ERRORS class fields, all previously enabled fields are disabled, and only the newly added fields are displayed.


Examples

#1

COMMAND> ADD ERRORS
      

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

#2

COMMAND> REMOVE ERRORS
COMMAND> ADD ERT_MAX
COMMAND> REMOVE ERRORS
   .
   .
   .
COMMAND> ADD ERRORS
      

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

ADD (Field)

Enables the display of specific fields of SHOW CLUSTER information.

Format

ADD field-name[,...]

CIRCUITS

The CIRCUITS class contains information about the virtual circuits on a system, such as the local port name, the remote port type and number, the number of connections on the circuit, and the circuit state.

See Table 20-2 for a table containing the fields in the CIRCUITS class.

CLUSTER

The CLUSTER class contains general information about the cluster, such as the time it was formed, the last time a system joined or left the cluster, and the cluster quorum.

See Table 20-3 for a table containing the fields in the CLUSTER class.

CONNECTIONS

The CONNECTIONS class contains information about connections established over a virtual circuit, such as the names of the local and remote processes, and the state of the connection.

See Table 20-4 for a table containing the fields in the CONNECTIONS class.

COUNTERS

The COUNTERS class displays statistics on connection traffic, such as the number of application datagrams or the number of application messages that have been sent or received.

See Table 20-5 for a table containing the fields in the COUNTERS class.

CREDITS

The CREDITS class displays the send and receive credit counts for each connection.

See Table 20-6 for a table containing the fields in the CREDITS class.

ERRORS

The ERRORS class displays a count of the errors on each port, along with information about the feasibility of reinitializing a port.

See Table 20-7 for a table containing the fields in the ERRORS class.

LOCAL_PORTS

The LOCAL_PORTS class displays information about the local system interface to the cluster, such as the name, number, and status of each port, and the number of entries in the queues associated with each port.

See Table 20-8 for a table containing the fields in the LOCAL_PORTS class.

MEMBERS

The MEMBERS class contains information about active systems in the cluster, such as their identification numbers and membership status.

See Table 20-9 for a table containing the fields in the MEMBERS class.

SYSTEMS

The SYSTEMS class lists information about all systems in the cluster, such as their identification numbers, node names, hardware types, and software versions.

See Table 20-10 for a table containing the fields in the SYSTEMS class.


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. The qualifier /ALL on any ADD (Class) command adds all fields in the class to the display.

To remove a field from the SHOW CLUSTER display, enter the REMOVE (Field) command.


Examples

#1

COMMAND> ADD SEND
      

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

#2

COMMAND> ADD 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.

ADD LOCAL_PORTS

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

Format

ADD LOCAL_PORTS


Parameters

None.

Qualifier

/ALL

Specifies that all fields in this class are to 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 following fields are enabled:

NAME
LP_STATUS---port status
PORT_NUM---port number
DGS_FREE---free datagrams queued
MSGS_FREE---free messages queued
OPEN_CIRCS---open circuits
FORM_CIRCS---formative circuits

For a list of all LOCAL_PORTS class fields, see Table 20-8.

Use the ADD LOCAL_PORTS command 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 same fields are displayed again. 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.


Examples

#1

COMMAND> ADD LOCAL_PORTS
      

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

#2

COMMAND> REMOVE LOCAL_PORTS
COMMAND> ADD LB_STATUS
COMMAND> REMOVE LOCAL_PORTS
   .
   .
   .
COMMAND> ADD LOCAL_PORTS

      

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

ADD MEMBERS

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

Format

ADD MEMBERS


Parameters

None.

Qualifier

/ALL

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

Description

The ADD MEMBERS command adds MEMBERS class information to the SHOW CLUSTER display. This information includes data for all currently enabled fields in the MEMBERS class.

By default, only the STATUS field is enabled. For a list of all MEMBERS class fields, see Table 20-9.

Use the ADD MEMBERS command 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 same fields are displayed again. 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

#1

COMMAND> ADD MEMBERS
      

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

#2

COMMAND> REMOVE MEMBERS
COMMAND> ADD VOTES
COMMAND> REMOVE MEMBERS
   .
   .
   .
COMMAND> ADD MEMBERS
      

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

ADD SYSTEMS

Adds all currently enabled SYSTEMS class fields to the SHOW CLUSTER display for all active systems or for selected systems.

Format

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


Parameters

None.

Qualifiers

/ALL

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

/ID=ALL

Restores the display after selectively removing systems by ID.

/ID=system-id

Specifies, by system identification number, systems to be added to the SHOW CLUSTER display. The system-id can be any identification number displayed in the SYS_ID field of the SYSTEMS class. When using a hexadecimal value for an identifier, precede the number with the characters %X.

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

/NODE=ALL

Restores the display after selectively removing systems by node name.

/NODE=node-name

Specifies, by node name, systems to be added to the SHOW CLUSTER display. The node-name can be any node displayed in the NODE field of the SYSTEMS class, and it can be enclosed in quotation marks. The /NODE qualifier affects all information displayed about the specified node, not just information in the SYSTEMS class display.

/TYPE=ALL

Restores the display after selectively removing systems by type.

/TYPE=hardware-type

Specifies, by hardware type, systems to be added to the SHOW CLUSTER display. You can specify any of the types shown in the HW_TYPE field, and you must enclose the type in quotation marks; for example, "VAX 8800". Because the quoted text may be abbreviated, it is possible, for example, to add VAXstation II and VAXstation 2000 systems with a single command. Multiple types may be specified if enclosed in parentheses and separated by commas. Hardware types are not case sensitive.

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


Description

The 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 following fields are enabled:
NODE
SOFTWARE

For a list of all SYSTEMS class fields, see Table 20-10.

Use the ADD SYSTEMS command 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 same fields are displayed again. 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

#1

COMMAND> ADD SYSTEMS
      

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

#2

COMMAND> ADD SYSTEMS/NODE=(PISHTA,ELF)
      

This command adds the nodes PISHTA and ELF to the SHOW CLUSTER display, reporting all currently enabled information about the nodes.

#3

COMMAND> ADD SYSTEMS/TYPE=("VAX 8800","MicroVAX 2000")
      

This command adds all VAX 8800 and MicroVAX 2000 processors to the SHOW CLUSTER display, reporting all currently enabled information about those hardware types.

#4

COMMAND> REMOVE SYSTEMS
COMMAND> ADD SYS_ID
COMMAND> REMOVE SYSTEMS
   .
   .
   .
COMMAND> ADD SYSTEMS
      

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

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


Parameters

key-name

Specifies the name of the key that you are defining. Use the following key names when defining keys:
Key Name LK201 VT100 VT52
PF1 PF1 PF1 [blue]
PF2 PF2 PF2 [red]
PF3 PF3 PF3 [gray]
PF4 PF4 PF4 - -
KP0, KP1 to KP9 0, 1 to 9 0, 1 to 9 0, 1 to 9
PERIOD . . .
COMMA , , n/a
MINUS - - n/a
ENTER 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 - - - -
DO Do - - - -
F17 to F20 F17 to F20 - - - -

equivalence-string

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

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 /IF_STATE qualifier or use /NOIF_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 be specified only 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, use the DCL command SET KEY 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.


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, such as the VT200 series.

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 want to create a state name that is easy to remember and type and, if possible, reminds you of the types of definitions you created for that state.


Example


Command> DEFINE/KEY PF3 "LOCAL_PORT"/NOTERMINATE
      

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

DESELECT

Terminates the selection of a previously selected window. When the DESELECT command is entered after a MOVE command, SHOW CLUSTER completes the move operation when it deselects the window. See also the MOVE and SELECT commands for related information.

Format

DESELECT


Parameters

None.

Qualifiers

None.

Example


Command> DESELECT
      

When you sent the DESELECT command, the previously selected window is deselected and the window is no longer highlighted.

EXIT

Terminates the SHOW CLUSTER display and returns control to the DCL command level. You can also press Ctrl/Z to exit at any time.

Format

EXIT


Parameters

None.

Qualifiers

None.

Example


COMMAND> EXIT
      

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

HELP

Provides online help information to use SHOW CLUSTER commands, parameters, and qualifiers. Press Ctrl/Z to exit.

Format

HELP [keyword ...]


Parameter

keyword

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.

Qualifiers

None.

Examples

#1

COMMAND> HELP INITIALIZE
      

This command displays help information about the SHOW CLUSTER command INITIALIZE.

#2

COMMAND> HELP FIELDS
      

This command displays help information about the valid field names that you can specify with the ADD, REMOVE, and SET commands.

INITIALIZE

Resets the display using the original default values for field names, class names, and field widths. It also restores any systems that were removed from the display by the REMOVE SYSTEMS command.

Format

INITIALIZE


Parameters

None.

Qualifiers

None.

Description

The INITIALIZE command resets the SHOW CLUSTER display to its default setting, consisting of the SCS window with data from the SYSTEMS class and the MEMBERS class. The report shows the node name, the software version, and the status of cluster members.

If you save a series of commands in an initialization file, using the SAVE command, SHOW CLUSTER automatically inserts an INITIALIZE command at the beginning of the file. Any command procedure that you build should start with the INITIALIZE command. In this way, you always tailor the display from a known state.


Example


COMMAND> INITIALIZE
      

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

MOVE

Moves a selected window to a specified position.

Format

MOVE direction value


Parameters

direction

Specifies the 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 511. If you do not enter a number for this parameter, SHOW CLUSTER prompts you for one.

Qualifiers

None.

Description

The MOVE command allows you to reposition a window manually on the display screen. With one window in the SHOW CLUSTER display, you can enter MOVE commands directly. However, with multiple windows, you must select the appropriate window (SELECT window-name) before invoking MOVE commands. The MOVE command implicitly disables AUTO_POSITIONING.

To move a selected window, either enter MOVE commands at the command prompt or use the arrow keys defined as MOVE commands. Entering the command SET FUNCTION MOVE redefines the direction keys as MOVE UP 1, MOVE DOWN 1, MOVE RIGHT 1, and MOVE LEFT 1, respectively.

When you enter 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, enter 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.

Note

If you set the function to MOVE, the arrow keys are no longer defined to perform DCL line-mode editing. Only one function can be enabled at a time, using the SET FUNCTION command.

Example


Command> SELECT CLUSTER
Command> MOVE RIGHT 10
Command> DESELECT
      

The command sequence in this example moves the CLUSTER window 10 columns to the right.

PAN

Exhibits a wide display area, a part at a time, as though being unrolled.

Format

PAN direction value


Parameters

direction

Specifies the 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 511. If you do not enter a number for this parameter, SHOW CLUSTER prompts you for one.

Qualifiers

None.

Description

The PAN commands rotate the entire display by column (horizontally) and by line (vertically). 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. Entering the command SET FUNCTION PAN redefines the up, down, right, and left 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, using the SET FUNCTION command.

Example


Command> PAN DOWN 10
      

This command pans the display 10 lines.

REFRESH

Clears the screen, removes extraneous characters, and updates all fields. Pressing Ctrl/W has the same effect as entering REFRESH.

Format

REFRESH


Parameters

None.

Qualifiers

None.

Example


Command> REFRESH
      

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

REMOVE CIRCUITS

Removes CIRCUITS class information from the SHOW CLUSTER display.

Format

REMOVE CIRCUITS [/qualifier[,...]]


Parameters

None.

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 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 Table 20-2.


Examples

#1

COMMAND> REMOVE CIRCUITS
      

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

#2

COMMAND> REMOVE CIRCUITS/TYPE=OPEN
      

This command removes all Open circuits from the display.

REMOVE CLUSTER

Removes CLUSTER class information from the SHOW CLUSTER display.

Format

REMOVE CLUSTER


Parameters

None.

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 Table 20-3.


Example


COMMAND> REMOVE CLUSTER
      

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

REMOVE CONNECTIONS

Removes CONNECTIONS class information from the SHOW CLUSTER display.

Format

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


Parameters

None.

Qualifiers

/NAME=ALL

Removes all connections currently displayed by SHOW CLUSTER. This qualifier allows you to clear the display before adding specific connection information with the command ADD CONNECTIONS/NAME=local-process-name.

/NAME=local-process-name

Specifies the local process name of connections that are to be removed from the display. A local process name appears in the LOC_PROC_NAME field; it can be up to 16 characters in length. If the local process name is abbreviated, SHOW CLUSTER removes all local process names matching the abbreviation.

/TYPE=ALL

Specifies that all types of connections on each circuit be removed from the SHOW CLUSTER display.

/TYPE=OPEN

/TYPE=NOOPEN

Controls whether connections in the open or nonopen state 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 Table 20-4.


Examples

#1

COMMAND> REMOVE CONNECTIONS
      

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

#2

COMMAND> REMOVE CONNECTIONS/NAME=(VMS$DISK_CL_DRVR,VMS$TAPE_CL_DRVR)
      

This command removes the CONNECTIONS class fields associated with the local process names VMS$DISK_CL_DRVR and VMS$TAPE_CL_DRVR from the SHOW CLUSTER display.

#3

COMMAND> REMOVE CONNECTIONS/TYPE=OPEN
      

This command removes all Open connections from the SHOW CLUSTER display.

REMOVE COUNTERS

Removes COUNTERS class information from the SHOW CLUSTER display.

Format

REMOVE COUNTERS


Parameters

None.

Qualifiers

None.

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 Table 20-5.


Example


COMMAND> REMOVE COUNTERS
      

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

REMOVE CREDITS

Removes CREDITS class information from the SHOW CLUSTER display.

Format

REMOVE CREDITS


Parameters

None.

Qualifiers

None.

Description

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

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


Example


COMMAND> REMOVE CREDITS
      

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

REMOVE ERRORS

Removes ERRORS class information from the SHOW CLUSTER display.

Format

REMOVE ERRORS


Parameters

None.

Qualifiers

None.

Description

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

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


Example


COMMAND> REMOVE ERRORS
      

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

REMOVE (Field)

Disables the display of specific fields of SHOW CLUSTER information.

Format

REMOVE field-name[,...]


Parameter

field-name

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

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


Qualifiers

None.

Examples

#1

COMMAND> REMOVE SOFTWARE
      

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

#2

COMMAND> REMOVE SOFTWARE,RP_TYPE,CON_STATE
      

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

REMOVE LOCAL_PORTS

Removes LOCAL_PORTS class information from the SHOW CLUSTER display.

Format

REMOVE LOCAL_PORTS


Parameters

None.

Qualifiers

None.

Description

The REMOVE LOCAL_PORTS command removes LOCAL_PORTS class information.

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


Example


COMMAND> REMOVE LOCAL_PORTS
      

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

REMOVE MEMBERS

Removes MEMBERS class information from the SHOW CLUSTER display.

Format

REMOVE MEMBERS


Parameters

None.

Qualifiers

None.

Description

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

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


Example


COMMAND> REMOVE MEMBERS
      

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

REMOVE SYSTEMS

Removes SYSTEMS class information from the SHOW CLUSTER display.

Format

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


Parameters

None.

Qualifiers

/ID=ALL

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

/ID=system-id

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

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

/NODE=ALL

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

/NODE=node-name

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

/TYPE=ALL

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

/TYPE=hardware-type

Specifies, by hardware type, systems to be added to the SHOW CLUSTER display. You can specify any of the types shown in the HW_TYPE field, and you must enclose the type in quotation marks, for example: "VAX 8800". Because the quoted text may be abbreviated, it is possible, for example, to remove VAXstation II and VAXstation 2000 systems with a single command. Multiple types may be specified if enclosed in parentheses and separated by commas. Hardware types are not case sensitive.

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


Description

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

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


Examples

#1

COMMAND> REMOVE SYSTEMS
      

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

#2

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

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

#3

COMMAND> REMOVE SYSTEMS/TYPE="VAX 8800"
      

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

SAVE

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

Format

SAVE [file-spec]


Parameter

file-spec

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

Qualifiers

None.

Description

The SAVE command allows you to build a startup initialization file or a command procedure that you can use in subsequent SHOW CLUSTER sessions. To use the SAVE command, perform the following steps:
  1. Customize the display to meet your needs by using SHOW CLUSTER commands.
  2. Enter the SAVE command. By default, the command procedure created is named SHOW_CLUSTER.COM. If you want a name that is different from the default, specify the alternate name on the SAVE command line. You save a startup initialization file as an .INI file.
  3. Edit the file to improve its efficiency and document it.

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

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

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


Command> ADD CIRCUITS/ALL
Command> REMOVE RP_TYPE

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


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

Example


Command> ADD CLUSTER
Command> REMOVE SOFTWARE
Command> SAVE
      

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


INITIALIZE
ADD CLUSTER
REMOVE SYSTEMS
ADD NODE

SCROLL

Scrolls a window.

Format

SCROLL direction value


Parameters

direction

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

value

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

Qualifiers

None.

Description

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

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

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

Note

If you set the function to SCROLL, the arrow keys are no longer defined to perform DCL line-mode editing. Only one function can be enabled at a time, using the SET FUNCTION command.

Example


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

This command sequence scrolls the SCS window up 10 lines.

SELECT

Designates which window to scroll, move, or pan.

Format

SELECT [window-name]


Parameter

window-name

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

Qualifiers

None.

Description

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

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

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


Example


Command> SELECT LOCAL_PORTS
      

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

SET AUTO_POSITIONING

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

Format

SET AUTO_POSITIONING keyword


Parameter

keyword

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

Qualifiers

None.

Description

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

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

Setting AUTO_POSITION to ON reestablishes the previous positions of windows.


Example


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

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

SET (Field)

Modifies the characteristics of particular fields within the display.

Format

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


Parameter

field-name

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

Qualifiers

/WIDTH=field-width

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

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

Note

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

/FORMAT=radix

Specifies the display format used to display the specified field. You can specify either of the following radix values:
DECIMAL for decimal format
HEXADECIMAL for hexadecimal format

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

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


Example


COMMAND> SET SYSID/FORMAT=HEXADECIMAL
      

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

SET FUNCTION

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

Format

SET FUNCTION function-name


Parameter

function-name

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

Qualifiers

None.

Description

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

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

Note

Setting the function to MOVE implicitly disables AUTO_POSITIONING.

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


Example


Command> SET FUNCTION MOVE
      

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

SET INTERVAL

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

Format

SET INTERVAL= seconds


Parameter

seconds

The number of seconds between display updates.

Qualifiers

None.

Example


COMMAND> SET INTERVAL=5
      

This command changes the display interval time to 5 seconds.

SET SCREEN

Sets the terminal to a display of up to 511 columns. This command can be used only on HP-compatible terminals.

Format

SET SCREEN= screen-width


Parameter

screen-width

Specifies the width of the screen display. Depending on terminal type, you can specify a value up to 511.

Qualifiers

None.

Description

The SET SCREEN command redefines the width of the display to the number of columns that you specify.

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 resets the screen to the original size.


Example


COMMAND> SET SCREEN=132
      

This command sets the screen width to 132 columns.

WRITE

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

Format

WRITE [file-spec]


Parameter

file-spec

Names the file specification of the printable output file. By default, the output file name is SHOW_CLUSTER.LIS.

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 the /ALL qualifier, a display update occurs prior to the output of the file. As a result, the output file may differ from the display on the screen at the time the command was entered. The screen is updated along with the file output, so subsequently they are the same.

When reporting a cluster-related problem to HP, use the /ALL qualifier to produce an output or hardcopy file.


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.


Chapter 21
System Generation Utility

21.1 SYSGEN Description

The System Generation utility (SYSGEN) is a system management tool used to tailor a system for a specific hardware and software configuration. Use SYSGEN commands to manipulate specific parts of the operating system, as follows:
  • System parameters: DISABLE, ENABLE, SET, SHOW, USE, and WRITE.
  • Devices and device drivers: SHOW/CONFIGURATION, SHOW/DEVICE, SHOW/DRIVER, SHOW/TURBOCHANNEL, and SHOW/UNIBUS.
    The SYSGEN device table in Appendix K lists characteristics of HP devices that SYSGEN configures automatically.
    A complete description of devices and device drivers is in the OpenVMS VAX Device Support Manual. (This manual has been archived but is available on the OpenVMS Documentation CD-ROM.)
  • System files: CREATE and INSTALL.
  • Startup command procedure: SET/STARTUP and SHOW/STARTUP.
  • Multiport memory: SHARE and SHARE/INITIALIZE.

You can use a subset of the SYSGEN commands to invoke the SYSBOOT facility during bootstrap operations. Refer to the installation instructions for your processor and the HP OpenVMS System Manager's Manual for more information.

21.1.1 Specifying Values for SYSGEN Qualifiers and Parameters

Normally, you specify values as an integer, keyword, or file specification. For parameters, integer values must be within the defined maximum and minimum values for the parameter unless the SYSGEN command DISABLE CHECKS was specified.

You can specify values for certain SYSGEN qualifiers and parameters in hexadecimal or octal radixes and for others as an ASCII string. To specify a value in octal or hexadecimal, precede the value with %O or %X, respectively. To specify a value in ASCII, enclose the value string in quotation marks (" ").

Appendix J lists system parameters.

21.1.2 Using Active and Current Parameter Values

System parameter values can be either active or current:

  • An active parameter is one whose value is active when the system is running. Active parameters that can be changed on a running system are categorized as dynamic parameters. (See Appendix J.)
  • A current parameter is one whose value is stored on disk (SYS$SYSTEM:VAXVMSSYS.PAR on VAX systems or SYS$SYSTEM:ALPHAVMSSYS.PAR on Alpha systems) and used for booting the system. Current parameters become active parameters when the system boots.

Modifying active parameters with SYSGEN has no effect on the values of the stored current parameters; you change the values of these parameters only while the system is running. In a subsequent bootstrap of the system, the old values of the current parameters are established as the active parameters. To change the values of the current parameters on disk, use the SYSGEN command WRITE CURRENT. To change the values of any active parameter that is not in the dynamic category, enter the WRITE CURRENT command and reboot the system.

21.2 SYSGEN Usage Summary

The System Generation utility (SYSGEN) is a system management tool that performs certain privileged system configuration functions. With SYSGEN, you can create and modify system parameters, load device drivers, and create additional page and swap files.

Format

RUN SYS$SYSTEM:SYSGEN


Parameters

None.

Description

To invoke SYSGEN, enter RUN SYS$SYSTEM:SYSGEN at the DCL command prompt. At the SYSGEN> prompt, enter any of the SYSGEN commands described in the following section. These commands follow the standard rules of grammar as specified in the HP OpenVMS DCL Dictionary.

To exit from SYSGEN, enter the EXIT command at the SYSGEN> prompt or press Ctrl/Z. You can direct output from a SYSGEN session to an output file using the SET/OUTPUT command. By default, output is written to SYS$OUTPUT.

Note

HP recommends the use of the AUTOGEN command procedure when modifying system parameters, loading device drivers, or creating additional page and swap files.

21.3 SYSGEN Commands

This section describes and provides examples of SYSGEN commands.

AUTOCONFIGURE (VAX Only)

On VAX systems, automatically connects devices that are physically attached to the system and loads their drivers. On Alpha systems, use the SYSMAN command IO AUTOCONFIGURE.

Use of the AUTOCONFIGURE command requires the CMKRNL privilege.


Format

AUTOCONFIGURE adapter-spec

AUTOCONFIGURE ALL


Parameter

adapter-spec

Specifies the adapter specification (backplane interconnect arbitration line) or slot number of the single UNIBUS or MASSBUS adapter that is to be configured. The adapter specification can be expressed as an integer or with one of the names listed by the SYSGEN command SHOW/ADAPTER.

You can specify AUTOCONFIGURE ALL to configure all standard devices attached to the system.

Caution

If you use the AUTOCONFIGURE ALL command on a running system with active UNIBUS or Q-bus devices, it could result in unpredictable behavior.

Qualifiers

/EXCLUDE=(device-name[,...])

Specifies the device types that you do not want automatically configured.

You can specify a device-type code as shown in Table 21-1 or a standard device name as shown in Appendix K. You can include a controller designation but not a unit number. If the controller designation is omitted, all devices of the specified type are excluded. The device-name specification defaults to all devices on the adapter. Do not use this qualifier with the /SELECT qualifier.

/LOG

Produces a display of the controller and its units on the current SYS$OUTPUT device after they have been successfully autoconfigured. Each controller and its associated units are displayed only after AUTOCONFIGURE has found the next controller. Therefore, the error message displays precede the display of the controller and units that caused the error.

/SELECT=(device-name[,...])

Specifies the device types that you want automatically configured.

You can specify a device-type code as shown in Table 21-1 or a standard device name as shown in Appendix K. You can include a controller designation but not a unit number. If the controller designation is omitted, all devices of the specified type are selected. The device-name specification defaults to all devices on the adapter.

Do not use /SELECT with the /EXCLUDE qualifier.

Table 21-1 Device Type Codes
Code Device Type
CR Card Reader
CS Console Storage Device
DB RP05, RP06 Disk
DD TU58 Cartridge Tape
DJ RA60 Disk
DL RL02 Cartridge Disk
DM RK06, RK07 Cartridge Disk
DQ RL02 Cartridge Disk, R80 Disk
DR RM03, RM05, RM80, RP07 Disk
DU UDA Disk
DX RX01 Diskette
DY RX02 Diskette
LA LPA11--K Laboratory Peripheral Accelerator
LC Line Printer on DMF32
LP Line Printer on LP11
MB Mailbox
MF TU78 Magnetic Tape
MS TS11 Magnetic Tape
MT TE16, TU45, TU77 Magnetic Tape
MU Tape Class Driver
NET Network Communications Logical Device
NL System "Null" Device
OP Operator's Console
PA Computer Interconnect
PT TU81 Magnetic Tape
PU UDA-50
RT Remote Terminal
TT Interactive Terminal on DZ11
TX Interactive Terminal on DMF32, DMZ32, DHU11, or DMB32
XA DR11--W General-Purpose DMA Interface
XD DMP--11 Synchronous Communications Line
XF DR32 Interface Adapter
XG DMF32 Synchronous Communications Line
XI DR Interface on DMF32
XJ DUP11 Synchronous Communications Line
XM DMC11 Synchronous Communications Line

Examples

#1

SYSGEN> AUTOCONFIGURE ALL
      

This command automatically configures all standard devices.

#2

SYSGEN> AUTOCONFIGURE ALL/SELECT=(TT,MTA,LP)
      

This command automatically configures all terminals, all magnetic tape units on controller A, and all line printers.

#3

SYSGEN> AUTOCONFIGURE ALL/EXCLUDE=XM
      

This command shows the use of the /EXCLUDE qualifier to autoconfigure all but the DMC11 devices, assuming DECnet will not be operating on this system.

CONFIGURE (VAX Only)

On VAX systems, requests UNIBUS device names and issues the set of control and status register (CSR) and vector addresses that AUTOCONFIGURE will use.

Format

CONFIGURE


Parameters

None.

Qualifiers

/INPUT=file-spec

Specifies the name of an input file from which previously prepared data is read. By default, input data is read from SYS$INPUT.

/OUTPUT=file-spec

Specifies the name of an output file to which output from CONFIGURE is written. By default, output is directed to SYS$OUTPUT. The default file type is .LIS.

/RESET

/NORESET

Controls whether controller names are reset. The /NORESET qualifier is useful with multiple UNIBUS systems. When you specify /NORESET, you do not need to specify the second parameter (p) on subsequent CONFIGURE commands, because the controller names are not reset. By default, if you omit /NORESET, the controller names are reset.

Description

The CONFIGURE command issues the following prompt:


DEVICE>

Input should be in the following form, where input to the prompt is controller:


controller[[,n],p]

Possible controller names are listed in the second column in Table K-1. You cannot abbreviate controller names.

You can optionally specify n, the number of devices on the UNIBUS being configured, and p, the optional number of devices on all previous UNIBUS devices in a multiple UNIBUS system. Note that p affects only the device names, not the addresses generated. By default, n is 1 and p is 0.

SYSGEN continues to prompt for devices until you enter Ctrl/Z. SYSGEN then displays the CSR and vector addresses for the devices specified.

Note that CONFIGURE does not look at the actual hardware configuration of the system. Rather, CONFIGURE determines which CSR and vector addresses AUTOCONFIGURE would use if the specified hardware was installed.


Example


SYSGEN>  CONFIGURE
DEVICE> DZ11,3,2
DEVICE> LP11
DEVICE> DMC11,2
DEVICE> [Ctrl/Z]
      

The system displays the following data:


Device:  RK611  Name:  DMA   CSR: 777440  Vector: 210  Support:  yes
Device:  LP11   Name:  LPA   CSR: 777514  Vector: 200  Support:  yes
Device:  DMC11  Name:  XMA   CSR: 760070* Vector: 300* Support:  yes
Device:  DMC11  Name:  XMB   CSR: 760100* Vector: 310* Support:  yes
Device:  DZ11   Name:  TTC   CSR: 760120* Vector: 320* Support:  yes
Device:  DZ11   Name:  TTD   CSR: 760130* Vector: 330* Support:  yes
Device:  DZ11   Name:  TTE   CSR: 760140* Vector: 340* Support:  yes

* Indicates a floating address.

In this example, the CONFIGURE command calculates the UNIBUS CSR and vector addresses. The support field in the display indicates whether HP includes the supported driver for this device with the operating system.

For a description of floating addresses referred to in the example, see Appendix K.

CONNECT (VAX Only)

On VAX systems, creates I/O data base control blocks for additional devices. Also loads the appropriate driver if it is not currently loaded. This is usually used to add nonstandard devices and I/O drivers to a system. Requires the CMKRNL privilege.

On Alpha systems, use the SYSMAN command IO CONNECT.

Note

Be very careful when issuing a CONNECT command because the system does little error-checking. A misspelled device name, for example, will damage the I/O database and could cause the system to fail.

Format

CONNECT device-name/[NO]ADAPTER=adapter-spec/CSR=aaaa/VECTOR=nn

CONNECT CONSOLE [/REMOTE]


Parameters

device-name

Specifies the name of the device for which control blocks are to be added to the I/O database, and has the following format:

devcu

where:

dev is the device-type
c is the controller
u is the unit

For example, LPA0 specifies the line printer (LP) on controller A at unit number 0. When specifying the device name, do not follow it with a colon (:).

CONSOLE

Loads and connects the console block storage device driver. The console device name is typically CSA1 but can vary depending on the system type.

Qualifiers

/ADAPTER=adapter-spec

/NOADAPTER

Specifies the nexus number (SBI arbitration line) or slot number of the adapter to which the device is connected. The nexus number can be found by using the SYSGEN command SHOW/ADAPTER or SHOW/BUS.

/NOADAPTER specifies that the I/O driver does not handle a physical device, rather it is a pseudo or test device driver.

Caution

The system does not perform complete error checking on the CONNECT/ADAPTER=adapter-spec command. An incorrect vector address or misspelled device name, for example, can damage the I/O database and usually causes the system to fail. The OpenVMS VAX Device Support Manual has more information about loading device drivers and connecting devices. (This manual has been archived but is available on the OpenVMS Documentation CD-ROM.)

/ADPUNIT=unit-number

Specifies the unit number of a device on the MASSBUS adapter. The unit number for a disk drive is the number of the plug on the drive. For magnetic tape drives, the unit number corresponds to the tape controller's number.

/CSR=csr-addr

Specifies the UNIBUS address of the first addressable location on the controller (usually the status register) for the device. This qualifier must be specified for UNIBUS devices. For devices on multiple device boards (for example, the DMF32), the address must be the control and status register (CSR) address specified in the output of the CONFIGURE command. To specify the address in octal or hexadecimal, precede the address with %O or %X, respectively.

/CSR_OFFSET=value

For devices on multiple device boards, specifies the offset from the CSR address of the multiple device board to the CSR address for the specific device being connected. To specify the address in octal or hexadecimal, precede the address with %O or %X, respectively.

/DRIVERNAME=driver

Specifies the name of the driver as recorded in the prolog table. If the driver has not been loaded, the system acts as if the driver name is also the name of an executable image (file type .EXE) in the SYS$LOADABLE_IMAGES directory and loads the driver. The driver name defaults to the first two characters of the device name concatenated with "DRIVER" (for example, LPDRIVER).

/MAXUNITS=max-unit-cnt

Specifies the maximum number of units the controller can support (that is, the number of UCB slots in the IDB). The default is the number specified in the prolog table of the driver, or 8 if the number is not specified in the prolog table.

/NUMVEC=vector-cnt

Specifies the number of interrupt vectors for the device. By default, the vector count is 1.

/REMOTE

Enables a remote diagnostic port for a second console or terminal connected to a VAX 8600.

/SYSIDHIGH=value

Specifies the high-order 16 bits of the 48-bit system identification number and must be 0. To specify the value in octal or hexadecimal, precede the value with %O or %X, respectively.

/SYSIDLOW=value

Specifies the low-order 32 bits of the 48-bit system identification number. The value must be identical to the DECnet node number. To specify the value in octal or hexadecimal, precede the value with %O or %X, respectively.

/VECTOR=vector-addr

Specifies the UNIBUS address of the interrupt vector for the device or the lowest vector, if more than one exists. This qualifier must be specified for UNIBUS devices. For devices on multiple device boards (for example, the DMF32), the address must be the interrupt vector address for the multiple device board specified in the output of the CONFIGURE command. To specify the address in octal or hexadecimal, precede the address with %O or %X, respectively.

/VECTOR_OFFSET=value

For devices on multiple device boards, specifies the offset from the interrupt vector address of the multiple device board to the interrupt vector address for the specific device being connected. To specify the address in octal or hexadecimal, precede the address with %O or %X, respectively.

Examples

#1

SYSGEN> CONNECT LPA0/ADAPTER=3/CSR=%O777514 -
SYSGEN> /DRIVERNAME=LP2DRIVER/VECTOR=%O200
      

This command connects the device named LPA0 to the driver named LP2DRIVER and loads the driver if it is not already loaded.

#2

SYSGEN> CONNECT NET/NOADAPTER/DRIVER=NETDRIVER
      

This command connects the device named NET to the driver NETDRIVER and loads the driver if it is not already loaded.

CREATE

Creates a file that can be used as a page, swap, or dump file. Normally, this command is used indirectly by executing the command procedure SYS$UPDATE:SWAPFILES.

Format

CREATE file-spec


Parameter

file-spec

The name of the file to be created.

Qualifiers

/CONTIGUOUS

/NOCONTIGUOUS

Specifies that the created file is either to be contiguous (/CONTIGUOUS) or contiguous-best-try (/NOCONTIGUOUS). The Primitive File System used during OpenVMS bootstrap limits the page, swap, and dump files to one file header. Because of this restriction, OpenVMS cannot be reliably bootstrapped from a bound volume set and is not supported on a bound volume set.

/SIZE=block-count

Specifies the size in blocks of the file to be created.

Example


SYSGEN>  CREATE DISK$PAGE:[NODE1]PAGEFILE.SYS /SIZE=200000
      

This command creates a file called PAGEFILE.SYS on the disk DISK$PAGE: in directory [NODE1]. This file is created as a contiguous-best-try file, which is the default. SYSGEN creates the file with 200,000 blocks, or allocates as many blocks on the disk as it can and displays a message warning that the file does not have the full allocation specified with the CREATE command.

The file will not be used for paging or swapping until you use the SYSGEN command INSTALL specifying the file and how it is to be used.

DEINSTALL

Deinstalls a page or swap file. Requires CMKRNL privilege. Any file installed with the SYSGEN command INSTALL can be deinstalled.

If the specified file is being actively used by processes, this command simply marks the file as "deinstall pending". This prevents any new assignments or reservations to the file from occurring. When all outstanding references to the file have been removed, the deinstallation will complete.

Files in the deinstall pending state are identified in the DCL command SHOW MEMORY/FILES display.


Format

DEINSTALL file-spec

DEINSTALL/ALL

DEINSTALL/INDEX=n


Parameter

file-spec

Specifies the name of a file that is to be deinstalled as a page or swap file.

Qualifiers

/PAGEFILE

Specifies that the file to be deinstalled is a page file.

/SWAPFILE

Specifies that the file to be deinstalled is a swap file.

/ALL

Deinstalls all page and swap files currently installed on the system. This command is most useful during an orderly system shutdown procedure where all disk volumes are being dismounted.

No other parameters or qualifiers are allowed.

/INDEX=n

Deinstalls a page or swap file specified by page file index. The page file index is presented in the DCL command SHOW MEMORY/FILES/FULL display as "Page File Number."

No other parameters or qualifiers are allowed.


Example


SYSGEN>  DEINSTALL DRA1:[SYSEXE]PAGEFILE.SYS /PAGEFILE
      

DISABLE

Inhibits the checking that SYSGEN performs on parameter values. By default, range checking is enabled.

Format

DISABLE CHECKS


Parameters

None.

Qualifiers

None.

ENABLE

Requests that SYSGEN ensure that parameter values changed using the SET command remain in the allowable range. By default, the range checking is enabled.

Format

ENABLE CHECKS


Parameters

None.

Qualifiers

None.

INSTALL

Installs an additional page or swap file. Requires CMKRNL privilege.

Format

INSTALL file-spec


Parameter

file-spec

Specifies the name of a file that is to be installed as a page or swap file. This file can reside on any volume that is mounted /SYSTEM. The file should be contiguous for best performance.

Qualifiers

/PAGEFILE

Specifies that the file is to be installed as an additional page file. This page file will augment any page file installed during the boot process.

/SWAPFILE

Specifies that the file is to be installed as an additional swap file. This swap file will augment any swap file installed during the boot process.

Example


SYSGEN>  INSTALL DRA1:[SYSEXE]PAGEFILE.SYS /PAGEFILE
      

LOAD (VAX Only)

On VAX systems, loads an I/O driver. On Alpha systems, use the SYSMAN command IO LOAD.

Use of the LOAD command requires the CMKRNL privilege.

Note

Be very careful when issuing a LOAD command because the system does little error-checking.

Format

LOAD file-spec


Parameter

file-spec

Specifies the file specification of the driver image to be loaded. This parameter is required.

If the entire file specification is the same as that of a driver already loaded, no load takes place. If only the file name is the same as that of a driver already loaded (but the file specification is different), the driver specified replaces the driver previously specified; that is, the existing driver.

The default file type is .EXE.


Description

Refer to the OpenVMS VAX Device Support Manual for a complete description of the LOAD command. (This manual has been archived but is available on the OpenVMS Documentation CD-ROM.)

Example


SYSGEN>  LOAD SYS$SYSTEM:RTTDRIVER
      

This command loads the standard driver for a remote terminal.

RELOAD (VAX Only)

On VAX systems, replaces a loaded device driver with a new version.

Use of the RELOAD command requires the CMKRNL privilege.


Format

RELOAD file-spec


Parameter

file-spec

The file specification of the new driver image. The default file type is .EXE. The specified image is loaded and replaces any existing driver with the same file specification.

Qualifiers

None.

Description

Refer to the OpenVMS VAX Device Support Manual for a complete description of the RELOAD command. (This manual has been archived but is available on the OpenVMS Documentation CD-ROM.)

Example


SYSGEN>  RELOAD SYS$SYSTEM:RTTDRIVER
      

This command reloads the remote terminal driver.

SET

Assigns a value to a system parameter in the SYSGEN work area.

This command does not modify parameter files, the current system parameter file on disk, or the active system; for information about performing these modifications, see the WRITE command.


Format

SET parameter-name value


Parameters

parameter-name

Specifies the name of a system parameter. If you enter a period (.), it is interpreted as a request for the system parameter specified in the last SET or SHOW command. See the description of the SHOW parameter-name command for an example of the use of the period in place of a parameter name.

value

Usually specifies an integer or the keyword DEFAULT. Integer values must be within the defined minimum and maximum values for the parameter unless the SYSGEN command DISABLE CHECKS was specified.

The keyword DEFAULT specifies the default value for the parameter. You can display the maximum, minimum, and default values for any parameter with the SYSGEN command SHOW parameter-name.

You can specify values for certain SYSGEN parameters in hexadecimal or octal radixes and for others as an ASCII string. To specify a value in octal or hexadecimal, precede the value with %O or %X, respectively. To specify a value in ASCII, enclose the value string in quotation marks (" ").


Qualifiers

None.

Examples

#1

SYSGEN> SET PFCDEFAULT 20
      

This command assigns a value of 20 to the PFCDEFAULT parameter.

#2

SYSGEN> SET GBLSECTIONS DEFAULT
      

This command assigns the default value (40) to the GBLSECTIONS parameter.

SET/OUTPUT

Establishes a file to be used for output during the session. By default the output is written to SYS$OUTPUT, but you can use SET/OUTPUT to designate a disk file.

At any time you can direct the output back to SYS$OUTPUT by using the SET/OUTPUT=SYS$OUTPUT command.


Format

SET/OUTPUT[=] file-spec


Parameter

file-spec

The name of the output file. The default file type is .LIS. The equal sign (=) is optional.

Example


SYSGEN>  SET/OUTPUT=PARAMS.LIS
SYSGEN>  SHOW/ALL
SYSGEN>  SHOW/SPECIAL
SYSGEN>  EXIT
      

In this example, output is directed to the file PARAMS.LIS to capture a complete list of all the system parameters (including the SPECIAL parameters reserved for HP use) and their values.

SET/STARTUP

Names the site-independent startup command procedure to be associated with a parameter file for subsequent bootstrap operations.

Format

SET/STARTUP file-spec


Parameter

file-spec

The file specification of a startup command procedure on the system disk (maximum of 31 characters). The initial site-independent startup command procedure (as named in the software distribution kit) is SYS$SYSTEM:STARTUP.COM.

Example


SYSGEN>  SET/STARTUP SYS$SYSTEM:XSTARTUP.COM
      

This command assigns SYS$SYSTEM:XSTARTUP.COM as the current site-independent startup command procedure.

SHARE (VAX Only)

On VAX systems, connects a processor to a multiport memory unit already initialized by this or another processor. The number and name of the specified multiport memory unit must be those of an initialized unit, or an error condition results.

Use of the SHARE command requires the CMKRNL privilege.


Format

SHARE MPMn MPM-name


Parameters

MPMn

Specifies the number on the front panel of the multiport memory unit being connected.

MPM-name

Specifies the name of the multiport memory unit as indicated in a previous SHARE/INITIALIZE command.

Qualifiers

/MAXCEFCLUSTERS=max-cef

Specifies the maximum number of common event flag clusters that the processor can create in the multiport memory unit. The default is no limit.

/MAXGBLSECTIONS=max-gbl

Specifies the maximum number of global sections that the processor can create in the multiport memory unit. The default is no limit.

/MAXMAILBOXES=max-mail

Specifies the maximum number of mailboxes the processor can create in the multiport memory unit. The default is no limit.

Example


SYSGEN>  SHARE MPM1 SHR_MEM_1
      

This command connects a multiport memory unit. Because no qualifiers are specified, defaults apply to all the parameters.

The unit with a 1 on the front panel must be initialized with the name SHR_MEM_1 for the command to work.

SHARE/INITIALIZE (VAX Only)

On VAX systems, initializes a multiport memory unit and connects it to the processor on which SYSGEN is running.

Use of the SHARE/INITIALIZE command requires the CMKRNL privilege.


Format

SHARE/INITIALIZE MPMn MPM-name


Parameters

MPMn

Specifies the number on the front panel of the multiport memory unit being connected.

MPM-name

Specifies the name by which the multiport memory unit is to be known to systems using it. The MPM-name is a 1 to 15 alphanumeric character string that may contain dollar signs ($) and underscores (_).

Qualifiers

/CEFCLUSTERS=cef

Specifies the total number of common event flag clusters permitted in the multiport memory unit. The cef value is an integer with a default of 32.

/GBLSECTIONS=gbl

Specifies the total number of global sections permitted in the multiport memory unit. The gbl value is an integer with a default of 32.

/MAILBOXES=mail

Specifies the total number of mailboxes permitted in the multiport memory unit. The mail value is an integer with a default of 32.

/MAXCEFCLUSTERS=max-cef

Specifies the maximum number of common event flag clusters that the processor can create in the multiport memory unit. The default is no limit.

/MAXGBLSECTIONS=max-gbl

Specifies the maximum number of global sections that the processor can create in the multiport memory unit. The default is no limit.

/MAXMAILBOXES=max-mail

Specifies the maximum number of mailboxes the processor can create in the multiport memory unit. The default is no limit.

/POOLBCOUNT=block-cnt

Specifies the number of blocks allocated to the multiport memory unit's dynamic pool. The block-cnt value is an integer with a default of 128.

/POOLBSIZE=block-size

Specifies the size of each block in the dynamic pool. The block-size value is an integer with a default of 128 bytes.

/PRQCOUNT=prq-cnt

Specifies the number of interprocessor request blocks (PRQs) allocated. The prq-cnt value is an integer with a default of 64.

Description

If the specified multiport memory unit is already initialized and connected to other active processors, the gbl, mail, cef, block-cnt, block-size, and prq-cnt parameter values are ignored, and the unit is simply connected to the processor.

Example


SYSGEN>  SHARE MPM1 SHR_MEM_1/INITIALIZE -
SYSGEN>  /GBLSECTIONS=128/MAILBOXES=64/CEFCLUSTERS=0
      

This command initializes a multiport memory unit with defaults on all but the gbl, mail, and cef parameters. In this example, assume that the number of the multiport memory unit as it appears on the front panel is 1, and the unit name is SHR_MEM_1.

SHOW

Displays the values of system parameters in the SYSGEN work area, plus the default, minimum, and maximum values of the parameters and their units of measure.

Format

SHOW parameter-name


Parameter

parameter-name

Specifies the name of a system parameter. If you enter a period (.), it is interpreted as a request for the system parameter specified in the last SET parameter-name or SHOW parameter-name command.

Qualifiers

/ACP

Specifies that all ACP parameter values are displayed.

/ALL

Specifies that all parameter values other than SPECIAL parameter values are displayed.

/BI

Specifies that device addresses that are currently mapped in the I/O space for the VAXBI bus are displayed.

/CLUSTER

Specifies that all CLUSTER parameter values are displayed.

/DYNAMIC

Specifies that all DYNAMIC parameter values are displayed.

/GEN

Specifies that all GEN parameter values are displayed.

/HEX

Specifies that the values of parameters be displayed in hexadecimal representation. Specify the /HEX system parameter name or the parameter type. If you specify the /HEX qualifier with the /NAMES qualifier, /HEX is ignored.

/JOB

Specifies that all JOB parameter values are displayed.

/LGI

Specifies that all LGI parameter values are displayed.

/MAJOR

Specifies that all MAJOR parameter values are displayed.

/MULTIPROCESSING

Specifies that all MULTIPROCESSING parameters are displayed.

/NAMES

Specifies that the names of all parameters are displayed.

/PQL

Specifies that all PQL parameter values are displayed.

/RMS

Specifies that all RMS parameter values are displayed.

/SCS

Specifies that all SCS parameter values are displayed.

/SPECIAL

Specifies that all parameter values reserved for HP use are displayed.

/STARTUP

Specifies that the name of the current site-independent startup command procedure is displayed.

/SYS

Specifies that all SYS parameter values are displayed.

/TTY

Specifies that all terminal parameter values are displayed.

/XMI[=BIindex]

Specifies that device addresses that are currently mapped in the I/O space for the XMI bus are displayed. The /XMI qualifier also displays node and nexus numbers and generic names of all processors, adapters, VAXBI adapters, memory controllers, and interconnection devices such as the NI.

Use of the SHOW/XMI=BIindex command requires the CMEXEC privilege.


Description

Parameter values are displayed in decimal unless the /HEX qualifier is specified. Note that ASCII values are displayed in ASCII by default.

When parameter names are abbreviated on a VAX platform, the first parameter matching the abbreviation is selected for display. No ambiguity checks are made. On an Alpha platform, all parameters whose names match the abbreviation are printed.

For example, a specification of SHOW GBL on a VAX system displays only the GBLSECTIONS parameter. To display the GBLPAGFIL parameter, you must specify SHOW GBLPAGF (to avoid further ambiguity with the GBLPAGES parameter). On an Alpha system, the same SHOW GBL command displays GBLSECTIONS, GBLPAGES, and GBLPAGFIL.

You can enter a period (.) to indicate that you want to work with the system parameter that was specified in the last SET parameter-name or SHOW parameter-name command.


Examples

#1

SYSGEN> SHOW GBLSECTIONS









Parameter Name            Current   Default   Minimum   Maximum Unit  Dynamic
GBLSECTIONS                   100        40        20        -1 Sections

SYSGEN> SET . 110

SYSGEN> SHOW .

Parameter Name            Current   Default   Minimum   Maximum Unit  Dynamic
GBLSECTIONS                   110        40        20        -1 Sections

In this example, the user first displays the values of the GBLSECTIONS parameter and then refers to the parameter with a period to set its current value to 110. The next SHOW command also uses the period notation to obtain confirmation that the change occurred.

#2

SYSGEN> SHOW/ACP
      

On a VAX system, the command in this example produces the following output:


Parameters in use: Active
Parameter Name             Current   Default   Minimum   Maximum Unit  Dynamic
ACP_MULTIPLE                     0         1         0         1 Boolean     D
ACP_SHARE                        1         1         0         1 Boolean
ACP_MAPCACHE                    52         8         1        -1 Pages       D
ACP_HDRCACHE                   138       128         2        -1 Pages       D
ACP_DIRCACHE                   138        80         2        -1 Pages       D
ACP_DINDXCACHE                  37        25         2        -1 Pages       D
ACP_WORKSET                      0         0         0        -1 Pages       D
ACP_FIDCACHE                    64        64         0        -1 File-Ids    D
ACP_EXTCACHE                    64        64         0        -1 Extents     D
ACP_EXTLIMIT                   300       300         0      1000 Percent/10  D
ACP_QUOCACHE                   130        64         0        -1 Users       D
ACP_SYSACC                       4         8         0        -1 Directories D
ACP_MAXREAD                     32        32         1        64 Blocks      D
ACP_WINDOW                       7         7         1        -1 Pointers    D
ACP_WRITEBACK                    1         1         0         1 Boolean     D
ACP_DATACHECK                    2         2         0         3 Bit-mask    D
ACP_BASEPRIO                     8         8         4        31 Priority    D
ACP_SWAPFLGS                    14        15         0        15 Bit-mask    D
ACP_XQP_RES                      1         1         0         1 Boolean
ACP_REBLDSYSD                    0         1         0         1 Boolean


#3

SYSGEN> SHOW/ACP/HEX
      

The command in this example produces a hexadecimal display of the values of the ACP system parameters, as follows:


Parameters in use: Active
Parameter Name             Current   Default   Minimum   Maximum Unit  Dynamic
ACP_MULTIPLE              00000000  00000001  00000000  00000001 Boolean     D
ACP_SHARE                 00000001  00000001  00000000  00000001 Boolean
ACP_MAPCACHE              00000034  00000008  00000001  FFFFFFFF Pages       D
ACP_HDRCACHE              0000008A  00000080  00000002  FFFFFFFF Pages       D
ACP_DIRCACHE              0000008A  00000050  00000002  FFFFFFFF Pages       D
ACP_DNDXCACHE             00000025  00000019  00000002  FFFFFFFF Pages       D
ACP_WORKSET               00000000  00000000  00000000  FFFFFFFF Pages       D
ACP_FIDCACHE              00000040  00000040  00000000  FFFFFFFF File-Ids    D
ACP_EXTCACHE              00000040  00000040  00000000  FFFFFFFF Extents     D
ACP_EXTLIMIT              0000012C  0000012C  00000000  000003E8 Percent/10  D
ACP_QUOCACHE              00000082  00000040  00000000  FFFFFFFF Users       D
ACP_SYSACC                00000004  00000008  00000000  FFFFFFFF Directories D
ACP_MAXREAD               00000020  00000020  00000001  00000040 Blocks      D
ACP_WINDOW                00000007  00000007  00000001  FFFFFFFF Pointers    D
ACP_WRITEBACK             00000001  00000001  00000000  00000001 Boolean     D
ACP_DATACHECK             00000002  00000002  00000000  00000003 Bit-mask    D
ACP_BASEPRIO              00000008  00000008  00000004  0000001F Priority    D
ACP_SWAPFLGS              0000000E  0000000F  00000000  0000000F Bit-mask    D
ACP_XQP_RES               00000001  00000001  00000000  00000001 Boolean
ACP_REBLDSYSD             00000000  00000001  00000000  00000001 Boolean
#4

SYSGEN> SHOW/PQL
      

On an Alpha system, the command in this example produces the following output:



Parameters in use: Active
Parameter Name            Current    Default     Min.     Max.     Unit  Dynamic
--------------            -------    -------    -------  -------   ----  -------
PQL_DASTLM                     24         24        -1        -1 Ast        D
PQL_MASTLM                      4          4        -1        -1 Ast        D
PQL_DBIOLM                     32         32        -1        -1 I/O        D
PQL_MBIOLM                      4          4        -1        -1 I/O        D
PQL_DBYTLM                  65536      65536        -1        -1 Bytes      D
PQL_MBYTLM                   1024       1024        -1        -1 Bytes      D
PQL_DCPULM                      0          0        -1        -1 10Ms       D
PQL_MCPULM                      0          0        -1        -1 10Ms       D
PQL_DDIOLM                     32         32        -1        -1 I/O        D
PQL_MDIOLM                      4          4        -1        -1 I/O        D
PQL_DFILLM                    128        128        -1        -1 Files      D
PQL_MFILLM                      2          2        -1        -1 Files      D
PQL_DPGFLQUOTA              65536      65536        -1        -1 Pagelets   D
 internal value              4096       4096         0        -1 Pages      D
PQL_MPGFLQUOTA               2048       2048        -1        -1 Pagelets   D
 internal value               128        128       128        -1 Pages      D
PQL_DPRCLM                     32         32        -1        -1 Processes  D
PQL_MPRCLM                      0          0        -1        -1 Processes  D
PQL_DTQELM                     16         16        -1        -1 Timers     D
PQL_MTQELM                      0          0        -1        -1 Timers     D
PQL_DWSDEFAULT               2000       2000        -1        -1 Pagelets
 internal value               125        125         0        -1 Pages
PQL_MWSDEFAULT               2000       2000        -1        -1 Pagelets
 internal value               125        125       125        -1 Pages
PQL_DWSQUOTA                 4000       4000        -1        -1 Pagelets   D
 internal value               250        250         0        -1 Pages      D
PQL_MWSQUOTA                 4000       4000        -1        -1 Pagelets   D
 internal value               250        250       250        -1 Pages      D
PQL_DWSEXTENT               12000      12000        -1        -1 Pagelets   D
 internal value               750        750         0        -1 Pages      D
PQL_MWSEXTENT                4000       4000        -1        -1 Pagelets   D
 internal value               250        250       250        -1 Pages      D
PQL_DENQLM                     64         64        -1        -1 Locks      D
PQL_MENQLM                      4          4        -1        -1 Locks      D
PQL_DJTQUOTA                 1024       1024        -1        -1 Bytes      D
PQL_MJTQUOTA                    0          0        -1        -1 Bytes      D


SHOW/ADAPTER (VAX Only)

On VAX systems, displays all the nexus numbers and generic names on the adapter.

Use of the SHOW/ADAPTER command requires the CMEXEC privilege.


Format

SHOW/ADAPTER


Parameters

None.

Qualifiers

None.

Example


SYSGEN>  SHOW/ADAPTER
      

The following example is a sample display produced by the SYSGEN SHOW/ADAPTER command:


CPU Type: 11/780

 Nexus Generic Name or Description
   1   16K memory, non-interleaved
   3   UB0
   8   MB0
   9   MB1


SHOW/BUS (VAX Only)

On VAX systems, displays all the nexus numbers and generic names on the adapter. On Alpha systems, use the SYSMAN command IO SHOW BUS.

Use of the SHOW/BUS command requires the CMEXEC privilege.


Format

SHOW/BUS


Parameters

None.

Qualifiers

None.

SHOW/CONFIGURATION (VAX Only)

On VAX systems, displays information about the device configuration.

Use of the SHOW/CONFIGURATION command requires the CMEXEC privilege.


Format

SHOW/CONFIGURATION


Parameters

None.

Qualifiers

/ADAPTER=nexus

Specifies the number of MASSBUS or UNIBUS adapters to be displayed. The nexus value can be expressed as an integer or with one of the generic names listed by the SYSGEN command SHOW/ADAPTER.

/COMMAND_FILE

Specifies that SYSGEN formats all the device data into CONNECT/ADAPTER=adapter-spec commands and writes the commands in an output file you specify. In this way, you can completely reconfigure a system for UNIBUS devices without the use of the SYSGEN command AUTOCONFIGURE.

/OUTPUT=file-spec

Specifies the file specification of an optional output file. If you specify the /OUTPUT qualifier but omit the file type, the default is .LIS. However, if you specify the /COMMAND_FILE and /OUTPUT qualifiers together, the default file type for the output file is .COM.

Description

The SHOW/CONFIGURATION command shows devices by name, number of units, nexus number, and adapter type, as well as by control and status register (CSR) and vector addresses. You can specify an output file with the /OUTPUT qualifier.

Note that you can remove a device from the middle of the floating addresses without completely redoing jumpers to the CSR and vector addresses of the remaining devices by following these steps:

  1. Modify your site-independent STARTUP.COM file to invoke the command file specified with the /OUTPUT qualifier instead of entering an AUTOCONFIGURE ALL command.
  2. Enter the SHOW/CONFIGURATION/COMMAND_FILE/OUTPUT command to format and save the device data. If you must bring the system down for service and remove a board, SYS$SYSTEM:STARTUP.COM invokes your output file as a command procedure when the system reboots, and the system automatically configures UNIBUS devices and MASSBUS devices for you.

Remember that a new version of SYS$SYSTEM:STARTUP.COM is provided with each major release, so you would need to repeat any modifications you have made to SYS$SYSTEM:STARTUP.COM after you install the new version.

Note

Although this technique can offer a convenient short-term solution, use AUTOCONFIGURE ALL when possible.

Examples

#1

SYSGEN> SHOW/CONFIGURATION
      

This command displays the current system I/O database. The following example illustrates a typical display produced by this command on VS3100 and 6000-400 systems:



 System CSR and Vectors on 23-OCT-2002 16:39:28.74
 Name: OPA  Units: 1  Nexus:0    (410)
 Name: PKB  Units: 1  Nexus:0    (410)
 Name: TTA  Units: 4  Nexus:0    (410)
 Name: PKA  Units: 1  Nexus:0    (410)
 Name: ESA  Units: 3  Nexus:0    (410)
 Name: GCA  Units: 1  Nexus:0    (410)

 System CSR and Vectors on 23-OCT-2002 16:31:47.12
 Name: PAA  Units: 1  Nexus:48   (CI )
 Name: PAB  Units: 1  Nexus:64   (CI )
 Name: PAC  Units: 1  Nexus:64   (CI )
 Name: PAD  Units: 1  Nexus:176  (CI )
 Name: FXA  Units: 2  Nexus:192  (GXM)
 Name: ETA  Units: 3  Nexus:213  (BVP)
 Name: PAE  Units: 1  Nexus:228  (CI )
 Name: PBA  Units: 1  Nexus:237  (BVP)
 Name: TXA  Units: 16 Nexus:211  (DMB)

#2

SYSGEN> SHOW/CONFIGURATION/COMMAND_FILE/OUTPUT=CONFIG.COM
      

This command formats all device data into CONNECT/ADAPTER=adapter-spec commands and writes the commands to the command file CONFIG.COM. The following example is a typical command file produced by this command:


$ RUN SYS$SYSTEM:SYSGEN
AUTOCONFIGURE 4
AUTOCONFIGURE 5
CONNECT DMA0 /ADAP=8 /CSR=%O777440 /VECT=%O210 /NUMV=01 /DRIVER=DMDRIVER
CONNECT DMA1 /ADAP=8 /CSR=%O777440 /VECT=%O210 /NUMV=01 /DRIVER=DMDRIVER
CONNECT LPA0 /ADAP=8 /CSR=%O777514 /VECT=%O200 /NUMV=01 /DRIVER=LPDRIVER
CONNECT DYA0 /ADAP=8 /CSR=%O777170 /VECT=%O264 /NUMV=01 /DRIVER=DYDRIVER
CONNECT DYA1 /ADAP=8 /CSR=%O777170 /VECT=%O264 /NUMV=01 /DRIVER=DYDRIVER
CONNECT XMA0 /ADAP=8 /CSR=%O760070 /VECT=%O300 /NUMV=02 /DRIVER=XMDRIVER
CONNECT XMB0 /ADAP=8 /CSR=%O760100 /VECT=%O310 /NUMV=02 /DRIVER=XMDRIVER
CONNECT XMC0 /ADAP=8 /CSR=%O760110 /VECT=%O320 /NUMV=02 /DRIVER=XMDRIVER
CONNECT TTA0 /ADAP=8 /CSR=%O760130 /VECT=%O330 /NUMV=02 /DRIVER=DZDRIVER
CONNECT TTA1 /ADAP=8 /CSR=%O760130 /VECT=%O330 /NUMV=02 /DRIVER=DZDRIVER
CONNECT TTA2 /ADAP=8 /CSR=%O760130 /VECT=%O330 /NUMV=02 /DRIVER=DZDRIVER
.
.
.
CONNECT TTF7 /ADAP=8 /CSR=%O760200 /VECT=%O400 /NUMV=02 /DRIVER=DZDRIVER


SHOW/DEVICE (VAX Only)

On VAX systems, displays full information about device drivers loaded into the system, the devices connected to them, and their I/O databases. All addresses are in hexadecimal and are virtual. On Alpha systems, use the SYSMAN command IO SHOW DEVICE.

Use of the SHOW/DEVICE command requires the CMEXEC privilege.


Format

SHOW/DEVICE =device-driver


Parameters

None.

Qualifiers

None.

Description

The SHOW/DEVICE command specifies that the following information be displayed about the specified device driver:
Driver Name of the driver
Start Starting address of the driver
End Ending address of the driver
Dev Name of each device connected to the driver
DDB Address of the device's device data block
CRB Address of the device's channel request block
IDB Address of the device's interrupt dispatch block
Unit Number of each unit on the device
UCB Address of each unit's unit control block

By default, if you omit the driver name, information is displayed for all device drivers loaded into the system.


Example


SYSGEN>  SHOW/DEVICE=DBDRIVER
      

This command displays the following information about the DBDRIVER:


__Driver_____Start____End____Dev___DDB______CRB______IDB_____Unit__UCB___
DBDRIVER   80082390 80082A7E
                             DBA 80000848 800988C0 80098920
                                                              0 8000087C
                                                              1 8008A4F0
                                                              2 8008A590
                                                              5 8008A630
                                                              7 8008A6D00


SHOW/DRIVER (VAX Only)

On VAX systems, displays the starting and ending address of the specified device driver loaded into the system.

Format

SHOW/DRIVER =device-driver


Parameters

None.

Qualifiers

None.

Description

If you omit the driver name, SHOW/DRIVER displays the starting and ending address of all device drivers loaded into the system. All addresses are in hexadecimal and are virtual.

Use of the SHOW/DRIVER command requires the CMEXEC privilege.

The SHOW/DRIVER command displays the following information about the specified device driver:

Driver Name of the device driver
Start Starting address of the device driver
End Ending address of the device driver


Example


SYSGEN>  SHOW/DRIVER
      

This command displays the starting and ending addresses of all drivers, as follows:


__Driver_____Start____End___
RTTDRIVER  800C1060 800C1960
NETDRIVER  800BAFD0 800BD4B0
TMDRIVER   800B3950 800B4BF0
DRDRIVER   800B2950 800B3290
DDDRIVER   800B1740 800B2060
DLDRIVER   800B0D10 800B15A0
DMDRIVER   800B0070 800B0990
LCDRIVER   800AFC50 800AFFB0
YCDRIVER   800AED20 800AF3E0
XGDRIVER   800AC3F0 800AE9E0
XDDRIVER   800AA5A0 800AC380
DZDRIVER   800A4F30 800A59B0
XMDRIVER   800A3E10 800A4A50
DYDRIVER   800A3300 800A3C30
LPDRIVER   800A2E90 800A3300
DBDRIVER   800DE7A0 800DEFB7
TTDRIVER   800DC770 800DE79B
OPERATOR   80001650 80001F8B
NLDRIVER   80001626 80001D20
MBDRIVER   800015FC 80001CBE


SHOW/STARTUP

Displays the name of the current site-independent startup command procedure.

Format

SHOW/STARTUP


Parameters

None.

Qualifiers

None.

Example


SYSGEN>  SHOW/STARTUP
Startup command file = SYS$SYSTEM:STARTUP.COM
      

This command displays the name of the site-independent startup command procedure.

SHOW/TURBOCHANNEL (VAX Only)

On VAX systems, displays the nexus number of a device on the TURBOchannel.

Format

SHOW/TURBOCHANNEL


Parameters

None.

Qualifiers

None.

Example


SYSGEN>  SHOW/TURBOCHANNEL
      

The following example is a sample display produced by the SHOW/TURBOCHANNEL command:


TURBOCHANNEL: Device Name       Nexus Number        TC Slot
              PMAQT-AA          00000000            00000001


SHOW/UNIBUS (VAX Only)

On VAX systems, displays the addresses in UNIBUS I/O space that can be addressed.

Use of the SHOW/UNIBUS command requires the CMKRNL privilege.


Format

SHOW/UNIBUS


Parameters

None.

Qualifier

/ADAPTER=nexus

Specifies that the address of the specified UNIBUS adapter is to be displayed. The nexus value specifies the number of the UNIBUS adapter. It can be expressed as an integer or as one of the names listed by the SYSGEN command SHOW/ADAPTER.

Description

The SHOW/UNIBUS command reads all device registers. For some controllers, the result might be reading a character out of a buffer or some other undesired action. Therefore, use the SHOW/UNIBUS command only when you debug a UNIBUS configuration. On a system with more than one UNIBUS adapter, the command shows only the address of the first UNIBUS adapter.

Note

Never use the SHOW/UNIBUS command on a running system. Use of this command is valid only during a conversational bootstrap.

Example


SYSGEN>  SHOW/UNIBUS/ADAPTER=4
      

This command displays the available addresses for nexus 4, as follows:


**UNIBUS map for nexus #4 on 30-JUN-2002  14:19:38.00 **

Address 760070 (8001F838) responds with value 9B6E (hex)
Address 760072 (8001F83A) responds with value 0340 (hex)
Address 760074 (8001F83C) responds with value 403C (hex)
Address 760076 (8001F83E) responds with value 0240 (hex)
Address 760100 (8001F840) responds with value 8000 (hex)
Address 760102 (8001F842) responds with value 0340 (hex)
Address 760104 (8001F844) responds with value 7DAC (hex)
Address 760106 (8001F846) responds with value 000A (hex)
Address 760110 (8001F848) responds with value 8000 (hex)
Address 760112 (8001F84A) responds with value 0340 (hex)
Address 760114 (8001F84C) responds with value AD5C (hex)
Address 760116 (8001F84E) responds with value 000A (hex)
Address 760130 (8001F858) responds with value 9B6E (hex)
Address 760132 (8001F85A) responds with value 030D (hex)
Address 760134 (8001F85C) responds with value FF00 (hex)
Address 760136 (8001F85E) responds with value CECE (hex)
Address 760140 (8001F860) responds with value 4060 (hex)
Address 760142 (8001F862) responds with value 0761 (hex)
Address 760144 (8001F864) responds with value FF00 (hex)
.
.
.


TERMINAL

Modifies the Ctrl/C, Ctrl/O, Ctrl/Y, and Ctrl/Z echo strings on a systemwide basis.

Format

TERMINAL/ECHO


Parameters

None.

Qualifiers

None.

Description

Before entering the TERMINAL command, edit the file SYSGTTSTR.MSG in SYS$EXAMPLES. The file contains detailed instructions for the editing procedure.

When you enter the TERMINAL command after editing the file, the modifications you have specified are carried out.

USE

Initializes the SYSGEN work area with system parameter values and the name of the site-independent startup command procedure, overwriting existing values. The initial values of the SYSGEN work area when the utility is invoked are the active values.

Specify the source for both the parameter values and the procedure name. They can be retrieved from a parameter file, the current system parameter file on disk, the active system in memory, or the default list.


Format

USE file-spec


Parameters

file-spec

The file specification of a system parameter file from which data is to be retrieved. You can use the SYSGEN command WRITE to create the parameter file. The default file type is .PAR.

In place of a file specification, you can specify one of the following keywords:

CURRENT

Specifies that source information is to be retrieved from the current system parameter file on disk.

On VAX systems, the system parameter file is SYS$SYSTEM:VAXVMSSYS.PAR.

On Alpha systems, the system parameter file is SYS$SYSTEM:ALPHAVMSSYS.PAR.

ACTIVE

Specifies that source information is to be retrieved from the active system in memory.

DEFAULT

Specifies that source information is to be retrieved from the default list. The USE DEFAULT command initializes the SYSGEN work area with parameter values that are built into SYSGEN; these values allow the operating system to boot on any standard configuration.

To avoid starting all layered products on a system that is not tuned for them, possibly causing the system to hang, set the STARTUP_P1 system parameter as follows:


SYSGEN> SET STARTUP_P1 "MIN"

Qualifiers

None.

Examples

#1

SYSGEN> USE SYS$SYSTEM:SPECIAL
      

This command uses the existing parameter file SYS$SYSTEM:SPECIAL.PAR.

#2

SYSGEN> USE DEFAULT


SYSGEN> SET STARTUP_P1 "MIN"
      

The first command initializes the SYSGEN work area with default parameter values. The second command sets the STARTUP_P1 system parameter to "minimum."

WRITE

Writes the system parameter values and the name of the site-independent startup command procedure from the SYSGEN work area to a parameter file, the current system parameter file on disk, or the active system in memory.

Format

WRITE file-spec


Parameters

file-spec

The file specification of a new parameter file to be created. The default file type is .PAR.

In place of a file specification, you can specify one of the following keywords:

CURRENT

Specifies that source information is to be written to the current system parameter file on disk.

On VAX systems, the system parameter file is SYS$SYSTEM:VAXVMSSYS.PAR.

On Alpha systems, the system parameter file is SYS$SYSTEM:ALPHAVMSSYS.PAR.

Use of the WRITE CURRENT command requires the SYSPRV privilege.

ACTIVE

Specifies that source information is to be written to the active system in memory. (Only the dynamic parameter values are written to the active system.)

Use of the WRITE ACTIVE command requires the CMKRNL privilege.


Qualifiers

None.

Description

On VAX systems, the implementation of security auditing within SYSGEN has altered the reporting of modifications to the system parameter file VAXVMSSYS.PAR. System managers can receive notification of a change to the file by setting up an access control list (ACL) on the file to signal such an event, as in the following example:


$ SET SECURITY/ACL=(ALARM=SECURITY,ACCESS=WRITE+FAILURE+SUCCESS)-
_$ SYS$SYSTEM:VAXVMSSYS.PAR

For more information about setting ACLs, refer to the OpenVMS User's Manual and the HP OpenVMS Guide to System Security.