HELPLIB.HLB  —  PRODUCT  REGISTER  VOLUME
    For a volume containing installed products, records a change in
    volume label in the product database.

    For device independence, the product database identifies the
    destination device of an installed product by its logical volume
    name, not by its physical device name. The logical volume name
    (usually in the form DISK$labelname) is defined by the MOUNT
    command and associated with the device.

    Format

      PRODUCT REGISTER VOLUME  old-volume-label device-name

                               [/qualifiers]

1  –  Description

    You can check the logical volume name of a mounted device by
    issuing a command in the following format:

     $ WRITE SYS$OUTPUT F$GETDVI("device","LOGVOLNAM")

    When you use the SET VOLUME command to change the volume label
    of a nonsystem device that contains installed products, you
    must also use the PRODUCT REGISTER VOLUME command to update the
    product database with this information. Register the new volume
    label after you dismount and remount the volume so that the new
    logical volume name (DISK$labelname) is defined.

    If you change the volume label of the system device, you do not
    need to use the PRODUCT REGISTER VOLUME command because PCSI
    automatically detects the change after the volume is remounted
    following a system reboot.

2  –  Parameters

 old-volume-label

    Names the old (existing) volume label.

 device-name

    Names the device for which the volume label is to be changed in
    the product database.

3  –  Qualifiers

3.1    /LOG

       /LOG
       /NOLOG (default)

    Displays the file specifications of the product database files
    that are created or modified.

3.2    /REMOTE

       /REMOTE
       /NOREMOTE (default)

    Selects the product database located on a privately mounted
    system disk. By default, PCSI searches the currently booted
    system disk for the product database.

    When you use /REMOTE, the following logical names must be
    defined:

    o  PCSI$SYSDEVICE must specify the physical disk name of the
       target system disk. This disk must be mounted and allocated to
       the process executing the PRODUCT command.

    o  PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE.
       It must be defined in the following form, where x is a valid
       system root:

       PCSI$SYSDEVICE:[SYSx.]

4  –  Example

  $ PRODUCT REGISTER VOLUME AXPVMSV62 DKA0:

      The command in this example replaces all occurrences of the old
      volume label in the PCSI database with the current volume label
      of the specified disk.
Close Help