[an error occurred while processing this directive]

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.

On Alpha systems, both the WRITE ACTIVE and WRITE CURRENT commands send a message to OPCOM and log the event.


Examples

#1

SYSGEN> WRITE SYS$SYSTEM:SPECIAL
      

This command creates a new parameter specification file, SYS$SYSTEM:SPECIAL.PAR.

#2

SYSGEN> WRITE CURRENT
      

On VAX systems, this command modifies the current system parameter file on disk, VAXVMSSYS.PAR.

On Alpha systems, this command modifies the current system parameter file on disk, ALPHAVMSSYS.PAR.


Chapter 22
System Management Utility

22.1 SYSMAN Description

The System Management utility (SYSMAN) centralizes the management of nodes and cluster environments. Rather than logging in to individual nodes and repeating a set of management tasks, SYSMAN enables you to define your management environment to be a particular node, a group of nodes, or a cluster environment. With a management environment defined, you can perform system management tasks from your local node. SYSMAN executes these tasks on all nodes in the target environment.

Managing a system with SYSMAN is similar to the traditional management of an individual system because SYSMAN uses many of the same software tools. It can process most DCL commands, such as MOUNT, DEFINE, INITIALIZE, SET, and SHOW. It can also execute many OpenVMS system management utilities and command procedures, such as AUTHORIZE, AUTOGEN, and INSTALL.

SYSMAN also contains system management tools that let you perform the following tasks:

  • Set disk quotas using DISKQUOTA commands.
  • Load and unload licenses using LICENSE commands.
  • Associate a terminal or port with a user name using the automatic login facility (ALF) commands.
  • Modify or display System Generation utility (SYSGEN) parameters using PARAMETERS commands.
  • Build site-specific startup procedures using STARTUP commands, which display or modify startup components of the OpenVMS operating system, site-specific programs, and layered products.
  • Modify or display OpenVMS Cluster parameters using CONFIGURATION commands.
  • Load system services using SYS_LOADABLE commands, which add and remove executive loaded images from the set of images loaded at boot time.
  • Create and modify scheduling classes, which allow you to limit the amount of CPU time alloted to users on a system.
  • Shut down systems using the SHUTDOWN NODE command.
  • On Alpha systems, detect all previously undiscovered tapes and media changers.
  • On Alpha systems, connect devices, load device drivers, and display configuration information using I/O commands.
  • On Alpha systems, set the priority of processes so that they are dumped early during a selective dump.

22.1.1 Defining Keys to Execute SYSMAN Commands

Instead of having to type lengthy command lines, SYSMAN enables you to define keys to execute SYSMAN commands. For example, you can define a key to execute a SET ENVIRONMENT command as follows:


SYSMAN> DEFINE/KEY/TERMINATE
_Key name: KP0
_Translation: "SET ENVIRONMENT/NODE=(NODE21,NODE22,NODE23)"

Once the key is defined, you can press keypad 0, and SYSMAN executes the SET ENVIRONMENT command. Note that key definitions are lost each time that you exit from SYSMAN, unless you define them in the SYSMAN initialization file. (See Section 22.1.2 for more information about executing commands from an initialization file.)

22.1.2 Executing Commands from an Initialization File

You can create an initialization file that SYSMAN will use each time you invoke the utility. In the SYSMAN initialization file, you can perform tasks such as defining keys and setting the SYSMAN environment.

The default file specification for the SYSMAN initialization file is SYS$LOGIN:SYSMANINI.INI. If you want your SYSMAN initialization file to have a different file specification, you must define the logical name SYSMANINI to point to the location of the file.

The following example is a sample initialization file in which several keys are defined:


$ TYPE SYSMANINI.INI
DEFINE/KEY/TERMINATE KP0 "SET ENVIRONMENT/CLUSTER/NODE=(NODE21,NODE22,NODE23,NODE24)"
DEFINE/KEY/TERMINATE KP1 "CONFIGURATION SHOW TIME"
DEFINE/KEY/TERMINATE KP2 "SHOW PROFILE"
   .
   .
   .

22.2 SYSMAN Usage Summary

The System Management utility (SYSMAN) centralizes system management, enabling you to manage nodes or clusters from one location.

Format

RUN SYS$SYSTEM:SYSMAN


Parameters

None.

Description

To invoke SYSMAN, enter the following command at the DCL prompt:


$ RUN SYS$SYSTEM:SYSMAN

SYSMAN displays the following prompt at which you can enter SYSMAN commands using the standard rules of DCL syntax:


SYSMAN>

To exit from SYSMAN and return to the DCL command level, enter the EXIT command at the SYSMAN> prompt or press Ctrl/Z.

Note

SYSMAN has the following restrictions:
  • You must have the OPER privilege on the local node and authorization for the OPER or SETPRV privilege on any remote nodes in the management environment.
    You must also have the privileges required by individual commands, as each command in this chapter describes. To determine which privileges are required for DCL commands or for system management utilities, refer to the HP OpenVMS DCL Dictionary or the appropriate utility reference part of this manual.
  • You cannot run SYSMAN from a batch job in any environment that requires a password.
  • Some DCL commands, such as SHOW SYSTEM/CLUSTER, SET CLUSTER/QUORUM, MOUNT/CLUSTER, and some forms of the REPLY command, operate clusterwide by design. These commands should not be run using SYSMAN, unless the environment has been set to a single node. Similarly, operations on clusterwide logical names and tables operate clusterwide by design.
  • If a SYSMAN user running with more than 125 total rights attempts to issue a SYSMAN command to a remote node within a cluster, the following error message is displayed:


    SMI-E-RIGHTSLIM, Rights limit exceeded.
    

    Note that this rights limitation includes a minimum of three identifiers that are granted during login when the process rights list is created:
    • A UIC identifier
    • A system identifier
    • Depending upon the environment in which the process is operating, at least one environmental identifier

    Users who want to run SYSMAN must have either one of the following items:
    • A separate account with no more than 125 rights
    • Enough identifiers removed from their current account so that the total number of rights falls within the appropriate range

22.3 SYSMAN Commands

This section describes the SYSMAN commands and demonstrates their use. Table 22-1 summarizes each command.

Table 22-1 SYSMAN Commands
Command Function
@ (Execute Procedure) Requests that SYSMAN read subsequent command input from the specified file or device.
ALF ADD Adds a record to the automatic login facility (ALF) database.
ALF REMOVE Deletes one or more records from the automatic login facility (ALF) database.
ALF SHOW Displays one or more records from the automatic login facility (ALF) database.
ATTACH Transfers control from your current process to the specified process in your job.
CLASS_SCHEDULE ADD Creates a new scheduling class.
CLASS_SCHEDULE DELETE Deletes a scheduling class.
CLASS_SCHEDULE MODIFY Modifies the characteristics of a scheduling class.
CLASS_SCHEDULE RESUME Resumes a scheduling class that has been suspended.
CLASS_SCHEDULE SHOW Displays the characteristics of a scheduling class.
CLASS_SCHEDULE SUSPEND Temporarily suspends a scheduling class.
CONFIGURATION SET
CLUSTER_AUTHORIZATION
Updates security data in a local area cluster.
CONFIGURATION SET TIME Updates system time.
CONFIGURATION SHOW CLUSTER_AUTHORIZATION Displays cluster security data.
CONFIGURATION SHOW TIME Displays current system time.
DEFINE/KEY Defines a key to execute a SYSMAN command
DISKQUOTA ADD Adds an entry to a disk quota file.
DISKQUOTA CREATE Creates and enables a disk quota file for a volume that does not contain one.
DISKQUOTA DELETE Removes an entry from a quota file.
DISKQUOTA DISABLE Suspends disk quota operations on a volume.
DISKQUOTA ENABLE Resumes disk quota operations on a volume.
DISKQUOTA MODIFY Changes an entry in the quota file or adjusts the default quota and overdraft values.
DISKQUOTA REBUILD Reconstructs the disk usage counts for all entries.
DISKQUOTA REMOVE Removes an entry from a disk quota file.
DISKQUOTA SHOW Displays disk quotas and usage counts.
DO Executes a DCL command or DCL command procedure.
++ DUMP_PRIORITY ADD Adds an entry to the System Dump Priority registry file.
++ DUMP_PRIORITY LIST Lists the contents of the System Dump Priority registry file.
++ DUMP_PRIORITY LOAD Loads the contents of the System Dump Priority registry file into memory for BUGCHECK to use.
++ DUMP_PRIORITY MODIFY Modifies an entry in the System Dump Priority registry file.
++ DUMP_PRIORITY REMOVE Removes a record from the System Dump Priority registry file.
++ DUMP_PRIORITY SHOW Lists the contents of the in-memory copy of the System Dump Priority registry file.
++ DUMP_PRIORITY UNLOAD Clears the in-memory copy of the System Dump Priority registry file.
EXIT Terminates the SYSMAN session and returns control to the DCL command level.
HELP Provides information about SYSMAN commands.
++ IO AUTOCONFIGURE Automatically identifies and configures all hardware devices attached to a system.
++ IO CONNECT Connects devices and loads device drivers.
++ IO CREATE_WWID Assigns a new device name to a new worldwide identifier (WWID).
++ IO FIND_WWID Detects all previously undiscovered tapes and medium changers.
++ IO LIST_WWID Lists all tape device worldwide identifiers (WWIDs) that are not yet configured on Fibre Channel.
++ IO LOAD Loads an I/O driver.
++ IO REBUILD Rebuilds all device configuration tables.
++ IO REPLACE_WWID Replaces one worldwide identifier (WWID) with another.
++ IO SCSI_PATH_VERIFY Checks each SCSI and FC path in the system to determine whether the attached device has been changed; if it has, the SCSI or FC path in the IO database is disconnected.
++ IO SET EXCLUDE Sets the permanent exclusion list to be used when configuring devices automatically.
++ IO SET PREFIX Sets the prefix used to build the IOGEN Configuration Building Module (ICBM) names.
++ IO SHOW BUS Lists the system's buses, node numbers, bus names, TR numbers, and base CSR addresses on the system.
++ IO SHOW DEVICE Displays information about devices, their drivers, and their I/O databases.
++ IO SHOW EXCLUDE Displays the permanent exclusion list used in the autoconfiguration of devices.
++ IO SHOW PREFIX Displays the current prefix list used to produce the IOGEN Configuration Building Module (ICBM) names.
LICENSE LOAD Activates a license that is registered in the LICENSE database.
LICENSE UNLOAD Deactivates a license that is registered in the LICENSE database.
PARAMETERS DISABLE CHECKS Inhibits range checks on system parameter values specified in subsequent PARAMETERS SET commands.
PARAMETERS ENABLE CHECKS Ensures that range checks are in effect. Enables range checks after a PARAMETERS DISABLE CHECKS command.
PARAMETERS SET Modifies the value of a system parameter in the work area.
PARAMETERS SHOW Displays the values of system parameters in the work area, plus the default, minimum, and maximum values of the parameters and their units of measure.
PARAMETERS USE Initializes the current work area with system parameter values and the name of the site-independent command procedure.
PARAMETERS WRITE Writes the system parameter values and the name of the site-independent command procedure from the work area to a parameter file, the current system parameter file, or the active system in memory.
RESERVED_MEMORY ADD On Alpha systems, reserves an amount of physical memory, referred to as a memory reservation, in the Reserved Memory Registry data file.
RESERVED_MEMORY EXTEND On Alpha systems, adds memory sections if you want to accommodate more than one Resource Affinity Domain (RAD) for a single memory reservation.
RESERVED_MEMORY FREE On running Alpha systems, frees reserved memory.
RESERVED_MEMORY LIST On Alpha systems, provides a preview of this reservation as it is currently stored in the Reserved Memory Registry data file.
RESERVED_MEMORY MODIFY On Alpha systems, allows you to modify an existing entry in the Reserved Memory Registry data file.
RESERVED_MEMORY REMOVE On Alpha systems, removes a reserved memory entry from the Reserved Memory Registry data file.
RESERVED_MEMORY SHOW On Alpha systems, displays the memory reservations on the running system.
SET ENVIRONMENT Establishes a management context for subsequent SYSMAN commands.
SET PROFILE Modifies the default device and directory and the current privileges for the current management environment, and allows you to set DCL verification for future DO commands.
SET TIMEOUT Establishes the amount of time that SYSMAN waits for a node to respond.
SHOW ENVIRONMENT Displays the current command context.
SHOW KEY Displays key definitions.
SHOW PROFILE Displays the default device and directory and the current privileges.
SHOW TIMEOUT Displays the current timeout period.
SHUTDOWN NODE Shuts down one or more nodes simultaneously with a single command line.
SPAWN Creates a subprocess of the current process, where the context of the subprocess is copied from the current process.
STARTUP ADD Adds an executable file or command procedure to the startup database.
STARTUP DISABLE Prevents a component of the startup database from executing on one or more nodes in the environment.
STARTUP ENABLE Allows a component of the startup database to execute.
STARTUP MODIFY Edits a record in the startup database describing how a startup component executes.
STARTUP REMOVE Removes one or more components from the startup database.
STARTUP SET DATABASE Determines the default database.
STARTUP SET OPTIONS Controls logging and display of information for one or more nodes in a cluster during startup.
STARTUP SHOW Displays the name of the current startup database or its contents.
SYS_LOADABLE ADD Adds an executive loaded image to the set of images loaded at boot time.
SYS_LOADABLE REMOVE Removes an executive loaded image from the set of images loaded at boot time.

