271 lines
8.7 KiB
HTML
271 lines
8.7 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>Change Optical Volume (CHGOPTVOL)</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="CHGOPTVOL.Top_Of_Page"></a>
|
|
<h2>Change Optical Volume (CHGOPTVOL)</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="#CHGOPTVOL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGOPTVOL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGOPTVOL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGOPTVOL"></a>
|
|
<p>The Change Optical Volume (CHGOPTVOL) command changes the volume-full threshold, the authorization list, or the description of an optical volume. If TYPE(*BACKUP) was specified when the volume was initialized, the volume-full threshold cannot be changed.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>To use this command the user must have *CHANGE authority to the volume being changed.
|
|
</li>
|
|
<li>If this command is being used to change the volume's authorization list, the user must have *AUTLMGT authority to the authorization list currently securing the volume.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGOPTVOL.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="#CHGOPTVOL.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGOPTVOL.THRESHOLD"><b>THRESHOLD</b></a></td>
|
|
<td valign="top">Volume full threshold</td>
|
|
<td valign="top">1-100, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGOPTVOL.AUTL"><b>AUTL</b></a></td>
|
|
<td valign="top">Authorization list</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGOPTVOL.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, *BLANK, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGOPTVOL.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the volume identifier of the optical volume to be changed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGOPTVOL.THRESHOLD"></a>
|
|
<h3>Volume full threshold (THRESHOLD)</h3>
|
|
<p>Specifies the volume-full-threshold percentage.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b><i>volume-full-threshold</i></b></dt>
|
|
<dd>Specify the threshold percentage. Valid values range from 1 through 100.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGOPTVOL.AUTL"></a>
|
|
<h3>Authorization list (AUTL)</h3>
|
|
<p>The authorization list used to verify access to the optical volume on this iSeries. This value is not stored on the volume and will not be maintained when the optical disk is moved between systems.
|
|
</p>
|
|
<p>For volumes in media library devices the authorization list can be maintained for this iSeries when the optical disk is removed from the device. This can be done by specifying VOLOPT(*KEEP) on the Remove Optical Cartridge (RMVOPTCTG) CL command. The authorization list can then be restored by specifying AUTL(*PRV) on the Add Optical Cartridge (ADDOPTCTG) CL command.
|
|
</p>
|
|
<p>If the volume is in a stand-alone optical device such as a CD-ROM or DVD device, the authorization list will secure the volume for the duration that the optical disk is in the device. The authorization list cannot be maintained when the optical disk is removed from the device. If the optical disk is ejected from the device then inserted again, the authorization list will be reset to the default which is QOPTSEC.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No authorization list is used to secure the optical volume.
|
|
</dd>
|
|
<dt><b><i>authorization-list-name</i></b></dt>
|
|
<dd>Specify the name of the authorization list used to secure the optical volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGOPTVOL.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the optical volume.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>Text is not specified.
|
|
</dd>
|
|
<dt><b><i>'description'</i></b></dt>
|
|
<dd>Specify a maximum of 50 characters enclosed in apostrophes to describe the optical volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGOPTVOL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGOPTVOL VOL(VOL01) THRESHOLD(99)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the volume-full-threshold for the optical volume VOL01 to 99 percent.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGOPTVOL.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>OPT1340</b></dt>
|
|
<dd>Optical volume &1 not initialized.
|
|
</dd>
|
|
<dt><b>OPT1341</b></dt>
|
|
<dd>THRESHOLD or TEXT can not be specified.
|
|
</dd>
|
|
<dt><b>OPT1345</b></dt>
|
|
<dd>No free space available on media.
|
|
</dd>
|
|
<dt><b>OPT1350</b></dt>
|
|
<dd>Write operation failed to optical volume &1.
|
|
</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>OPT1463</b></dt>
|
|
<dd>Operation not completed, optical volume is not a primary volume.
|
|
</dd>
|
|
<dt><b>OPT1485</b></dt>
|
|
<dd>Initialize or rename of optical volume failed.
|
|
</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>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>OPT2410</b></dt>
|
|
<dd>Authorization list &1 for volume &2 was not found.
|
|
</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="#CHGOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|