The relabel command is used to allow the operator to rename a volume serial number on a previously defined 3995 optical disk volume. As a preventive measure to keep from losing all active primary or backup copies of objects on the 3995 disk volume that is being relabeled, the following conditions apply:

• The optical disk volume being relabeled cannot be an Object Backup volume.
• There can be no active primary copy of an object on the volume.
• There can be no write requests scheduled for the volume.
• In an OAMplex, the requested volume must be controlled by the OAM on which the command was entered.

To erase all copies of objects on the 3995 optical disk volume, submit the OAM utility job to reformat the volume. See Reformatting a 3995 optical disk for more information on this utility.

The following command syntax relabels an optical disk volume:

>>-+-MODIFY-+--------------------------------------------------->
   '-F------'   

>--OAM,-+-RELABEL-+-,-old_volser-,-new_volser-+---------------+-><
        '-RL------'                           '-,--drive_name-'   

The following describes the values of the options for the RELABEL command:

old_volser

This a required parameter that specifies the current volume serial number of the OAM volume.

new_volser

This is a required parameter that specifies the new volume serial number to be assigned to the optical volume.

drive_name

This is an optional parameter that specifies a write compatible operator-accessible drive for processing this relabel request if the volume resides outside a 3995 optical disk library. If drive_name is not supplied or if the volume is library-resident, OAM selects an optical drive in the ACDS that is capable of processing this request.

To relabel a requested optical disk volume and direct the request to a specific operator-accessible drive, enter the following command:

F OAM,RELABEL,old_volser,new_volser,drive_name

This system issues the following messages:

CBR1000I OAM RELABEL command execution scheduled.
 
CBR4460I Volume old_volser on drive-name has been relabeled to new_volser.
 
CBR2822I RELABEL function completed for volume old_volser to new_volser.