++Alpha specific

@ (Execute Procedure)

Requests that SYSMAN read subsequent command input from the specific file or device.

Format

@ filespec


Parameter

filespec

Specifies either the input device or the command procedure you want to execute. The default file type is .COM. You cannot use wildcard characters in the file specification.

Description

Use the execute procedure command to execute a command procedure containing SYSMAN commands. To execute the command procedure, invoke SYSMAN, place the at sign (@) command at the beginning of a command line, then specify the file name of the command procedure.

The command procedure can contain any valid SYSMAN command.


Examples

#1

$ CREATE ENV.COM
SET ENVIRONMENT
SHOW PROFILE[Ctrl/Z]
$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> @ENV.COM

%SYSMAN-I-DEFDIR, default directory on node -- SYS$SYSROOT:[SYSMGR]
%SYSMAN-I-DEFPRIV, default process privileges on node --
        CMKRNL
        CMEXEC
        SYSNAM
        .
        .
        .
        GRPPRV
        READALL
        SECURITY
SYSMAN>
      

This example shows how to create a command procedure that sets the SYSMAN environment to the local node, and displays the current profile. These commands execute when you enter the @ENV.COM command.

#2

$ CREATE TIME.COM
SET ENVIRONMENT/CLUSTER
CONFIGURATION SHOW TIME[Ctrl/Z]
$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> @TIME

System time on node NODE23: 19-JUN-2002 13:32:19.45
System time on node NODE24: 19-JUN-2002 13:32:27.79
System time on node NODE25: 19-JUN-2002 13:32:58.66
      

This example shows how to create and execute a command procedure that shows the current date and time for all the nodes in the cluster.

ALF ADD

Adds a new record to the automatic login facility (ALF) database. You can also create records for proxy accounts.

Requires read (R) and write (W) access to the SYSALF database (SYS$SYSTEM:SYSALF.DAT by default).


Format

ALF ADD device user


Parameters

device

Specifies the terminal name or port name that you want to assign to a user name. The parameter device must be a terminal name if you do not specify qualifiers on the command line, and can be either a logical name or an abbreviated device name. This parameter accepts a maximum of 63 characters, including devices for proxy accounts.

user

Specifies the user name of the account that you want to assign to a particular terminal or port.

Qualifiers

/TERMINAL (default)

Checks whether the device name you specified is a terminal on the target system. The parameter device can be a logical name or an abbreviated device name, which SYSMAN translates to a full device name.

/PORT

Checks whether the device name you specified is a valid port. If the port name contains special characters, such as a slash (/), or if it contains lowercase letters that you want to preserve, you must enclose the port name within quotation marks (" ").

Be aware that anything within quotation marks is written literally to the ALF database file. For example, if the actual port name contains uppercase letters as well as special characters, be sure to specify uppercase letters within the quotation marks. Otherwise, a mismatch will occur between the actual port name and what is specified in the SYSALF.DAT file.

/PROXY

Checks that the device name is in the NODE::USERNAME format.

/LOG

Displays the device names and user names as they are added to the ALF database.

Description

You can use the ALF ADD command to associate a terminal or port with a particular user name. This will enable certain users to log in to certain terminals or ports without specifying a user name.

The ALF ADD command adds a new record to the ALF database.


Examples

#1

SYSMAN> ALF ADD TTA3 JBERGERON
SYSMAN> ALF ADD "MN34C3/LC-1-2" FMARTIN /PORT

      

In this example, the first command assigns terminal TTA3 to user JBERGERON. The second command assigns port MN34C3/LC-1-2 to user FMARTIN.

#2

SYSMAN> ALF ADD VMS:.ZKO.VMSORG.SYSMAN.CLIENT1::SYSTEM FOOBAR
      

In this example, VMS:.ZKO.VMSORG.SYSMAN.CLIENT1::SYSTEM is the value for the device parameter, which is assigned to FOOBAR.

ALF REMOVE

Removes one or more records from the ALF database.

Requires read (R) and write (W) access to the SYSALF database (SYS$SYSTEM:SYSALF.DAT).


Format

ALF REMOVE device


Parameter

device

Specifies the terminal name or port name whose record you want to remove from ALF. The device name is required, even if you use qualifiers with the ALF REMOVE command.

You can use wildcard characters in the terminal name or port name. For example, if you specify the device TTA*, the system removes all records that start with the string TTA. The system does not, however, remove any records that start with the string <nodename>$TTA (where <nodename> is the system's SCSNODE name). To remove records starting with $, you would have to specify $TTA* or use two wildcards: *TTA*.

If you omit wildcard characters and enter a REMOVE command, SYSMAN attempts to match the device name exactly. If more than one record matches the criteria, SYSMAN displays an error message.


Qualifiers

/USERNAME=user

Enables you to remove a record in ALF for a specific user associated with a device. You must also enter the device when you use the /USERNAME qualifier. You can use wildcard characters with the /USERNAME qualifier.

/CONFIRM

Displays a message asking you to verify that you want to remove the record.

/LOG

Displays each device name and user name after it has been removed from the ALF database.

Description

The ALF REMOVE command removes one or more records from the ALF database.

Examples

#1

SYSMAN> ALF REMOVE WORK1/USERNAME=*
      

The command in this example removes the records of the WORK1 device from the ALF datebase for all users. The asterisk (*) replaces user names.

#2

SYSMAN> ALF REMOVE */USERNAME=*
      

The command in this example removes all records from the ALF database. The first asterisk (*) replaces device names; the second asterisk replaces user names.

#3

SYSMAN> ALF REMOVE _TTA3:
SYSMAN> ALF REMOVE */USERNAME=SMITHSON

      

In this example, the first command removes the record for terminal TTA3. The second command removes all records (for all devices) assigned to user name SMITHSON.

#4

SYSMAN> ALF REMOVE *TTA*
      

The command in this example removes all records for devices containing the string TTA.

#5

SYSMAN> REMOVE TTA
      

This command produces the following error message:


%SYSMAN-E-ALFWILCRDREQ, more than one record might match - Wildcard or
unit number of device required.

Note

HP recommends that you use caution when issuing REMOVE commands from Version 6.1 or lower SYSMAN clients to Version 6.2 or higher systems.

For example, the following command issued from a system running OpenVMS Version 6.1 or lower to a system running OpenVMS Version 6.2 produces no error messages and deletes all records that match FOOBAR$TTA:


SYSMAN> SET ENVIRONMENT/NODE=FOOBAR     ! FOOBAR runs OpenVMS Version 6.2
%SYSMAN-I-ENV, current command environment:
        Individual nodes: FOOBAR
        Username SYSTEM will be used on nonlocal nodes
SYSMAN> ALF REMOVE TTA                  ! Does not produce an error message

 SYSMAN>

If you issue the same command from a system running OpenVMS Version 6.1 or lower to another system running OpenVMS Version 6.1 or lower, it produces the following error message:


%SYSMAN-I-NODERR,  error returned from node FOO
-SMI-E-ALFNOMATCH, no records matched search criteria
This is due to incorrect processing of wildcards prior to OpenVMS Version 6.2.

ALF SHOW

Displays one or more records from the ALF database.

Requires read (R) and write (W) access to the SYSALF database (SYS$SYSTEM:SYSALF.DAT).


Format

ALF SHOW [device]


Parameter

[device]

Specifies the terminal name or port name whose record you want to display. You can use wildcard characters in the terminal name or port name. Certain restrictions in wildcard matching of ALF records exist, as shown in the examples section.

Qualifiers

/USERNAME=user

Displays the records held by the specified user. You can use wildcard characters with this qualifier.

/OUTPUT[=filespec]

Directs the output of the command to a file. If you do not include a file specification with this qualifier, SYSMAN writes the output to the file SYSMAN.LIS in your default directory.

Description

The ALF SHOW command displays one or more records in the ALF database.

Examples

#1

SYSMAN> ALF SHOW TTA* /USERNAME=MANESS /OUTPUT=ALF.TXT

      

In this example, the records for all terminals named TTAx that are assigned to user MANESS are selected and directed to the file ALF.TXT.

#2

SYSMAN> ALF SHOW TTA*
      

This command displays only those records that start with the string TTA.

#3

SYSMAN> ALF SHOW TTA
      

This command displays only those records that start with the string <nodename>$TTA.

#4

SYSMAN> ALF SHOW *TTA
      

This command displays records that have device names ending with TTA.

#5

SYSMAN> ALF SHOW *TTA*
      

This command displays all records that contain the string TTA.

ATTACH

Transfers control from your current process (which then hibernates) to the specified process in your job.

The ATTACH and SPAWN commands cannot be used if your terminal has an associated mailbox.


Format

ATTACH [process-name]


Parameter

process-name

Specifies the name of a parent process or a spawned subprocess to which control passes. The process must already exist, be part of your current job tree, and share the same input stream as your current process. However, the process cannot be your current process or a subprocess created with the /NOWAIT qualifier.

Process names can contain from 1 to 15 alphanumeric characters. If a connection to the specified process cannot be made, an error message is displayed.


Qualifier

/PARENT

Enables you to attach to the parent process. If no parent process exists, you receive an error message.

Description

The ATTACH command connects your input stream to another process. You can use the ATTACH command to change control from one subprocess to another subprocess or to the parent process.

When you enter the ATTACH command, the parent process goes into hibernation and your input stream connects to the specified destination process. You can use the ATTACH command to connect to a subprocess that is part of a current job (left hibernating as a result of the SPAWN/WAIT command or another ATTACH command) as long as the connection is valid. No connection can be made to the current process, to a process that is not part of the current job, or to a process that does not exist. If you attempt any of these connections, you receive an error message.

You can also use the ATTACH command in conjunction with the SPAWN/WAIT command to return to a parent process without terminating the created subprocess. See the description of the SPAWN command for more details.


Example


$ SPAWN
%DCL-S-SPAWNED, process SYSTEM_1 spawned
%DCL-S-ATTACHED, terminal now attached to process SYSTEM_1
$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> ATTACH SYSTEM
%DCL-S-RETURNED, control returned to process SYSTEM
$
      

In this example, the SPAWN command creates a subprocess (SYSTEM_1). After you invoke SYSMAN and enter the ATTACH command, you transfer the terminal's control back to the parent process (SYSTEM).

CLASS_SCHEDULE ADD

The ADD command creates a new scheduling class.

The class scheduler provides the ability to limit the amount of CPU time that a system's users receive by placing users in scheduling classes. Each class is assigned a percentage of the overall system CPU time. As the system runs, the combined set of users in a class is limited to the percentage of CPU execution time allocated to their class.

Users might get some additional CPU time if the qualifier /WINDFALL is enabled for their scheduling class. Enabling the qualifier /WINDFALL allows the system to give a small amount of CPU time to a scheduling class when the scheduling class's allotted time has been depleted, but a free CPU is available.


Format

CLASS_SCHEDULE ADD class_name


Parameter

class_name

Specifies the name of the scheduling class. You must specify a class name with the ADD command. The maximum length for this name is 16 characters.

Qualifiers

/ACCOUNT

Specifies which user is part of this scheduling class. This is part of a user's SYSUAF record.

The syntax for this qualifier is as follows:


   [/ACCOUNT = (name1, name2,...name"n")]

/CPULIMIT

Defines the maximum amount of CPU time that this scheduling class can receive for the specified days and hours. You must specify this qualifier when adding a class.

The syntax for this qualifier is as follows:


   /CPULIMIT = ([primary], [h1-h2=time%],[h1=time%],
               [,...],[secondary],[h1-h2=time%],[h1=time%],[,...])

The h1-h2=time% syntax allows you to specify a range of hours followed by the maximum amount of CPU time (expressed as a percentage) to be associated with this set of hours. The first set of hours after the keyword PRIMARY specifies hours on primary days; the set of hours after the keyword SECONDARY specifies hours on secondary days. The hours are inclusive; if you class schedule a given hour, access extends to the end of that hour.

/PRIMEDAYS

Allows you to define which days are primary days and which days are secondary days.

The syntax for this qualifier is as follows:


    [/PRIMEDAYS = ([no]day[,...])]

You specify primary days as MON, TUE, WED, THU, FRI, SAT, and SUN. You specify secondary days as NOMON, NOTUE, NOWED, NOTHU, NOFRI, NOSAT, and NOSUN.

The default is MON through FRI and NOSAT and NOSUN. Any days omitted from the list take their default value. You can use the DCL command, SET DAY, to override the class definition of primary and secondary days.

/UIC

Specifies which users are part of this scheduling class. This is part of a user's SYSUAF record.

The syntax for this qualifier is as follows:


   [/UIC = (uic1,uic2,...uic"n")]

/USERNAME

Specifies which user is part of this scheduling class. This is part of a user's SYSUAF record.

The syntax for this qualifier is as follows:


   [/USERNAME = (name1, name2,...name"n")]

/WINDFALL

Specifies that all processes in the scheduling class are eligible for windfall.

The syntax for this qualifier is as follows:


   [/WINDFALL])

