HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index

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 23
System Generation Utility

23.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:

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

23.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 K lists system parameters.

23.1.2 Using Active and Current Parameter Values

System parameter values can be either active or current:

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.

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

23.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 and I64 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 23-1 or a standard device name as shown in Appendix L. 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 23-1 or a standard device name as shown in Appendix L. 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 23-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 L-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 L.

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 and I64 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.)

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


Previous Next Contents Index