1 – AUTO
Displays the current settings of auto-load, auto-perm, and any
exclude or include lists.
Format
SHOW AUTO
1.1 – Example
$ UCM
UCM> SHOW AUTO
AUTO LOAD ENABLED
AUTO PERM ENABLED
EXCLUDE = (*)
INCLUDE = (TX, DN)
This SHOW AUTO example indicates that all devices are excluded
with the exception of TX and DN devices.
2 – DEVICE
Displays information about devices.
Format
SHOW DEVICE device-name:
2.1 – Parameter
device-name:
The name of the device whose characteristics are to be displayed.
The device name has the form ddcu,
where:
dd is the device code-for example, LP. (The driver name
corresponds to the device code; in this case, the driver
name would be SYS$LPDRIVER.)
c is the controller designation A through Z; unless UCM
specifies a different letter, all USB devices are A.
u is the unit number (0 through 9999.)
OpenVMS device names are made up of the two-character device
code, followed by the controller designation, the unit number
(which can be 1 to 4 characters long), and, finally, a colon (:).
2.2 – Display Qualifiers
2.2.1 /BRIEF
/BRIEF (default)
Displays summary information for each device.
2.2.2 /FULL
Displays complete information for each device.
2.3 – Selection Qualifiers
2.3.1 /ALL
/ALL (default)
Displays all device entries, including those that the
/CONFIGURED, /GENERIC, /PERMANENT, /PHYSICAL, and /UNCONFIGURED
qualifiers display.
2.3.2 /CONFIGURED
Displays all the devices connected to the bus that have been
configured successfully.
2.3.3 /GENERIC
Displays the devices that are on the generic device list.
2.3.4 /PERMANENT
Displays the devices for which the system automatically loads
device drivers if the devices are plugged in.
2.3.5 /PHYSICAL
Displays the devices that are connected to the bus even if
drivers for these devices are not loaded.
2.3.6 /UNCONFIGURED
Displays devices that are attached to the bus and that have
drivers, but that do not have entries in the permanent list.
(These are also known as tentative devices.)
You must execute an ADD DEVICE command to make these devices
part of the permanent list. Once the drivers have been added, the
device is automatically configured the next time it is plugged
in.
2.4 – Example
$ UCM
UCM> SHOW DEVICE /PERMANENT /FULL DNA3:
DEVICE
DEVICE_TYPE PERMANENT
DEVICE_NAME_ROOT DNA
UNIT_NUMBER 3
DRIVER SYS$DNDRIVER.EXE
USB_CONFIG_TYPE INTERFACE
VENDOR_ID 3519
PRODUCT_ID 768
RELEASE_NUMBER 4352
BUS_NUMBER 1
PATH 1.0.0.0.0.0
DEVICE_CLASS 0
DEVICE_SUB_CLASS 0
DEVICE_PROTOCOL 0
NUMBER_OF_INTERFACES 1
CONFIGURATION_VALUE 2
NUMBER_OF_CONFIGURATIONS 1
SERIAL_NUMBER 2B0301060D97A4C8
MANUFACTURER_STRING QTS
PRODUCT_STRING USB 2.0 ATAPI Bridge
CONFIGURATION_NUMBER 0
BEGIN_INTERFACE
INTERFACE_CLASS 8
INTERFACE_SUB_CLASS 6
INTERFACE_PROTOCOL 80
END_INTERFACE
END_DEVICE
In this example, the SHOW DEVICE command displays complete
information about DNA3:.
3 – EVENTS
Displays important events that occur on the USB bus. Data
displayed can include information about device events, such as
removals, connections, unrecognized devices, new devices, and so
on.
Format
SHOW EVENTS
3.1 – Qualifiers
3.1.1 /BEFORE
/BEFORE=time
Selects events that occurred before the specified time. You can
specify time as an absolute time, as a combination of absolute
and delta times, or as the keyword TODAY (default), TOMORROW,
or YESTERDAY. Times are expressed in standard OpenVMS date/time
format.
3.1.2 /OUTPUT
/OUTPUT=file-name
Writes the selected events to the specified file. By default,
output is sent to the current SYS$OUTPUT device (usually your
terminal).
You cannot use the /OUTPUT qualifier with the /PAGE qualifier.
3.1.3 /PAGE
/PAGE
/NOPAGE (default)
Controls how information is displayed. /PAGE displays events on
one screen at a time.
You cannot use the /PAGE qualifier with the /OUTPUT qualifier.
3.1.4 /PRIORITY
/PRIORITY=(keyword[,...])
Selects the event priorities to display. By default, only
CRITICAL aand NORMAL event priorities are displayed. Additional
messages are available as INFORMATIONAL or debug priority
information.
The keywords in the following table are valid. CRITICAL and
NORMAL are the defaults.
Keyword Description
CRITICAL Errors and critical information
NORMAL Normal event reports such as device
configuration
INFORMATIONAL Additional informational messages from drivers
or UCM
DBG1 Debug level 1 information
DBG2 Debug level 2 information
DBG3 Debug level 3 information
ALL All event priorities
3.1.5 /SINCE
/SINCE=time
Selects only those events that occurred on or after the specified
time. You can specify time as absolute time, as a combination of
absolute and delta times, or as the keyword TODAY (default) or
YESTERDAY.
3.1.6 /TYPE
/TYPE=event-type
Selects only the specified type of events. Valid event-types are
the following:
ALL All event-types (default).
CONFIGURED Device was recognized and configured.
DECONFIGURE Device was removed from the bus.
DRIVER Driver events.
UCM UCM server events.
UNCONFIGURE Device was recognized but not configured.
UNKNOWN Event type is unknown.
3.1.7 /VALUE
/VALUE=event-number
Selects only the events specified by the event number. In a
future version of this product, you will be able to use this
qualifier as an alternative to the /TYPE qualifier for events
that do not have an assigned keyword.