By enabling windfall, you allow processes in the scheduling class to receive a "windfall", that is, a small percentage of CPU time, when the class's allotted CPU time has been depleted, and a CPU is idle. Rather than let the CPU remain idle, you might decide that it is better to let these processes execute, even if it means giving them more than their alloted time.

The default value is for windfall to be disabled.


Description

The format for the CLASS_SCHEDULE ADD command is as follows:


SYSMAN> CLASS_SCHEDULE ADD class_name

You can use the /ACCOUNT, /UIC, or /USERNAME qualifier to specify which users are to be part of a scheduling class.

The Class Scheduler Database

The class scheduler database is a permanent database that allows OpenVMS to class schedule processes automatically after a system has been booted and rebooted. This database resides on the system disk in SYS$SYSTEM:VMS$CLASS_SCHEDULE.DATA. SYSMAN creates this file as an RMS indexed file when the first scheduling class is created with the SYSMAN command CLASS_SCHEDULE ADD.

You can have a common class scheduler database for all cluster nodes, or you can have a separate database for one node or for a small group of nodes. Using a common database can be helpful in simplifying system management. However, you must be aware of the issues raised in the following examples:

  • Example 1
    Within a single database---common or separate---you can have only one set of parameters for each class. For example,


       SYSMAN> SET ENV/NODE=X
    
       SYSMAN> CLASS ADD class1 /USERNAME=(user1) /CPULIMIT=(0-2=100%,3-23=30%)
    
       SYSMAN> SET ENV/NODE=Y
    
       SYSMAN> CLASS ADD class1 /USERNAME=(user1) /CPULIMIT=(0-2=40%,3-23=20%)
    

    With a database that is common to both nodes X and Y, the second command produces an error because you have given the same class different parameters. With separate databases for nodes X and Y, the second command works.
  • Example 2
    The system must also be able to assign a process to a unique class. You can specify the same user---or other identifying information---in several classes as long as you define these classes on separate nodes. For example:


       SYSMAN> SET ENV/NODE=X
    
       SYSMAN> CLASS ADD class1 /USERNAME=(user1) /CPULIMIT=(0-2=100%,3-23=30%)
    
       SYSMAN> SET ENV/NODE=Y
    
       SYSMAN> CLASS ADD class2 /USERNAME=(user1) /CPULIMIT=(0-2=40%,3-23=20%)
    

    This example works on a database that is common to both nodes X and Y because the two sets of parameters also have different class names. The system can determine the class for user1 by checking the node on which user1 is running.
  • Example 3
    The following example is incorrect on both common and separate databases because the system cannot determine whether user1 is a member of class1 or class2, since they are both defined for NODE X.


       SYSMAN> SET ENV/NODE=X
    
       SYSMAN> CLASS ADD class1 /USERNAME=(user1) /CPULIMIT=(0-2=100%,3-23=30%)
    
       SYSMAN> CLASS ADD class2 /USERNAME=(user1) /CPULIMIT=(0-2=40%,3-23=20%)
    
  • Example 4
    In addition to specifying nodes explicitly, as shown in the preceding examples, you can also specify that a class applies to the entire cluster. For example:


       SYSMAN> SET ENV /CLUSTER
    
       SYSMAN> CLASS ADD class1 /USERNAME=(user1) /CPULIMIT=(0-2=100%,3-23=30%)
    

    In this example, not only is class1 defined for all nodes in the cluster, but class1 will also be defined for any node that you might add to the cluster later---as long as the new node uses the same database.
    Note that if you define a class with the environment set to CLUSTER, the command SYSMAN> CLASS SHOW/FULL lists that class with the notation "Nodes: All Cluster Members," even if the database is not common to all cluster nodes. To prevent confusion, HP recommends using a common database.

Defining the Logical Name VMS$CLASS_SCHEDULE

If you wish to have a common class scheduler database on a cluster with different system disks, or if you want to have a separate database for each node on a cluster with a common system disk, on each node define the system logical name VMS$CLASS_SCHEDULE to point to the location of the database that you want that node to use. For example, in SYSTARTUP_VMS.COM, include the following command:


$ DEFINE/SYSTEM VMS$CLASS_SCHEDULE disk:[directory]VMS$CLASS_SCHEDULE.DATA

where:

disk:[directory] represents the disk and directory where you want the database file to reside.

The Class Scheduler Database and Process Creation

By using a permanent class scheduler, a process is placed in a scheduling class, if appropriate, at process creation time. When a new process is created, the system determines whether this process belongs to a scheduling class. To determine this, the system relies on data in the SYSUAF file. Because the Loginout image already has information about the process from this file, Loginout class-schedules the process if it determines that the process belongs to a scheduling class.

Two other types of processes to consider during process creation are subprocess and detached process:

  • A subprocess becomes part of the same scheduling class as the parent process, even though the subprocess might not match the criteria of the class. That is, the subprocess's user and account name and/or UIC might not be part of the class's record.
  • A detached process joins the same scheduling class as the process that creates it unless the detached process executes the LOGINOUT image (LOGINOUT.EXE) during process creation. If a detached process executes LOGINOUT, it joins a class if it matches the class criteria in the class scheduler database.

Although a process can join a scheduling class at process creation time, you can change or modify its scheduling class during runtime with the SET PROCESS/SCHEDULING_CLASS command.

Determining If a Process is Class-Scheduled

You can determine whether a process is class-scheduled by any of the following methods:

  • Either of the following DCL commands:


    $ SHOW SYSTEM/SCHEDULING_CLASS
    $ SHOW SYSTEM/FULL
    

    For more information about the DCL command SHOW SYSTEM, see HP OpenVMS DCL Dictionary: N--Z.
  • The SYS$GETJPI system service, using the JPI$_SCHED_CLASS_NAME item
    For more information about the SYS$GETJPI system service, see HP OpenVMS System Services Reference Manual: A--GETUAI.
  • The AUTHORIZE utility
    When a new user is added to the SYSUAF file, or when a user's record is modified, AUTHORIZE searches the class scheduler database file to determine if this user is a member of a scheduling class. If it is, then AUTHORIZE displays the following message:


    UAF-I-INCLASS, user belongs to at least 1 selecting class
    

    For more information about the AUTHORIZE utility, refer to that chapter in this manual.

CLASS_SCHEDULE DELETE

The DELETE subcommand deletes a scheduling class from the class scheduler database file.

Format

CLASS_SCHEDULE DELETE class_name


Parameter

class_name

Specifies the name of the scheduling class. You must specify a class name with the DELETE command. The maximum length for this name is 16 characters.

Qualifiers

None.

CLASS_SCHEDULE MODIFY

The MODIFY subcommand changes the characteristics of a scheduling class.

Format

CLASS_SCHEDULE MODIFY class_name


Parameter

class_name

Specifies the name of the scheduling class. You must specify a class name with the MODIFY command. The maximum length for this name is 16 characters.

Qualifiers

/ACCOUNT

Specifies which user is part of this scheduling class. This is part of a user's SYSUAF record.

The syntax for this qualifier is as follows:


   [/ACCOUNT = (name1, name2,...name"n")]

/CPULIMIT

Defines the maximum amount of CPU time that this scheduling class can receive for the specified days and hours. You must specify this qualifier when adding a class.

The syntax for this qualifier is as follows:


   /CPULIMIT = ([primary], [h1-h2=time%],[h1=time%],
               [,...],[secondary],[h1-h2=time%],[h1=time%],[,...])

The h1-h2=time% syntax allows you to specify a range of hours followed by the maximum amount of CPU time (expressed as a percentage) to be associated with this set of hours. The first set of hours after the keyword PRIMARY specifies hours on primary days; the set of hours after the keyword SECONDARY specifies hours on secondary days. The hours are inclusive; if you class schedule a given hour, access extends to the end of that hour.

/PRIMEDAYS

Allows you to define which days are primary days and which days are secondary days.

The syntax for this qualifier is as follows:


    [/PRIMEDAYS = ([no]day[,...])]

You specify primary days as MON, TUE, WED, THU, FRI, SAT, and SUN. You specify secondary days as NOMON, NOTUE, NOWED, NOTHU, NOFRI, NOSAT, and NOSUN.

The default is MON through FRI and NOSAT and NOSUN. Any days omitted from the list take their default value. You can use the DCL command, SET DAY, to override the class definition of primary and secondary days.

/UIC

Specifies which users are part of this scheduling class. This is part of a user's SYSUAF record.

The syntax for this qualifier is as follows:


   [/UIC = (uic1,uic2,...uic"n")]

/USERNAME

Specifies which user is part of this scheduling class. This is part of a user's SYSUAF record.

The syntax for this qualifier is as follows:


   [/USERNAME = (name1, name2,...name"n")]

/WINDFALL

Specifies that all processes in the scheduling class are eligible for windfall.

The syntax for this qualifier is as follows:


   [/WINDFALL])

By enabling windfall, you allow processes in the scheduling class to receive a "windfall," that is, a small percentage of CPU time, when the class's allotted CPU time has been depleted and a CPU is idle. Rather than let the CPU remain idle, you might decide that it is better to let these processes execute, even if it means giving them more than their alloted time.

The default value is for windfall to be disabled.


Description

To remove a time restriction, specify a zero (0) for the time percentage associated with a particular range of hours.

To remove a name or uic value, you must specify a minus sign in front of each name or value.

CLASS_SCHEDULE RESUME

The RESUME subcommand complements the suspend command. You use this command to resume a scheduling class that is currently suspended.

Format

CLASS_SCHEDULE RESUME class_name


Parameter

class_name

Specifies the name of the scheduling class. You must specify a class name with the RESUME command. The maximum length for this name is 16 characters.

Qualifiers

None.

CLASS_SCHEDULE SHOW

The SHOW subcommand displays the characteristics of a scheduling class.

Format

CLASS_SCHEDULE SHOW [class_name] [/qualifier]


Parameter

class_name

Specifies the name of the scheduling class. You must specify a class name or the /ALL qualifier with the SHOW command. The maximum length for the class name is 16 characters.

Qualifiers

/ALL

Displays all scheduling classes. The qualifier must be specified if no class name is given.

/FULL

Displays all information about this scheduling class.

Description

By default, a limited display of data is shown by the SHOW subcommand. The default displays the following:
  • Name
  • Maximum CPU time or times for each range of hours
  • Primary days and secondary days
  • Windfall settings

CLASS_SCHEDULE SUSPEND

The SUSPEND subcommand suspends the specified scheduling class.

Format

CLASS_SCHEDULE SUSPEND class_name


Parameter

class_name

Specifies the name of the scheduling class. You must specify a class name with the SUSPEND command. The maximum length for this name is 16 characters.

Qualifiers

None.

Description

When you suspend a scheduling class, all processes that are part of the scheduling class remain as part of the class but are granted unlimited CPU time.

CONFIGURATION SET CLUSTER_AUTHORIZATION

