184 lines
7.6 KiB
HTML
184 lines
7.6 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>Remove Link (ERASE)</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="ERASE.Top_Of_Page"></a>
|
|
<h2>Remove Link (ERASE)</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="#ERASE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ERASE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ERASE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ERASE"></a>
|
|
<p>The Remove link (ERASE) command removes the link to the specified object. If this is the only hard link to the object, the object is removed when no longer in use. The object can be removed even if a symbolic link to it exists. The symbolic link remains until it is removed.
|
|
</p>
|
|
<p>This command is an alias for the Remove link (RMVLNK) command and can also be issued using the following alternative command names:
|
|
</p>
|
|
<ul>
|
|
<li>DEL
|
|
</li>
|
|
<li>RMVLNK
|
|
</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>In the "root" (/), QOpenSys, and user-defined file systems, the user must have write, execute (*WX) authority to the directory containing the object. If a hard link is to be unlinked, the user must also have object existence (*OBJEXIST) authority to the object.
|
|
</li>
|
|
<li>In the QDLS file system, the user must have all (*ALL) authority to the object and execute (*X) authority to the parent directory.
|
|
</li>
|
|
<li>The user must have *X authority to each directory in the path.
|
|
</li>
|
|
<li>See the iSeries Security Reference, SC41-5302 book for the authority requirements for other file systems.
|
|
</li>
|
|
<li>A user cannot unlink 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>A directory cannot be unlinked.
|
|
</li>
|
|
<li>The link to a file cannot be removed if the file is a DataLink column in an SQL table and where a row in that SQL table references this file.
|
|
</li>
|
|
<li>The restrictions listed above are for the i5/OS objects of the types *DDIR, *DSTMF, *SOCKET, *STMF, and *SYMLNK.
|
|
</li>
|
|
</ol>
|
|
<p><b>QSYS.LIB and independent ASP QSYS.LIB File System Differences</b>
|
|
</p>
|
|
<ol>
|
|
<li>If this command is to be used to remove links for an object that is in these file systems, additional restrictions may apply. To identify these restrictions, see the delete command for the object to be removed. In general, the name of this command is formed using the i5/OS object type value, from the character * is removed, and add the verb DLT to the beginning. For example, to delete an alert table, which has the object type value of *ALRTBL, see the Delete Alert Table (DLTALRTBL) command for any additional restrictions.
|
|
<p>However, there are exceptions to this rule. For example, to delete a compiler unit, which has the object type value of *MODULE, see the Delete Module (DLTMOD) command for any additional restrictions.
|
|
</p>
|
|
<p>For a description of the object types, see the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
</li>
|
|
<li>In these file systems, libraries and database files cannot be deleted using the Remove Link (RMVLNK or alias DEL or ERASE) command. However, these objects can be deleted using the Remove Directory (RMVDIR or alias RMDIR or RD) command.
|
|
</li>
|
|
<li>The following object types cannot be deleted using another command: *EXITRG, *IGCSRT, *JOBSCD, *PRDAVL, *QRYDFN, *RCT.
|
|
</li>
|
|
</ol>
|
|
<p><b>QDLS File System Differences</b>
|
|
</p>
|
|
<ol>
|
|
<li>If this command is to be used to remove links for an object that is in this file system, additional restrictions may apply. To identify these restrictions, see the description of the Delete Document Library Object (DLTDLO) command.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ERASE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ERASE.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="#ERASE.OBJLNK"><b>OBJLNK</b></a></td>
|
|
<td valign="top">Object link</td>
|
|
<td valign="top"><i>Path name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ERASE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ERASE.OBJLNK"></a>
|
|
<h3>Object link (OBJLNK)</h3>
|
|
<p>Specifies the path name of the object to unlink. Multiple links can be removed with a name pattern.
|
|
</p>
|
|
<p>The object path name can be either a simple name or a name that is qualified with the name of the directory in which the object is located. A pattern can be specified in the last part of the path name. An asterisk (*) matches any number of characters and a question mark (?) matches a single character. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes.
|
|
</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="#ERASE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ERASE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>The alternative command name for ERASE is RMVLNK. The following examples use the alternative command name, but ERASE can be replaced directly for RMVLNK in all of them.
|
|
</p>
|
|
<p><b>Example 1: Removing an Object Link</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RMVLNK OBJLNK('PAY')
|
|
</pre>
|
|
</p>
|
|
<p>This command removes a link named PAY.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ERASE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ERASE.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>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>CPFA0A7</b></dt>
|
|
<dd>Path name too long.
|
|
</dd>
|
|
<dt><b>CPFA0A9</b></dt>
|
|
<dd>Object not found. Object is &1.
|
|
</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>CPFA0BD</b></dt>
|
|
<dd>&1 links removed. &2 links failed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ERASE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|