220 lines
6.8 KiB
HTML
220 lines
6.8 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>Work with Optical Volumes (WRKOPTVOL)</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="WRKOPTVOL.Top_Of_Page"></a>
|
|
<h2>Work with Optical Volumes (WRKOPTVOL)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#WRKOPTVOL.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#WRKOPTVOL.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#WRKOPTVOL.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="WRKOPTVOL"></a>
|
|
<p>The Work with Optical Volumes (WRKOPTVOL) command displays a list of optical volumes and provides options to:
|
|
</p>
|
|
<ul>
|
|
<li>add an optical cartridge
|
|
</li>
|
|
<li>remove an optical cartridge
|
|
</li>
|
|
<li>change optical volume attributes
|
|
</li>
|
|
<li>display optical volume attributes
|
|
</li>
|
|
<li>print optical volume attributes
|
|
</li>
|
|
<li>copy a volume
|
|
</li>
|
|
<li>initialize a volume
|
|
</li>
|
|
<li>rename a volume
|
|
</li>
|
|
<li>delete a volume entry
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="WRKOPTVOL.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="#WRKOPTVOL.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Optical device</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKOPTVOL.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *BACKUP, *INDRIVE, *REMOVED</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKOPTVOL.CSI"><b>CSI</b></a></td>
|
|
<td valign="top">Side information</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKOPTVOL.RTVEXTINFO"><b>RTVEXTINFO</b></a></td>
|
|
<td valign="top">Retrieve extended information</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="#WRKOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="WRKOPTVOL.DEV"></a>
|
|
<h3>Optical device (DEV)</h3>
|
|
<p>Specifies the optical device from which the volumes are listed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The volumes in all optical devices are listed.
|
|
</dd>
|
|
<dt><b><i>optical-device-name</i></b></dt>
|
|
<dd>Specify the name of an optical device from which the volumes are listed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKOPTVOL.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the optical volume identifiers which are listed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All optical volume identifiers in the specified optical devices are listed.
|
|
</dd>
|
|
<dt><b>*BACKUP</b></dt>
|
|
<dd>The optical volumes in the specified optical devices whose type is backup are listed.
|
|
</dd>
|
|
<dt><b>*INDRIVE</b></dt>
|
|
<dd>Only the volumes which are currently in a drive for the specified optical device are listed.
|
|
</dd>
|
|
<dt><b>*REMOVED</b></dt>
|
|
<dd>The volumes removed from optical libraries but whose information was kept in the optical index database files are listed.
|
|
</dd>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the identifier of a specific volume to be listed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKOPTVOL.CSI"></a>
|
|
<h3>Side information (CSI)</h3>
|
|
<p>Specifies the communications side information objects representing the optical servers in the optical configuration from which the volumes are listed. This parameter is valid only when DEV(*ALL) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The names of volumes for all remote optical servers are listed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No volumes are listed for remote optical servers.
|
|
</dd>
|
|
<dt><b><i>communications-side-information-object-name</i></b></dt>
|
|
<dd>Specify the name of the communications side information object representing the optical server for which volumes are listed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKOPTVOL.RTVEXTINFO"></a>
|
|
<h3>Retrieve extended information (RTVEXTINFO)</h3>
|
|
<p>Specifies whether extended volume information, such as location of the volume and the percentage of the volume used, is retrieved.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>No extended volume information is retrieved.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The extended volume information is retrieved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKOPTVOL.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying Optical Volumes in an Optical Device</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKOPTVOL DEV(OPT01)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the Work with Optical Volumes panel, showing a list of all optical volumes in the optical device OPT01.
|
|
</p>
|
|
<p><b>Example 2: Displaying Optical Volumes in a Remote Server</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKOPTVOL DEV(*ALL) VOL(*ALL) CSI(LAN01)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the Work with Optical Volumes panel, showing a list of all optical volumes in the optical server LAN01.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKOPTVOL.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>OPT1530</b></dt>
|
|
<dd>&1 does not represent a valid optical device.
|
|
</dd>
|
|
<dt><b>OPT1805</b></dt>
|
|
<dd>Error accessing optical volume index file.
|
|
</dd>
|
|
<dt><b>OPT1815</b></dt>
|
|
<dd>Internal program error occurred.
|
|
</dd>
|
|
<dt><b>OPT1860</b></dt>
|
|
<dd>Request to optical device &1 failed.
|
|
</dd>
|
|
<dt><b>OPT2301</b></dt>
|
|
<dd>Internal system object in use.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTVOL.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|