Modifies security data in a local area cluster.

Requires SYSPRV privilege.


Format

CONFIGURATION SET CLUSTER_AUTHORIZATION


Parameters

None.

Qualifiers

/GROUP_NUMBER=[n]

Specifies the cluster group number that is recorded in SYS$SYSTEM:CLUSTER_AUTHORIZE.DAT. A group number uniquely identifies each local area cluster on a single Ethernet. This number must be in the range from 1 to 4095 or 61440 to 65535.

/PASSWORD=password

Specifies a password for cluster access. A password consists of 1 to 31 characters, including alphanumeric characters, dollar signs, and underscores. A password provides a second level of validation to ensure the integrity of individual clusters on the same Ethernet that accidentally use identical group numbers. A password also prevents an intruder who discovers the group number from joining the cluster.

Description

The CONFIGURATION SET CLUSTER_AUTHORIZATION command modifies the group number and password of a local area cluster, as recorded in SYS$SYSTEM:CLUSTER_AUTHORIZE.DAT. If your configuration has multiple system disks, SYSMAN automatically updates each copy of CLUSTER_AUTHORIZE.DAT, provided the environment is defined as a cluster (SET ENVIRONMENT/CLUSTER). For more information about CLUSTER_AUTHORIZE.DAT, refer to OpenVMS Cluster Systems.

Caution

If you change either the group number or the password, you must reboot the entire cluster.

The file CLUSTER_AUTHORIZE.DAT is initialized during execution of CLUSTER_CONFIG.COM and maintained through SYSMAN. Under normal conditions, altering records in the CLUSTER_AUTHORIZE.DAT file interactively is not necessary. To protect the integrity of the cluster membership use the CONFIGURATION SET CLUSTER_AUTHORIZATION command.


Example


SYSMAN> SET ENVIRONMENT/CLUSTER/NODE=NODE21
SYSMAN> SET PROFILE /PRIVILEGES=SYSPRV
SYSMAN> CONFIGURATION SET CLUSTER_AUTHORIZATION/PASSWORD=GILLIAN
%SYSMAN-I-CAFOLDGROUP, existing group will not be changed
%SYSMAN-I-GRPNOCHG, Group number not changed
SYSMAN-I-CAFREBOOT, cluster authorization file updated.
The entire cluster should be rebooted.

      

The CONFIGURATION SET CLUSTER_AUTHORIZATION command in this example sequence modifies the cluster password. Note that the environment is defined to be a cluster, and the SYSPRV privilege is established before entering the CONFIGURATION SET CLUSTER_AUTHORIZATION command.

CONFIGURATION SET TIME

Modifies the current system time.

Requires OPER, LOG_IO, and SYSPRV privileges, and, in a cluster environment, SYSLCK privilege.


Format

CONFIGURATION SET TIME [time]


Parameters

None.

Qualifiers

None.

Description

The CONFIGURATION SET TIME command enables you to reset the system time. Specify a time value using the following format:

[dd-mmm-yyyy[:]] [hh:mm:ss.cc]

You can also enter a delta time value. Refer to the OpenVMS User's Manual for more information about time formats.

In an environment of individual nodes, SYSMAN sets the time to the specified value on each node. Without a time specification, SYSMAN sets the time according to the time-of-year clock on each node.

In an OpenVMS Cluster environment, SYSMAN sets the time to the specified value on each node. If you do not specify a value, SYSMAN uses the time-of-year clock. In a local cluster, SYSMAN reads the clock on the node from which you are executing SYSMAN and assigns this value to all nodes in the cluster. In a remote OpenVMS Cluster, SYSMAN reads the clock on the target node in the cluster and assigns that value to all nodes. Note that the time-of-year clock is optional for some processors; refer to your processor handbook for further information.

SYSMAN uses special processing in an OpenVMS Cluster environment to ensure that all processors in the cluster are set to the same time. Because of communication and processing delays, it is not possible to synchronize clocks exactly. However, the variation is typically less than a few hundredths of a second. If SYSMAN cannot set the time to within one half second of the specified time, you receive a warning message that names the node that failed to respond quickly enough.

As a result of slight inaccuracies in each processor clock, times on various members of a cluster tend to drift apart. The following procedure synchronizes system times in a cluster environment:


$  SYNCH_CLOCKS:
$  RUN SYS$SYSTEM:SYSMAN
       SET ENVIRONMENT/CLUSTER
       CONFIGURATION SET TIME
       EXIT
$  WAIT 6:00:00
$  GOTO SYNCH_CLOCKS

The procedure sets the time on all cluster nodes to the value obtained from the local time-of-year clock, waits 6 hours, then resets the time for the cluster.


Example


SYSMAN> SET ENVIRONMENT/NODE=(NODE21,NODE22,NODE23)
SYSMAN> SET PROFILE /PRIVILEGE=LOG_IO
SYSMAN> CONFIGURATION SET TIME 12:38:00
      

The CONFIGURATION SET TIME command in this example sequence modifies the system time on NODE21, NODE22, and NODE23.

CONFIGURATION SHOW CLUSTER_AUTHORIZATION

Displays the group number and multicast address of a local area cluster.

Requires SYSPRV privilege.


Format

CONFIGURATION SHOW CLUSTER_AUTHORIZATION


Parameters

None.

Qualifier

/OUTPUT[=filespec]

Redirects output from SYS$OUTPUT to the specified file. If no file specification is provided, SYSMAN writes the output to SYSMAN.LIS in the current directory.

Description

The CONFIGURATION SHOW CLUSTER_AUTHORIZATION command displays the group number and multicast address, and Ethernet address used to send a message to all nodes in the cluster. The group number and multicast address are recorded in SYS$SYSTEM:CLUSTER_AUTHORIZE.DAT during the CLUSTER_CONFIG dialog.

In a cluster or multinode environment, SYSMAN displays the group number of the first node and then displays the names of any nodes in the cluster whose group numbers, passwords, or both, are different.


Example


SYSMAN> SET ENVIRONMENT/CLUSTER/NODE=NODE21
.
.
.
SYSMAN> SET PROFILE /PRIVILEGE=SYSPRV
SYSMAN> CONFIGURATION SHOW CLUSTER_AUTHORIZATION
Node NODE23: Cluster group number 65240
Multicast address: AB-00-04-01-F2-FF

      

The CONFIGURATION SHOW CLUSTER_AUTHORIZATION command in this example displays the group number and multicast address of NODE21. Because the group number and password on other nodes in the cluster are identical, no further information is displayed.

CONFIGURATION SHOW TIME

Displays the current date and system time to the nearest hundredth of a second.

Format

CONFIGURATION SHOW TIME


Parameters

None.

Qualifier

/OUTPUT[=filespec]

Redirects output from SYS$OUTPUT to the specified file. If no file specification is provided, SYSMAN writes the output to SYSMAN.LIS in the current directory.

Example


SYSMAN> SET ENVIRONMENT/CLUSTER/NODE=NODE21
.
.
.
SYSMAN> CONFIGURATION SHOW TIME
System time on node NODE21:  19-JUN-2002 13:32:19.45
System time on node NODE22:  19-JUN-2002 13:32:27.79
System time on node NODE23:  19-JUN-2002 13:32:58.66
      

The CONFIGURATION SHOW TIME command in this example displays the system times for all nodes in the cluster.

DEFINE/KEY

Defines a key to execute a SYSMAN command. This enables you to press the key to enter a command, instead of typing the command name.

Format

DEFINE/KEY key-name string


Parameters

key-name

Specifies the name of the key you are defining. Use the key names in the following table when defining keys:
Key Name VT100 LK201/LK401
PF1 PF1 PF1
PF2 PF2 PF2
PF3 PF3 PF3
PF4 PF4 PF4
KP0, KP1--KP9 keypad 0--9 keypad 0--9
PERIOD period key period key
COMMA comma key comma key
MINUS minus key minus key
ENTER ENTER key ENTER key
UP, DOWN, LEFT, RIGHT arrow keys arrow keys
FIND, INSERT_HERE -- Find, Insert Here keys
REMOVE, SELECT -- Remove, Select keys
PREV_SCREEN -- Previous Screen key
NEXT_SCREEN -- Next Screen key
HELP, DO -- Help, Do keys
F6--F10, F11--F14 -- function keys
F17--F20 -- function keys

string

Specifies the string you want entered when you press the defined key. For example, you can define string as the SYSMAN command SHOW ENVIRONMENT or SHOW PROFILE.

Qualifiers

/ECHO (default)

/NOECHO

Specifies whether the command line echoes after you press the defined key. Note that you cannot define a key using both the /NOECHO and /NOTERMINATE qualifiers.

/IF_STATE=state_list

/NOIF_STATE

Specifies a list of states, any one of which must be set in order to enable the specified key definition. If you omit or negate this qualifier, the current state prevails.

/LOCK_STATE

/NOLOCK_STATE (default)

Retains the state specified by the /SET_STATE qualifier until you use the /SET_STATE qualifier again to change it.

/SET_STATE

/NOSET_STATE

Associates a state with the key you are defining. A state name can be any alphanumeric string. If you omit or negate this qualifier, the current state remains unchanged. You cannot define a key using both the /SET_STATE and /TERMINATE qualifiers.

/TERMINATE

/NOTERMINATE

Determines whether the specified command string executes when you press the key. When you use /NOTERMINATE, you must press the Return key to execute the command string. You cannot define a key using both the /SET_STATE and /TERMINATE qualifiers.

Description

The DEFINE/KEY command assigns a key to a SYSMAN command. This enables you to execute the command by pressing the key. You can confirm which keys you have defined by using the SHOW KEY command.

When you exit from SYSMAN, any SYSMAN key definitions you established will be lost unless you define them in a SYSMAN initialization file. (See Section 22.1.2.)


Examples

#1

SYSMAN> DEFINE /KEY PF1 "SHOW PROFILE"
      

This example shows how to define the keypad key PF1 as the SYSMAN command SHOW PROFILE. To execute the SHOW PROFILE command, press PF1 and then the Return key.

#2

SYSMAN> DEFINE /KEY KP0 /TERMINATE "CONFIGURATION SHOW TIME"
      

This example shows how to define the keypad key 0 as the CONFIGURATION SHOW TIME command. The /TERMINATE qualifier causes the SYSMAN command to execute when you press keypad key 0 without having to press Return.

DISKQUOTA ADD

Adds an entry to a disk quota file and initializes the usage count to zero.

Requires write (W) access to the quota file.


Format

DISKQUOTA ADD owner


Parameter

owner

Specifies the user identification code (UIC) or rights identifier for which the quota entry is added. You can specify the UIC in numeric or alphanumeric format. For complete information about UIC specification, refer to the HP OpenVMS Guide to System Security.

Rights identifiers are granted with the Authorize utility and use an ID format rather than a UIC format. Refer to the OpenVMS Programming Concepts Manual for a complete description of rights identifiers.

When working in nonlocal environments, be careful that the alphanumeric UIC or rights identifiers that you use are valid for the environment.


Qualifiers

/DEVICE=device-spec

Specifies the location of the quota file. SYSMAN validates the device specification. You can specify a logical name for device-spec. If you do, the logical name is translated in the target environment.

Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.

/OVERDRAFT=value

Specifies a positive integer that provides an overdraft value for the specified UIC. If omitted, the overdraft value defaults to the overdraft value in the entry for [0,0].

/PERMQUOTA=value

Specifies a positive integer that provides the quota for the specified UIC. If omitted, the permanent quota defaults to the value of the quota in the entry for [0,0].

Description

The DISKQUOTA ADD command appends individual entries to a quota file on the specified disk. Note that the quota file must already exist and be enabled.

Unless you specify the permanent quota and overdraft values, SYSMAN applies the default values from the UIC entry [0,0]. You adjust UIC [0,0] with the DISKQUOTA MODIFY command.


Example


SYSMAN> SET ENVIRONMENT/NODE=(NODE22,NODE21) (1)
%SYSMAN-I-ENV, Current command environment:
        Individual nodes: NODE22,NODE21
        Username ALEXIS    will be used on nonlocal nodes.
