196 lines
6.9 KiB
HTML
196 lines
6.9 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>Rename Object (REN)</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="REN.Top_Of_Page"></a>
|
|
<h2>Rename Object (REN)</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="#REN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#REN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#REN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="REN"></a>
|
|
<p>The Rename Object (REN) command changes the name of an object in a directory.
|
|
</p>
|
|
<p>This command is an alias for the Rename Object (RNM) command and can also be issued using the following alternative command names:
|
|
</p>
|
|
<ul>
|
|
<li>RNM
|
|
</li>
|
|
</ul>
|
|
<p>For more information about integrated file system commands, see the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This command works on only one object. If a pattern is specified on the <b>Object (OBJ)</b> parameter and more than one object matches the pattern, the user can select the object from a list in an interactive job. If this is a batch job, the command fails with error message CPFA08E, "More than one name matches pattern.".
|
|
</li>
|
|
<li>When renaming an object in the "root" (/), QOpenSys or user-defined file systems, the user must have object management (*OBJMGT) authority to the object to be renamed, and write, execute (*WX) authority to the directory that contains the object. If the object to be renamed is a directory, the user must also have write (*W) authority to the directory.
|
|
</li>
|
|
<li>The user must have execute (*X) authority to each directory in the path.
|
|
</li>
|
|
<li>A user cannot rename an object within a "root" (/), QOpenSys, or user-defined file system directory that has the "restricted rename and unlink" attribute set on (this attribute is equivalent to the S_ISVTX mode bit) unless one or more of the following are true:
|
|
<ol>
|
|
<li>The user is the owner of the object.
|
|
</li>
|
|
<li>The user is the owner of the directory.
|
|
</li>
|
|
<li>The user has all object (*ALLOBJ) special authority.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
<li>The authority requirements and restrictions from the existing Rename Object (RNMOBJ) command and Rename Document Library Object (RNMDLO) command apply to objects in the QSYS.LIB, independent ASP QSYS.LIB, and QDLS file systems.
|
|
</li>
|
|
<li>In the QSYS.LIB and independent ASP QSYS.LIB file systems, the new name must contain the same object type suffix.
|
|
</li>
|
|
<li>Some objects cannot be renamed. An error is returned if an attempt is made to rename these objects.
|
|
</li>
|
|
<li>The file cannot be renamed if the file is a DataLink column in an SQL table and where a row in that SQL table references this file.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#REN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="REN.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="#REN.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Object</td>
|
|
<td valign="top"><i>Path name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#REN.NEWOBJ"><b>NEWOBJ</b></a></td>
|
|
<td valign="top">New object</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#REN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="REN.OBJ"></a>
|
|
<h3>Object (OBJ)</h3>
|
|
<p>Specifies the path name of the object to be renamed.
|
|
</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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#REN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="REN.NEWOBJ"></a>
|
|
<h3>New object (NEWOBJ)</h3>
|
|
<p>Specifies the new name of the object to be renamed. This name cannot contain any directory qualifiers and is in the same directory containing the existing object.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#REN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="REN.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>The alternative command name for REN is RNM. The following examples use the alternative command name, but REN can be replaced directly for RNM in all of them.
|
|
</p>
|
|
<p><b>Example 1: Renaming an Object Link</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RNM OBJ('DECEMBER-1994-MONTHLY-PAYROLL-FILE')
|
|
NEWOBJ('JANUARY-1995-MONTHLY-PAYROLL-FILE')
|
|
</pre>
|
|
</p>
|
|
<p>This command renames a file named DECEMBER-1994-MONTHLY-PAYROLL-FILE to a file named JANUARY-1995-MONTHLY-PAYROLL-FILE.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#REN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="REN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFA085</b></dt>
|
|
<dd>Home directory not found for user &1.
|
|
</dd>
|
|
<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>CPFA09D</b></dt>
|
|
<dd>Error occurred in program &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>CPFA0B1</b></dt>
|
|
<dd>Requested operation not allowed. Access problem.
|
|
</dd>
|
|
<dt><b>CPFA0B2</b></dt>
|
|
<dd>No objects satisfy request.
|
|
</dd>
|
|
<dt><b>CPFA0B4</b></dt>
|
|
<dd>NEWOBJ parameter cannot start with a slash.
|
|
</dd>
|
|
<dt><b>CPFA0B5</b></dt>
|
|
<dd>The NEWOBJ parameter cannot contain path.
|
|
</dd>
|
|
<dt><b>CPFA0C4</b></dt>
|
|
<dd>Object not a file. Object is &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#REN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|