224 lines
8.0 KiB
HTML
224 lines
8.0 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 Autostart Job Entry (CHGAJE)</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="CHGAJE.Top_Of_Page"></a>
|
|
<h2>Change Autostart Job Entry (CHGAJE)</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="#CHGAJE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGAJE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGAJE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGAJE"></a>
|
|
<p>The Change Autostart Job Entry (CHGAJE) command is used to specify a different job description for a previously defined autostart job entry in the specified subsystem description.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The job associated with an active subsystem can only find objects that exist in the system auxiliary storage pool (ASP) or in a basic user ASP. Therefore, objects that are referenced by this command should exist in the system ASP or in a basic user ASP.
|
|
</li>
|
|
</ol>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>To use this command, you must have:
|
|
<ul>
|
|
<li>object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing that subsystem description.
|
|
</li>
|
|
<li>object operational (*OBJOPR) and read (*READ) authority to the job description and execute (*EXECUTE) authority to the library containing that job description.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Only a user with all object (*ALLOBJ) special authority is allowed to change an entry for which the job description does not exist.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGAJE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGAJE.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="#CHGAJE.SBSD"><b>SBSD</b></a></td>
|
|
<td valign="top">Subsystem description</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: Subsystem description</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="#CHGAJE.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGAJE.JOBD"><b>JOBD</b></a></td>
|
|
<td valign="top">Job description</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *SBSD<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job description</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></table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGAJE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGAJE.SBSD"></a>
|
|
<h3>Subsystem description (SBSD)</h3>
|
|
<p>Specifies the name and library of the subsystem description containing the autostart job entry being changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Subsystem description</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the subsystem description where the autostart job entry is being changed. p.<b>Note:</b> The following IBM-supplied objects are not valid on this parameter:
|
|
<ul>
|
|
<li>QSYSSBSD
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the thread's library list are searched until a match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the library where the subsystem description is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGAJE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGAJE.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the simple name of the job that is automatically started when a subsystem is started using the subsystem description specified on the <b>Subsystem description (SBSD)</b> parameter.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the simple name of the job that is automatically started.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGAJE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGAJE.JOBD"></a>
|
|
<h3>Job description (JOBD)</h3>
|
|
<p>Specifies the name of the job description used for the job that is started by this autostart job entry. If the job description does not exist when the entry is added or changed, a library qualifier must be specified because the qualified job description name is kept in the subsystem description.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Only a user with all object (*ALLOBJ) special authority is allowed to add or change an entry for which the job description does not exist.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The job description specified in the existing autostart job entry is used.
|
|
</dd>
|
|
<dt><b>*SBSD</b></dt>
|
|
<dd>The job description having the same qualified name as the subsystem description, specified on the <b>Subsystem description (SBSD)</b> parameter, is used for the job that is being started.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job description</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job description used for the job started by this autostart job entry.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the thread's library list are searched until a match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the library where the job description is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGAJE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGAJE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGAJE SBSD(QGPL/PAYROLL) JOB(INIT) JOBD(MANAGER)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes autostart job entry for the job INIT to use the job description MANAGER. The autostart job entry is in the PAYROLL subsystem description in the QGPL library. The library list is used to locate the job description MANAGER. When the correct library is determined, the qualified job description name is placed in the subsystem description for this autostart job entry.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGAJE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGAJE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1619</b></dt>
|
|
<dd>Subsystem description &1 in library &2 damaged.
|
|
</dd>
|
|
<dt><b>CPF1697</b></dt>
|
|
<dd>Subsystem description &1 not changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGAJE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|