SYSMAN> SET PROFILE /PRIVILEGE=SYSPRV (2)
SYSMAN> DISKQUOTA ADD [MKT,MORSE] /DEVICE=WORK1 -
_SYSMAN> /PERMQUOTA=200 /OVERDRAFT=50    (3)
SYSMAN> DISKQUOTA ADD PAYROLL /DEVICE=WORK1 /PERMQUOTA=1000 (4)


      

  1. Defines the management environment to be NODE22 and NODE21.
  2. Adds SYSPRV privilege to the user's current privileges in order to write to the quota file.
  3. Adds UIC [MKT,MORSE] to the quota file on the device named WORK1 on both NODE22 and NODE21, setting the permanent quota to 200 disk blocks and the overdraft limit to 50 disk blocks, for an absolute limit of 250 blocks.
    If the user name MORSE has a unique UIC on the system, you can enter the following command:


    SYSMAN> DISKQUOTA ADD MORSE
    
  4. Adds an entry for the rights identifier PAYROLL. Any user holding the PAYROLL identifier can use this disk space.

DISKQUOTA CREATE

Creates and enables a quota file for a disk volume that does not currently contain one.

Requires write (W) access to the volume's master file directory (MFD), plus one of the following items: SYSPRV privilege, a system UIC, or ownership of the volume.


Format

DISKQUOTA CREATE


Parameters

None.

Qualifier

/DEVICE=device-spec

Specifies the disk volume on which to create a quota file. SYSMAN validates the device specification. A logical name may be specified for device-spec. If so, it is translated in the target environment.

Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.


Description

The DISKQUOTA CREATE command creates a quota file for a volume that does not currently have one.

Only one quota file, [000000]QUOTA.SYS, can be present on any volume or volume set. As soon as you create a quota file, establish default values for quotas and overdrafts by adjusting UIC [0,0] with the DISKQUOTA MODIFY command. When a disk has existing files, use the DISKQUOTA REBUILD command to have SYSMAN update the quota file to contain current usage values.

Note

HP recommends that you do not create and enable a quota file on the system disk unless users are allowed to create files on that disk.

Example


SYSMAN> SHOW ENVIRONMENT
%SYSMAN-I-ENV, Current command environment:
        Node NODE24 of local cluster
        Username ALEXIS    will be used on nonlocal nodes

SYSMAN> DO SHOW DEVICES
.
.
.
SYSMAN> DISKQUOTA CREATE /DEVICE=DJA31:
SYSMAN> DISKQUOTA MODIFY /DEVICE=DJA31: [0,0] -
_SYSMAN> /PERMQUOTA=10000 /OVERDRAFT=100

      

The commands in this example sequence display the characteristics of the current management environment and verify the device name. Then they create a quota file on the disk DJA31 and set up default quota values.

DISKQUOTA DELETE

Removes an entry from a quota file.

See the command DISKQUOTA REMOVE for more information. The DISKQUOTA REMOVE and DISKQUOTA DELETE commands perform the same function.

DISKQUOTA DISABLE

Suspends the maintenance and enforcement of disk quotas on a volume in the current management environment; this applies to each node that has the disk mounted.

Caution

To use the DISKQUOTA DISABLE command on a disk that has been mounted on multiple nodes in a cluster, you must first specify the nodes in the SET ENVIRONMENT command.

Requires SYSPRV privilege, a system UIC, or ownership of the volume.


Format

DISKQUOTA DISABLE


Parameters

None.

Qualifier

/DEVICE=device-spec

Specifies a disk volume on which to disable a quota file. SYSMAN validates the device specification. A logical name may be specified for device-spec. If so, it is translated in the target environment.

Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.


Description

The DISKQUOTA DISABLE command suspends quota operations on a volume. To permanently disable quotas on a device, disable the quotas with the DISKQUOTA DISABLE command and delete the file [000000]QUOTA.SYS. Otherwise, the system implicitly enables quotas when the disk is mounted, leaving invalid quota information.

If you enable the quota file later, enter the DISKQUOTA REBUILD command to update UIC entries and usage counts.


Examples

#1

SYSMAN> SET ENVIRONMENT/NODE=(AMANDA,BARRY)
SYSMAN> DISKQUOTA DISABLE /DEVICE=DJA1:
      

These commands suspend quota enforcement on disk DJA1, which is mounted on nodes AMANDA and BARRY.

#2

SYSMAN> SET ENVIRONMENT/CLUSTER (1)
%SYSMAN-I-ENV, current command environment:
        Clusterwide on local cluster
        Username STEIN    will be used on nonlocal nodes

SYSMAN> DO SHOW QUOTA/DISK=$6$dkd0:/USER=[0,0] (2)
%SYSMAN-I-OUTPUT, command execution on node WALTER
  User [0,0] has 0 blocks used, 1000 available,
  of 1000 authorized and permitted overdraft of 100 blocks on $6$DKD0
%SYSMAN-I-OUTPUT, command execution on node ARTOS2
  User [0,0] has 0 blocks used, 1000 available,
  of 1000 authorized and permitted overdraft of 100 blocks on $6$DKD0
%SYSMAN-I-OUTPUT, command execution on node ARTOS1
  User [0,0] has 0 blocks used, 1000 available,
  of 1000 authorized and permitted overdraft of 100 blocks on $6$DKD0
%SYSMAN-I-OUTPUT, command execution on node EXPERT
  User [0,0] has 0 blocks used, 1000 available,
  of 1000 authorized and permitted overdraft of 100 blocks on $6$DKD0

SYSMAN> DISKQUOTA DISABLE/DEVICE=$6$dkd0: (3)
SYSMAN> DO SHOW QUOTA/DISK=$6$dkd0:/USER=[0,0] (4)
%SYSMAN-I-OUTPUT, command execution on node WALTER
%SYSTEM-F-QFNOTACT, disk quotas not enabled on this volume
%SYSMAN-I-OUTPUT, command execution on node ARTOS2
%SYSTEM-F-QFNOTACT, disk quotas not enabled on this volume
%SYSMAN-I-OUTPUT, command execution on node ARTOS1
%SYSTEM-F-QFNOTACT, disk quotas not enabled on this volume
%SYSMAN-I-OUTPUT, command execution on node EXPERT
%SYSTEM-F-QFNOTACT, disk quotas not enabled on this volume
SYSMAN>


      

In this example, the disk $6$dkd0: has been mounted clusterwide.

  1. The SET ENVIRONMENT command sets the environment for all nodes in the cluster.
  2. The output of this DO SHOW QUOTA command shows that disk quotas are enabled over the cluster.
  3. The DISKQUOTA DISABLE command disables disk quotas over the entire cluster.
  4. The output of this DO SHOW QUOTA command shows that disk quotas have been disabled.

DISKQUOTA ENABLE

Resumes quota enforcement on a disk volume in the current management environment; this applies to each node that has the disk mounted.

Caution

To use the DISKQUOTA ENABLE command on a disk that has been mounted on multiple nodes in a cluster, you must first specify the nodes in the SET ENVIRONMENT command.

Requires SYSPRV privilege, a system UIC, or ownership of the volume.


Format

DISKQUOTA ENABLE


Parameters

None.

Qualifier

/DEVICE=device-spec

Specifies a disk volume on which to enable the quota file. SYSMAN validates the device specification. A logical name may be specified for device-spec. If so, it is translated in the target environment.

Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.


Description

The DISKQUOTA ENABLE command reinstates the enforcement of quotas on a volume that had been suspended with the DISKQUOTA DISABLE command. Whenever you enable quotas on a volume, use the DISKQUOTA REBUILD command to update UIC entries and usage counts.

Examples

#1

SYSMAN> SET ENVIRONMENT/NODE=(NODE21,NODE22)
SYSMAN> DISKQUOTA ENABLE
SYSMAN> DISKQUOTA REBUILD
      

The DISKQUOTA ENABLE command in this example resumes quota enforcement on the default disk DJA12, which is mounted on NODE21 and NODE22. The DISKQUOTA REBUILD command updates the quota file, correcting quotas and adding any new entries.

#2

SYSMAN> SET ENVIRONMENT/CLUSTER (1)
%SYSMAN-I-ENV, current command environment:
        Clusterwide on local cluster
        Username STEIN    will be used on nonlocal nodes

SYSMAN> DO SHOW QUOTA/DISK=$6$dkd0:/USER=[0,0] (2)
%SYSMAN-I-OUTPUT, command execution on node WALTER
%SYSTEM-F-QFNOTACT, disk quotas not enabled on this volume
%SYSMAN-I-OUTPUT, command execution on node ARTOS2
%SYSTEM-F-QFNOTACT, disk quotas not enabled on this volume
%SYSMAN-I-OUTPUT, command execution on node ARTOS1
%SYSTEM-F-QFNOTACT, disk quotas not enabled on this volume
%SYSMAN-I-OUTPUT, command execution on node EXPERT
%SYSTEM-F-QFNOTACT, disk quotas not enabled on this volume

SYSMAN> DISKQUOTA ENABLE/DEVICE=$6$dkd0: (3)
SYSMAN> DO SHOW QUOTA/DISK=$6$dkd0:/USER=[0,0] (4)
%SYSMAN-I-OUTPUT, command execution on node WALTER
  User [0,0] has 0 blocks used, 1000 available,
  of 1000 authorized and permitted overdraft of 100 blocks on $6$DKD0
%SYSMAN-I-OUTPUT, command execution on node ARTOS2
  User [0,0] has 0 blocks used, 1000 available,
  of 1000 authorized and permitted overdraft of 100 blocks on $6$DKD0
%SYSMAN-I-OUTPUT, command execution on node ARTOS1
  User [0,0] has 0 blocks used, 1000 available,
  of 1000 authorized and permitted overdraft of 100 blocks on $6$DKD0
%SYSMAN-I-OUTPUT, command execution on node EXPERT
  User [0,0] has 0 blocks used, 1000 available,
  of 1000 authorized and permitted overdraft of 100 blocks on $6$DKD0

      

In this example, the disk $6$dkd0: has been mounted clusterwide.

  1. The SET ENVIRONMENT command sets the environment for all nodes in the cluster.
  2. The output of this DO SHOW QUOTA command shows that disk quotas have not been enabled.
  3. The DISKQUOTA ENABLE command enables disk quotas over the entire cluster.
  4. The output of this DO SHOW QUOTA command shows that disk quotas have been enabled over the cluster.

DISKQUOTA MODIFY

Changes an entry in a quota file or adjusts default values for quotas and overdrafts. If a new quota limit is less than the current usage count, SYSMAN issues a warning message before it implements the new quota.

Requires write (W) access to the quota file.


Format

DISKQUOTA MODIFY owner


Parameter

owner

Specifies the user identification code (UIC) or rights identifier. You can specify the UIC in numeric or alphanumeric format. For complete information about UIC specification, refer to the HP OpenVMS Guide to System Security.

Rights identifiers are granted with the Authorize utility and use an ID format rather than a UIC format. Refer to the OpenVMS Programming Concepts Manual for a complete description of rights identifiers.

When working in nonlocal environments, make sure that the alphanumeric UIC or rights identifiers that you use are valid for the environment.


Qualifiers

/DEVICE=device-spec

Specifies the disk volume that contains the quota file. SYSMAN validates the device specification. A logical name may be specified for device-spec. If so, it is translated in the target environment.

Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.

/OVERDRAFT=value

Specifies a positive integer that provides an overdraft value for the specified UIC. If you omit a value, the overdraft value defaults to the overdraft value in the entry for [0,0].

/PERMQUOTA=value

Specifies a positive integer that provides the quota for the specified UIC. If you omit a value, the permanent quota defaults to the value of the quota in the entry for [0,0].


Description

The DISKQUOTA MODIFY command changes values in a quota file for the disk named in the device specification. If you establish a quota limit that is less than the current usage count, a user can still log in and out, but cannot create files.

After creating a quota file, use the DISKQUOTA MODIFY command to set default values for quotas and overdrafts. UIC [0,0] sets the default permanent quota and overdraft values for a quota file, so you must change the entry [0,0] to values appropriate for your installation. Unless you specify quota and overdraft values when adding a file entry, SYSMAN applies these defaults to UIC entries.


Examples

#1

SYSMAN> SET ENVIRONMENT/NODE=NODE21
SYSMAN> DISKQUOTA MODIFY /DEVICE=DUA12: [0,0] -
_SYSMAN> /PERMQUOTA=3000 /OVERDRAFT=300
      

The commands in this example edit the entry for UIC [0,0] in the quota file on DUA12, which is located on NODE21.

#2

SYSMAN> DISKQUOTA MODIFY /DEVICE=SYS$DISK1 [TTD,DAVIS] -
_SYSMAN> /PERMQUOTA=900
      

