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

208 lines
7.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>Change Activation Scd Entry (CHGACTSCDE)</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="CHGACTSCDE.Top_Of_Page"></a>
<h2>Change Activation Scd Entry (CHGACTSCDE)</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="#CHGACTSCDE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGACTSCDE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGACTSCDE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGACTSCDE"></a>
<p>The Change Activation Schedule Entry (CHGACTSCDE) command allows you to make a user profile available for sign on only for a specific period of time on specific days.
</p>
<p>If you specify a new schedule for a user profile (use the CHGACTSCDE again for that user), the system replaces that profile's existing schedule with the new information.
</p>
<p>When a profile is enabled or disabled, a message will be sent to the message queue of the user who issued the CHGACTSCDE command.
</p>
<p>The enable and disable times are set up to occur on the same day. For example, if you specify an enable time of 07:00, a disable time of 18:00, and *MON for the days, the profile is enabled on Monday at 7:00 and disabled on Monday at 18:00. If you wish to span days such that a profile should be enabled Monday at 23:00 and disabled Tuesday at 07:00, you need to specify *ALL for the days. (The profile will be enabled from 23:00 to 07:00 every day.)
</p>
<p>To remove a user profile from the file so that it will no longer be enabled and disabled specify ENBTIME(*NONE) DSBTIME(*NONE).
</p>
<p>The activation schedule can be displayed with the Display Activation Schedule (DSPACTSCD) command.
</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="#CHGACTSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGACTSCDE.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="#CHGACTSCDE.USRPRF"><b>USRPRF</b></a></td>
<td valign="top">User profile</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGACTSCDE.ENBTIME"><b>ENBTIME</b></a></td>
<td valign="top">Enable time</td>
<td valign="top"><i>Time</i>, *NONE</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGACTSCDE.DSBTIME"><b>DSBTIME</b></a></td>
<td valign="top">Disable time</td>
<td valign="top"><i>Time</i>, *NONE</td>
<td valign="top">Required, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CHGACTSCDE.DAYS"><b>DAYS</b></a></td>
<td valign="top">Days</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 7 repetitions): *MON, *TUE, *WED, *THU, *FRI, *SAT, *SUN</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGACTSCDE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGACTSCDE.USRPRF"></a>
<h3>User profile (USRPRF)</h3>
<p>This is a required parameter.
</p>
<p>The name of the user profile to be activated for a period of time.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGACTSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGACTSCDE.ENBTIME"></a>
<h3>Enable time (ENBTIME)</h3>
<p>This is a required parameter.
</p>
<p>The time on the specified days at which the job to enable the user profile will be submitted.
</p>
<p>A profile will not be enabled at its specified time if it has reached the maximum number of not valid sign-on attempts.
</p>
<p>
<b>Note: </b>Although the time can be specified to the second, the activity involved in submitting a job and the load on the system may affect the exact time at which the job is submitted.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>The profile is not to be enabled.
</dd>
<dt><b><i>enable-time</i></b></dt>
<dd>The time of day that the user profile will be enabled.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGACTSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGACTSCDE.DSBTIME"></a>
<h3>Disable time (DSBTIME)</h3>
<p>This is a required parameter.
</p>
<p>The time on the specified days at which the job to disable the user profile will be submitted.
</p>
<p>
<b>Note: </b>Although the time can be specified to the second, the activity involved in submitting a job and the load on the system may affect the exact time at which the job is submitted.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>The profile is not to be disabled.
</dd>
<dt><b><i>disable-time</i></b></dt>
<dd>The time of day that the user profile will be disabled.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGACTSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGACTSCDE.DAYS"></a>
<h3>Days (DAYS)</h3>
<p>The days of the week on which the job to enable and/or disable the user profile will be submitted.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The job is submitted every day.
</dd>
<dt><b>*MON</b></dt>
<dd>The job is submitted on Monday.
</dd>
<dt><b>*TUE</b></dt>
<dd>The job is submitted on Tuesday.
</dd>
<dt><b>*WED</b></dt>
<dd>The job is submitted on Wednesday.
</dd>
<dt><b>*THU</b></dt>
<dd>The job is submitted on Thursday.
</dd>
<dt><b>*FRI</b></dt>
<dd>The job is submitted on Friday.
</dd>
<dt><b>*SAT</b></dt>
<dd>The job is submitted on Saturday.
</dd>
<dt><b>*SUN</b></dt>
<dd>The job is submitted on Sunday.
</dd>
</dl>
<p>You can enter multiple values for this parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGACTSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGACTSCDE.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGACTSCDE USRPRF(GARRY) ENBTIME('07:00:00')
DSBTIME('18:00:00')
DAYS(*MON,*TUE,*WED,*THU,*FRI)
</pre>
</p>
<p>This command changes the activation schedule for user profile GARRY. The user profile GARRY will be enabled at 7:00 AM on every Monday, Tuesday, Wednesday, Thursday and Friday, and disabled at 6:00 PM on every Monday, Tuesday, Wednesday, Thursday, and Friday. The user profile will remain disabled over the weekend.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGACTSCDE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGACTSCDE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPDB305</b></dt>
<dd>User &amp;1 not found in list.
</dd>
<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="#CHGACTSCDE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>