234 lines
8.1 KiB
HTML
234 lines
8.1 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>Set Dependent Job using JS (SETDEPJS)</title>
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<a name="SETDEPJS.Top_Of_Page"></a>
|
||
|
|
<h2>Set Dependent Job using JS (SETDEPJS)</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="#SETDEPJS.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#SETDEPJS.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#SETDEPJS.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="SETDEPJS"></a>
|
||
|
|
<p>The Set Dependent Job using Job Scheduler (SETDEPJS) command allows you change the completion flag from *YES to *NO or vice versa for a predecessor job in a predecessor/successor relationship. The completion flag indicates whether a job has processed. This command allows you to indicate that a job has or has not completed so that a dependent job can be submitted or omitted from submission.
|
||
|
|
</p>
|
||
|
|
<p>For instance, you could set up an end of day (EOD) job that runs every week day at 5:00 p.m.. A dependent job for end of week (EOW) processing could also set up that is scheduled to run on Friday after the EOD job is completed. A third job called EOWCHECK (end of week check) could be set up whose only purpose is to change the completion flag on the EOD job from *YES to *NO. This EOWCHECK job would run prior to 5:00 p.m. on Friday. The reason you would want to do this is to allow the EOW job to run on Friday after the EOD job is completed. The following command string could be used to accomplish this:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SETDEPJS PREDJOB(EOD) SUCCJOB(EOW) COMPLETE(*NO)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETDEPJS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="SETDEPJS.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="#SETDEPJS.PREDJOB"><b>PREDJOB</b></a></td>
|
||
|
|
<td valign="top">Predecessor 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>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Group</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Group sequence</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-99, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#SETDEPJS.SUCCJOB"><b>SUCCJOB</b></a></td>
|
||
|
|
<td valign="top">Successor job entry</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Job</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Group</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Group sequence</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-99, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SETDEPJS.COMPLETE"><b>COMPLETE</b></a></td>
|
||
|
|
<td valign="top">Complete</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETDEPJS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="SETDEPJS.PREDJOB"></a>
|
||
|
|
<h3>Predecessor job entry (PREDJOB)</h3>
|
||
|
|
<p>Specifies the name of the predecessor job schedule entry that you want to change. You must specify a job for every job and optionally can specify a group to which the job belongs as well as a sequence number for the job within the group.
|
||
|
|
</p>
|
||
|
|
<p>The first job of a group must be sequence number 1. Subsequent sequence numbers should leave gaps (10, 20, 30 and so on) to allow job insertions if necessary.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Job</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user-defined name of the predecessor job schedule entry that you want to change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Group</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The job is not assigned to a group.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user-defined name of the group to which the job belongs.
|
||
|
|
</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 assigned to the job.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-99</i></b></dt>
|
||
|
|
<dd>Specify the sequence number of the job within the group. Sequence numbers can range from 1 to 99.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETDEPJS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SETDEPJS.SUCCJOB"></a>
|
||
|
|
<h3>Successor job entry (SUCCJOB)</h3>
|
||
|
|
<p>Specifies the name of the successor job schedule entry that you want to change. You must specify a job for every job and alternately can specify a group to which the job belongs as well as a sequence number for the job within the group.
|
||
|
|
</p>
|
||
|
|
<p>The first job of a group must be sequence number 1. Subsequent sequence numbers should leave gaps (10, 20, 30 and so on) to allow job insertions if necessary.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All successor jobs are included in the jobs that you are changing.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Job</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user-defined name of the successor job schedule entry that you want to change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Group</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The job does not belong to a group.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user-defined name of the group to which the job belongs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Group sequence</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The job does not have a sequence number
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-99</i></b></dt>
|
||
|
|
<dd>Specify the sequence number of the job within the group.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETDEPJS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SETDEPJS.COMPLETE"></a>
|
||
|
|
<h3>Complete (COMPLETE)</h3>
|
||
|
|
<p>Specifies whether you want to change the completion flag for a predecessor job from completed (*YES) or not completed (*NO) or vice versa.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>Change the completion flag to *YES.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Change the completion flag to *NO.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETDEPJS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SETDEPJS.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Changing a Predecessor Job</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SETDEPJS PREDJOB(JOB10) SUCCJOB(JOB11)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets job JOB10 to <b>processed</b>, thus freeing JOB11 to run as a successor job to JOB10.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Triggering End-of-Week Processing</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SETDEPJS PREDJOB(EOD) SUCCJOB(EOW) COMPLETE(*NO)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command sets up an end-of-day (EOD) job that runs every week day at 5:00 p.m. A dependent (successor) job for end-of-week (EOW) processing could also be set up that is scheduled to run on Friday after the EOD job is completed. A third job called EOWCHECK (end of week check) could be set up whose only purpose is to change the completion flag on the EOD job from *YES to *NO. This EOWCHECK job would run prior to 5:00 p.m. on Friday. The reason you would want to do this is to allow the EOW job to run on Friday after the EOD job is completed. This command would be used in the EOWCHECK job.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETDEPJS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div>
|
||
|
|
<h3><a name="SETDEPJS.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SETDEPJS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|