This command sets the permanent quota for UIC [TTD,DAVIS] to 900 blocks, while making no change to the overdraft limit. SYSMAN modifies the quota file that is located on disk SYS$DISK1 in the current environment.

If the user name DAVIS has a unique UIC on the system, you can enter the following command:


SYSMAN> DISKQUOTA MODIFY DAVIS/PERMQUOTA=900

DISKQUOTA REBUILD

Updates a quota file, adding new UICs and correcting usage counts for each user on the volume.

Requires write (W) access to the quota file, plus one of the following items: SYSPRV privilege, a system UIC, or ownership of the volume.


Format

DISKQUOTA REBUILD


Parameters

None.

Qualifier

/DEVICE=device-spec

Specifies the disk volume that contains the quota file. SYSMAN validates the device specification and translates any logical name in the target environment before rebuilding the file.

Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.


Description

The DISKQUOTA REBUILD command reads the disk, recalculates usage counts for all existing entries in QUOTA.SYS, and adds new entries. It sets quota and overdraft values to the defaults set in UIC [0,0] if the entry did not previously exist. While the DISKQUOTA REBUILD command is executing, file activity on the volume is frozen. No files can be created, deleted, extended, or truncated.

Use the DISKQUOTA REBUILD command in the following circumstances:

  • After creating a quota file on a volume with existing files.
  • When the quota file has been enabled after a period of being disabled. The command corrects the usage counts and adds any new UICs.

Example


SYSMAN> SET ENVIRONMENT /NODE=NODE21
SYSMAN> SET PROFILE /PRIVILEGE=SYSPRV
SYSMAN> DISKQUOTA ENABLE /DEVICE=DUA226:
SYSMAN> DISKQUOTA REBUILD /DEVICE=DUA226:
      

These commands enable the quota file and reconstruct the usage counts for all entries on disk DUA226, which is located on node NODE21.

DISKQUOTA REMOVE

Removes an entry from a quota file.

Requires write (W) access to the quota file.


Format

DISKQUOTA REMOVE owner


Parameter

owner

Specifies the user identification code (UIC) or rights identifier. You can specify the UIC in numeric or alphanumeric format. For complete information about UIC specification, refer to the HP OpenVMS Guide to System Security.

Rights identifiers are granted with the Authorize utility and use an ID format rather than a UIC format. For more information about rights identifiers, refer to the OpenVMS Programming Concepts Manual.

When working in nonlocal environments, be careful that the alphanumeric UIC or rights identifiers that you use are valid for the environment.


Qualifier

/DEVICE=device-spec

Specifies the disk volume containing the quota file. SYSMAN validates the device specification and translates any logical name in the target environment before deleting the UIC entry.

Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.


Description

The DISKQUOTA REMOVE command eliminates the specified UIC from the quota file on the named device.

If the usage count for the UIC is not zero, files remain on disk and the user can still log in, but any attempt to create or extend files will fail.

The UIC [0,0] entry cannot be removed.


Example


SYSMAN> SET ENVIRONMENT/NODE=MARS
SYSMAN> SHOW PROFILE
%SYSMAN-I-DEFDIR, Default directory on node MARS  -- WORK2:[CASEY]
%SYSMAN-I-DEFPRIV, Process privileges on node MARS --
        TMPMGX
        OPER
        NETMBX
        SYSPRV

SYSMAN> DISKQUOTA REMOVE /DEVICE=DUA45: [TTD,DAVIS]
      

These commands remove UIC [TTD,DAVIS] from the quota file for disk DUA45, which is located on node MARS.

DISKQUOTA SHOW

Displays quotas, overdrafts, and usage counts.

Requires no additional privileges to display your own quota, overdraft, and usage count, but otherwise requires read (R) access to the quota file.


Format

DISKQUOTA SHOW owner


Parameter

owner

Specifies the user identification code (UIC) or rights identifier. You can specify the UIC in numeric or alphanumeric format. For complete information about UIC specification, refer to the HP OpenVMS Guide to System Security.

Rights identifiers are granted with the Authorize utility and use an ID format rather than a UIC format. Refer to the OpenVMS Programming Concepts Manual for a complete description of rights identifiers.

You can use an asterisk wildcard character (*) to specify the quota entry as follows:

Command Description
DISQUOTA SHOW CJ Show user CJ (if CJ has a unique UIC on the system)
DISKQUOTA SHOW [TTD,CJ] Show user CJ in group TTD
DISKQUOTA SHOW [TTD,*] Show all users in group TTD
DISKQUOTA SHOW * Show all entries

Qualifiers

/DEVICE=device-spec

Specifies the disk volume containing the quota file. DISKQUOTA validates device specification and translates any logical name in the target environment before displaying UIC entries.

Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.

/OUTPUT[=filespec]

Directs output to the specified file. Without a file specification, /OUTPUT defaults to SYSMAN.LIS in the current directory on the local node where you are running SYSMAN.

Example


SYSMAN> DISKQUOTA SHOW [ACCT,*]
      

This command displays quotas, overdrafts, and usage counts for all users in group ACCT on the default disk.

DO

Executes a DCL command or DCL command procedure on all nodes in the current management environment.

Requires the privileges of the DCL command being executed.


Format

DO [command-line]


Parameter

command-line

Specifies a command string that SYSMAN passes to the command line interface (CLI) for execution.

The command DO RUN SYS$SYSTEM:SYSMAN [SYSMAN-command] is not supported. Instead, follow these steps:

  1. Enter RUN SYS$SYSTEM:SYSMAN at the dollar ($) prompt.
  2. At the SYSMAN> prompt, set the environment to the selected node or nodes with the SET ENVIRONMENT command.
  3. Enter a SYSMAN command at the SYSMAN> prompt.

For complete information about DCL command syntax, refer to the HP OpenVMS DCL Dictionary.


Qualifiers

/CONFIRM

Verifies that you want to perform a DO command on each node you have specified with the SYSMAN command SET ENVIRONMENT.

When you use the /CONFIRM qualifier, the system prompts you as follows:


Execute command for node <nodename>? [N]:

The following responses are valid:


     YES      NO       QUIT       ALL
     TRUE     FALSE    [Ctrl/Z]
     1        0        [Ctrl/C]
              [Return]

Usage Notes

  • Affirmative answers are YES, TRUE, and 1.
  • Negative answers are NO, FALSE, 0, and pressing the Return key.
  • You can use any combination of uppercase and lowercase letters for word responses.
  • You can abbreviate word responses to one or more letters (for example, T, TR, or TRU for TRUE), but these abbreviations must be unique.
  • Entering QUIT or pressing Ctrl/C or Ctrl/Z indicates that you want to stop processing the command at that point.
  • When you enter ALL, the command continues to process, but the system displays no further prompts.
  • If you type a response that is not valid, SYSMAN issues an error message and redisplays the prompt.

/OUTPUT[=filespec]

Records output from the command in the specified file, which is located on the node from which you are executing SYSMAN. Position the qualifier immediately after the DO command. The default file specification is SYSMAN.LIS in the current device and directory. SYSMAN prefaces output with the message "%SYSMAN-I-OUTPUT, command execution on node xxxxxx."

/PAUSE

Controls the rate at which the system displays information. Using the /PAUSE qualifier causes the system to display information about one node at a time; the system prompts you to press Return when you are ready to display information about the next node.

Description

The DO command executes the accompanying DCL command or DCL command procedure on all nodes in the current environment. Each DO command executes as an independent process, so no process context is retained between DO commands. For this reason, you must express all DCL commands in a single command string, and you cannot run a program that expects input.

In an OpenVMS Cluster environment, SYSMAN executes the commands sequentially on all nodes in the cluster. Each command executes completely before SYSMAN sends it to the next node in the environment. Any node that is unable to execute the command returns an error message. SYSMAN displays an error message if the timeout period expires before the node responds.

The system cannot display output returned from a command of more than 2048 characters without concatenation.

Three exceptions to be aware of when using the DO command in clusters are the following ones:

  • In a dual-architecture heterogeneous cluster running both OpenVMS VAX and OpenVMS Alpha, some uses of the DO command may require special handling. For example, if you are installing images that are named differently in each architecture, you can still use the DO command if you create logical name tables for VAX and for Alpha nodes. See the example sequence that follows this description for an example.
  • Some DCL commands, such as MOUNT/CLUSTER or SET QUORUM/CLUSTER, operate clusterwide by design. It is best to avoid using these kinds of commands with the DO command in SYSMAN when the environment is set to cluster. As alternatives, you could leave SYSMAN temporarily with the SPAWN command and execute these commands in DCL, or you could define the environment to be a single node within the cluster. Similarly, operations on clusterwide logical names and tables operate clusterwide by design.
  • Make sure that if you redefine the logical DCLTABLES, you do so in SYLOGICALS.COM, not in SYSTARTUP_VMS.COM or elsewhere. Otherwise, you will receive a command interpreter failure when executing a DO command on a remote node.

Examples

#1

SYSMAN> SET ENVIRONMENT/CLUSTER/NODE=NODE21
SYSMAN> DO/OUTPUT SHOW DEVICE
      

The first command in this example defines the management environment to be the cluster where NODE21 is a member. The second command executes a DCL command on each node in the cluster. Output goes to the file SYSMAN.LIS rather than to the terminal.

#2

SYSMAN> SET ENVIRONMENT/NODE=NODE21
SYSMAN> SET PROFILE /DEFAULT=[CJ.PROGRAMS] -
_SYSMAN> /PRIVILEGES=NOSYSPRV
SYSMAN> DO/OUTPUT @PROCESS_INFO
      

The commands in this example define the environment as a single node and adjust the current privileges and directory. The DO command executes the command procedure PROCESS_INFO.COM, located in directory [CJ.PROGRAMS] and writes any output to SYSMAN.LIS in the directory from which SYSMAN is running.

#3

$ CREATE/NAME_TABLE/PARENT=LNM$SYSTEM_DIRECTORY SYSMAN$NODE_TABLE
$ DEFINE/TABLE=SYSMAN$NODE_TABLE ALPHA_NODES NODE21,NODE22,NODE23
$ DEFINE/TABLE=SYSMAN$NODE_TABLE VAX_NODES NODE24,NODE25,NODE26
$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> SET ENVIRONMENT/NODE=ALPHA_NODES
%SYSMAN-I-ENV, current command environment:
         Individual nodes: NODE21,NODE22,NODE23
         Username BOUCHARD will be used on nonlocal nodes

SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE
%SYSMAN-I-OUTPUT, command execution on node NODE21
%SYSMAN-I-OUTPUT, command execution on node NODE22
%SYSMAN-I-OUTPUT, command execution on node NODE23
SYSMAN> DO INSTALL REPLACE SYS$SYSTEM: COM_FORTRAN.EXE
%SYSMAN-I-OUTPUT, command execution on node NODE21
%SYSMAN-I-OUTPUT, command execution on node NODE22
%SYSMAN-I-OUTPUT, command execution on node NODE23

SYSMAN> SET ENVIRONMENT/NODE=VAX_NODES
%SYSMAN-I-ENV, current command environment:
         Individual nodes: NODE24,NODE25,NODE26
         Username BOUCHARD will be used on nonlocal nodes

SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE
%SYSMAN-I-OUTPUT, command execution on node NODE24
%SYSMAN-I-OUTPUT, command execution on node NODE25
%SYSMAN-I-OUTPUT, command execution on node NODE26
SYSMAN> DO INSTALL REPLACE SYS$SYSTEM:FORTRAN$MAIN.EXE
%SYSMAN-I-OUTPUT, command execution on node NODE24
%SYSMAN-I-OUTPUT, command execution on node NODE25
%SYSMAN-I-OUTPUT, command execution on node NODE26

      

This example shows how you can define logical names for VAX and Alpha nodes in a dual-architecture heterogeneous cluster, so that you can use the DO command to install architecture-specific images.

#4

$ RUN SYS$SYSTEM:SYSMAN
SYSMAN> SET ENVIRONMENT/CLUSTER
%SYSMAN-I-ENV, current command environment:
        Clusterwide on local cluster
        Username STEIN   will be used on nonlocal nodes
SYSMAN> DO/CONFIRM SHOW TIME
Execute command for node EXPERT? [N]: Y [Return]
%SYSMAN-I-OUTPUT, command execution on node EXPERT
  22-MAR-2002 09:40:28

Execute command for node MODERN? [N]: Y [Return]

%SYSMAN-I-OUTPUT, command execution on node MODERN
  22-MAR-2002 09:40:56

