308 lines
12 KiB
HTML
308 lines
12 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>Change Object Owner (CHGOBJOWN)</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="CHGOBJOWN.Top_Of_Page"></a>
|
|
<h2>Change Object Owner (CHGOBJOWN)</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="#CHGOBJOWN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGOBJOWN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGOBJOWN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGOBJOWN"></a>
|
|
<p>The Change Object Owner (CHGOBJOWN) command transfers object ownership from one user to another. The authorities that other users have to the object are not changed.
|
|
</p>
|
|
<p>The owner of an object always has all the authorities applicable to the object unless they are explicitly revoked. The owner of an object has the authority to grant any authorities to any user for that object. Owners can also grant to themselves authorities that were previously revoked. Owners may, for example, remove some of their specific authorities as a precautionary measure, and then, when the need arises, grant those same authorities to themselves again.
|
|
</p>
|
|
<p>A user with *ALLOBJ special authority has complete authority for all objects and can transfer the ownership of any object. All users have add and delete authorities for their own user profiles; that is, users can add objects to or delete objects (that they created) from their own user profiles by transferring the ownership of the object.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>To transfer ownership, any user (including the object's present owner) must have:
|
|
<ul>
|
|
<li>Object existence (*OBJEXIST) authority for the object (except authorization list)
|
|
</li>
|
|
<li>Object operational (*OBJOPR) and *OBJEXIST authorities if the object is a file, library, or subsystem description
|
|
</li>
|
|
<li>All object (*ALLOBJ) special authority or ownership if the object is an authorization list
|
|
</li>
|
|
<li>Add (*ADD) authority for the new owner's user profile
|
|
</li>
|
|
<li>Delete (*DLT) authority for the present owner's user profile
|
|
</li>
|
|
<li>All object (*ALLOBJ) and security administrator (*SECADM) special authorities to change the object owner of a program or an SQL (Structured Query Language) package that adopts its owner's authority.
|
|
</li>
|
|
<li>Use (*USE) authority to the auxiliary storage pool device if one is specified.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>For display stations, if this command is not run from the device whose ownership is to be changed or whose message queue's ownership is to be changed, this command should be preceded by the Allocate Object (ALCOBJ) command and followed by the Deallocate Object (DLCOBJ) command.
|
|
</li>
|
|
<li>Object type *DOC or *FLR cannot be specified; the user must use DLO (document interchange) support.
|
|
</li>
|
|
<li>Changing the ownership of an object that has an authority holder associated with it also changes the ownership of the authority holder.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGOBJOWN.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" rowspan="3"><a href="#CHGOBJOWN.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Object</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Object</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGOBJOWN.OBJTYPE"><b>OBJTYPE</b></a></td>
|
|
<td valign="top">Object type</td>
|
|
<td valign="top">*ALRTBL, *AUTL, *BNDDIR, *CFGL, *CHTFMT, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DEVD, *DTAARA, *DTADCT, *DTAQ, *EDTD, *FCT, *FILE, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *M36, *M36CFG, *MEDDFN, *MENU, *MGTCOL, *MODD, *MODULE, *MSGF, *MSGQ, *NODGRP, *NODL, *NTBD, *NWID, *NWSCFG, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *S36, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *SVRSTG, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGOBJOWN.ASPDEV"><b>ASPDEV</b></a></td>
|
|
<td valign="top">ASP device</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*</u></b>, *SYSBAS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGOBJOWN.NEWOWN"><b>NEWOWN</b></a></td>
|
|
<td valign="top">New owner</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGOBJOWN.CUROWNAUT"><b>CUROWNAUT</b></a></td>
|
|
<td valign="top">Current owner authority</td>
|
|
<td valign="top"><b><u>*REVOKE</u></b>, *SAME</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGOBJOWN.OBJ"></a>
|
|
<h3>Object (OBJ)</h3>
|
|
<p>Specifies the object that is to be assigned to a new owner.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A library name can be specified to ensure that the correct object changes ownership.
|
|
</p>
|
|
<p><b>Qualifier 1: Object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the object whose ownership is to be changed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGOBJOWN.OBJTYPE"></a>
|
|
<h3>Object type (OBJTYPE)</h3>
|
|
<p>Specifies the object type of the object whose ownership is to be changed.
|
|
</p>
|
|
<p>For more information, refer to the OBJTYPE parameter description in "Commonly used parameters: Expanded descriptions" in 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>object-type</i></b></dt>
|
|
<dd>Specify the object type of the object for which ownership is to be changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGOBJOWN.ASPDEV"></a>
|
|
<h3>ASP device (ASPDEV)</h3>
|
|
<p>Specifies the auxiliary storage pool (ASP) device name where the library that contains the object (OBJ parameter) is located. If the object's library resides in an ASP that is not part of the library name space associated with the job, this parameter must be specified to ensure the correct object is used as the target of this command's operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*</b></dt>
|
|
<dd>The ASPs that are currently part of the job's library name space will be searched to locate the object. This includes the system ASP (ASP number 1), all defined basic user ASPs (ASP numbers 2-32), and, if the job has an ASP group, all independent ASPs in the ASP group.
|
|
</dd>
|
|
<dt><b>*SYSBAS</b></dt>
|
|
<dd>The system ASP and all basic user ASPs will be searched to locate the object. No independent ASPs will be searched, even if the job has an ASP group.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the device name of the independent ASP to be searched to locate the object. The independent ASP must have been activated (by varying on the ASP device) and have a status of AVAILABLE. The system ASP and basic user ASPs will not be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGOBJOWN.NEWOWN"></a>
|
|
<h3>New owner (NEWOWN)</h3>
|
|
<p>Specifies the user profile of the new owner for the object. The user profile must exist when this command is run.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the user profile.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGOBJOWN.CUROWNAUT"></a>
|
|
<h3>Current owner authority (CUROWNAUT)</h3>
|
|
<p>Specifies whether the authorities for the current owner are revoked when ownership is changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REVOKE</u></b></dt>
|
|
<dd>The authority of the current owner is revoked when the object ownership is changed to the new owner.
|
|
</dd>
|
|
<dt><b>*SAME</b></dt>
|
|
<dd>The current owner's authority is retained as a private authority to the object.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGOBJOWN.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGOBJOWN OBJ(USERLIB/PROGRAM1) OBJTYPE(*PGM) NEWOWN(ANN)
|
|
</pre>
|
|
</p>
|
|
<p>This command assigns ownership of the program named PROGRAM1, located in the user library named USERLIB, to the user named ANN. The authority is revoked from the current owner.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGOBJOWN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0609</b></dt>
|
|
<dd>Not allowed to use specified user profile.
|
|
</dd>
|
|
<dt><b>CPF22BD</b></dt>
|
|
<dd>Ownership may not have been changed for object &1 in &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF22BE</b></dt>
|
|
<dd>Function not done for user profile &1.
|
|
</dd>
|
|
<dt><b>CPF22DA</b></dt>
|
|
<dd>Operation on file &1 in &2 not allowed.
|
|
</dd>
|
|
<dt><b>CPF220A</b></dt>
|
|
<dd>New owner &1 does not have a uid.
|
|
</dd>
|
|
<dt><b>CPF220C</b></dt>
|
|
<dd>Owner and primary group cannot be the same.
|
|
</dd>
|
|
<dt><b>CPF2204</b></dt>
|
|
<dd>User profile &1 not found.
|
|
</dd>
|
|
<dt><b>CPF2207</b></dt>
|
|
<dd>Not authorized to use object &1 in library &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF2208</b></dt>
|
|
<dd>Object &1 in library &3 type *&2 not found.
|
|
</dd>
|
|
<dt><b>CPF2209</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF2210</b></dt>
|
|
<dd>Operation not allowed for object type *&1.
|
|
</dd>
|
|
<dt><b>CPF2211</b></dt>
|
|
<dd>Not able to allocate object &1 in &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF2213</b></dt>
|
|
<dd>Not able to allocate user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2216</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF2217</b></dt>
|
|
<dd>Not authorized to user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2222</b></dt>
|
|
<dd>Storage limit is greater than specified for user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2226</b></dt>
|
|
<dd>Function not done for user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2230</b></dt>
|
|
<dd>Not authorized to object &1 in library &3.
|
|
</dd>
|
|
<dt><b>CPF2231</b></dt>
|
|
<dd>Not authorized to change ownership for program &1.
|
|
</dd>
|
|
<dt><b>CPF2232</b></dt>
|
|
<dd>Not authorized to user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2233</b></dt>
|
|
<dd>No delete authority to user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2298</b></dt>
|
|
<dd>Authority not revoked for object &2 in &3 from user &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGOBJOWN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|