Document revision date: 15 July 2002

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.

Example

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

This command sequence scrolls the SCS window up 10 lines.

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.

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.

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

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.

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.

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.

Sets the terminal to a display of up to 511 columns. This command can be used only on Compaq-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.

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.

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

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.

20.1 SYSGEN Description

• 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 Compaq 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 OpenVMS System Manager's Manual for more information.

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

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

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

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 20-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 20-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 20-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

SYSGEN> AUTOCONFIGURE ALL
      

This command automatically configures all standard devices.

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

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

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.

	privacy and legal statement
6048PRO_062.HTML