Execute command for node IMPOSE? [N]: N [Return]

Execute command for node ADU26A? [N]: Y [Return]
   .
   .
   .
      

The commands in this example show how to control whether the system displays time for each node in a cluster.

#5

SYSMAN> DO/PAUSE SHOW TIME
%SYSMAN-I-OUTPUT, command execution on node EXPERT
  22-MAR-2002 09:40:13
Press return to continue [Return]
%SYSMAN-I-OUTPUT, command execution on node MODER
  22-MAR-2002 09:40:41
Press return to continue [Return]
%SYSMAN-I-OUTPUT, command execution on node IMPOSE
  22-MAR-2002 09:39:46
Press return to continue [Return]
   .
   .
   .
      

The commands in this example show how you can control the rate at which information is displayed on your system.

DUMP_PRIORITY ADD (Alpha Only)

On Alpha systems, adds an entry to the System Dump Priority registry file.

The registry data file is the permanent database that survives reboots. It is loaded into memory during a boot. (You can use the DUMP_PRIORITY LOAD command at any time to load the contents of this file into memory.)

When you add an entry to the registry file, you must specify both the process name and UIC.

How Dump Priority Works

BUGCHECK uses the loaded contents of the System Dump Priority registry to select priority processes to dump early on during a selective dump. Adding a dump priority for a process increases the likelihood that the process will be included in a dump, if there is insufficient space for all processes. (The ADD command only adds an entry to the System Dump Priority registry permanent file. For BUGCHECK to be able to see the entry, you must also enter a DUMP_PRIORITY LOAD command.)

BUGCHECK also keeps its own in-memory hardcoded list of priority processes, which are always treated as priority processes, even if the System Dump Priority registry is empty. These processes are the following:

Process Name UIC
MSCPmount [1,4]
AUDIT_SERVER [1,4]
NETACP [1,4]
NET$ACP [1,3]
REMACP [1,3]
LES$ACP [1,4]

Note that you cannot see, change, or delete these default processes with DUMP_PRIORITY commands.

If you enter a process into the System Dump Priority registry, that process is dumped earlier, because user-specified priority processes are dumped before processes that are hardcoded into BUGCHECK.

Keep in mind that BUGCHECK keeps track of the processes that have been dumped, so that no process is dumped twice.


Format

DUMP_PRIORITY ADD process-name /UIC=uic [/WILD_CARD]


Parameter

process-name

The exact name of the process. If the process name is mixed-case or includes spaces or any other nonstandard OpenVMS characters, you must enclose it in double quotes; for example, "My Process".

You can use wildcard characters (* and %). Because these characters are valid characters in any process name, you must include the wildcard flag /WILD_CARD. Setting the /WILD_CARD flag for a specific process entry tells BUGCHECK to treat the asterisk (*) and percent-sign (%) as wild cards.


Qualifiers

/UIC

Specifies the UIC of the entry to add. You must enclose the UIC in brackets ([ ]). You can specify the /UIC with an octal number (for example, [377,377]) or in the identifier form (for example, [SYSTEM] or [VMS,USER]).

Wildcards are allowed as follows:

Wildcard Example Description
/UIC = [*] To select processes with the specified name in any UIC.
/UIC = [group,*] To select processes with the specified name in the group called "group".
/UIC = [100,*] To select processes with the specified name in group 100>.

Note

You cannot use wildcards within identifier names or within UIC numbers. For example, /UIC=[USER*,*] or /UIC=[17*,100] are not allowed.

/WILD_CARD
/NOWILD_CARD

Specifies whether or not wildcard characters in the process name are to be treated as wildcards. Note, however, that you cannot add the same process name and UIC combination both with and without the /WILD_CARD qualifier. If the combination has already been specified, use the DUMP_PRIORITY MODIFY command to change the wildcard setting.

The /WILD_CARD setting affects only the process name. Wildcards are always allowed in the UIC.


Example


SYSMAN>  DUMP_PRIORITY ADD "MyPro*"/UIC=[*]/WILD_CARD
SYSMAN> DUMP_PRIORITY LIST
%SYSMAN-I-OUTPUT, command execution on node VMS73

Process name    UIC                                 Wild Card
MyPro*          [*]                                 Y

      

The first command in this example adds an entry to the System Dump Priority registry. The process name is "MyPro*" with any UIC, and BUGCHECK will treat the asterisk (*) in MyPro* as a wildcard when the registry is loaded into memory.

BUGCHECK treats the UIC wildcard asterisk (*) as a wildcard, even if you do not specify the /WILD_CARD qualifier on the command line.

The Y under the Wild Card heading means that the /WILD_CARD qualifier has been specified on the command line and a wildcard has been specified in the process name.

DUMP_PRIORITY LIST (Alpha Only)

On Alpha systems, lists the contents of the System Dump Priority registry file.

Format

DUMP_PRIORITY LIST


Parameters

None.

Qualifiers

None.

Example


SYSMAN> DUMP_PRIORITY LIST
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name    UIC                                 Wild Card
MSCPmount       [SYSTEM]                            N
NETACP          [SYSTEM]                            N
NET$ACP         [1,3]                               N
REMACP          [1,3]                               N
LES$ACP         [SYSTEM]                            N
SYSMAN>
      

The command in this example produces a list of the contents of the System Dump Priority registry, including the process name and UIC of each entry. The list also shows N under the Wild Card heading, which indicates that BUGCHECK is to match the process name exactly during a crash. (However, N or Y under Wild Card is important only if the the process name contains one or more wildcard characters.)

DUMP_PRIORITY LOAD (Alpha Only)

On Alpha systems, loads the contents of the System Dump Priority registry file into memory for BUGCHECK to use.

Format

DUMP_PRIORITY LOAD


Parameters

None.

Qualifiers

None.

Example


SYSMAN> DUMP_PRIORITY SHOW
%SMI-F-SDPNOTLOAD, System Dump Priority not loaded
SYSMAN> DUMP_PRIORITY LOAD
SYSMAN> DUMP_PRIORITY SHOW
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name    UIC                                 Wild Card
MSCPmount       [SYSTEM]                            N
NETACP          [SYSTEM]                            N
NET$ACP         [00001,000003]                      N
REMACP          [00001,000003]                      N
LES$ACP         [SYSTEM]                            N
SYSMAN>
      

The first command in the example displays the message that the System Dump Priority registry file has not been loaded into memory. The second command loads the registry file into memory for BUGCHECK to use, and the third command displays the contents of the registry file that have been loaded into memory.

DUMP_PRIORITY MODIFY (Alpha Only)

On Alpha systems, modifies an entry in the System Dump Priority registry file.

Format

DUMP_PRIORITY MODIFY process-name /UIC=uic [/NEWUIC=newuic][/WILD_CARD]


Parameter

process-name

The exact name of the process. If the process name is mixed-case or includes spaces or any other nonstandard OpenVMS characters, you must enclose the process name in double quotes; for example, "My Process". Also, when you enter a DUMP_PRIORITY MODIFY command, be sure to enter the process name exactly as it is displayed when you enter a DUMP_PRIORITY LIST command, because the system searches for that process name to find the entry to modify.

Qualifiers

/UIC

Specifies the UIC of the entry in the registry that you want to modify. The UIC and process name together make the entry unique. Specify the UIC as it is displayed when you enter the DUMP_PRIORITY LIST command.

/NEWUIC

Modifies the UIC of an entry that you specify by its process name and current UIC. You can specify the /NEWUIC with an octal number (for example, [377,377]) or in the identifier form (for example, [SYSTEM] or [VMS,USER]).

Wildcards are allowed as follows:

Wildcard Example Description
/UIC = [*] To select processes with the specified name in any UIC.
/UIC = [group,*] To select processes with the specified name in the group called "group".
/UIC = [100,*] To select processes with the specified name in group 100>.

Note

You cannot use wildcards within identifier names or within UIC numbers. For example, /UIC=[USER*,*] or /UIC=[17*,100] are not allowed.

/WILD_CARD
/NOWILD_CARD

The /WILD_CARD qualifier, used together with the MODIFY command, modifies the wildcard setting on the entry that you are modifying. If you omit /WILD_CARD, the current wildcard setting is retained.

Example


SYSMAN> DUMP_PRIORITY LIST








%SYSMAN-I-OUTPUT, command execution on node VMS73

Process name    UIC                                 Wild Card
MSCP*           [SYSTEM]                            Y
NETACP          [SYSTEM]                            N

SYSMAN> DUMP_PRIORITY MODIFY "MSCP*"/UIC=[SYSTEM]/NEWUIC=[TEST]/NOWILD_CARD (1)
SYSMAN> DUMP_PRIORITY LIST

%SYSMAN-I-OUTPUT, command execution on node VMS73

Process name    UIC                                 Wild Card
MSCP*           [TEST]                              N
NETACP          [SYSTEM]                            N

SYSMAN> DUMP_PRIORITY MODIFY "MSCP*"/UIC=[TEST]/NEWUIC=[*] (2)
SYSMAN> DUMP_PRIORITY LIST

%SYSMAN-I-OUTPUT, command execution on node VMS73

Process name    UIC                                 Wild Card
MSCP*           [*]                                 N
NETACP          [SYSTEM]                            N

SYSMAN> DUMP_PRIORITY MODIFY "MSCP*"/UIC=[*]/WILD_CARD (3)

%SYSMAN-I-OUTPUT, command execution on node VMS73

Process name    UIC                                 Wild Card
MSCP*           [*]                                 Y
NETACP          [SYSTEM]                            N

Refer to the numbers at the end of the DUMP_PRIORITY MODIFY command lines in the example, which correspond to the numbered explanations that follow. (The DUMP_PRIORITY LIST command, after each MODIFY command, displays the results of the modifications in the System Dump Priority registry.)

  1. The first DUMP_PRIORITY MODIFY command modifies the MSCP* entry with the current UIC [SYSTEM] the new UIC [TEST]. It also changes the /WILD_CARD flag to /NOWILD_CARD. If the System Dump Priority registry is then loaded into memory, BUGCHECK will not treat the asterisk (*) in the process name as a wildcard, but rather, will do an exact character match of MSCP*.
  2. The second DUMP_PRIORITY MODIFY command modifies only the UIC of the entry to [*]. Omitting the /[NO]WILD_CARD qualifier will leave the current setting unchanged.
  3. The third DUMP_PRIORITY MODIFY command modifies only the process name wildcarding flag with the /WILD_CARD qualifier.

DUMP_PRIORITY REMOVE (Alpha Only)

On Alpha systems, removes a record from the System Dump Priority registry file.

Format

DUMP_PRIORITY REMOVE process-name /UIC=uic


Parameter

process-name

The exact name of the process. If the process name is mixed-case or includes spaces or any other nonstandard OpenVMS characters, you must enclose the process name in double quotes; for example, "My Process". Also, when you enter a DUMP_PRIORITY REMOVE command, be sure to enter the process name exactly as it is displayed when you enter a DUMP_PRIORITY LIST command, because the system searches for that process name to find the entry to remove.

Qualifier

/UIC

Specifies the UIC of the entry in the registry that you want to remove. The UIC and process name together make the entry unique. Specify the UIC as it is displayed when you enter the DUMP_PRIORITY LIST command.

Example


SYSMAN> DUMP_PRIORITY LIST
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name    UIC                                 Wild Card
MSCPmount       [SYSTEM]                            N
NETACP          [SYSTEM]                            N
NET$ACP         [1,3]                               N
REMACP          [1,3]                               N
LES$ACP         [SYSTEM]                            N

SYSMAN> DUMP_PRIORITY REMOVE "MSCPmount"/UIC=[SYSTEM]
SYSMAN> DUMP_PRIORITY LIST
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name    UIC                                 Wild Card
NETACP          [SYSTEM]                            N
NET$ACP         [1,3]                               N
REMACP          [1,3]                               N
LES$ACP         [SYSTEM]                            N
      

The DUMP_PRIORITY REMOVE command in this example removes the entry MSCPmount with the UIC of [SYSTEM] from the System Dump Priority registry file. (The process name MSCPmount is enclosed in quotes because it is mixed-case.)

DUMP_PRIORITY SHOW (Alpha Only)

On Alpha systems, lists the contents of the in-memory copy of the System Dump Priority registry file.

Format

DUMP_PRIORITY SHOW


Parameters

None.

Qualifiers

None.

Example


SYSMAN> DUMP_PRIORITY SHOW
%SMI-F-SDPNOTLOAD, System Dump Priority not loaded

