 |
HP OpenVMS System Management Utilities Reference
Manual
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:
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.
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 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:
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.
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.
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 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.
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.)
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.
|
