UCM$HELP.HLB  —  SHOW

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.
Close Help