119 lines
4.4 KiB
HTML
119 lines
4.4 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 Held Optical Files (WRKHLDOPTF)</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="WRKHLDOPTF.Top_Of_Page"></a>
|
|
<h2>Work with Held Optical Files (WRKHLDOPTF)</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="#WRKHLDOPTF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#WRKHLDOPTF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#WRKHLDOPTF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="WRKHLDOPTF"></a>
|
|
<p>The Work with Held Optical Files (WRKHLDOPTF) command displays a list of held optical files and provides options to save, release, and display usage information about the held optical files. For more information on held optical files, refer to the Optical Support, SC41-4310 book.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>To use this command you must have *USE authority to the authorization list securing the volume associated with the held optical files.
|
|
</li>
|
|
<li>To save the held file, you must have *CHANGE authority to the authorization list of the volume to which the file is saved.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKHLDOPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="WRKHLDOPTF.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="#WRKHLDOPTF.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, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKHLDOPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="WRKHLDOPTF.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the volume identifier where the optical files were to be stored, had they not been held. This is the volume identifier that was specified when the files were opened.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All held optical files on the system for all optical volumes are listed.
|
|
</dd>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the volume identifier of the volume that was specified when the files were opened.
|
|
</dd>
|
|
<dt><b><i>generic*-volume-identifier</i></b></dt>
|
|
<dd>Specify the generic name of the volume identifier to be listed. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKHLDOPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKHLDOPTF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
WRKHLDOPTF
|
|
</pre>
|
|
</p>
|
|
<p>This command displays a list of all held optical files for all optical volumes and provides options to save, release, and display usage information about the held optical files.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKHLDOPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKHLDOPTF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>OPT1234</b></dt>
|
|
<dd>Held file can not be saved.
|
|
</dd>
|
|
<dt><b>OPT1239</b></dt>
|
|
<dd>Error saving held optical files.
|
|
</dd>
|
|
<dt><b>OPT1342</b></dt>
|
|
<dd>Invalid volume identifier specified.
|
|
</dd>
|
|
<dt><b>OPT2301</b></dt>
|
|
<dd>Internal system object in use.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKHLDOPTF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|