Convert Optical Backup (CVTOPTBKU)

The Convert Optical Backup (CVTOPTBKU) command converts an optical backup volume to an optical primary volume. User applications and programs can then write to the converted volume.

Note: Once an optical volume is converted from a backup volume to a primary volume, you must initialize the optical volume to convert it to a backup volume again. Initializing an optical volume results in losing all existing information on the optical volume.

Restriction: To use this command you must have *ALL authority to the authorization list securing the volume to be converted.

Keyword	Description	Choices	Notes
BKUVOL	Backup volume identifier	Character value	Required, Positional 1
PRIVOL	Primary volume identifier	Character value, *PRVPRIVOL	Optional, Positional 2

Primary volume identifier (PRIVOL)

Specifies the identifier of the optical volume after it is converted to a primary volume.

Note: The identifier must be unique within the system you are using. More information about optical volume names can be found in the Optical Support, SC41-4310 book.

*PRVPRIVOL: The identifier of the new primary optical volume is the same as the identifier of the primary optical volume for which this volume previously was a backup.
When an optical backup volume is first used, the system records the volume identifier of the primary volume on the media. This is done to ensure that no other primary volume can use the same backup volume identifier. This also ensures that the original name of the primary volume is known at the time the optical backup volume is converted.
primary-volume-identifier: Specify a new volume identifier. This is the identifier of the volume after this command completes successfully.

Examples

CVTOPTBKU   BKUVOL(VOL01BACKUP)  PRIVOL(VOL02)

This command converts the optical backup volume VOL01BACKUP to a primary optical volume. VOL02 is the identifier of the optical volume after it is converted.

Error messages

*ESCAPE Messages

OPT1305: Optical volume &1 is read only.
OPT1315: Optical volume &1 is write protected.
OPT1320: Optical volume &1 in use.
OPT1325: Optical volume format not recognized.
OPT1330: Optical volume not found or not useable.
OPT1331: Optical volume &1 not found.
OPT1340: Optical volume &1 not initialized.
OPT1342: Invalid volume identifier specified.
OPT1345: No free space available on media.
OPT1350: Write operation failed to optical volume &1.
OPT1360: Media directory corrupted on optical volume &1.
OPT1375: Optical volume &1 already exists.
OPT1460: Optical volume &1 is not in an optical device.
OPT1462: Operation not completed, optical volume is not a backup volume.
OPT1530: &1 does not represent a valid optical device.
OPT1605: Media or device error occurred.
OPT1790: Operation not allowed or conflicts with another request.
OPT1805: Error accessing optical volume index file.
OPT1810: Error accessing optical directory index file.
OPT1815: Internal program error occurred.
OPT1820: Internal error occurred on optical device &1.
OPT1825: Optical indexes are incorrect for optical device &1.
OPT1860: Request to optical device &1 failed.
OPT1861: No device description configured for resource &1.
OPT1862: No active device description for resource &1.
OPT1863: Optical libraries need to be reclaimed.
OPT1872: Optical request timed out or was cancelled.
OPT2030: Error during Convert Optical Backup.
OPT2301: Internal system object in use.
OPT7740: User not authorized to object &2 in library &3 type &4.