356 lines
12 KiB
HTML
356 lines
12 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>Remove Optical Cartridge (RMVOPTCTG)</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="RMVOPTCTG.Top_Of_Page"></a>
|
|
<h2>Remove Optical Cartridge (RMVOPTCTG)</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="#RMVOPTCTG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RMVOPTCTG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RMVOPTCTG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RMVOPTCTG"></a>
|
|
<p>The Remove Optical Cartridge (RMVOPTCTG) command can be used to:
|
|
</p>
|
|
<ul>
|
|
<li>Remove an optical disk cartridge and its volume(s) from an optical device or media library device.
|
|
</li>
|
|
<li>Remove a cartridge currently in the input/output station of an optical media library.
|
|
</li>
|
|
<li>Move the input/output station of an optical media library to the out position.
|
|
</li>
|
|
<li>Open the tray for some optical devices.
|
|
</li>
|
|
<li>Remove the volume description of an optical volume previously removed using this command with VOLOPT(*KEEP) specified.
|
|
</li>
|
|
</ul>
|
|
<p><b>Restriction:</b> You must have *USE authority to use this command. It is shipped with *EXCLUDE public authority.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RMVOPTCTG.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="#RMVOPTCTG.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top"><i>Character value</i>, *IOSTATION, *MOUNTED, *LEASTUSED, *MAGAZINE</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVOPTCTG.VOLOPT"><b>VOLOPT</b></a></td>
|
|
<td valign="top">Volume description option</td>
|
|
<td valign="top"><b><u>*REMOVE</u></b>, *KEEP</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVOPTCTG.MEDLOC"><b>MEDLOC</b></a></td>
|
|
<td valign="top">Media location</td>
|
|
<td valign="top"><b><u>*IOSTATION</u></b>, *MAGAZINE</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVOPTCTG.RMVCTGLOC"><b>RMVCTGLOC</b></a></td>
|
|
<td valign="top">Removed cartridge location</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVOPTCTG.MLB"><b>MLB</b></a></td>
|
|
<td valign="top">Optical media library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RMVOPTCTG.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Optical device</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RMVOPTCTG.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the volume identifier of the optical cartridge to be removed from the optical device or media library device. For cartridges with two volumes, only one volume identifier must be specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*IOSTATION</b></dt>
|
|
<dd>The input/output station of an optical media library is moved to the out position. This allows any optical cartridge currently in the input/output station to be removed.
|
|
<p>
|
|
<b>Note: </b>This value is only valid when parameter MLB is specified.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*LEASTUSED</b></dt>
|
|
<dd>The system will determine which optical cartridge is the least recently used and removes it from the specified media library.
|
|
<p>
|
|
<b>Note: </b>This value is only valid when parameter MLB is specified.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*MOUNTED</b></dt>
|
|
<dd>The system will remove the description of the volume located in the optical device specified on the DEV parameter. For some optical devices the tray will be opened.
|
|
<p>
|
|
<b>Note: </b>This value is only valid when parameter DEV is specified.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*MAGAZINE</b></dt>
|
|
<dd>This value will open the bulk load magazine for removal from the optical library..
|
|
<p>
|
|
<b>Note: </b>This value is only valid when parameter MLB is specified.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the volume identifier of the optical cartridge being removed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVOPTCTG.VOLOPT"></a>
|
|
<h3>Volume description option (VOLOPT)</h3>
|
|
<p>Specifies whether to keep the optical volume description in the optical index database files.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only if a volume identifier is specified on the VOL parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REMOVE</u></b></dt>
|
|
<dd>The volume description is removed from the optical index database files.
|
|
</dd>
|
|
<dt><b>*KEEP</b></dt>
|
|
<dd>The volume description is kept in the optical index database files. This allows the volume descriptions of removed volumes to be displayed when using the Work with Optical Volumes (WRKOPTVOL) command.
|
|
<p>
|
|
<b>Note: </b>This value is only valid for initialized volumes in media library devices. For uninitialized volumes and volumes in other optical devices, this value will be ignored and *REMOVE will be used.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVOPTCTG.MEDLOC"></a>
|
|
<h3>Media location (MEDLOC)</h3>
|
|
<p>Specifies the final destination of the optical volume being removed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*IOSTATION</u></b></dt>
|
|
<dd>The optical cartridge is removed to the input/output station.
|
|
</dd>
|
|
<dt><b>*MAGAZINE</b></dt>
|
|
<dd>The optical cartridge is removed to the bulk load magazine.
|
|
<p>
|
|
<b>Note: </b>Not all optical libraries are equipped with a bulk load magazine.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVOPTCTG.RMVCTGLOC"></a>
|
|
<h3>Removed cartridge location (RMVCTGLOC)</h3>
|
|
<p>Specifies the external location of the optical cartridge after it is removed.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when VOLOPT(*KEEP) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No external location is specified.
|
|
</dd>
|
|
<dt><b><i>removed-cartridge-location</i></b></dt>
|
|
<dd>Specify the location of the optical cartridge after it is removed. A maximum of 50 characters can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVOPTCTG.MLB"></a>
|
|
<h3>Optical media library (MLB)</h3>
|
|
<p>Specifies the name of the optical media library to use for the operation.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when VOL(*IOSTATION), VOL(*MAGAZINE) or VOL(*LEASTUSED) is specified. This parameter is ignored when a specific volume name is specified on the VOL parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RMVOPTCTG.DEV"></a>
|
|
<h3>Optical device (DEV)</h3>
|
|
<p>Specifies the name of the optical device which is to have the volume which it contains removed from the optical index database and tray opened if supported by the device.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when VOL(*MOUNTED) is specified. This parameter is ignored when a specific volume name is specified on the VOL parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVOPTCTG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Specify a Volume Identifier</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVOPTCTG VOL(VOL01)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes optical cartridge with volume identifier VOL01.
|
|
</p>
|
|
<p><b>Example 2: Specify a Stand-Alone Device</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVOPTCTG VOL(*MOUNTED) DEV(OPT01)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes the volume found in the stand-alone optical device OPT01.
|
|
</p>
|
|
<p><b>Example 3: Specify a Media Location of *MAGAZINE</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVOPTCTG VOL(VOL01) MEDLOC(*MAGAZINE)
|
|
</pre>
|
|
</p>
|
|
<p>This command removes optical cartridge with volume identifier VOL01 to the bulk load magazine.
|
|
</p>
|
|
<p><b>Example 4: Specify a Volume Name of *MAGAZINE</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVOPTCTG VOL(*MAGAZINE) MLB(OPTMLB01)
|
|
</pre>
|
|
</p>
|
|
<p>This command opens the bulk load magazine so that it can be removed from the optical media library.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RMVOPTCTG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<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>OPT1346</b></dt>
|
|
<dd>Operation not allowed to volume located in a remote optical device.
|
|
</dd>
|
|
<dt><b>OPT1430</b></dt>
|
|
<dd>Optical volume &1 information removed.
|
|
</dd>
|
|
<dt><b>OPT1460</b></dt>
|
|
<dd>Optical volume &1 is not in an optical device.
|
|
</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>OPT1652</b></dt>
|
|
<dd>Device &1 is not an optical media library.
|
|
</dd>
|
|
<dt><b>OPT1671</b></dt>
|
|
<dd>Feature not installed for optical device &1.
|
|
</dd>
|
|
<dt><b>OPT1672</b></dt>
|
|
<dd>Error accessing bulk load magazine for optical device &1.
|
|
</dd>
|
|
<dt><b>OPT1676</b></dt>
|
|
<dd>Bulk load magazine is full for optical device &1.
|
|
</dd>
|
|
<dt><b>OPT1677</b></dt>
|
|
<dd>Bulk load magazine is open for optical device &1.
|
|
</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>OPT1872</b></dt>
|
|
<dd>Optical request timed out or was cancelled.
|
|
</dd>
|
|
<dt><b>OPT2301</b></dt>
|
|
<dd>Internal system object in use.
|
|
</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="#RMVOPTCTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|