Technical data

Managing Peripheral Devices
8.5 Automatically Configuring Devices for OpenVMS Alpha Systems
where the value is a string, a quoted string, or a numeric value. The END_
DEVICE keyword has no associated value. For example, a minimal description of
a non-disk device might look like the following:
DEVICE = "My device"
NAME = UU
DRIVER = USER$UUDRIVER
ID = 0x0005111
ADAPTER = PCI
FLAGS = NOVECTOR
END_DEVICE
In this example, the description indicates that when a device with the hardware
ID of 5111 (hex) is found on a PCI bus, the device named UU should be
configured, and the USER$UUDRIVER device driver should be loaded. This
example also specifies that the driver does not want to be connected to an
interrupt vector. (If the bus information had a vector, it would be ignored.)
In addition to the values shown in the previous example, the following implied
values can also be specified:
UNITS = 1
NUM_VECTORS = 1
These values usually default to the correct values for a single unit controller.
8.5.2.2 Configuration File Syntax
The following syntax rules apply to the SYS$USER_CONFIG.DAT file.
• All white space is equivalent to a single space. Blank lines, multiple spaces,
and tabs may be used for clarity, but they are treated by the parser as a
single space.
• All strings are converted to uppercase unless within quotes.
• A quotation mark cannot be passed within a string (it will be deleted).
• All numbers are in the C language format: the default is decimal, octal may
be specified by providing a leading ‘‘0’’, hex by providing a leading "0x".
• Comments can occur anywhere in the file and can begin with an exclamation
point (!). All text on the line from the exclamation point to the end of the line
is ignored.
8.5.2.3 Device Descriptions
A minimal device description consists of DEVICE, NAME, DRIVER, ADAPTER,
and END_DEVICE statements. The following keywords are defined for file-based
autoconfiguration device descriptions:
• DEVICE = string
The DEVICE keyword starts a device description. The DEVICE keyword
takes a string argument, which is an arbitrary description of the device being
defined.
Example: DEVICE = "NI (Tulip)"
The string argument is used by utilities such as the CLUE CONFIG
command in $ANALYZE/SYSTEM. It should be kept short enough to look
correct.
Managing Peripheral Devices 8–13