HP OpenVMS Systems Documentation

HP OpenVMS System Management Utilities Reference Manual

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.

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.

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

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.

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.

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.

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
      

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

Format

DISABLE CHECKS

Parameters

None.

Qualifiers

None.

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
      

On VAX systems, loads an I/O driver. On Alpha and I64 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.)

Example

SYSGEN>  LOAD SYS$SYSTEM:RTTDRIVER
      

This command loads the standard driver for a remote terminal.

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

Example

SYSGEN>  RELOAD SYS$SYSTEM:RTTDRIVER
      

This command reloads the remote terminal driver.

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

SYSGEN> SET PFCDEFAULT 20
      

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

SYSGEN> SET GBLSECTIONS DEFAULT
      

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

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.