SYSMAN> DUMP_PRIORITY LOAD
SYSMAN> DUMP_PRIORITY SHOW
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name    UIC                                 Wild Card
MSCPmount       [SYSTEM]                            N
NETACP          [SYSTEM]                            N
NET$ACP         [00001,000003]                      N
REMACP          [00001,000003]                      N
LES$ACP         [SYSTEM]                            N
SYSMAN>
      

The first DUMP_PRIORITY SHOW command in the example results in the display indicating that the System Dump Priority registry file has not been loaded into memory. The second DUMP_PRIORITY SHOW command, which follows a LOAD command, displays an in-memory copy of the file.

DUMP_PRIORITY UNLOAD (Alpha Only)

On Alpha systems, clears the in-memory copy of the System Dump Priority registry file.

Format

DUMP_PRIORITY UNLOAD


Parameters

None.

Qualifiers

None.

Example


SYSMAN> DUMP_PRIORITY UNLOAD
SYSMAN> DUMP_PRIORITY SHOW
%SMI-F-SDPNOTLOAD, System Dump Priority not loaded
      

Following a DUMP_PRIORITY UNLOAD command, the DUMP_PRIORITY SHOW command in this example displays the message that the System Dump Priority registry no longer has an in-memory copy of the file.

EXIT

Terminates the SYSMAN session and returns control to the DCL command level. Any profile changes, established on the local node with the command SET PROFILE, are restored to their values at the time SYSMAN was invoked. You can also press Ctrl/Z to exit at any time.

Format

EXIT


Parameters

None.

Qualifiers

None.

HELP

Provides online help for using the SYSMAN commands, parameters, and qualifiers. Press Ctrl/Z to exit.

Format

HELP [keyword...]


Parameter

keyword

Specifies the command, parameter, or qualifier for which you want help. If you omit the keyword, the HELP command displays a list of Help topics and prompts you for a particular keyword.

Qualifiers

None.

Example


SYSMAN> HELP DO
      

This command displays help information about the SYSMAN command DO.

IO AUTOCONFIGURE (Alpha Only)

On Alpha systems, automatically identifies and configures all hardware devices attached to a system by connecting devices and loading their drivers. On VAX systems, use the SYSGEN command AUTOCONFIGURE.

You must have CMKRNL and SYSLCK privileges to use the SYSMAN IO AUTOCONFIGURE command.


Format

IO AUTOCONFIGURE


Parameters

None.

Qualifiers

/SELECT=(device_name)

Specifies the device type to be automatically configured. Use valid device names or mnemonics that indicate the devices to be included in the configuration. You can use wildcard characters with this qualifier.

See the Usage Notes under the /EXCLUDE qualifier for notes that apply to both qualifiers.

Table 22-2 shows /SELECT qualifier examples.

Table 22-2 /SELECT Qualifier Examples
Command Devices That Are Configured Devices That Are
Not Configured
/SELECT=P* PKA,PKB,PIA None
/SELECT=PK* PKA,PKB PIA
/SELECT=PKA* PKA PKB,PIA

/EXCLUDE=(device_name)

Specifies the device type that should not be automatically configured. Use valid device names or mnemonics that indicate the devices to be excluded from the configuration. You can use wildcard characters with this qualifier.

Usage Notes for the /SELECT and /EXCLUDE Qualifiers

  • The /SELECT and /EXCLUDE qualifiers are not mutually exclusive, as they are on VAX systems. You can specify both qualifiers on the command line.
  • You can use the /SELECT and /EXCLUDE qualifiers to permanently specify device autoconfiguration to include and exclude Fibre Channel port driver devices (FG) and any SCSI port driver devices (PK) for the duration of a manual autoconfiguration command. (To permanently specify devices to be excluded at each system boot, use the SYSMAN command IO SET EXCLUDE.)
    You cannot use the /SELECT and /EXCLUDE qualifiers to include and exclude any of the following device types:
    • SCSI class-driver devices (DK, MK, GK) whose names include a port allocation class or an HSZ allocation class
    • Fibre Channel class-driver devices (PG, DG, GG)

    This restriction also applies to SCSI devices on OpenVMS Alpha Version 7.1 systems, if the SCSI device names include a port allocation class.

/LOG

Controls whether the SYSMAN IO AUTOCONFIGURE command displays information about loaded devices.

Description

The SYSMAN IO AUTOCONFIGURE command identifies and configures all hardware devices attached to a system. VAX system managers use the SYSGEN command AUTOCONFIGURE. It connects devices and loads their drivers. You must have CMKRNL and SYSLCK privileges to use the SYSMAN IO AUTOCONFIGURE command.

Examples

#1

SYSMAN> IO AUTOCONFIGURE/EXCLUDE=DKA0
      

This command autoconfigures all devices on the system except DKA0.

IO AUTOCONFIGURE automatically configures all standard devices that are physically attached to the system, except for the network communications device.

#2

SYSMAN> IO AUTOCONFIGURE/LOG
      

The /LOG qualifier displays information about all the devices that AUTOCONFIGURE loads.

IO CONNECT (Alpha Only)

On Alpha systems, connects a hardware device and loads its driver, if the driver is not already loaded. On VAX systems, use the SYSGEN command CONNECT.

You must have CMKRNL and SYSLCK privileges to use the SYSMAN IO CONNECT command.

Note

Be very careful when issuing a SYSMAN IO 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

IO CONNECT device-name[:]


Parameter

device-name[:]

Specifies the name of the hardware device to be connected. The device name requires the following format:
device-type controller unit-number

For example, in the designation LPA0, LP is a line printer on controller A at unit number 0. If you use the /NOADAPTER qualifier, the device is the software to be loaded.


Qualifiers

/ADAPTER=tr_number
/NOADAPTER (default)

Specifies the nexus number of the adapter to which the specified device is connected. It is a nonnegative 32-bit integer. The /NOADAPTER qualifier indicates that the device is not associated with any particular hardware. The /NOADAPTER qualifier is compatible with the /DRIVER_NAME qualifier only.

/CSR=csr_address

Specifies the CSR address for the device being configured. This address must be specified in hexadecimal. You must precede the CSR address with %X. The CSR address is a quadword value that is loaded into IDB$Q_CSR without any interpretation by SYSMAN. This address can be physical or virtual, depending on the specific device being connected:
  • /CSR=%X3A0140120 for a physical address
  • /CSR=%XFFFFFFFF807F8000 for a virtual address (the sign extension is required for Alpha virtual addresses)

This qualifier is required if /ADAPTER=tr_number is specified.

/DRIVER_NAME=filespec

Specifies the name of the device driver that you are loading. If you do not specify this qualifier, SYSMAN obtains the default in the same way that the SYSGEN default name is determined. For example, if you want to load the HP-supplied SYS$ELDRIVER.EXE, the prefix SYS$ must be present. Without the SYS$, SYSMAN looks for ELDRIVER.EXE in SYS$LOADABLE_IMAGES. This implementation separates the user device driver namespace from the HP-supplied device driver namespace.

/LOG=(ALL,CRB,DDB,DPT,IDB,SB,UCB)
/NOLOG (default)

Controls whether SYSMAN displays the addresses of the specified control blocks. The default value for the /LOG qualifier is /LOG=ALL. If /LOG=UCB is specified, a message similar to the following one is displayed:


%SYSMAN-I-IOADDRESS, the UCB is located at address 805AB000

/MAX_UNITS=maximum-number-of-units

Specifies the maximum number of units the driver can support. The default is specified in the driver prologue table (DPT) of the driver. If the number is not specified in the DPT, the default is 8. This number must be greater than or equal to the number of units specified by /NUM_UNITS. This qualifier is optional.

/NUM_UNITS=number-of-units

Specifies the number of units to be created. The starting device number is the number specified in the device name parameter. For example, the first device in DKA0 is 0. Subsequent devices are numbered sequentially. The default is 1. This qualifier is optional.

/NUM_VEC=vector-count

Specifies the number of vectors for this device. The default vector count is 1. The /NUM_VEC qualifier is optional. This qualifier should be used only when using the /VECTOR_SPACING qualifier. When using the /NUM_VEC qualifier, you must also use the /VECTOR qualifier to supply the base vector.

/SYS_ID=number-of-remote-system

Indicates the SCS system ID of the remote system to which the device is to be connected. It is a 64-bit integer; you must specify the remote system number in hexadecimal. The default is the local system. This qualifier is optional.

/VECTOR=(vector-address,...)

Specifies the interrupt vectors for the device or lowest vector. This is either a byte offset into the SCB of the interrupt vector for directly vectored interrupts or a byte offset into the ADP vector table for indirectly vectored interrupts. The values must be longword aligned. To specify the vector address in octal or hexadecimal, precede the address with %O or %X, respectively. The /VECTOR qualifier is required when you use the /ADAPTER=tr_number qualifier or the /NUM_VEC=vector-count qualifier. You can list up to 64 vectors.

/VECTOR_SPACING=number-of-bytes-between-vectors

Specifies the spacing between vectors. Specify the amount as a multiple of 16 bytes. The default is 16. You must specify both the base vector with /VECTOR and the number of vectors with /NUM_VEC. This qualifier is optional.

Description

The SYSMAN IO CONNECT command connects a hardware device and loads its driver, if the driver is not already loaded. VAX system managers use the SYSGEN command CONNECT. You must have CMKRNL and SYSLCK privileges to use the SYSMAN IO CONNECT command.

The chapter "Managing Peripheral Devices" in the HP OpenVMS System Manager's Manual contains information about file-based device configuration support.


Examples

#1

SYSMAN> IO CONNECT DKA0:/DRIVER_NAME=SYS$DKDRIVER/CSR=%X80AD00-
/ADAPTER=4/NUM_VEC=3/VECTOR_SPACING=%X10/VECTOR=%XA20/LOG

%SYSMAN-I-IOADDRESS, the CRB is located at address 805AEC40
%SYSMAN-I-IOADDRESS, the DDB is located at address 805AA740
%SYSMAN-I-IOADDRESS, the DPT is located at address 80D2A000
%SYSMAN-I-IOADDRESS, the IDB is located at address 805AEE80
%SYSMAN-I-IOADDRESS, the SB is located at address 80417F80
%SYSMAN-I-IOADDRESS, the UCB is located at address 805B68C0
      

The command in this example connects device DKA0, loads driver SYS$DKDRIVER, and specifies the following data:

Physical CSR address
Adapter number
Number of vectors
Spacing between vectors
Interrupt vector address

The /LOG qualifier displays the addresses of all control blocks, as shown.

#2

SYSMAN> IO CONNECT DKA0:/DRIVER_NAME=SYS$DKDRIVER/CSR=%X80AD00-
/ADAPTER=4/VECTOR=(%XA20,%XA30,%XA40)/LOG=(CRB,DPT,UCB)

%SYSMAN-I-IOADDRESS, the CRB is located at address 805AEC40
%SYSMAN-I-IOADDRESS, the DPT is located at address 80D2A000
%SYSMAN-I-IOADDRESS, the UCB is located at address 805B68C0

      

The command in this example connects device DKA0, loads driver SYS$DKDRIVER, and specifies the following data:

Physical CSR address
Adapter number
Addresses for interrupt vectors

The /LOG qualifier displays the addresses of the channel request block (CRB), the driver prologue table (DPT), and the unit control block (UCB).

#3

SYSMAN> IO CONNECT FTA0:/DRIVER=SYS$FTDRIVER/NOADAPTER/LOG=(ALL)

%SYSMAN-I-IOADDRESS, the CRB is located at address 805AEC40
%SYSMAN-I-IOADDRESS, the DDB is located at address 805AA740
%SYSMAN-I-IOADDRESS, the DPT is located at address 80D2A000
%SYSMAN-I-IOADDRESS, the IDB is located at address 805AEE80
%SYSMAN-I-IOADDRESS, the SB is located at address 80417F80
%SYSMAN-I-IOADDRESS, the UCB is located at address 805B68C0

      

The command in this example connects pseudoterminal FTA0, loads driver SYS$FTDRIVER, and uses the /NOADAPTER qualifier to indicate that FTA0 is not an actual hardware device. The /LOG=(ALL) qualifier displays the addresses of all control blocks, as shown.

For more information about loading and configuring device drivers, refer to Writing OpenVMS Alpha Device Drivers in C (Margie Sherlock and Leonard S. Szubowicz, Digital Press, 1996).


Previous Next Contents Index