470 lines
17 KiB
HTML
470 lines
17 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Duplicate Optical (DUPOPT)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="DUPOPT.Top_Of_Page"></a>
|
|
<h2>Duplicate Optical (DUPOPT)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#DUPOPT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DUPOPT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DUPOPT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DUPOPT"></a>
|
|
<p>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 the time it was created.
|
|
</p>
|
|
<p><b>Restriction:</b> To use this command you must 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 media library. You need *CHANGE authority to the authorization list securing the target volume if it is in an optical device.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DUPOPT.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.FROMVOL"><b>FROMVOL</b></a></td>
|
|
<td valign="top">From volume identifier</td>
|
|
<td valign="top"><i>Character value</i>, *MOUNTED</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.TOVOL"><b>TOVOL</b></a></td>
|
|
<td valign="top">To volume identifier</td>
|
|
<td valign="top"><i>Character value</i>, *MOUNTED</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.NEWVOL"><b>NEWVOL</b></a></td>
|
|
<td valign="top">New volume identifier</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*TOVOL</u></b>, *FROMVOL</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.CLEAR"><b>CLEAR</b></a></td>
|
|
<td valign="top">Clear</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.FROMDEV"><b>FROMDEV</b></a></td>
|
|
<td valign="top">From device</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.TODEV"><b>TODEV</b></a></td>
|
|
<td valign="top">To device</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.ALWMEDERR"><b>ALWMEDERR</b></a></td>
|
|
<td valign="top">Allow media errors</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *FILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*ERROR</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.FROMENDOPT"><b>FROMENDOPT</b></a></td>
|
|
<td valign="top">From end of media option</td>
|
|
<td valign="top"><b><u>*LEAVE</u></b>, *UNLOAD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DUPOPT.TOENDOPT"><b>TOENDOPT</b></a></td>
|
|
<td valign="top">To end of media option</td>
|
|
<td valign="top"><b><u>*LEAVE</u></b>, *UNLOAD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DUPOPT.FROMVOL"></a>
|
|
<h3>From volume identifier (FROMVOL)</h3>
|
|
<p>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).
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>from-volume-identifier</i></b></dt>
|
|
<dd>Specify the source volume identifier.
|
|
</dd>
|
|
<dt><b>*MOUNTED</b></dt>
|
|
<dd>Use the optical volume mounted in the optical device specified by the FROMDEV parameter.
|
|
<p>
|
|
<b>Note: </b>This value is not valid for volumes in optical media library devices.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.TOVOL"></a>
|
|
<h3>To volume identifier (TOVOL)</h3>
|
|
<p>Specifies the volume identifier of the optical volume being created (new volume). This volume must have the same physical characteristics as the volume specified on the FROMVOL parameter, but cannot be the volume on the opposite side of the cartridge. If the volume specified is WORM (write-once-read-many) media, it must be a volume that is not initialized. Use the Display Optical (DSPOPT) CL command to determine the physical characteristics of an optical volume.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>to-volume-identifier</i></b></dt>
|
|
<dd>Specify the target volume identifier.
|
|
</dd>
|
|
<dt><b><i> *MOUNTED</i></b></dt>
|
|
<dd>Use the optical volume mounted in the optical device specified by the TODEV parameter.
|
|
<p>
|
|
<b>Note: </b>This value is not valid for volumes in optical media library devices.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.NEWVOL"></a>
|
|
<h3>New volume identifier (NEWVOL)</h3>
|
|
<p>Specifies the new volume identifier of the to-volume after the duplication is complete.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*TOVOL</u></b></dt>
|
|
<dd>The volume identifier will be identical to the to-volume identifier.
|
|
</dd>
|
|
<dt><b>*FROMVOL</b></dt>
|
|
<dd>The volume identifier will be identical to the from-volume identifier. This parameter is only allowed for volumes that are not in a library device and either FROMENDOPT or TOENDOPT is *UNLOAD.
|
|
</dd>
|
|
<dt><b><i>new-volume-identifier</i></b></dt>
|
|
<dd>Specify the new volume identifier of the to-volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.CLEAR"></a>
|
|
<h3>Clear (CLEAR)</h3>
|
|
<p>Indicates whether to re-initialize the target optical volume if the volume is found to be already initialized.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored if the volume is WORM (write-once-read-many) media.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The volume is not re-initialized.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The volume is re-initialized.
|
|
<p>
|
|
<b>Note: </b>For media type *ERASE, specifying *YES will result in all existing data being erased prior to the start of the duplication process.
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.FROMDEV"></a>
|
|
<h3>From device (FROMDEV)</h3>
|
|
<p>Specifies the optical device which contains the from-volume.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only required if parameter FROMVOL is specified as *MOUNTED.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>from-optical-device</i></b></dt>
|
|
<dd>Specify the name of the optical device containing the from-volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.TODEV"></a>
|
|
<h3>To device (TODEV)</h3>
|
|
<p>Specifies the optical device which contains the to-volume.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is only required if parameter TOVOL is specified as *MOUNTED.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>to-optical-device</i></b></dt>
|
|
<dd>Specify the name of the optical device containing the to-volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.ALWMEDERR"></a>
|
|
<h3>Allow media errors (ALWMEDERR)</h3>
|
|
<p>Specifies whether or not the Duplicate Optical (DUPOPT) command should terminate if an error is encountered while trying to duplicate the file data areas.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>When an error is encountered duplicating the file data, stop the duplication and return the error.
|
|
</dd>
|
|
<dt><b>*FILE</b></dt>
|
|
<dd>When an error is encountered duplicating the file data, continue the duplication. A list of files not duplicated may be output by specifying OUTPUT(*ERROR).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether or not the output from the command is printed with the job's spooled output.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when *FILE is specified for the <b>Allow media errors (ALWMEDERR)</b> parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ERROR</u></b></dt>
|
|
<dd>If all of the files are duplicated, there is no output. If there are files that were not duplicated, a list of these files will be printed with the job's spooled output. Escape message OPT2047 will also be returned.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>If all of the files are duplicated, there is no output. If there are files that were not duplicated, the number of files not duplicated will be in the escape message OPT2047.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.FROMENDOPT"></a>
|
|
<h3>From end of media option (FROMENDOPT)</h3>
|
|
<p>After the DUPOPT request has completed, specifies whether to leave or unload the from-volume from the optical device in which it is located.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored if the from-volume is in an optical media library device.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LEAVE</u></b></dt>
|
|
<dd>The from-volume is left in the optical device.
|
|
</dd>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>The from-volume is unloaded from the optical device.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DUPOPT.TOENDOPT"></a>
|
|
<h3>To end of media option (TOENDOPT)</h3>
|
|
<p>After the DUPOPT request has completed, specifies whether to leave or unload the to-volume from the optical device in which it is located.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored if the to-volume is in an optical media library device.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LEAVE</u></b></dt>
|
|
<dd>The to-volume is left in the optical device.
|
|
</dd>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>The to-volume is unloaded from the optical device.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DUPOPT.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Duplicate an Optical Volume When the Volume Names are Known.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DUPOPT FROMVOL(VOL01) TOVOL(VOL02) NEWVOL(*TOVOL)
|
|
CLEAR(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
<p><b>Example 2: Duplicate an Optical Volume When the Device Names are Known.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DUPOPT FROMVOL(*MOUNTED) TOVOL(*MOUNTED) NEWVOL(BKP001)
|
|
CLEAR(*YES) FROMDEV(OPT01) TODEV(OPT02)
|
|
FROMENDOPT(*LEAVE) TOENDOPT(*UNLOAD)
|
|
</pre>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
<p><b>Example 3: Duplicate an Optical Volume and Continue the Duplication if Damaged Files are Found.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DUPOPT FROMVOL(VOL01) TOVOL(VOL02) NEWVOL(*TOVOL)
|
|
CLEAR(*YES) ALWMEDERR(*FILE) OUTPUT(*ERROR)
|
|
</pre>
|
|
</p>
|
|
<p>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. If there are any damaged files on VOL01 the duplication will continue and the damaged files will not be duplicated. The names of the damaged files will be printed to the job's spooled output.
|
|
</p>
|
|
<p><b>Example 4: Duplicate an Exact Copy of a Volume Using NEWVOL(*FROMVOL).</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DUPOPT FROMVOL(VOL01) TOVOL(VOL02) NEWVOL(*FROMVOL)
|
|
CLEAR(*YES) TODEV(OPT02) TOENDOPT(*UNLOAD)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a duplicate of the optical volume VOL01 on volume VOL02. VOL02 will be re-initialized prior to the duplication process. The volume in device OPT02 will be unloaded after the duplication process completes and will have a volume identifier of VOL01.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DUPOPT.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>OPT1305</b></dt>
|
|
<dd>Optical volume &1 is read only.
|
|
</dd>
|
|
<dt><b>OPT1315</b></dt>
|
|
<dd>Optical volume &1 is write protected.
|
|
</dd>
|
|
<dt><b>OPT1320</b></dt>
|
|
<dd>Optical volume &1 in use.
|
|
</dd>
|
|
<dt><b>OPT1325</b></dt>
|
|
<dd>Optical volume format not recognized.
|
|
</dd>
|
|
<dt><b>OPT1330</b></dt>
|
|
<dd>Optical volume not found or not useable.
|
|
</dd>
|
|
<dt><b>OPT1331</b></dt>
|
|
<dd>Optical volume &1 not found.
|
|
</dd>
|
|
<dt><b>OPT1335</b></dt>
|
|
<dd>Volume &1 already initialized.
|
|
</dd>
|
|
<dt><b>OPT1338</b></dt>
|
|
<dd>Operation not supported for library device.
|
|
</dd>
|
|
<dt><b>OPT1340</b></dt>
|
|
<dd>Optical volume &1 not initialized.
|
|
</dd>
|
|
<dt><b>OPT1342</b></dt>
|
|
<dd>Invalid volume identifier specified.
|
|
</dd>
|
|
<dt><b>OPT1346</b></dt>
|
|
<dd>Operation not allowed to volume located in a remote optical device.
|
|
</dd>
|
|
<dt><b>OPT1350</b></dt>
|
|
<dd>Write operation failed to optical volume &1.
|
|
</dd>
|
|
<dt><b>OPT1375</b></dt>
|
|
<dd>Optical volume &1 already exists.
|
|
</dd>
|
|
<dt><b>OPT1460</b></dt>
|
|
<dd>Optical volume &1 is not in an optical device.
|
|
</dd>
|
|
<dt><b>OPT1499</b></dt>
|
|
<dd>Source and target volumes are in different optical device types.
|
|
</dd>
|
|
<dt><b>OPT1515</b></dt>
|
|
<dd>Unsupported or insufficient configuration on optical device &1.
|
|
</dd>
|
|
<dt><b>OPT1530</b></dt>
|
|
<dd>&1 does not represent a valid optical device.
|
|
</dd>
|
|
<dt><b>OPT1555</b></dt>
|
|
<dd>Optical device &1 in use.
|
|
</dd>
|
|
<dt><b>OPT1605</b></dt>
|
|
<dd>Media or device error occurred.
|
|
</dd>
|
|
<dt><b>OPT1790</b></dt>
|
|
<dd>Operation not allowed or conflicts with another request.
|
|
</dd>
|
|
<dt><b>OPT1805</b></dt>
|
|
<dd>Error accessing optical volume index file.
|
|
</dd>
|
|
<dt><b>OPT1810</b></dt>
|
|
<dd>Error accessing optical directory index file.
|
|
</dd>
|
|
<dt><b>OPT1815</b></dt>
|
|
<dd>Internal program error occurred.
|
|
</dd>
|
|
<dt><b>OPT1820</b></dt>
|
|
<dd>Internal error occurred on optical device &1.
|
|
</dd>
|
|
<dt><b>OPT1821</b></dt>
|
|
<dd>Error occurred on optical device &1.
|
|
</dd>
|
|
<dt><b>OPT1825</b></dt>
|
|
<dd>Optical indexes are incorrect for optical device &1.
|
|
</dd>
|
|
<dt><b>OPT1860</b></dt>
|
|
<dd>Request to optical device &1 failed.
|
|
</dd>
|
|
<dt><b>OPT1861</b></dt>
|
|
<dd>No device description configured for resource &1.
|
|
</dd>
|
|
<dt><b>OPT1862</b></dt>
|
|
<dd>No active device description for resource &1.
|
|
</dd>
|
|
<dt><b>OPT1863</b></dt>
|
|
<dd>Optical libraries need to be reclaimed.
|
|
</dd>
|
|
<dt><b>OPT1864</b></dt>
|
|
<dd>Insufficient allocated and operational optical drives.
|
|
</dd>
|
|
<dt><b>OPT1872</b></dt>
|
|
<dd>Optical request timed out or was cancelled.
|
|
</dd>
|
|
<dt><b>OPT2029</b></dt>
|
|
<dd>TOVOL on opposite side of FROMVOL
|
|
</dd>
|
|
<dt><b>OPT2047</b></dt>
|
|
<dd>Duplicate Optical completed. &3 files were not duplicated.
|
|
</dd>
|
|
<dt><b>OPT2050</b></dt>
|
|
<dd>The duplicate optical volume request from optical volume &1 to optical volume &2 failed.
|
|
</dd>
|
|
<dt><b>OPT2301</b></dt>
|
|
<dd>Internal system object in use.
|
|
</dd>
|
|
<dt><b>OPT2420</b></dt>
|
|
<dd>Not authorized to optical volume &2.
|
|
</dd>
|
|
<dt><b>OPT7740</b></dt>
|
|
<dd>User not authorized to object &2 in library &3 type &4.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DUPOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|