240 lines
9.5 KiB
HTML
240 lines
9.5 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>Retrieve Directory Information (RTVDIRINF)</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="RTVDIRINF.Top_Of_Page"></a>
|
|
<h2>Retrieve Directory Information (RTVDIRINF)</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="#RTVDIRINF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RTVDIRINF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RTVDIRINF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RTVDIRINF"></a>
|
|
<p>The Retrieve Directory Information (RTVDIRINF) command is used to collect attributes for directories and files in the Integrated File System. The collected information is stored in database files that are named using the information file prefix specified by the INFFILEPFX parameter. The files are created in the library specified by the INFLIB parameter.
|
|
</p>
|
|
<p>You can run the Print Directory Information (PRTDIRINF) command to print reports using the retrieved directory information.
|
|
</p>
|
|
<p>To get the most accurate results, this command should be run at a time when there is very little activity for files in the specified directory. If SUBTREE(*ALL) is specified, try to run this command when there is very little activity for files in all subdirectories of the specified directory.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If there is more than one member in the files, the results of running this command can be unpredictable.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>Directory information can be retrieved only for mounted file systems.
|
|
</li>
|
|
<li>Directory information can be retrieved only for local file systems.
|
|
</li>
|
|
<li>You must have all object (*ALLOBJ) special authority to run this command.
|
|
</li>
|
|
<li>Job CCSID value 65535 is not allowed.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVDIRINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RTVDIRINF.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="#RTVDIRINF.DIR"><b>DIR</b></a></td>
|
|
<td valign="top">Directory</td>
|
|
<td valign="top"><i>Path name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RTVDIRINF.SUBTREE"><b>SUBTREE</b></a></td>
|
|
<td valign="top">Directory subtree</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RTVDIRINF.INFFILEPFX"><b>INFFILEPFX</b></a></td>
|
|
<td valign="top">Information file prefix</td>
|
|
<td valign="top"><i>Simple name</i>, <b><u>*GEN</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RTVDIRINF.INFLIB"><b>INFLIB</b></a></td>
|
|
<td valign="top">Information library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QUSRSYS</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVDIRINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RTVDIRINF.DIR"></a>
|
|
<h3>Directory (DIR)</h3>
|
|
<p>Specifies the path name of the directory for which directory information will be collected.
|
|
</p>
|
|
<p>For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>directory-path-name</i></b></dt>
|
|
<dd>Specify the path name of a directory.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVDIRINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVDIRINF.SUBTREE"></a>
|
|
<h3>Directory subtree (SUBTREE)</h3>
|
|
<p>Specifies whether or not to collect directory information for subdirectories of the directory specified by the DIR parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Directory information for subdirectories of the specified directory will be collected.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Directory information will only be collected for the files in the specified directory. No directory information will be collected for subdirectories.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVDIRINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVDIRINF.INFFILEPFX"></a>
|
|
<h3>Information file prefix (INFFILEPFX)</h3>
|
|
<p>Specifies the file name prefix of the database files where the retrieved directory information is to be stored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*GEN</u></b></dt>
|
|
<dd>The database files will be created with a unique prefix generated by this command. The prefix will begin with QAEZD followed by four digits. The files created to store the collected information will be named using this prefix followed by either the letter 'D' (for the file which contains directory information) or the letter 'O' (for the file that contains information about objects in directories). For example, the first time the command is run with *GEN specified, files QAEZD0001D and QAEZD0001O will be created in the library specified by the INFLIB parameter. Informational message CPI1E30 will be sent to the job log and will contain the names of the files created.
|
|
</dd>
|
|
<dt><b><i>information-file-prefix</i></b></dt>
|
|
<dd>Specify the file prefix to use for creating the database files used to store the collected directory information. The prefix can be up to nine letters. The files created to store the collected information will be named using this prefix followed by either the letter 'D' (for the file which contains directory information) or the letter 'O' (for the file that contains information about objects in directories). For example, if the prefix specified is MYDIR, database files MYDIRD and MYDIRO will be created in the library specified by the INFLIB parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVDIRINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVDIRINF.INFLIB"></a>
|
|
<h3>Information library (INFLIB)</h3>
|
|
<p>Specifies the library where the database files used to store the directory information will be created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QUSRSYS</u></b></dt>
|
|
<dd>The files will be created in library QUSRSYS.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library to create the database files.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVDIRINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RTVDIRINF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Retrieve Information, Including Subdirectories</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RTVDIRINF DIR('/MYDIR/MYDOCS') SUBTREE(*ALL)
|
|
INFFILEPFX(*GEN) INFLIB(QUSRSYS)
|
|
</pre>
|
|
</p>
|
|
<p>This command retrieves directory information about directory /MYLIB/MYDOCS, including information for all nested subdirectories, and stores it the database files created in library QUSRSYS. The database files will be created with unique names that begin with 'QAEZD' followed by four digits. If this is the first time the RTVDIRINF command is run, the file names will be QAEZD0001O and QAEZD0001D.
|
|
</p>
|
|
<p><b>Example 2: Retrieve Information for Specified Directory Only</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RTVDIRINF DIR('/') SUBTREE(*NO) INFFILEPFX(MYROOTDIR)
|
|
INFLIB(MYLIB)
|
|
</pre>
|
|
</p>
|
|
<p>This command retrieves directory information about the root directory without inspecting nested subdirectories and stores it in the database files MYROOTDIRO and MYROOTDIRD in library MYLIB. If database files with either of those names already exist in library MYLIB, an error message will be sent and no directory information will be retrieved.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVDIRINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RTVDIRINF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFA08E</b></dt>
|
|
<dd>More than one name matches pattern.
|
|
</dd>
|
|
<dt><b>CPFA093</b></dt>
|
|
<dd>Name matching pattern not found.
|
|
</dd>
|
|
<dt><b>CPFA09C</b></dt>
|
|
<dd>Not authorized to object. Object is &1.
|
|
</dd>
|
|
<dt><b>CPFA0A1</b></dt>
|
|
<dd>An input or output error occurred.
|
|
</dd>
|
|
<dt><b>CPFA0A3</b></dt>
|
|
<dd>Path name resolution causes looping.
|
|
</dd>
|
|
<dt><b>CPFA0A6</b></dt>
|
|
<dd>Number of links exceeds maximum allowed for the file system.
|
|
</dd>
|
|
<dt><b>CPFA0A7</b></dt>
|
|
<dd>Path name too long.
|
|
</dd>
|
|
<dt><b>CPFA0A9</b></dt>
|
|
<dd>Object not found. Object is &1.
|
|
</dd>
|
|
<dt><b>CPFA0AA</b></dt>
|
|
<dd>Error occurred while attempting to obtain space.
|
|
</dd>
|
|
<dt><b>CPFA0AB</b></dt>
|
|
<dd>Operation failed for object. Object is &1.
|
|
</dd>
|
|
<dt><b>CPFA0AD</b></dt>
|
|
<dd>Function not supported by file system.
|
|
</dd>
|
|
<dt><b>CPFA0B2</b></dt>
|
|
<dd>No objects satisfy request.
|
|
</dd>
|
|
<dt><b>CPF1ED2</b></dt>
|
|
<dd>File &1 is in use and cannot be accessed.
|
|
</dd>
|
|
<dt><b>CPF1ED4</b></dt>
|
|
<dd>Not authorized to collect directory information.
|
|
</dd>
|
|
<dt><b>CPF1E99</b></dt>
|
|
<dd>Unexpected error occurred.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVDIRINF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|