HP OpenVMS Systems Documentation
OpenVMS System Management Utilities Reference Manual
Enables one of the following SHOW CLUSTER functions: EDIT, MOVE, PAN, or SCROLL.
SET FUNCTION function-name
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.)
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.
SET INTERVAL= seconds
Sets the terminal to a display of up to 511 columns. This command can be used only on Compaq-compatible terminals.
SET SCREEN= screen-width
The SET SCREEN command redefines the width of the display to the number of columns that you specify.
Compaq recommends the use of the AUTOGEN command procedure when modifying system parameters, loading device drivers, or creating additional page and swap files.
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.
adapter-specSpecifies 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.
If you use the AUTOCONFIGURE ALL command on a running system with active UNIBUS or Q-bus devices, it could result in unpredictable behavior.
/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.
/LOGProduces 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.
|CS||Console Storage Device|
|DB||RP05, RP06 Disk|
|DD||TU58 Cartridge Tape|
|DL||RL02 Cartridge Disk|
|DM||RK06, RK07 Cartridge Disk|
|DQ||RL02 Cartridge Disk, R80 Disk|
|DR||RM03, RM05, RM80, RP07 Disk|
|LA||LPA11--K Laboratory Peripheral Accelerator|
|LC||Line Printer on DMF32|
|LP||Line Printer on LP11|
|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|
|PT||TU81 Magnetic Tape|
|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|
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.
On VAX systems, requests UNIBUS device names and issues the set of control and status register (CSR) and vector addresses that AUTOCONFIGURE will use.
/INPUT=file-specSpecifies the name of an input file from which previously prepared data is read. By default, input data is read from SYS$INPUT.
/OUTPUT=file-specSpecifies 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.
/NORESETControls 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.
The CONFIGURE command issues the following prompt:
Input should be in the following form, where input to the prompt is controller:
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.
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 Compaq 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.
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.
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.
CONNECT CONSOLE [/REMOTE]
device-nameSpecifies the name of the device for which control blocks are to be added to the I/O database, and has the following format:
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 (:).
CONSOLELoads and connects the console block storage device driver. The console device name is typically CSA1 but can vary depending on the system type.
/NOADAPTERSpecifies 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.
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-numberSpecifies 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-addrSpecifies 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=valueFor 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=driverSpecifies 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-cntSpecifies 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-cntSpecifies the number of interrupt vectors for the device. By default, the vector count is 1.
/REMOTEEnables a remote diagnostic port for a second console or terminal connected to a VAX 8600.
/SYSIDHIGH=valueSpecifies 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=valueSpecifies 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-addrSpecifies 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=valueFor 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.
SYSGEN> CONNECT LPA0/ADAPTER=3/CSR=%O777514 - SYSGEN> /DRIVERNAME=LP2DRIVER/VECTOR=%O200