147 lines
6.4 KiB
HTML
147 lines
6.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>Reclaim Objects by Owner (RCLOBJOWN)</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="RCLOBJOWN.Top_Of_Page"></a>
|
|
<h2>Reclaim Objects by Owner (RCLOBJOWN)</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="#RCLOBJOWN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RCLOBJOWN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RCLOBJOWN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RCLOBJOWN"></a>
|
|
<p>The Reclaim Objects by Owner (RCLOBJOWN) command checks the objects owned by a user profile to make sure those objects which must be in a library are actually in one. If any of the owned objects are not in a library, they are inserted in one. If the object can only be in a specific system library, the object is inserted in that library. If the object can exist in any user library and is reclaimed from the system auxiliary storage pool (ASP 1) or a basic user ASP (ASPs 2-32), the object is inserted in library QRCL. If the object is reclaimed from a primary or secondary ASP, the object is inserted in library QRCLnnnnn where <u> nnnnn</u> is the number assigned by the operating system to the primary ASP.
|
|
</p>
|
|
<p>When a user profile is deleted and the profile owns objects which are not in a library, message CPC2216 is sent after the user profile is deleted stating that the ownership for the objects was changed and that a reclaim operation, either RCLOBJOWN or RCLSTG, is necessary to place the objects in a library. Since RCLSTG can be a long-running command, you can try running RCLOBJOWN which is much faster because it only checks the objects owned by the specified user profile. If RCLOBJOWN is unable to reclaim the objects, you will need to run the RCLSTG command to reclaim the objects.
|
|
</p>
|
|
<p>When a user profile is deleted because it is damaged, the objects owned by the user profile are left with no owner. In this case, you need to run the RCLSTG command to assign those objects to the QDFTOWN user profile. After running RCLSTG, you can use the Change Object Owner (CHGOBJOWN) command to change the ownership of objects assigned to QDFTOWN by the RCLSTG command.
|
|
</p>
|
|
<p>If RCLOBJOWN is run against a user profile which has objects residing in an Independent Auxiliary Storage Pool (IASP), this IASP must be in AVAILABLE status, in order that the objects are reclaimed.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The RCLOBJOWN command performs only a subset of the functions performed by the Reclaim Storage (RCLSTG) command. Refer to the RCLSTG command information for other reclaim commands that can be used to perform specific parts of the RCLSTG function.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>All subsystems must be inactive before the RCLOBJOWN command can be specified. The End System (ENDSYS) or End Subsystem (ENDSBS) command with *ALL specified on the SBS parameter can be used to make the subsystems inactive. You must have job control (*JOBCTL) authority to use the ENDSYS or the ENDSBS command.
|
|
</li>
|
|
<li>This command will not reclaim document (*DOC) objects or the folder (*FLR) objects where documents reside. It also will not reclaim directory (*DIR) objects, or the following types of objects which reside in directories:
|
|
<ul>
|
|
<li>stream file (*STMF)
|
|
</li>
|
|
<li>symbolic link (*SYMLNK)
|
|
</li>
|
|
<li>FIFO queue (*FIFO)
|
|
</li>
|
|
<li>block special file (*BLKSF)
|
|
</li>
|
|
<li>socket (*SOCKET)
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RCLOBJOWN.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="#RCLOBJOWN.USRPRF"><b>USRPRF</b></a></td>
|
|
<td valign="top">User profile</td>
|
|
<td valign="top"><i>Simple name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RCLOBJOWN.USRPRF"></a>
|
|
<h3>User profile (USRPRF)</h3>
|
|
<p>Specifies the user profile for which the reclaim will be performed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>simple-name</i></b></dt>
|
|
<dd>Specify the name of the user profile to be processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RCLOBJOWN.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Reclaim Objects for a User Profile</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RCLOBJOWN USRPRF(MYPROFILE)
|
|
</pre>
|
|
</p>
|
|
<p>This command will check all objects owned by MYPROFILE. If there are objects that are not in a library, they will be placed in a system library. A message is sent for each object inserted into a system library by the reclaim operation.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RCLOBJOWN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF8204</b></dt>
|
|
<dd>Commitment control cannot be active during RCLSTG or RCLOBJOWN.
|
|
</dd>
|
|
<dt><b>CPF8208</b></dt>
|
|
<dd>System not in proper state to reclaim objects by owner.
|
|
</dd>
|
|
<dt><b>CPF8213</b></dt>
|
|
<dd>Object &1 cannot be inserted in &2 library.
|
|
</dd>
|
|
<dt><b>CPF8215</b></dt>
|
|
<dd>User profile &1 damaged.
|
|
</dd>
|
|
<dt><b>CPF8220</b></dt>
|
|
<dd>Library &1 damaged. Reclaim Objects by Owner (RCLOBJOWN) command ended.
|
|
</dd>
|
|
<dt><b>CPF8232</b></dt>
|
|
<dd>Commitment definitions prevent RCLSTG or RCLOBJOWN.
|
|
</dd>
|
|
<dt><b>CPF8282</b></dt>
|
|
<dd>User profile &1 not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RCLOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|