275 lines
10 KiB
HTML
275 lines
10 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>Reclaim Optical (RCLOPT)</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="RCLOPT.Top_Of_Page"></a>
|
|
<h2>Reclaim Optical (RCLOPT)</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="#RCLOPT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RCLOPT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RCLOPT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RCLOPT"></a>
|
|
<p>The Reclaim Optical (RCLOPT) command rebuilds the optical index database files and/or the internal library indexes. These files and indexes are used to maintain volume and directory information. Following are some of the reasons the files and indexes may need to be rebuilt: after CISC to RISC migration, after optical media is physical moved or removed by hand, after a hardware failure while media was being moved, or when a database or index has been damaged or destroyed. This command requires exclusive use of the directly-attached optical device.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This command may take an extended period of time to complete - possibly more then 24 hours. The time to completion is influenced by several factors including: number of optical libraries, number of media in each library, capacity of each media, number of files and directories on each media and the options chosen on the command.
|
|
</p>
|
|
<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="#RCLOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RCLOPT.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="#RCLOPT.MLB"><b>MLB</b></a></td>
|
|
<td valign="top">Optical media library</td>
|
|
<td valign="top"><i>Name</i>, *ALL</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCLOPT.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top"><b><u>*SYNC</u></b>, *UPDATE, *RESET</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCLOPT.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RCLOPT.DIR"><b>DIR</b></a></td>
|
|
<td valign="top">Rebuild directory index</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RCLOPT.MLB"></a>
|
|
<h3>Optical media library (MLB)</h3>
|
|
<p>Specifies the directly-attached optical device for which the optical indexes are rebuilt.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The optical indexes for all directly-attached optical devices are rebuilt.
|
|
</dd>
|
|
<dt><b><i>optical-device-name</i></b></dt>
|
|
<dd>Specify the name of the directly-attached optical device for which the optical indexes are rebuilt.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCLOPT.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Specifies which type of reclaim operation is performed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SYNC</u></b></dt>
|
|
<dd>The optical volume index is synchronized with the internal device index. If a volume is not in the optical volume index, both the volume and the directory index entries are created for the volume. This option will usually complete in the shortest amount of time and, in most cases, should be attempted first before trying the *UPDATE or *RESET option.
|
|
</dd>
|
|
<dt><b>*UPDATE</b></dt>
|
|
<dd>The optical volume index is rebuilt and the optical directory index is optionally rebuilt with information read from the optical cartridge. In most cases this option will be used to rebuild the indexes for a single volume or optical cartridge.
|
|
</dd>
|
|
<dt><b>*RESET</b></dt>
|
|
<dd>The internal device index and the optical volume index are rebuilt. The optical directory index is optionally rebuilt with information read from the optical cartridge. Selecting *RESET requires every volume to be mounted into a drive at least once. The optical directory index is built if the Rebuild directory index parameter is set to *YES. Specifying DIR(*YES) will require every volume to be mounted a second time. In most cases *RESET should be used only after *SYNC and/or *UPDATE have already been attempted.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCLOPT.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies which volumes are used during the reclaim operation when OPTION(*UPDATE) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All volumes in the optical device are used.
|
|
</dd>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the volume identifier of a specific volume to use during the reclaim operation.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RCLOPT.DIR"></a>
|
|
<h3>Rebuild directory index (DIR)</h3>
|
|
<p>Specifies whether the optical directory index is rebuilt for each volume processed during Reclaim Optical processing. This parameter only applies to options *UPDATE and *RESET. When *SYNC is specified, DIR(*NO) will be used. In addition, this option does not apply to volumes which have a media format type of *UDF since directory index information is not maintained for *UDF volumes. When *UDF volumes are processed, DIR(*NO) will be used.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The optical directory index is not rebuilt for each volume processed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The optical directory index is rebuilt for each volume processed. Only applies to *UPDATE and *RESET for non-UDF volumes.
|
|
<p>
|
|
<b>Note: </b>Choosing the value *NO may result in less time being required to complete the Reclaim Optical request.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RCLOPT.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
RCLOPT MLB(OPT01) OPTION(*UPDATE) VOL(VOL01) DIR(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command re-creates both the optical volume index and the optical directory index for the optical volume VOL01 in the optical media library OPT01.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RCLOPT.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>OPT0125</b></dt>
|
|
<dd>Command &1 completed with errors, more information in job log.
|
|
</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>OPT1346</b></dt>
|
|
<dd>Operation not allowed to volume located in a remote optical device.
|
|
</dd>
|
|
<dt><b>OPT1360</b></dt>
|
|
<dd>Media directory corrupted on optical volume &1.
|
|
</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>OPT1605</b></dt>
|
|
<dd>Media or device error occurred.
|
|
</dd>
|
|
<dt><b>OPT1640</b></dt>
|
|
<dd>Error occurred reading files or directories.
|
|
</dd>
|
|
<dt><b>OPT1652</b></dt>
|
|
<dd>Device &1 is not an optical media library.
|
|
</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>OPT2040</b></dt>
|
|
<dd>Error accessing backup control file.
|
|
</dd>
|
|
<dt><b>OPT2155</b></dt>
|
|
<dd>Reclaim Optical failed for optical device &1.
|
|
</dd>
|
|
<dt><b>OPT2165</b></dt>
|
|
<dd>Reclaim Optical failed for volume &1.
|
|
</dd>
|
|
<dt><b>OPT2187</b></dt>
|
|
<dd>Optical index inconsistency, reclaim optical required.
|
|
</dd>
|
|
<dt><b>OPT2188</b></dt>
|
|
<dd>Optical index files are damaged.
|
|
</dd>
|
|
<dt><b>OPT2190</b></dt>
|
|
<dd>Error occurred during reclaim optical processing while accessing volume &1.
|
|
</dd>
|
|
<dt><b>OPT2191</b></dt>
|
|
<dd>Error occurred while reading volume directory for volume &1.
|
|
</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="#RCLOPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|