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

276 lines
10 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 Job Authority using JS (CHGAUTJS)</title>
</head>
<body bgcolor="white">
<a name="CHGAUTJS.Top_Of_Page"></a>
<h2>Change Job Authority using JS (CHGAUTJS)</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="#CHGAUTJS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGAUTJS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGAUTJS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGAUTJS"></a>
<p>The Change Job Authority using Job Scheduler (CHGAUTJS) command allows you to change the job authority that you have set up for Advanced Job Scheduler jobs. You can select specific jobs, generic jobs or all jobs as well as group and application whose authority you want to change.
</p>
<p>After you select the parameters in the change command and press Enter, the authority that you have specified for the jobs are changed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGAUTJS.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="4"><a href="#CHGAUTJS.JOB"><b>JOB</b></a></td>
<td valign="top">Job entry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: Job</td>
<td valign="top">
<i>Generic name, name</i>, *ALL</td>
</tr>
<tr>
<td valign="top">Element 2: Group</td>
<td valign="top">
<i>Generic name, name</i>, *ALL, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Group sequence</td>
<td valign="top">
1-99, *ALL, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CHGAUTJS.USER"><b>USER</b></a></td>
<td valign="top">User</td>
<td valign="top"><i>Name</i>, *PUBLIC</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGAUTJS.APP"><b>APP</b></a></td>
<td valign="top">Application</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGAUTJS.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top">Single values: *ALL, <b><u>*CHANGE</u></b>, *OPER, *USE, *EXCLUDE, *REMOVE<br>Other values (up to 7 repetitions): *SBM, *MGT, *AUT, *DSP, *CPY, *UPD, *RMV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGAUTJS.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace authority</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGAUTJS.JOB"></a>
<h3>Job entry (JOB)</h3>
<p>Specifies the name of the job, generic job or all jobs whose authority that you want to change. You can optionally specify the group that the job belongs to and the associated sequence number within the group.
</p>
<p>This is a required parameter.
</p>
<p><b>Element 1: Job</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All the job entries that meet this command's other parameter values are changed.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the job schedule entries whose job schedule entries that you want to change. A generic job is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with jobs that begin with the generic name are changed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete job.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-defined name of the job entry whose authority that you want to change.
</dd>
</dl>
<p><b>Element 2: Group</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>This job does not belong to a group.
</dd>
<dt><b>*ALL</b></dt>
<dd>All the group entries that meet this command's other parameter values are changed.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the group entry. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with groups that begin with the generic name are changed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete group.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-defined name of the group entries you want to change.
</dd>
</dl>
<p><b>Element 3: Group sequence</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is not a sequence number associated with this job.
</dd>
<dt><b>*ALL</b></dt>
<dd>All sequence numbers in the group are included in the authority change.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the sequence number of the job in the group whose authority you are changing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGAUTJS.USER"></a>
<h3>User (USER)</h3>
<p>Specifies the name of a user to whom authority for the named job is being given.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*PUBLIC</b></dt>
<dd>All enrolled users (or their group) of the system who do not have specific authority to the job are changed.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile whose authority you want to change.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGAUTJS.APP"></a>
<h3>Application (APP)</h3>
<p>Specifies the name of the application, generic application or all applications whose authority that you want to change.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All the applications that meet this command's other parameter values are changed.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the application whose job schedule entries that you want to change. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with application names that begin with the generic name are changed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete application name.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-defined name of the application whose authority that you want to change.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGAUTJS.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority given to the user specified for the <b>Users (USER)</b> parameter.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*CHANGE</u></b></dt>
<dd>Change authority allows the user to perform all operations on the job except authority maintenance.
</dd>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations on the job. The user can control the job's existence, specify the security for the job, change the job, and perform basic functions on the job.
</dd>
<dt><b>*OPER</b></dt>
<dd>Operational authority provides job submission, job management and display authorities.
</dd>
<dt><b>*USE</b></dt>
<dd>Use authority provides display authority.
</dd>
<dt><b>*EXCLUDE</b></dt>
<dd>Exclude authority prevents the user from accessing the job.
</dd>
<dt><b>*REMOVE</b></dt>
<dd>Removes the authority entry for the specified user.
</dd>
</dl>
<p><b>Other values (up to 7 repetitions)</b>
</p>
<dl>
<dt><b>*SBM</b></dt>
<dd>Submit authority allows the user to start a job group or submit a job.
</dd>
<dt><b>*MGT</b></dt>
<dd>Management authority allows the user to hold or release jobs. Additionally, management authority allows the user to work with job dependencies as well as allowing use of the Set Dependent Job using Job Scheduler (SETDEPJS) command.
</dd>
<dt><b>*AUT</b></dt>
<dd>Allows the user to change the authority of a job.
</dd>
<dt><b>*DSP</b></dt>
<dd>Display authority allows the user to display the information of a job.
</dd>
<dt><b>*CPY</b></dt>
<dd>Copy authority allows the user to copy a job.
</dd>
<dt><b>*UPD</b></dt>
<dd>Update authority allows the user to change the attributes of a job.
</dd>
<dt><b>*RMV</b></dt>
<dd>Remove authority allows the user to remove a job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGAUTJS.REPLACE"></a>
<h3>Replace authority (REPLACE)</h3>
<p>Specifies whether you should replace the current job authorities for the user specified for the <b>User (USER)</b> parameter.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Do not replace the current job authorities. This will combine current job authorities with the authorities specified for the <b>Authority (AUT)</b> parameter.
</dd>
<dt><b>*YES</b></dt>
<dd>Replace the current job authorities with the authorites specified for the AUT parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGAUTJS.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGAUTJS JOB(JOB02) USER(SAM) AUT(*USE)
</pre>
</p>
<p>This command changes job JOB02 to give user SAM *USE authority, which provides screen display authority to user SAM.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGAUTJS.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGAUTJS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>