DUPOPT (Duplicate Optical)

DUPOPT Command syntax diagram

 

Purpose

The Duplicate Optical (DUPOPT) command creates a duplicate optical volume. The duplicate volume is identical to the original volume except for the volume identifier and time the volume was created.

Restriction: To use this command have *USE authority to the authorization list securing the source volume. You need *ALL authority to the authorization list securing the target volume if it is in an optical library device. You need *CHANGE authority to the authorization list securing the target volume if it is in an optical stand-alone device.

 

Required Parameters

FROMVOL
Specifies the volume identifier of the optical volume being duplicated. To determine the volume identifier of media not in an optical media library issue the following Display Optical CL command: DSPOPT VOL(*MOUNTED) DEV(device).

from-volume-identifier: Specify the source volume identifier.

*MOUNTED: Use the optical volume mounted in the optical device specified by the FROMDEV parameter.

Note: This value is not valid for volumes in optical media library devices.

TOVOL
Specifies the volume identifier of the optical volume onto which the from-volume will be duplicated. This volume must have the following physical characteristics:

  • If the FROMVOL media type is *WORM then the TOVOL media type can be either *WORM or *ERASE.

  • If the FROMVOL media type is not *WORM then the TOVOL media type must be identical to the media type of the FROMVOL.

  • If the TOVOL media type is *WORM it must be a volume that is not initialized.

  • The TOVOL can not be on the opposite side of the FROMVOL cartridge.

  • The block size of the FROMVOL and TOVOL must be identical.

  • The volume capacity of the TOVOL must be equal to or greater than the FROMVOL volume capacity.

Use the Display Optical (DSPOPT) CL command to determine the physical characteristics of an optical volume.

to-volume-identifier: Specify the target volume identifier.

*MOUNTED: Use the optical volume mounted in the optical device specified by the TODEV parameter.

Note: This value is not valid for volumes in optical media library devices.

 

Optional Parameters

NEWVOL
Specifies the new volume identifier of the to-volume after the duplication is complete.

*TOVOL: The new volume identifier will be identical to the to-volume identifier.

new-volume-identifier: Specify the new volume identifier of the to-volume.

CLEAR
Indicates whether to re-initialize an optical volume if the volume is found to be already initialized.

Note: This parameter is ignored if the volume media type is *WORM.

*NO: The volume is not re-initialized.

*YES: The volume will be re-initialized.

Note: For media type *ERASE, specifying *YES will result in all existing data being erased prior to the start of the duplication process.

For media type *DVD-RAM, specifying *YES will not result in existing data being erased prior to the start of the duplication process. Though the data is not erased, access to the data is lost. If it is required that data on *DVD-RAM media be erased, initialize the volume using Initialize Optical (INZOPT), prior to running DUPOPT. Specify the CLEAR(*YES) parameter on the Initialize Optical (INZOPT) CL command.

FROMDEV
Specifies the name of an optical device which contains the from-volume.

Note: This parameter is only required if parameter FROMVOL is specified as *MOUNTED.

from-optical-device: The name of the optical device containing the from-volume.

TODEV
Specifies the name of an optical device which contains the to-volume.

Note: This parameter is only required if parameter TOVOL is specified as *MOUNTED.

to-optical-device: The name of the optical device containing the to-volume.

FROMENDOPT
After the DUPOPT request has completed, specifies whether to leave or unload the from-volume from the optical device in which it is located.

Note: This parameter is ignored if the from-volume is in an optical media library device.

*LEAVE: The from-volume is left in the optical device.

*UNLOAD: The from-volume is unloaded from the optical device.

TOENDOPT
After the DUPOPT request has completed, specifies whether to leave or unload the to-volume from the optical device in which it is located.

Note: This parameter is ignored if the to-volume is in an optical media library device.

*LEAVE: The to-volume is left in the optical device.

*UNLOAD: The to-volume is unloaded from the optical device.

Examples for DUPOPT

Example 1: Duplicate an optical volume when the volume names are known. 

DUPOPT   FROMVOL(VOL01)  TOVOL(VOL02)
         NEWVOL(*TOVOL)  CLEAR(*YES)

This command creates a duplicate of the optical volume VOL01 on volume VOL02, which keeps the same volume identifier. VOL02 will be re-initialized prior to the duplication process.

Example 2: Duplicate an optical volume when the device names are known. 

DUPOPT   FROMVOL(*MOUNTED)  TOVOL(*MOUNTED)
         NEWVOL(BKP001)     CLEAR(*YES)
         FROMDEV(OPT01)     TODEV(OPT02)
         FROMENDOPT(*LEAVE) TOENDOPT(*UNLOAD)

This command duplicates the optical volume in optical device OPT01 onto the volume in device OPT02. The optical volume in device OPT02 is re-initialized prior to the duplication process. The volume in device OPT01 will be left in the device after the duplication process completes. The volume in device OPT02 will be unloaded after the duplication process completes and will have a volume identifier of BKP001.

Error messages for DUPOPT

*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.
OPT1335
Volume &1 already initialized.
OPT1340
Optical volume &1 not initialized.
OPT1342
Invalid volume identifier specified.
OPT1346
Operation not allowed to volume located in a remote optical device.
OPT1350
Write operations failed to optical volume &1.
OPT1375
Optical volume &1 already exists.
OPT1460
Optical volume &1 is not in an optical device.
OPT1499
Source and target volumes are in different optical devices.
OPT1515
Unsupported or insufficient configuration on optical device &1.
OPT1530
&1 does not represent a valid optical device.
OPT1555
Optical device &1 in use.
OPT1605
Media or device error occurred.
OPT1790
Operation 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.
OPT1821
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.
OPT2029
TOVOL on opposite side of FROMVOL
OPT2050
The duplicate optical volume request from optical volume &1 to optical volume &2 failed.
OPT2301
Internal system object in use.
OPT2420
Not authorized to optical volume &2.
OPT7740
User not authorized to object &2 in library &3 type &4.