ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgexpscde.htm

272 lines
9.6 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!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 Expiration Scd Entry (CHGEXPSCDE)</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="CHGEXPSCDE.Top_Of_Page"></a>
<h2>Change Expiration Scd Entry (CHGEXPSCDE)</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="#CHGEXPSCDE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGEXPSCDE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGEXPSCDE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGEXPSCDE"></a>
<p>The Change Expiration Schedule Entry (CHGEXPSCDE) command allows you to expire a user profile on a certain date. The expired user profile can either be disabled or deleted.
</p>
<p>When a profile is disabled or deleted, a message will be sent to the message queue of the user who issued the CHGEXPSCDE command.
</p>
<p>To remove a user profile from the file so that it will no longer expire specify EXPDATE(*NONE).
</p>
<p>This information can be displayed using the Display Expiration Schedule (DSPEXPSCD) command.
</p>
<p>Once a profile has been scheduled to be disabled or deleted the CHGEXPSCDE job runs nightly. If you want to change the time the job runs, you can use the Change Job Schedule Entry (CHGJOBSCDE) command to change the QSECEXP1 job.
</p>
<p><b>Restriction:</b> You must have *ALLOBJ, *SECADM, and *JOBCTL special authorities to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGEXPSCDE.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="#CHGEXPSCDE.USRPRF"><b>USRPRF</b></a></td>
<td valign="top">User profile</td>
<td valign="top">Values (up to 10 repetitions): <i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEXPSCDE.EXPDATE"><b>EXPDATE</b></a></td>
<td valign="top">Expiration date</td>
<td valign="top"><i>Date</i>, *NONE</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGEXPSCDE.ACTION"><b>ACTION</b></a></td>
<td valign="top">Action</td>
<td valign="top"><b><u>*DISABLE</u></b>, *DELETE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGEXPSCDE.OWNOBJOPT"><b>OWNOBJOPT</b></a></td>
<td valign="top">Owned object option</td>
<td valign="top">Single values: <b><u>*NODLT</u></b>, *DLT<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Owned object value</td>
<td valign="top">
*CHGOWN</td>
</tr>
<tr>
<td valign="top">Element 2: User profile name if *CHGOWN</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGEXPSCDE.PGPOPT"><b>PGPOPT</b></a></td>
<td valign="top">Primary group option</td>
<td valign="top">Single values: <b><u>*NOCHG</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Primary group value</td>
<td valign="top">
*CHGPGP</td>
</tr>
<tr>
<td valign="top">Element 2: New primary group</td>
<td valign="top">
<i>Name</i>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 3: New primary group authority</td>
<td valign="top">
<b><u>*OLDPGP</u></b>, *PRIVATE, *ALL, *CHANGE, *USE, *EXCLUDE</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGEXPSCDE.USRPRF"></a>
<h3>User profile (USRPRF)</h3>
<p>This is a required parameter.
</p>
<p>The name of the user profile that is to expire.
</p>
<p>You can enter multiple values for this parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEXPSCDE.EXPDATE"></a>
<h3>Expiration date (EXPDATE)</h3>
<p>This is a required parameter.
</p>
<p>The date on which the user profile(s) should expire.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>The profile should be removed from the list of user profiles that are to expire.
</dd>
<dt><b><i>expiration-date</i></b></dt>
<dd>The date the profile will expire.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEXPSCDE.ACTION"></a>
<h3>Action (ACTION)</h3>
<p>The action to be taken against the expired user profile.
</p>
<dl>
<dt><b><u>*DISABLE</u></b></dt>
<dd>The profile is to be disabled.
</dd>
<dt><b>*DELETE</b></dt>
<dd>The profile is to be deleted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEXPSCDE.OWNOBJOPT"></a>
<h3>Owned object option (OWNOBJOPT)</h3>
<p>The type of operations to be performed on the owned objects of the user profile being deleted.
</p>
<p><b>Element 1: Owned objects option</b>
</p>
<dl>
<dt><b><u>*NODLT</u></b></dt>
<dd>The owned objects for the user profile are not changed, and the user profile is not deleted if the user owns any objects.
</dd>
<dt><b>*DLT</b></dt>
<dd>The owned objects for the user profile are deleted. The user profile is deleted if the deletion of all owned objects and the transfer of all primary group objects is successful.
</dd>
<dt><b>*CHGOWN</b></dt>
<dd>The owned objects for the user profile have ownership transferred to the specified user profile. The user profile is deleted if the transfer of all owned objects is successful.
<p>When *CHGOWN is specified, a user profile name must be specified for the new user profile. The new user profile owns all objects owned by the user profile specified by the USRPRF parameter.
</p>
</dd>
</dl>
<p><b>Element 2: User profile of new owner</b>
</p>
<dl>
<dt><b><i>user-profile-name</i></b></dt>
<dd>The user profile name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGEXPSCDE.PGPOPT"></a>
<h3>Primary group option (PGPOPT)</h3>
<p>The type of operations to be done on the objects that have the user profile being deleted as their primary group.
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The objects the user profile is the primary group for do not change, and the user profile i s not deleted if the user is the primary group for any objects.
</dd>
</dl>
<p><b>Element 1: Change primary group of objects</b>
</p>
<dl>
<dt><b>*CHGPGP</b></dt>
<dd>The objects the user profile is the primary group for are transferred to the specified user profile. The user profile is deleted if the transfer of all objects is successful.
<p>When *CHGPGP is specified, a user profile name or *NONE must be specified. If a user profile name is specified, that user becomes the primary group for all objects for which the user profile specified by the USRPRF parameter is the primary group. If *NONE is specified, all of the objects for which the user profile (specified by the USRPRF parameter) is the primary group, will no longer have a primary group.
</p>
</dd>
</dl>
<p><b>Element 2: User profile of new primary group</b>
</p>
<dl>
<dt><b><i>user-profile-name</i></b></dt>
<dd>The name of the user profile. The user profile specified must have a group ID number (GID).
</dd>
<dt><b>*NONE</b></dt>
<dd>The objects do not have a primary group.
</dd>
</dl>
<p><b>Element 3: New primary group authority</b>
</p>
<dl>
<dt><b><u>*OLDPGP</u></b></dt>
<dd>The new primary group has the same authority to the object as the old primary group.
</dd>
<dt><b>*PRIVATE</b></dt>
<dd>If the new primary group has a private authority to the object, it will become the primary group for that object and the primary group authority will be what the private authority was. If the new primary group does not have a private authority to the object, it becomes the primary group but does not have any authority to the object.
</dd>
<dt><b>*ALL</b></dt>
<dd>The new primary group has *ALL authority to the object.
</dd>
<dt><b>*CHANGE</b></dt>
<dd>The new primary group has *CHANGE authority to the object.
</dd>
<dt><b>*USE</b></dt>
<dd>The new primary group has *USE authority to the object.
</dd>
<dt><b>*EXCLUDE</b></dt>
<dd>The new primary group has *EXCLUDE authority to the object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGEXPSCDE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGEXPSCDE USRPRF(GARRY) EXPDATE('07/01/1996') ACTION(*DELETE)
</pre>
</p>
<p>This command changes the expiration schedule entry for user profile GARRY. The user profile GARRY will be deleted on July 1, 1996.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGEXPSCDE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFB304</b></dt>
<dd>User does not have required special authorities.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGEXPSCDE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>