256 lines
7.8 KiB
HTML
256 lines
7.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 Directories (WRKOPTDIR)</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="WRKOPTDIR.Top_Of_Page"></a>
|
|
<h2>Work with Optical Directories (WRKOPTDIR)</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="#WRKOPTDIR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#WRKOPTDIR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#WRKOPTDIR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="WRKOPTDIR"></a>
|
|
<p>The Work with Optical Directories (WRKOPTDIR) command displays a list of optical directories and provides options to create, to copy, to delete, and to display or print a list of directories and their attributes. This command also allows you to work with files in the directories.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>To use this command you must have at least *USE authority to the authorization list securing the volumes containing the optical directories.
|
|
</li>
|
|
<li>You must have *CHANGE authority to create, copy, or delete optical directories.
|
|
</li>
|
|
<li>If this command is issued for a directory on an optical volume which is in a remote optical server, only the following can be specified:
|
|
<ul>
|
|
<li>DIR(optical-directory-name)
|
|
</li>
|
|
<li>VOL(volume-identifier)
|
|
</li>
|
|
<li>SORT(*DIR)
|
|
</li>
|
|
<li>SLTLVL(1).
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="WRKOPTDIR.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="#WRKOPTDIR.DIR"><b>DIR</b></a></td>
|
|
<td valign="top">Optical directory</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKOPTDIR.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 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKOPTDIR.SORT"><b>SORT</b></a></td>
|
|
<td valign="top">Sort by</td>
|
|
<td valign="top"><b><u>*DATE</u></b>, *DIR</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKOPTDIR.SLTLVL"><b>SLTLVL</b></a></td>
|
|
<td valign="top">Select directory level</td>
|
|
<td valign="top"><i>Integer</i>, <b><u>1</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKOPTDIR.STRDATE"><b>STRDATE</b></a></td>
|
|
<td valign="top">Starting date</td>
|
|
<td valign="top"><i>Date</i>, <b><u>*AVAIL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="WRKOPTDIR.DIR"></a>
|
|
<h3>Optical directory (DIR)</h3>
|
|
<p>Specifies the optical directories to be listed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All directories in the specified optical volume are listed.
|
|
</dd>
|
|
<dt><b><i>optical-directory-name</i></b></dt>
|
|
<dd>Specify the name of a directory.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKOPTDIR.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the identifier of the volume that contains the directories specified on the DIR parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Optical volumes in direct-attached optical devices are listed.
|
|
</dd>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the volume identifier of the volume to search.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKOPTDIR.SORT"></a>
|
|
<h3>Sort by (SORT)</h3>
|
|
<p>Specifies how the output for each volume is sorted.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the optical volume was initialized as a backup volume, this parameter is ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DATE</u></b></dt>
|
|
<dd>The output list is sorted in order by the date that the volume was created, beginning with the most recent date.
|
|
</dd>
|
|
<dt><b>*DIR</b></dt>
|
|
<dd>The output list is sorted in alphabetical order by directory name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKOPTDIR.SLTLVL"></a>
|
|
<h3>Select directory level (SLTLVL)</h3>
|
|
<p>Specifies the number of levels of the directory structure to include in the list when SORT(*DIR) is specified.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the optical volume was initialized as a backup volume, this parameter is ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>1</u></b></dt>
|
|
<dd>Only first level directories are listed.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All directories are listed.
|
|
</dd>
|
|
<dt><b><i>select-directory-level</i></b></dt>
|
|
<dd>Specify the number of subdirectory levels for the specified directory. Valid values range from 1 through 32767.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKOPTDIR.STRDATE"></a>
|
|
<h3>Starting date (STRDATE)</h3>
|
|
<p>Specifies the starting date for the list when SORT(*DATE) is specified. Only directories created on or before the starting date are listed.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the optical volume was initialized as a backup volume, this parameter is ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
|
<dd>The directories created on all available dates are included in the output list.
|
|
</dd>
|
|
<dt><b><i>starting-date</i></b></dt>
|
|
<dd>Specify the starting date.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKOPTDIR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
WRKOPTDIR VOL(VOL01)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the Work with Optical Directories panel, showing a list of all optical directories on the volume VOL01 sorted by the date they were created.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKOPTDIR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>OPT1205</b></dt>
|
|
<dd>Directory not found.
|
|
</dd>
|
|
<dt><b>OPT1215</b></dt>
|
|
<dd>Directory cannot be deleted.
|
|
</dd>
|
|
<dt><b>OPT1317</b></dt>
|
|
<dd>Directory name is too long.
|
|
</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>OPT1331</b></dt>
|
|
<dd>Optical volume &1 not found.
|
|
</dd>
|
|
<dt><b>OPT1340</b></dt>
|
|
<dd>Optical volume &1 not initialized.
|
|
</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>OPT2301</b></dt>
|
|
<dd>Internal system object in use.
|
|
</dd>
|
|
</dl>
|
|
<p><b><u>*STATUS Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>OPT1937</b></dt>
|
|
<dd>Unable to display all requested files.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKOPTDIR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|