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.
When the command is accepted, if the requested volume is shelf-resident
and not mounted on the selected drive, OAM asks the operator to mount
the requested volume on the selected optical drive. If the requested
volume is library-resident, OAM mounts the volume on a library drive.
Following successful completion of this processing, OAM performs the
following functions:
- deletes the row in the DB2 Volume Table row for the old volume
serial number
- inserts a new row in the DB2 Volume Table for the new volume serial
number
- updates the row of the opposite volume in the DB2 Volume Table
with the new volume serial number
- issues message CBR4460 to inform the operator that the relabeling
of the 3995 optical disk volume has completed