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

1935 lines
73 KiB
HTML
Raw 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>Add Job using Job Scheduler (ADDJOBJS)</title>
</head>
<body bgcolor="white">
<a name="ADDJOBJS.Top_Of_Page"></a>
<h2>Add Job using Job Scheduler (ADDJOBJS)</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="#ADDJOBJS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDJOBJS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDJOBJS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDJOBJS"></a>
<p>The Add Job using Job Scheduler (ADDJOBJS) command allows you to schedule batch jobs by adding an entry to the job schedule. Jobs can be a single job or a member of a group of jobs or an application. You can use this command to schedule a batch job to be submitted once, at a regular interval and so on, based on the schedule code you specify. You can schedule jobs with user-defined calendars, holiday exception calendars and fiscal year calendars.
</p>
<p>The job schedule entry contains all of the information needed to submit the job, including the commands to process, the job description and user profile under which the job is run, the job queue to which the job is submitted, the message queue to which messages are sent and so on.
</p>
<p>At the date and time you specify or Advanced Job Scheduler calculates, the job is submitted to the specified job queue. This command does not guarantee that the job will begin running at the scheduled time, however. The job will not begin running if the job queue is held or attached to an inactive subsystem, or if the maximum number of active jobs allowed to run in the subsystem or on the system at one time has been reached.
</p>
<p>Each job schedule entry is identified by a user-defined job, which is specified for the <b>Job entry (JOB)</b> parameter of this command.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>You must have use (*USE) authority to the job description and the user profile.
</li>
<li>You must have *USE and add (*ADD) authorities to the message queue.
</li>
<li>You must have read (*READ) authority to the job queue and to all libraries associated with the specified objects.
</li>
<li>You must have *USE authority to the *ADDJOB function.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDJOBJS.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="#ADDJOBJS.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>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="#ADDJOBJS.APP"><b>APP</b></a></td>
<td valign="top">Application</td>
<td valign="top"><i>Name</i>, *NONE, <b><u>*JOBCTL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.SCDCDE"><b>SCDCDE</b></a></td>
<td valign="top">Schedule code</td>
<td valign="top"><b><u>*DAILY</u></b>, *CALENDAR, *DATE, *DAY, *NUMDAY, *MINUTES, *ONCE, *MONTHEND, *FIRST, *SECOND, *THIRD, *FOURTH, *FIFTH, *LAST, *FIRSTWRK, *LASTWRK, *ALTERNATE, *NONE, *JOBCTL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.TIME"><b>TIME</b></a></td>
<td valign="top">Scheduled time</td>
<td valign="top">Values (up to 10 repetitions): 0-2400</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.ITVMIN"><b>ITVMIN</b></a></td>
<td valign="top">Interval</td>
<td valign="top">1-720</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.CAL"><b>CAL</b></a></td>
<td valign="top">Calendar</td>
<td valign="top"><i>Name</i>, *NONE, <b><u>*JOBCTL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.HDYCAL"><b>HDYCAL</b></a></td>
<td valign="top">Holiday calendar</td>
<td valign="top"><i>Name</i>, *NONE, <b><u>*JOBCTL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.FSCCAL"><b>FSCCAL</b></a></td>
<td valign="top">Fiscal calendar</td>
<td valign="top"><i>Name</i>, *NONE, <b><u>*JOBCTL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.DAY"><b>DAY</b></a></td>
<td valign="top">Days</td>
<td valign="top">Single values: <b><u>*ALL</u></b>, *NONE<br>Other values (up to 7 repetitions): *MON, *TUE, *WED, *THU, *FRI, *SAT, *SUN</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.SNGDAY"><b>SNGDAY</b></a></td>
<td valign="top">Single day</td>
<td valign="top">*MON, *TUE, *WED, *THU, *FRI, *SAT, <b><u>*SUN</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.ITVDAY"><b>ITVDAY</b></a></td>
<td valign="top">Interval</td>
<td valign="top">1-99</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.DATE"><b>DATE</b></a></td>
<td valign="top">Dates of the year</td>
<td valign="top">Values (up to 13 repetitions): <i>Decimal number</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.SNGDATE"><b>SNGDATE</b></a></td>
<td valign="top">Single date</td>
<td valign="top"><i>Decimal number</i>, <b><u>*NEXT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.SAVE"><b>SAVE</b></a></td>
<td valign="top">Save</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.DAYMONTH"><b>DAYMONTH</b></a></td>
<td valign="top">Day of the month</td>
<td valign="top">Values (up to 13 repetitions): 1-31</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.WRKDAY"><b>WRKDAY</b></a></td>
<td valign="top">Working days</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.FSCPERIOD"><b>FSCPERIOD</b></a></td>
<td valign="top">Fiscal period</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 13 repetitions): 1-13</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.CMD"><b>CMD</b></a></td>
<td valign="top">Command request</td>
<td valign="top"><i>Command string</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location name</td>
<td valign="top"><i>Name</i>, <b><u>*JOBCTL</u></b>, *LCL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="7"><a href="#ADDJOBJS.RANGE"><b>RANGE</b></a></td>
<td valign="top">Schedule range</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="7">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Start time and date</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Beginning time</td>
<td valign="top">
0-2400, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Beginning date</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: End time and date</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
<td valign="top">
0-2400, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
<td valign="top">
<i>Character value</i>, <b><u>*NONE</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.MAXRUN"><b>MAXRUN</b></a></td>
<td valign="top">Maximum run time</td>
<td valign="top">1-9999, <b><u>*NOMAX</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDJOBJS.PGRRCPNORM"><b>PGRRCPNORM</b></a></td>
<td valign="top">Notification normal</td>
<td valign="top">Single values: *NONE<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Notification recipient</td>
<td valign="top">
<i>Name</i>, <b><u>*JOBCTL</u></b>, *ONCALL</td>
</tr>
<tr>
<td valign="top">Element 2: Notification message</td>
<td valign="top">
<i>Character value</i>, <b><u>*JOBCTL</u></b>, *COMP</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDJOBJS.PGRRCPABN"><b>PGRRCPABN</b></a></td>
<td valign="top">Notification abnormal</td>
<td valign="top">Single values: *NONE<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Notification recipient</td>
<td valign="top">
<i>Name</i>, <b><u>*JOBCTL</u></b>, *ONCALL</td>
</tr>
<tr>
<td valign="top">Element 2: Notification message</td>
<td valign="top">
<i>Character value</i>, <b><u>*JOBCTL</u></b>, *COMP</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDJOBJS.PGRRCPSTR"><b>PGRRCPSTR</b></a></td>
<td valign="top">Notification start job</td>
<td valign="top">Single values: *NONE<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Notification recipient</td>
<td valign="top">
<i>Name</i>, <b><u>*JOBCTL</u></b>, *ONCALL</td>
</tr>
<tr>
<td valign="top">Element 2: Start limit</td>
<td valign="top">
1-999, <b><u>*JOBCTL</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#ADDJOBJS.ALTJOB"><b>ALTJOB</b></a></td>
<td valign="top">Alternate job</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</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="#ADDJOBJS.RPTDSTID"><b>RPTDSTID</b></a></td>
<td valign="top">Report distribution ID</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.RCYACN"><b>RCYACN</b></a></td>
<td valign="top">Recovery action</td>
<td valign="top"><b><u>*JOBCTL</u></b>, *SBMRLS, *SBMHLD, *NOSBM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDJOBJS.JOBD"><b>JOBD</b></a></td>
<td valign="top">Job description</td>
<td valign="top">Single values: <b><u>*JOBCTL</u></b>, *USRPRF<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><tr>
<td valign="top" rowspan="3"><a href="#ADDJOBJS.JOBQ"><b>JOBQ</b></a></td>
<td valign="top">Job queue</td>
<td valign="top">Single values: <b><u>*JOBCTL</u></b>, *JOBD<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job queue</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="#ADDJOBJS.JOBPTY"><b>JOBPTY</b></a></td>
<td valign="top">Job priority (on JOBQ)</td>
<td valign="top">1-9, <b><u>*JOBCTL</u></b>, *JOBD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.OUTPTY"><b>OUTPTY</b></a></td>
<td valign="top">Output priority (on OUTQ)</td>
<td valign="top">1-9, <b><u>*JOBCTL</u></b>, *JOBD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.PRTDEV"><b>PRTDEV</b></a></td>
<td valign="top">Print device</td>
<td valign="top"><i>Name</i>, <b><u>*JOBCTL</u></b>, *CURRENT, *USRPRF, *SYSVAL, *JOBD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDJOBJS.OUTQ"><b>OUTQ</b></a></td>
<td valign="top">Output queue</td>
<td valign="top">Single values: <b><u>*JOBCTL</u></b>, *USRPRF, *DEV, *JOBD<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Output queue</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="#ADDJOBJS.USER"><b>USER</b></a></td>
<td valign="top">User</td>
<td valign="top"><i>Name</i>, <b><u>*JOBCTL</u></b>, *CURRENT, *JOBD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.PRTTXT"><b>PRTTXT</b></a></td>
<td valign="top">Print text</td>
<td valign="top"><i>Character value</i>, <b><u>*JOBCTL</u></b>, *BLANK, *JOBD, *SYSVAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.RTGDTA"><b>RTGDTA</b></a></td>
<td valign="top">Routing data</td>
<td valign="top"><i>Character value</i>, <b><u>*JOBCTL</u></b>, *JOBD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.CURLIB"><b>CURLIB</b></a></td>
<td valign="top">Current library</td>
<td valign="top"><i>Name</i>, <b><u>*JOBCTL</u></b>, *USRPRF, *CRTDFT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.LIBL"><b>LIBL</b></a></td>
<td valign="top">Library list</td>
<td valign="top"><i>Name</i>, <b><u>*JOBCTL</u></b>, *JOBD, *SYSVAL, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#ADDJOBJS.LOG"><b>LOG</b></a></td>
<td valign="top">Message logging</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Level</td>
<td valign="top">
0-4, <b><u>*JOBCTL</u></b>, *JOBD</td>
</tr>
<tr>
<td valign="top">Element 2: Severity</td>
<td valign="top">
0-99, <b><u>*JOBCTL</u></b>, *JOBD</td>
</tr>
<tr>
<td valign="top">Element 3: Text</td>
<td valign="top">
<b><u>*JOBCTL</u></b>, *JOBD, *MSG, *SECLVL, *NOLIST</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.LOGCLPGM"><b>LOGCLPGM</b></a></td>
<td valign="top">Log CL program commands</td>
<td valign="top"><b><u>*JOBCTL</u></b>, *JOBD, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.INQMSGRPY"><b>INQMSGRPY</b></a></td>
<td valign="top">Inquiry message reply</td>
<td valign="top"><b><u>*JOBCTL</u></b>, *JOBD, *RQD, *DFT, *SYSRPYL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.HOLD"><b>HOLD</b></a></td>
<td valign="top">Hold on job queue</td>
<td valign="top"><b><u>*JOBCTL</u></b>, *JOBD, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.SWS"><b>SWS</b></a></td>
<td valign="top">Job switches</td>
<td valign="top"><i>Character value</i>, <b><u>*JOBCTL</u></b>, *JOBD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDJOBJS.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top">Single values: <b><u>*JOBCTL</u></b>, *USRPRF, *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Message queue</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="#ADDJOBJS.ACGCDE"><b>ACGCDE</b></a></td>
<td valign="top">Accounting code</td>
<td valign="top"><i>Character value</i>, <b><u>*JOBCTL</u></b>, *JOBD, *USRPRF, *BLANK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.RUNPTY"><b>RUNPTY</b></a></td>
<td valign="top">Run priority</td>
<td valign="top">01-99, <b><u>*JOBCTL</u></b>, *NOCHG</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.INLASPGRP"><b>INLASPGRP</b></a></td>
<td valign="top">Initial ASP group</td>
<td valign="top"><i>Name</i>, <b><u>*JOBCTL</u></b>, *CURRENT, *JOBD, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDJOBJS.ADLCMD"><b>ADLCMD</b></a></td>
<td valign="top">Additional commands</td>
<td valign="top">Values (up to 4 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDJOBJS.JOB"></a>
<h3>Job entry (JOB)</h3>
<p>Specifies the name of the job schedule entry. You must specify a job name 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>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 job schedule entry.
</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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.APP"></a>
<h3>Application (APP)</h3>
<p>Specifies the name of the application to which the job specified for the <b>Job (JOB)</b> parameter belongs.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The application specified in the job controls is used as the application for this job.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no application specified for this job.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the application to which the job that you are adding belongs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.SCDCDE"></a>
<h3>Schedule code (SCDCDE)</h3>
<p>Specifies the schedule code that you want to assign to the job.
</p>
<p>
<b>Note: </b>The days that a job runs as a result of selecting a schedule code can be modified by selecting a calendar in one of the calendar fields. You can review calendars by going to the Job Controls (JSJOBCTL) menu and selecting the calendar type you want to review.
</p>
<dl>
<dt><b><u>*DAILY</u></b></dt>
<dd>The job is scheduled to run on a daily basis or on selected days every week. For example, it may be scheduled to run on Wednesday only, or every day of the week.
</dd>
<dt><b>*CALENDAR</b></dt>
<dd>You are using a calendar to schedule the job. Calendars are specified in the Work with Calendars display.
</dd>
<dt><b>*DATE</b></dt>
<dd>The job is scheduled to run on specific dates throughout the year. They are kept in the system in month day (MMDD) or day month (DDMM) format depending on the system value and will be submitted on the specified dates. Up to 13 dates can be scheduled.
</dd>
<dt><b>*DAY</b></dt>
<dd>The job is to be run on particular calendar days of the month, every month. These are entered in day (dd) format.
</dd>
<dt><b>*NUMDAY</b></dt>
<dd>The job runs every specified number of days. The number of days specified can range from 1 to 99.
<p>
<b>Note: </b>If the scheduled time to run is greater than the current time, Advanced Job Scheduler will count that time as a whole day (if you enter an Advanced Job Scheduler job on Monday at 3:00 p.m. to run every 2 days at 5:00 p.m., the job will run the first time on Tuesday at 5:00 p.m.).
</p>
</dd>
<dt><b>*MINUTES</b></dt>
<dd>The job runs every specified number of minutes. The number of minutes is based on the number of minutes specified for the <b>Interval (ITVMIN)</b> parameter.
</dd>
<dt><b>*ONCE</b></dt>
<dd>The job is to be run once. The <b>Save (SAVE)</b> parameter indicates whether the job is to be saved (*YES) or deleted (*NO) after it is run. If it is a job group, the SAVE parameter will not be shown and will assume saved (*YES). The date that the job is scheduled to be run is specified for the <b>Single date (SNGDATE)</b> parameter. Leaving the date blank will run the job when the scheduled time is reached.
</dd>
<dt><b>*MONTHEND</b></dt>
<dd>The job runs on the last day of the month.
</dd>
<dt><b>*FIRST</b></dt>
<dd>The job is to run on the first designated day of every month or specified fiscal period. This option is used in conjunction with the <b>Single day (SNGDAY)</b> parameter. For instance, if *TUE is specified for the SNGDAY parameter, the job will be scheduled to run on the first Tuesday of each month.
</dd>
<dt><b>*SECOND</b></dt>
<dd>The job is to run on the second designated day of every month or specified fiscal period. This option is used in conjunction with the SNGDAY parameter. For instance, if *TUE is specified for the SNGDAY parameter, the job will be scheduled to run on the second Tuesday of each month.
</dd>
<dt><b>*THIRD</b></dt>
<dd>The job is to run on the third designated day of every month or specified fiscal period. This option is used in conjunction with the SNGDAY parameter. For instance, if *TUE is specified for the SNGDAY parameter, the job will be scheduled to run on the third Tuesday of each month.
</dd>
<dt><b>*FOURTH</b></dt>
<dd>The job is to run on the fourth designated day of every month or specified fiscal period. This option is used in conjunction with the SNGDAY parameter. For instance, if *TUE is specified for the SNGDAY parameter, the job will be scheduled to run on the fourth Tuesday of each month.
</dd>
<dt><b>*FIFTH</b></dt>
<dd>The job is to run on the fifth designated day of every month or specified fiscal period. This option is used in conjunction with the SNGDAY parameter. For instance, if *TUE is specified for the SNGDAY parameter, the job will be scheduled to run on the fifth Tuesday of each month.
<p>
<b>Note: </b>If there is not a fifth occurrence in a month, the job will not run and will be scheduled for the next time there is a fifth occurrence of a selected day in a month.
</p>
</dd>
<dt><b>*LAST</b></dt>
<dd>The job is to run on the last designated day of every month or specified fiscal period. This option is used in conjunction with the SNGDAY parameter. For instance, if *TUE is specified for the SNGDAY parameter, the job will be scheduled to run on the last Tuesday of each month.
</dd>
<dt><b>*FIRSTWRK</b></dt>
<dd>The job is to run on the first working day of every month or specified fiscal period. This option is used in conjunction with the <b>Working days</b>field in the system controls.
</dd>
<dt><b>*LASTWRK</b></dt>
<dd>The job is to run on the last working day of every month or specified fiscal periods. This option is used in conjunction with the <b>Working days</b>field in the system controls.
</dd>
<dt><b>*ALTERNATE</b></dt>
<dd>The job is to run when a regular job terminates abnormally and has this job defined as its alternate job.
</dd>
<dt><b>*NONE</b></dt>
<dd>The job is not a scheduled job. It can be a member of a group job waiting for submission, a job waiting for a predecessor job to run, or a job waiting for manual submission by a user.
<p>
<b>Note: </b>The schedule code *NONE replaces the schedule code *DEPJOB which was used in releases prior to V4R2.
</p>
</dd>
<dt><b>*JOBCTL</b></dt>
<dd>The job is scheduled to run based on the schedule code specified in the job controls.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.TIME"></a>
<h3>Scheduled time (TIME)</h3>
<p>Specifies the time or times that you want the job to run on specified days. Times are entered in hour, minute (HHMM) format and can range from 0001 to 2400 (midnight).
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><i>0-2400</i></b></dt>
<dd>Specify the time that you want Advanced Job Scheduler to submit the job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.ITVMIN"></a>
<h3>Interval (ITVMIN)</h3>
<p>Specifies the number of minutes that you want to use as an interval with the *MINUTES schedule code. This field is required when the *MINUTES schedule code is used.
</p>
<dl>
<dt><b><i>1-720</i></b></dt>
<dd>Specify the number of minutes between submissions of the job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.CAL"></a>
<h3>Calendar (CAL)</h3>
<p>Specifies the name of the calendar that you want to use for the job. A calendar is a user-defined set of days or dates that can be used with all schedule codes except *NONE, *ALTERNATE and *NUMDAY. Calendars allow you to add multiple dates to a schedule in addition to normally scheduled dates.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The calendar that is used for this job is the calendar specified in the job controls.
</dd>
<dt><b>*NONE</b></dt>
<dd>This job does not use a calendar.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the calendar that you want to use for this job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.HDYCAL"></a>
<h3>Holiday calendar (HDYCAL)</h3>
<p>Specifies the name of the holiday calendar that you want to use with a job. A holiday calendar is a user-defined set of exception days or dates. It can be used to determine whether a job will process.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value specified for holiday calendar in the job controls is used for this job.
</dd>
<dt><b>*NONE</b></dt>
<dd>This job does not use a holiday calendar.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the holiday calendar that you want to use for this job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.FSCCAL"></a>
<h3>Fiscal calendar (FSCCAL)</h3>
<p>Specifies the name of the fiscal year calendar that you want to use with the job specified for the <b>Job (JOB)</b> parameter. Fiscal year calendars are made up of 12 or 13 periods with starting and ending dates for each period.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value specified for fiscal calendar in the job controls is used for this job.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is not a fiscal calendar for this job.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user-defined fiscal year calendar that you want to use for this job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.DAY"></a>
<h3>Days (DAY)</h3>
<p>Specifies the days that you want this job to process. Days are used with the *DAILY and *MINUTES schedule codes or job groups with a sequence number greater than 1.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The job runs on all days.
</dd>
<dt><b>*MON</b></dt>
<dd>The job is scheduled to run on Monday.
</dd>
<dt><b>*TUE</b></dt>
<dd>The job is scheduled to run on Tuesday.
</dd>
<dt><b>*WED</b></dt>
<dd>The job is scheduled to run on Wednesday.
</dd>
<dt><b>*THU</b></dt>
<dd>The job is scheduled to run on Thursday.
</dd>
<dt><b>*FRI</b></dt>
<dd>The job is scheduled to run on Friday.
</dd>
<dt><b>*SAT</b></dt>
<dd>The job is scheduled to run on Saturday.
</dd>
<dt><b>*SUN</b></dt>
<dd>The job is scheduled to run on Sunday.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.SNGDAY"></a>
<h3>Single day (SNGDAY)</h3>
<p>Specifies the day of the week that you want this job to process. Day of the week is used with the *FIRST, *SECOND, *THIRD, *FOURTH, *FIFTH and *LAST schedule codes.
</p>
<p>
<b>Note: </b>*SUN is the default day of the week when you specify *FIRST, *SECOND, *THIRD, *FOURTH, *FIFTH or *LAST.
</p>
<dl>
<dt><b><u>*SUN</u></b></dt>
<dd>The job is scheduled to run on Sunday.
</dd>
<dt><b>*MON</b></dt>
<dd>The job is scheduled to run on Monday.
</dd>
<dt><b>*TUE</b></dt>
<dd>The job is scheduled to run on Tuesday.
</dd>
<dt><b>*WED</b></dt>
<dd>The job is scheduled to run on Wednesday.
</dd>
<dt><b>*THU</b></dt>
<dd>The job is scheduled to run on Thursday.
</dd>
<dt><b>*FRI</b></dt>
<dd>The job is scheduled to run on Friday.
</dd>
<dt><b>*SAT</b></dt>
<dd>The job is scheduled to run on Saturday.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.ITVDAY"></a>
<h3>Interval (ITVDAY)</h3>
<p>Specifies the number of days that you want to use as an interval with the *NUMDAY schedule code. This field is required with the *NUMDAY schedule code.
</p>
<dl>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the number of days between submissions of the job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.DATE"></a>
<h3>Dates of the year (DATE)</h3>
<p>Specifies the dates that a job is scheduled to be processed. Dates are entered in month, day (MMDD) format or (DDMM) format depending on the system value. The DATE parameter is required when the <b>Schedule code (SCDCDE)</b> parameter has the value *DATE.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><i>date</i></b></dt>
<dd>Specify a date that a job is to be submitted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.SNGDATE"></a>
<h3>Single date (SNGDATE)</h3>
<p>Specifies the date that a job is scheduled to be processed. Dates are entered in month, day (MMDD) format or (DDMM) format depending on the system format. The SNGDATE parameter is used when the <b>Schedule code (SCDCDE)</b> parameter contains *ONCE.
</p>
<dl>
<dt><b><u>*NEXT</u></b></dt>
<dd>The job is to be processed at the next scheduled time.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the single date that the job is to be submitted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.SAVE"></a>
<h3>Save (SAVE)</h3>
<p>Specifies whether this job is to be saved after it has run. The SAVE parameter is used with the *ONCE schedule code.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The job is to be saved in Advanced Job Scheduler after it has run.
</dd>
<dt><b>*NO</b></dt>
<dd>The job is to be deleted by Advanced Job Scheduler after it has run.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.DAYMONTH"></a>
<h3>Day of the month (DAYMONTH)</h3>
<p>Specifies the days of the month that you want this job to process. Days of the month are used with the *DAY schedule code.
</p>
<p>You can specify 13 values for this parameter.
</p>
<dl>
<dt><b><i>1-31</i></b></dt>
<dd>Specify the day of the month that you the job to be processed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.WRKDAY"></a>
<h3>Working days (WRKDAY)</h3>
<p>Specifies whether the days specified for the <b>Day of the month (DAYMONTH)</b> parameter or <b>Interval (ITVDAY)</b> parameter are working days. Working days are used with the *DAY and *NUMDAY schedule codes respectively. For instance, when using the *DAY schedule code, if you specified DAYMONTH(05 10) and WRKDAY(*YES), the job would run on the fifth and tenth working day of each month. If you had specified *NO, the job would run each fifth and tenth calendar day of the month. Working days are specified in the system controls.
</p>
<p>If you were using the *NUMDAY schedule code, the interval that you select would be based on working days or calendar days, depending on your selection in the WRKDAY parameter.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Do not use working days in conjunction with the DAYMONTH or INTERVAL parameter respectively.
</dd>
<dt><b>*YES</b></dt>
<dd>Use working days in conjunction with the DAYMONTH or INTERVAL parameter respectively.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.FSCPERIOD"></a>
<h3>Fiscal period (FSCPERIOD)</h3>
<p>Specifies the periods within a fiscal year for the job. Periods are used when a fiscal calendar name is specified for the <b>Fiscal calendar (FSCCAL)</b> parameter.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All periods are to be included for the job.
</dd>
</dl>
<p><b>Other values (up to 13 repetitions)</b>
</p>
<dl>
<dt><b><i>1-13</i></b></dt>
<dd>Specify the fiscal periods that you want to include for the job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.TEXT"></a>
<h3>Text (TEXT)</h3>
<p>Specifies the text related to the job.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The job does not have any text description associated with it.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the text description associated with the job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.CMD"></a>
<h3>Command request (CMD)</h3>
<p>Specifies the command that you want to process in this job. You can specify a command, a call to a program or pass parameters to a called program. Commands are checked for validity and parameters are validated against the Advanced Job Scheduler parameter file. Object existence is not checked on added or changed jobs.
</p>
<dl>
<dt><b><i>command-string</i></b></dt>
<dd>Specify the command to be run.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.RMTLOCNAME"></a>
<h3>Remote location name (RMTLOCNAME)</h3>
<p>Specifies the location and network identification of the system on which to run the job.
</p>
<p>
<b>Note: </b>A value specified for the RMTLOCNAME parameter will be ignored when used with schedule code *ALTERNATE.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>Use the remote location name specified in the job controls.
</dd>
<dt><b>*LCL</b></dt>
<dd>Run the job on the local server.
</dd>
<dt><b><i>remote-location-name</i></b></dt>
<dd>Specify the name of the remote location associated with the system on which to run the job.
</dd>
<dt><b><i>network-ID.remote-location-name</i></b></dt>
<dd>Specify the network identifier and the name of the remote location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.RANGE"></a>
<h3>Schedule range (RANGE)</h3>
<p>Specifies the starting and ending time and date range for the job.
</p>
<p>
<b>Note: </b>If you are using the *MINUTES schedule code, the <b>Beginning time</b> value is used in conjunction with the <b>Ending time</b>. The *MINUTES schedule code is the only schedule code that uses these two values to indicate when a job starts and stops.
</p>
<p><b>Element 1: Start time and date</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Beginning time</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No beginning time is specified for the job.
</dd>
<dt><b><i>0-2400</i></b></dt>
<dd>Specify the beginning time for the job in hour, minute (HHMM) format.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Beginning date</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is not a beginning date specified for this job.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the beginning date for this job in job format.
</dd>
</dl>
</dd>
</dl>
<p><b>Element 2: End time and date</b>
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Ending time</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is not an ending time specified for this job.
</dd>
<dt><b><i>0-2400</i></b></dt>
<dd>Specify the ending time for this job in hour, minute (HHMM) format.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Ending date</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is not an ending date specified for this job.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the ending date for this job in job format.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.MAXRUN"></a>
<h3>Maximum run time (MAXRUN)</h3>
<p>Specifies the maximum run duration in minutes for the job.
</p>
<p>
<b>Note: </b>A value specified for the MAXRUN prompt will be ignored when used with schedule code *ALTERNATE.
</p>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>There is no maximum duration for the job.
</dd>
<dt><b><i>1-9999</i></b></dt>
<dd>Specify the number of minutes that is the maximum duration for this job. After this number of minutes has passed, Advanced Job Scheduler will end the job whether it has completed or not.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.PGRRCPNORM"></a>
<h3>Notification normal (PGRRCPNORM)</h3>
<p>Specifies the notification recipient who is to receive normal completion messages for the job that you are adding or changing. This field is used in conjunction with the notification command.
</p>
<p>
<b>Note: </b>SMTP information must be specified before this feature may be used with the Send Distribution using JS (SNDDSTJS) command.
</p>
<p>
<b>Note: </b>The values that you specify for Notification recipient normal and Notification message are the substitution variables used for the &amp;RCP and &amp;MSGTXT variables respectively in the CHGNFYJS command.
</p>
<p>You can specify the notification message that you want to send to the specified recipient when the job completes normally.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No notification recipient is assigned to receive messages when this job completes normally.
</dd>
</dl>
<p><b>Element 1: Notification recipient</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>You are using the notification recipient specified in the job controls.
</dd>
<dt><b>*ONCALL</b></dt>
<dd>Only recipients that are on-call will receive the message.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a recipient who is to receive messages from the job when it completes normally.
</dd>
</dl>
<p><b>Element 2: Notification message</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The notification recipient is sent the notification message from the job controls.
</dd>
<dt><b>*COMP</b></dt>
<dd>The completion status of the job is sent.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the notification message that you want to send to the notification recipient when this job completes normally.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.PGRRCPABN"></a>
<h3>Notification abnormal (PGRRCPABN)</h3>
<p>Specifies the notification recipient who is to receive abnormal completion messages for the job that you are adding or changing. This field is used in conjunction with the notification command.
</p>
<p>
<b>Note: </b>SMTP information must be specified before this feature may be used with the Send Distribution using JS (SNDDSTJS) command.
</p>
<p>
<b>Note: </b>The values that you specify for Notification recipient abnormal and Notification message are the substitution variables used for the &amp;RCP and &amp;MSGTXT variables respectively in the CHGNFYJS command.
</p>
<p>You can specify the notification message that you want to send to the specified recipient when the job completes abnormally.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No notification recipient is assigned to receive messages when this job completes abnormally.
</dd>
</dl>
<p><b>Element 1: Notification recipient</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>You are using the notification recipient specified in the job controls.
</dd>
<dt><b>*ONCALL</b></dt>
<dd>Only recipients that are on-call will receive the message.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a recipient who is to receive messages from the job when it completes abnormally.
</dd>
</dl>
<p><b>Element 2: Notification message</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The notification recipient is sent the notification message from the job controls.
</dd>
<dt><b>*COMP</b></dt>
<dd>The completion status of the job is sent.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the notification message that you want to send to the notification recipient when this job completes abnormally.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.PGRRCPSTR"></a>
<h3>Notification start job (PGRRCPSTR)</h3>
<p>Specifies the notification recipient who is to receive notification for the job that you are adding or changing if the job does not start within the limit after it has been submitted. This field is used in conjunction with the notification command.
</p>
<p>
<b>Note: </b>SMTP information must be specified before this feature may be used with the Send Distribution using JS (SNDDSTJS) command.
</p>
<p>
<b>Note: </b>The values that you specify for Notification recipient start job is the substitution variable used for the &amp;RCP variable in the CHGNFYJS command. The &amp;MSGTXT will be replaced with message IJS6059.
</p>
<p>You can specify the start limit in minutes. This is the amount of time a job can be sitting on the job queue before a notification is issued.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No notification recipient is assigned to receive messages when this job exceeds the start limit.
</dd>
</dl>
<p><b>Element 1: Notification recipient</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>You are using the notification recipient specified in the job controls.
</dd>
<dt><b>*ONCALL</b></dt>
<dd>Only recipients that are on-call will receive the message.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a recipient who is to receive messages if the job does not start within the limit after the job has been submitted.
</dd>
</dl>
<p><b>Element 2: Start limit</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The start limit in the job controls is used.
</dd>
<dt><b><i>1-999</i></b></dt>
<dd>Specify the number of minutes that a job can be sitting on the job queue before a notification is issued.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.ALTJOB"></a>
<h3>Alternate job (ALTJOB)</h3>
<p>Specifies the name of the alternate job for the job that you are adding. Alternate jobs only run when a regular job terminates abnormally. Jobs are not required to have alternate jobs. If you want to select a job from a job list when prompting this command, place the cursor on this parameter and press F4.
</p>
<p>You can also specify a group and group sequence if the alternate job is a member of a group.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The job does not have an alternate job.
</dd>
</dl>
<p><b>Element 1: Job</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job that you want to be the alternate job for this job.
</dd>
</dl>
<p><b>Element 2: Group</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The alternate job does not have an alternate group.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the group associated with the alternate job for this job.
</dd>
</dl>
<p><b>Element 3: Group sequence</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The alternate job does not have a sequence number assigned.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the sequence number assigned to the alternate job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.RPTDSTID"></a>
<h3>Report distribution ID (RPTDSTID)</h3>
<p>Specifies the report distribution ID that is used to distribute the reports generated as a result of processing the job.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The job does not have a report distribution ID.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the report distribution ID that you want to associate with this job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.RCYACN"></a>
<h3>Recovery action (RCYACN)</h3>
<p>Specifies the recovery action to be taken if the job cannot be submitted at the designated time because the system is powered down or in restricted state. The action specified on the parameter occurs at the next IPL or when the Advanced Job Scheduler system becomes active.
</p>
<p>Jobs submitted during IPL or when the system comes out of restricted state are submitted in the same order that they would have been had the jobs been submitted at the times specified in the job schedule entries. If multiple occurrences of a recurring job are missed, the job is submitted only once. The first missed occurrence of the job is calculated from the current date.
</p>
<p>Since the scheduler portion of IPL need not be complete for the IPL of the system to be complete, other jobs may start on the system before all of the jobs have been submitted.
</p>
<p>This parameter does not apply when a job is released after being held at the to be submitted.
</p>
<p>
<b>Note: </b>A value specified for the RCYACN parameter will be ignored when used with schedule code *ALTERNATE or *NONE.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The job uses the recovery action specified in the job controls.
</dd>
<dt><b>*SBMRLS</b></dt>
<dd>The job is submitted in release state (RLS).
</dd>
<dt><b>*SBMHLD</b></dt>
<dd>The job is submitted in the held state (HLD).
</dd>
<dt><b>*NOSBM</b></dt>
<dd>The job is not submitted.
<p>Specifying *NOSBM affects only missed occurrences of the job. If the job schedule entry is a recurring job, future occurrences are not affected.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.JOBD"></a>
<h3>Job description (JOBD)</h3>
<p>Specifies the job description to be used with this job.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The job description specified in the job controls is used for this job.
</dd>
<dt><b>*USRPRF</b></dt>
<dd>The job description in the user profile under which the submitted job runs is used as the job description of the submitted job.
</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.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the job description.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the job description. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the job description is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.JOBQ"></a>
<h3>Job queue (JOBQ)</h3>
<p>Specifies the job queue in which this job is to be placed.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The job queue specified in the job controls is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The submitted job is placed on the job queue named in the specified job description.
</dd>
</dl>
<p><b>Qualifier 1: Job queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job queue on which the submitted job is placed.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the job queue.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the job queue. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the job queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.JOBPTY"></a>
<h3>Job priority (on JOBQ) (JOBPTY)</h3>
<p>Specifies the job queue scheduling priority. Valid values range from 1 through 9, where 1 is the highest priority and 9 is the lowest priority.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The scheduling default specified in the job controls is used for the job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The scheduling priority specified in the job description is used for the job.
</dd>
<dt><b><i>1-9</i></b></dt>
<dd>Specify a value for the scheduling priority for the job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.OUTPTY"></a>
<h3>Output priority (on OUTQ) (OUTPTY)</h3>
<p>Specifies the output queue priority for spooled output files that are produced by this job. Valid values range from 1 through 9, where 1 is the highest priority and 9 is the lowest priority.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The output priority default specified in the job controls is used for the job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The output priority specified in the job description is used for the job.
</dd>
<dt><b><i>1-9</i></b></dt>
<dd>Specify a value for the output priority for the job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.PRTDEV"></a>
<h3>Print device (PRTDEV)</h3>
<p>Specifies the qualified name of the default printer device for this job.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The printer specified in the job controls is used by the job as the printer device.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The same printer device being used by the job that is currently running is used for this job.
</dd>
<dt><b>*USRPRF</b></dt>
<dd>The printer device specified in the user profile where the submitted job runs is used as the printer device for this job. The printer device name is obtained from the profile when this job is submitted.
</dd>
<dt><b>*SYSVAL</b></dt>
<dd>The printer device specified in the system value, QPRTDEV, when this job is submitted is used.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The printer device specified in the job description is used for the submitted job.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the printer device used for the submitted job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.OUTQ"></a>
<h3>Output queue (OUTQ)</h3>
<p>Specifies the output queue to be used for spooled output produced by the job. This parameter only applies to spooled printer files that specify *JOB for the output queue.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The output queue specified in the job controls is used as the job's output queue.
</dd>
<dt><b>*USRPRF</b></dt>
<dd>The output queue in the user profile where the submitted job runs is used as the output queue for this job.
</dd>
<dt><b>*DEV</b></dt>
<dd>The output queue associated with the printer device for the spooled file is used.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The output queue named in the job description used with the submitted job is the job's default output queue.
</dd>
</dl>
<p><b>Qualifier 1: Output queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the output queue to be used as the default output queue by the submitted
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the output queue.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the output queue. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the output queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.USER"></a>
<h3>User (USER)</h3>
<p>Specifies the name of the user profile for the job being submitted. If *RQD is specified in the job description, *JOBD cannot be specified; a user name must be specified instead.
</p>
<p><b>Note: </b>The following IBM-supplied objects are not valid on this parameter:
</p>
<ul>
<li>QDBSHR
</li>
<li>QDFTOWN
</li>
<li>QDOC
</li>
<li>QLPAUTO
</li>
<li>QLPINSTALL
</li>
<li>QRJE
</li>
<li>QSECOFR
</li>
<li>QSPL
</li>
<li>QSYS
</li>
<li>QTSTRQS
</li>
</ul>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The user profile specified in the job controls is used for the job being submitted.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The same user profile used by the job that is currently running is used for the submitted job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The user profile named in the specified job description is used for the job being submitted.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile that is used for the job being submitted. You must be authorized to the user profile; the user profile must be authorized to the job description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.PRTTXT"></a>
<h3>Print text (PRTTXT)</h3>
<p>Specifies up to 30 characters of text that is printed at the bottom of each page of printed output and on separator pages.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value in the job controls is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The value in the job description is used for this job.
</dd>
<dt><b>*SYSVAL</b></dt>
<dd>The system value, QPRTTXT, is used for this job.
</dd>
<dt><b>*BLANK</b></dt>
<dd>No text is printed.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the character string that is printed at the bottom of each page. A maximum of 30 characters can be entered, enclosed in apostrophes. The text on the listing will be centered in the same way it is entered.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.RTGDTA"></a>
<h3>Routing data (RTGDTA)</h3>
<p>Specifies the routing data used to start the first routing step in the job. The routing data is used to determine the routing entry that identifies the program that the job runs.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value in the job controls for routing data is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The routing data specified in the job description is used to start the routing steps.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the character string that is used as routing data for the job. A maximum of 80 characters can be entered, enclosed in apostrophes if necessary.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.CURLIB"></a>
<h3>Current library (CURLIB)</h3>
<p>Specifies the name of the current library associated with the job being run.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The current library specified in the job controls is used for the job being submitted.
</dd>
<dt><b>*USRPRF</b></dt>
<dd>The current library in the user profile where the submitted job runs is used as the current library for the submitted job.
</dd>
<dt><b>*CRTDFT</b></dt>
<dd>There is no current library for the submitted job. If objects are created in the current library, QGPL is used as the default current library.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a library used as the current library of the submitted job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.LIBL"></a>
<h3>Library list (LIBL)</h3>
<p>Specifies the name of the library list that is used to search for any operating system object names that were specified without a library qualifier. If you want to select a library list from a list when prompting this command, place the cursor on this parameter and press F4.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The library list specified in the job controls is used for the job being submitted.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The library list in the job description used with this job is used as the initial user part of the library list for the job.
</dd>
<dt><b>*SYSVAL</b></dt>
<dd>The system default user library list is used by this job. It contains the library names that were specified in the system value, QUSRLIBL, at the time that the job is started.
</dd>
<dt><b>*NONE</b></dt>
<dd>The user portion of the initial library list for this job will be empty.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library list that you want to use for this job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.LOG"></a>
<h3>Message logging (LOG)</h3>
<p>Specifies the message logging values used to determine the amount and type of information sent to the job log by this job. This parameter has three elements: the message (or logging) level, the message severity, and the level of message text. If no values are specified on this parameter, the values specified in the job description associated with this job are used.
</p>
<p><b>Element 1: Level</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value specified in the job controls for logging is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The value specified for message logging in the job description is used for this job.
</dd>
<dt><b><i>0-4</i></b></dt>
<dd>Specify a value for the message logging level to be used for this job's messages. The possible logging levels are:
<dl>
<dt><b>0</b></dt>
<dd>No data is logged.
</dd>
<dt><b>1</b></dt>
<dd>The following information is logged: All messages sent to the job's external message queue with a severity level greater than or equal to the message severity specified (this includes the indications of job start, job end and job completion status).
</dd>
<dt><b>2</b></dt>
<dd>The following information is logged:
<ul>
<li>Logging level 1 information.
</li>
<li>Requests or commands being logged from a CL program for which messages are issued with a severity code greater than or equal to the severity level specified.
</li>
<li>All messages associated with a request, or commands being logged from a CL program, that results in a high-level message with a severity level greater than or equal to the severity specified.
</li>
</ul>
</dd>
<dt><b>3</b></dt>
<dd>The following information is logged:
<ul>
<li>Logging level 1 information.
</li>
<li>All requests or commands being logged from a CL program.
</li>
<li>All messages associated with a request, or commands being logged from a CL program, that results in a high-level message with a severity level greater than or equal to the severity specified.
</li>
</ul>
</dd>
<dt><b>4</b></dt>
<dd>The following information is logged; All requests or commands being logged from a CL program and all messages with a severity code greater than or equal to the severity specified, including trace messages.
<p>
<b>Note: </b>A high-level message is one that is sent to the program message queue of the program that received the request or commands being logged from a CL program.
</p>
</dd>
</dl>
</dd>
</dl>
<p><b>Element 2: Severity</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value specified in the job controls for message severity is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The value specified for message logging in the job description is used for this job.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the lowest severity level that causes an error message to be logged in the job's log.
</dd>
</dl>
<p><b>Element 3: Text</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value specified in the job controls for message text is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The value specified for message logging in the job description is used for this job.
</dd>
<dt><b>*MSG</b></dt>
<dd>Only message text is written to the job's log or shown to the user.
</dd>
<dt><b>*SECLVL</b></dt>
<dd>Both the message text and message help of the error message is written to the job's log or shown to the user.
</dd>
<dt><b>*NOLIST</b></dt>
<dd>No job log is produced if the job completes normally. If the job ends abnormally (if the end of job code is 20 or higher), a job log is produced. The messages appearing in the job's log contain both message text and help text.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.LOGCLPGM"></a>
<h3>Log CL program commands (LOGCLPGM)</h3>
<p>Specifies whether the commands that are run in a control language program are logged to the job log by way of the CL program's message queue. This parameter sets the status of the job's logging flag. If *JOB has been specified for the LOG parameter on the Create CL Program (CRTCLPGM) command, the value specified for this parameter is used. Other values for the LOG parameter override the value specified for this parameter. The commands are logged in the same manner as the requests.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value in the job controls is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The value specified in the job description is used.
</dd>
<dt><b>*YES</b></dt>
<dd>The commands in a CL program are logged to the job log.
</dd>
<dt><b>*NO</b></dt>
<dd>The commands in a CL program are not logged to the job log.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.INQMSGRPY"></a>
<h3>Inquiry message reply (INQMSGRPY)</h3>
<p>Specifies the way that predefined messages that are sent as a result of running this job are answered. You can specify that no change is made in the way that predefined messages are answered, or that all inquiry messages require a reply, or that a default reply is issued, or that the system reply list is checked for a matching reply as each predefined inquiry message is sent.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value in the job controls for inquiry message reply is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The inquiry message reply control specified in the job description used with this job is used.
</dd>
<dt><b>*RQD</b></dt>
<dd>A reply is required by the receiver of the inquiry message for all inquiry messages that occur when this command is run.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default message reply is used to answer any inquiry messages that occur when this command is run.
</dd>
<dt><b>*SYSRPYL</b></dt>
<dd>The system reply list is checked to see if there is an entry for any inquiry message that is issued as a result of running this job that has a message identifier and any comparison data that match the inquiry message identifier and message data. If a match occurs, the reply value in that entry is used. If no entry exists for that message, a reply is required.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.HOLD"></a>
<h3>Hold on job queue (HOLD)</h3>
<p>Specifies whether this job is held at the time that it is put on the job queue. A job placed on the job queue in the hold state is held until it is released by the Release Job (RLSJOB) command or ended, either by the End Job (ENDJOB) command or by the Clear Job Queue (CLRJOBQ) command.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value in the job controls for hold on job queue is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The value specified in the job description determines whether the job is held when it is put on the job queue.
</dd>
<dt><b>*YES</b></dt>
<dd>The job is held when it is put on the job queue until it is released by a Release Job (RLSJOB) command or ended by an End Job (ENDJOB) command.
</dd>
<dt><b>*NO</b></dt>
<dd>The job is not held when it is put on the job queue.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.SWS"></a>
<h3>Job switches (SWS)</h3>
<p>Specifies the first settings for a group of eight job switches used with this job. These switches can be set or tested in a CL program and used to control the flow of the program. Only 0's (off) and 1's (on) can be specified in the 8-digit character string.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value in the job controls for job switches is used for this job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The value specified in the job description is the first setting for the job's switches.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify any combination of eight zeros and ones that is used as the first switch setting for the submitted job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.MSGQ"></a>
<h3>Message queue (MSGQ)</h3>
<p>Specifies the name of the message queue to which a completion message is sent when the submitted job has completed running, either normally or abnormally. If an abnormal ending occurs, the help information for the completion message specifies the possible causes.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The value in the job controls for message queue is used for this job.
</dd>
<dt><b>*USRPRF</b></dt>
<dd>A completion message is sent to the message queue specified in the user profile of the submitter.
</dd>
<dt><b>*NONE</b></dt>
<dd>No completion message is sent.
</dd>
</dl>
<p><b>Qualifier 1: Message queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the message queue to which the completion message is to be sent.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the message queue.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the message queue. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the message queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.ACGCDE"></a>
<h3>Accounting code (ACGCDE)</h3>
<p>Specifies the accounting code that is used when logging system resource use for jobs that use this description.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The accounting code for jobs using this description is obtained from the job controls.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The accounting code for jobs using this description is obtained from the job description.
</dd>
<dt><b>*USRPRF</b></dt>
<dd>The accounting code for jobs using this description is obtained from the user profile associated with the job.
</dd>
<dt><b>*BLANK</b></dt>
<dd>An accounting code of 15 blanks is assigned to jobs that use this description.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the accounting code that you want to use for jobs using this description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.RUNPTY"></a>
<h3>Run priority (RUNPTY)</h3>
<p>Specifies the run priority for the job. Run priority is a value ranging from 1 (highest priority) through 99 (lowest priority), that represents the importance of the job when it competes with other jobs for machine resources. This value represents the relative (not absolute) importance of the job. If the job is rerouted, this value is reset according to the job's importance within the job class.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The run priority is obtained from the job controls.
</dd>
<dt><b>*NOCHG</b></dt>
<dd>The run priority is not changed when job processing starts.
</dd>
<dt><b><i>01-99</i></b></dt>
<dd>Specify the run priority to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.INLASPGRP"></a>
<h3>Initial ASP group (INLASPGRP)</h3>
<p>Specifies the initial setting for the auxiliary storage pool (ASP) group name for the initial thread of the submitted job. A thread can use the Set ASP Group (SETASPGRP) command to change its library name space. When an ASP group is associated with a thread, all libraries in the independent ASPs in the ASP group are accessible and objects in those libraries can be referenced using regular library-qualified object name syntax. The libraries in the independent ASPs in the specified ASP group plus the libraries in the system ASP (ASP number 1) and basic user ASPs (ASP numbers 2-32) form the library name space for the thread.
</p>
<dl>
<dt><b><u>*JOBCTL</u></b></dt>
<dd>The initial ASP group is obtained from the job controls.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The ASP group name for the current thread is used for the submitted job.
</dd>
<dt><b>*JOBD</b></dt>
<dd>The initial ASP group name specified in the job description is used for the submitted job.
</dd>
<dt><b>*NONE</b></dt>
<dd>Specifies the initial thread of the submitted job will be started with no ASP group. The library name space will not include libraries from any ASP group. Only the libraries in the system ASP and any basic user ASPs will be in the library name space.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the ASP group to be set for the initial thread of the submitted job. The ASP group name is the name of the primary ASP device within the ASP group. All libraries from all ASPs in this ASP group will be included in the library name space.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDJOBJS.ADLCMD"></a>
<h3>Additional commands (ADLCMD)</h3>
<p>Specifies additional commands that you want to process in this job. You can specify a command, a call to a program or pass parameters to a called program. Commands are checked for validity and parameters are validated against the Advanced Job Scheduler parameter file. Object existence is not checked on added or changed jobs.
</p>
<p>You can specify 4 values for this parameter.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the additional command to be run.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDJOBJS.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Adding a Job</b>
</p>
<p>
<pre>
ADDJOBJS JOB(JOB01) TIME(1000)
</pre>
</p>
<p>This command adds a job to the job schedule. In this example, job JOB01 is being added to the job schedule and is scheduled to run at 10:00 a.m.. Note that the default schedule code for this job is *DAILY and the DAY parameter is *ALL.
</p>
<p><b>Example 2: Adding a Job with a *CALENDAR schedule code</b>
</p>
<p>
<pre>
ADDJOBJS JOB(JOB02) SCDCDE(*CALENDAR) CAL(CAL)
TIME(1100) CMD(WRKACTJOB)
</pre>
</p>
<p>This command adds the job JOB02 to the job scheduler. The job is scheduled to run at 11:00 a.m. using an *CALENDAR schedule and a calendar called CAL. When the job runs it processes the WRKACTJOB command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDJOBJS.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>