1  MODIFY
 

2  DEVICE
   Allows you to modify the path and unit number of a device in the
   permanent list. The changes take place immediately.

   Requires SYSPRV privilege.

   Format

     MODIFY DEVICE  device-name:
 

3  Parameter
 

device-name:

   The name of the device whose characteristics are to be modified.
   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 (:).
 

3  Qualifiers
 

/BUS_NUMBER

      /BUS_NUMBER=number

   Specifies the USB bus number of the device. This parameter is
   required to identify a particular device on a system that has
   multiple USB buses. If you do not use this qualifier, the bus
   number defaults to zero.

   The number can be any number from 0 through 25.
 

/PATH

      /PATH=(n1[.n2.n3.n4.n5.n6])

   Specifies the path to the device on the bus. The path is used
   to uniquely identify a device if the device does not have a
   serial number. The path specification is a series of six or fewer
   numbers,

   where:

   n1               is the number of the root hub (at tier 0).

   n2 through n6    are port numbers for downstream hubs at tiers 1,
                    2, 3, 4, and 5.

   For example, /PATH=1.4.3 indicates that the device is in turn
   plugged into port 3 of the second tier, which is plugged into
   port 4 of the first tier, which in turn is plugged into the root
   hub 1.
 

/UNIT_NUMBER

      /UNIT_NUMBER=number

   Unit numbers can be between 0 and 9999. By default, the
   configuration code selects the next available unit number. This
   qualifier allows you to change the unit number to suit your
   needs.
 

3  Example

 $  UCM
 Universal Serial Bus Configuration Manager, Version V1.0

 UCM> SHOW DEVICE /UNCONFIGURED

 DEVICE
 DEVICE_TYPE                     TENTATIVE
 DEVICE_NAME_ROOT                AGA
 UNIT_NUMBER                     0
 BUS                             1
 PATH                            1.0.0.0.0.0
 END_DEVICE

 UCM> ADD DEVICE AGA0:

 UCM> MODIFY DEVICE AGA0:/UNIT=9999

 UCM> SHOW DEVICE /PERMANENT /FULL AGA9999:

 DEVICE
 DEVICE_TYPE                     PERMANENT
 DEVICE_NAME_ROOT                AGA
 UNIT_NUMBER                     9999
 DRIVER                          SYS$AGDRIVER.EXE
 BUS_NUMBER                      1
 PATH                            1.0.0.0.0.0
 HID_USAGE_DATA                  65540
 BEGIN_INTERFACE
 HID_USAGE_DATA                  65540
 END_INTERFACE
 END_DEVICE

 UCM>

     The first SHOW DEVICE command displays information from the
     generic list about the unconfigured AG device. The ADD DEVICE
     command adds the device to the permanent list, and the MODIFY
     DEVICE command changes the unit number of the device. The
     second SHOW DEVICE command displays this change.