1113 lines
48 KiB
HTML
1113 lines
48 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>Create Job Description (CRTJOBD)</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="CRTJOBD.Top_Of_Page"></a>
|
||
|
<h2>Create Job Description (CRTJOBD)</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="#CRTJOBD.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
<a href="#CRTJOBD.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
<a href="#CRTJOBD.ERROR.MESSAGES">Error messages</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<div> <a name="CRTJOBD"></a>
|
||
|
<p>The Create Job Description (CRTJOBD) command creates a job description object that contains a specific set of job-related attributes that can be used by one or more jobs. The attributes determine how each job is run on the system. The same job description can be used by multiple jobs. The values in the job description are usually used as the default values of the corresponding parameters in the Batch Job (BCHJOB) and Submit Job (SBMJOB) commands when their parameters are not specified.
|
||
|
</p>
|
||
|
<p>The values in the job description can be overridden by the values specified on the BCHJOB and SBMJOB commands.
|
||
|
</p>
|
||
|
<p><b>Restrictions:</b>
|
||
|
</p>
|
||
|
<ol>
|
||
|
<li>To use this command, you must have:
|
||
|
<ul>
|
||
|
<li>read (*READ) and add (*ADD) authority to the library where the job description is to be created.
|
||
|
</li>
|
||
|
<li>use (*USE) authority to the user profile specified on the <b>User (USER)</b> parameter.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</li>
|
||
|
<li>To create a job description with an accounting code other than *USRPRF, you must have *USE authority to the Change Accounting Code (CHGACGCDE) command.
|
||
|
</li>
|
||
|
</ol>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
|
||
|
<div>
|
||
|
<h3><a name="CRTJOBD.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="#CRTJOBD.JOBD"><b>JOBD</b></a></td>
|
||
|
<td valign="top">Job 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: 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>*CURLIB</u></b></td>
|
||
|
</tr><tr>
|
||
|
<td valign="top" rowspan="3"><a href="#CRTJOBD.JOBQ"><b>JOBQ</b></a></td>
|
||
|
<td valign="top">Job queue</td>
|
||
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
<td valign="top" rowspan="3">Optional, Positional 3</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Qualifier 1: Job queue</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>QBATCH</u></b></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="#CRTJOBD.JOBPTY"><b>JOBPTY</b></a></td>
|
||
|
<td valign="top">Job priority (on JOBQ)</td>
|
||
|
<td valign="top">1-9, <b><u>5</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.OUTPTY"><b>OUTPTY</b></a></td>
|
||
|
<td valign="top">Output priority (on OUTQ)</td>
|
||
|
<td valign="top">1-9, <b><u>5</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.PRTDEV"><b>PRTDEV</b></a></td>
|
||
|
<td valign="top">Print device</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*USRPRF</u></b>, *SYSVAL, *WRKSTN</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="3"><a href="#CRTJOBD.OUTQ"><b>OUTQ</b></a></td>
|
||
|
<td valign="top">Output queue</td>
|
||
|
<td valign="top">Single values: <b><u>*USRPRF</u></b>, *DEV, *WRKSTN<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="#CRTJOBD.TEXT"><b>TEXT</b></a></td>
|
||
|
<td valign="top">Text 'description'</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.USER"><b>USER</b></a></td>
|
||
|
<td valign="top">User</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*RQD</u></b></td>
|
||
|
<td valign="top">Optional, Positional 2</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.ACGCDE"><b>ACGCDE</b></a></td>
|
||
|
<td valign="top">Accounting code</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*USRPRF</u></b>, *BLANK</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.PRTTXT"><b>PRTTXT</b></a></td>
|
||
|
<td valign="top">Print text</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*SYSVAL</u></b>, *BLANK</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.RTGDTA"><b>RTGDTA</b></a></td>
|
||
|
<td valign="top">Routing data</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>QCMDI</u></b>, *RQSDTA</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.RQSDTA"><b>RQSDTA</b></a></td>
|
||
|
<td valign="top">Request data or command</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *RTGDTA</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.INLLIBL"><b>INLLIBL</b></a></td>
|
||
|
<td valign="top">Initial library list</td>
|
||
|
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *NONE<br>Other values (up to 250 repetitions): <i>Name</i></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.INLASPGRP"><b>INLASPGRP</b></a></td>
|
||
|
<td valign="top">Initial ASP group</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="4"><a href="#CRTJOBD.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>4</u></b></td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 2: Severity</td>
|
||
|
<td valign="top">
|
||
|
0-99, <b><u>0</u></b></td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Element 3: Text</td>
|
||
|
<td valign="top">
|
||
|
<b><u>*NOLIST</u></b>, *MSG, *SECLVL</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.LOGCLPGM"><b>LOGCLPGM</b></a></td>
|
||
|
<td valign="top">Log CL program commands</td>
|
||
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.LOGOUTPUT"><b>LOGOUTPUT</b></a></td>
|
||
|
<td valign="top">Job log output</td>
|
||
|
<td valign="top"><b><u>*SYSVAL</u></b>, *JOBLOGSVR, *JOBEND, *PND</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.JOBMSGQMX"><b>JOBMSGQMX</b></a></td>
|
||
|
<td valign="top">Job message queue maximum size</td>
|
||
|
<td valign="top">2-64, <b><u>*SYSVAL</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.JOBMSGQFL"><b>JOBMSGQFL</b></a></td>
|
||
|
<td valign="top">Job message queue full action</td>
|
||
|
<td valign="top"><b><u>*SYSVAL</u></b>, *NOWRAP, *WRAP, *PRTWRAP</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.SYNTAX"><b>SYNTAX</b></a></td>
|
||
|
<td valign="top">CL syntax check</td>
|
||
|
<td valign="top">0-99, <b><u>*NOCHK</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.ENDSEV"><b>ENDSEV</b></a></td>
|
||
|
<td valign="top">End severity</td>
|
||
|
<td valign="top">0-99, <b><u>30</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.INQMSGRPY"><b>INQMSGRPY</b></a></td>
|
||
|
<td valign="top">Inquiry message reply</td>
|
||
|
<td valign="top"><b><u>*RQD</u></b>, *DFT, *SYSRPYL</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.HOLD"><b>HOLD</b></a></td>
|
||
|
<td valign="top">Hold on job queue</td>
|
||
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.DATE"><b>DATE</b></a></td>
|
||
|
<td valign="top">Job date</td>
|
||
|
<td valign="top"><i>Date</i>, <b><u>*SYSVAL</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.SWS"><b>SWS</b></a></td>
|
||
|
<td valign="top">Job switches</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>00000000</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.DEVRCYACN"><b>DEVRCYACN</b></a></td>
|
||
|
<td valign="top">Device recovery action</td>
|
||
|
<td valign="top"><b><u>*SYSVAL</u></b>, *MSG, *DSCMSG, *DSCENDRQS, *ENDJOB, *ENDJOBNOLIST</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.TSEPOOL"><b>TSEPOOL</b></a></td>
|
||
|
<td valign="top">Time slice end pool</td>
|
||
|
<td valign="top"><b><u>*SYSVAL</u></b>, *NONE, *BASE</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.AUT"><b>AUT</b></a></td>
|
||
|
<td valign="top">Authority</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.ALWMLTTHD"><b>ALWMLTTHD</b></a></td>
|
||
|
<td valign="top">Allow multiple threads</td>
|
||
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.SPLFACN"><b>SPLFACN</b></a></td>
|
||
|
<td valign="top">Spooled file action</td>
|
||
|
<td valign="top"><b><u>*SYSVAL</u></b>, *KEEP, *DETACH</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#CRTJOBD.DDMCNV"><b>DDMCNV</b></a></td>
|
||
|
<td valign="top">DDM conversation</td>
|
||
|
<td valign="top"><b><u>*KEEP</u></b>, *DROP</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<div> <a name="CRTJOBD.JOBD"></a>
|
||
|
<h3>Job description (JOBD)</h3>
|
||
|
<p>Specifies the name and library of the job description being created.
|
||
|
</p>
|
||
|
<p>This is a required parameter.
|
||
|
</p>
|
||
|
<p><b>Qualifier 1: Job description</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the job description.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Qualifier 2: Library</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*CURLIB</u></b></dt>
|
||
|
<dd>The current library for the thread is used to locate the object. If no current library entry exists in the thread's library list, the library QGPL is used.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the library where the object is located.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.JOBQ"></a>
|
||
|
<h3>Job queue (JOBQ)</h3>
|
||
|
<p>Specifies the name and library of the default job queue where jobs submitted using this job description are placed.
|
||
|
</p>
|
||
|
<p><b>Qualifier 1: Job queue</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>QBATCH</u></b></dt>
|
||
|
<dd>The QBATCH job queue is the queue where the jobs are placed.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of the job queue.
|
||
|
</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 queue is located.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p>
|
||
|
<b>Note: </b>If the job queue does not exist when the job description is created, a library qualifier must be specified because the name of the qualified job queue is kept in the job description.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.JOBPTY"></a>
|
||
|
<h3>Job priority (on JOBQ) (JOBPTY)</h3>
|
||
|
<p>Specifies the job queue scheduling priority used for jobs that use this job description. The highest priority is 1 and the lowest priority is 9.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>5</u></b></dt>
|
||
|
<dd>The scheduling priority for any job using this job description is 5.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>1-9</i></b></dt>
|
||
|
<dd>Specify the scheduling priority of jobs that use this job description.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.OUTPTY"></a>
|
||
|
<h3>Output priority (on OUTQ) (OUTPTY)</h3>
|
||
|
<p>Specifies the output priority of spooled output files produced by jobs that use this job description. The highest priority is 1 and the lowest priority is 9.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>5</u></b></dt>
|
||
|
<dd>The output priority for spooled files produced using this job description is 5.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>1-9</i></b></dt>
|
||
|
<dd>Specify a value ranging from 1 through 9 for the output priority of the spooled output files that are produced by jobs that use this job description. The highest priority is 1 and the lowest priority is 9.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.PRTDEV"></a>
|
||
|
<h3>Print device (PRTDEV)</h3>
|
||
|
<p>Specifies the qualified name of the default printer device for this job. If the printer file being used to create the output specifies to spool the file, the spooled file is placed on the device's output queue, which is named the same as the device.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>This assumes the defaults are specified on the <b>Output queue (OUTQ)</b> parameter for the printer file, job description, user profile and workstation.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*USRPRF</u></b></dt>
|
||
|
<dd>The printer device name for jobs that use this job description is taken from the user profile associated with the job at the time the job is started.
|
||
|
</dd>
|
||
|
<dt><b>*SYSVAL</b></dt>
|
||
|
<dd>The value in the system value QPRTDEV at the time the job is started is used as the printer device.
|
||
|
</dd>
|
||
|
<dt><b>*WRKSTN</b></dt>
|
||
|
<dd>The printer device used with this job description is the printer device assigned to the work station that is associated with the job at the time the job is started.
|
||
|
</dd>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the printer device to be used by jobs that use this job description.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.OUTQ"></a>
|
||
|
<h3>Output queue (OUTQ)</h3>
|
||
|
<p>Specifies the name and library of the output queue used as the default output queue for jobs that use this job description. This parameter applies only to spooled printer files that specify *JOB for the output queue.
|
||
|
</p>
|
||
|
<p><b>Single values</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*USRPRF</u></b></dt>
|
||
|
<dd>The output queue for jobs using this job description is obtained from the user profile associated with the job at the time the job is started.
|
||
|
</dd>
|
||
|
<dt><b>*DEV</b></dt>
|
||
|
<dd>The output queue associated with the printer specified on the <b>Device (DEV)</b> parameter of the printer file is used. The output queue has the same name as the printer. The printer file DEV parameter is determined by the Create Printer File (CRTPRTF), Change Printer File (CHGPRTF), or the Override with Printer File (OVRPRTF) commands.
|
||
|
<p>
|
||
|
<b>Note: </b>This assumes the defaults were specified on the OUTQ parameter for the printer file, job description, user profile, and workstation.
|
||
|
</p>
|
||
|
</dd>
|
||
|
<dt><b>*WRKSTN</b></dt>
|
||
|
<dd>The output queue to be used with this job description is the output queue assigned to the work station that is associated with the job at the time the job is started.
|
||
|
</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 with this job description
|
||
|
</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 output queue is located.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p>
|
||
|
<b>Note: </b>If the output queue does not exist when the job description is created, a library qualifier must be specified because the qualified output queue name is kept in the job description.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.TEXT"></a>
|
||
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
<p>Specifies the text that briefly describes the object.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
<dd>No text is specified.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.USER"></a>
|
||
|
<h3>User (USER)</h3>
|
||
|
<p>Specifies the name of the user profile associated with this job description. The names QSECOFR, QSPL, QDOC, QDBSHR, QRJE, QSYS, QLPAUTO, QLPINSTALL, QTSTRQS, and QDFTOWN are not valid entries for this parameter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*RQD</u></b></dt>
|
||
|
<dd>A user name is required to use the job description. For work station entries, you must enter a user name when signing on at the work station; the associated user name becomes the name used for the job. *RQD is not valid for job descriptions specified for autostart job entries or for those used by the Batch Job (BCHJOB) command. It is valid on the Submit Job (SBMJOB) command only if *CURRENT is specified on the <b>User (USER)</b> parameter.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the user name that identifies the user profile associated with batch jobs using this job description. For interactive jobs, this is the default user name used to sign on the system without typing a user name.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.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. If the job is submitted by the Submit Job (SBMJOB) command, the submitter's accounting code is used. To specify an accounting code other than *USRPRF, you must be authorized to the Change Accounting Code (CHGACGCDE) command.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*USRPRF</u></b></dt>
|
||
|
<dd>The accounting code for jobs using this job description is obtained from the user profile associated with the job.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*BLANK</b></dt>
|
||
|
<dd>An accounting code of 15 blanks is assigned to jobs that use this job description.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specify the accounting code for jobs that use this job description and have accounting statistics logged in the system accounting journal QACGJRN. If less than 15 characters are entered, the string is padded with blanks on the right.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.PRTTXT"></a>
|
||
|
<h3>Print text (PRTTXT)</h3>
|
||
|
<p>Specifies the printing of a line of text at the bottom of each page.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The value in the system value QPRTTXT is used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<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.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.RTGDTA"></a>
|
||
|
<h3>Routing data (RTGDTA)</h3>
|
||
|
<p>Specifies the routing data used with this job description to start jobs.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>QCMDI</u></b></dt>
|
||
|
<dd>The default routing data QCMDI is used by the IBM-supplied interactive subsystem to route the job to the IBM-supplied control language processor QCMD in the QSYS library.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*RQSDTA</b></dt>
|
||
|
<dd>Up to the first 80 characters of the request data specified on the <b>Request data or command (RQSDTA)</b> parameter are used as the routing data for the job.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specify the routing data for jobs that use this job description. A maximum of 80 characters can be typed (enclosed in apostrophes if necessary).
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.RQSDTA"></a>
|
||
|
<h3>Request data or command (RQSDTA)</h3>
|
||
|
<p>Specifies the request data that is placed as the last entry in the job's message queue for jobs using this job description.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
<dd>No request data is placed in the job's message queue.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*RTGDTA</b></dt>
|
||
|
<dd>The routing data specified on the <b>Routing data (RTGDTA)</b> parameter is placed as the last entry in the job's message queue.
|
||
|
</dd>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specify the character string that is placed as the last entry in the job's message queue as a single request. A maximum of 256 characters can be entered (enclosed in apostrophes if necessary). When a CL command is entered, it must be enclosed in single apostrophes, and where apostrophes would normally be used <b>inside</b> the command, double apostrophes must be used instead.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.INLLIBL"></a>
|
||
|
<h3>Initial library list (INLLIBL)</h3>
|
||
|
<p>Specifies the initial user part of the library list to be used for jobs using this job description.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>Duplication of library names in the library list is not allowed.
|
||
|
</p>
|
||
|
<p><b>Single values</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The system default library list is used for jobs that use this job description. The default library list contains the library names that were specified in the system value QUSRLIBL at the time a job using this job description is started.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*NONE</b></dt>
|
||
|
<dd>The user part of the library list is empty; only the system portion is used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Other values (up to 250 repetitions)</b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the library in the user part of the library list to be used for jobs using this job description.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p>
|
||
|
<b>Note: </b>Libraries are searched in the same order as they are listed here.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.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 jobs using this job description. 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>
|
||
|
<p><b>Restrictions: </b>
|
||
|
</p>
|
||
|
<ol>
|
||
|
<li>The job descriptions QGPL/QDFTJOBD and QGPL/QDFTSVR cannot be changed to specify the name of an ASP group. For these job descriptions, the INLASPGRP must be *NONE.
|
||
|
</li>
|
||
|
</ol>
|
||
|
<dl>
|
||
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
<dd>Specifies the initial thread of jobs using this job description 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>Specifies the name of the ASP group to be set for the initial thread of jobs using this job description. 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="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.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.
|
||
|
</p>
|
||
|
<p><b>Element 1: Level </b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>4</u></b></dt>
|
||
|
<dd>A message logging level of 4 is used for jobs that use this job description.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>0-4</i></b></dt>
|
||
|
<dd>Specify the message logging level to be used for the job's messages.
|
||
|
<dl>
|
||
|
<dt><b>0</b></dt>
|
||
|
<dd>No messages are logged.
|
||
|
</dd>
|
||
|
<dt><b>1</b></dt>
|
||
|
<dd>All messages sent to the job's external message queue with a severity greater than or equal to the message logging severity are logged. 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>Request messages which result in a high-level message with a severity code greater than or equal to the message logging severity. Both the request message and all associated messages are logged.
|
||
|
</li>
|
||
|
</ul>
|
||
|
<p>
|
||
|
<b>Note: </b>A high-level message is one that is sent to the program message queue of the program that receives the request message. For example, QCMD is an IBM-supplied request processing program that receives request messages.
|
||
|
</p>
|
||
|
</dd>
|
||
|
<dt><b>3</b></dt>
|
||
|
<dd>The following information is logged:
|
||
|
<ul>
|
||
|
<li>Logging level 1 and 2 information
|
||
|
</li>
|
||
|
<li>All request messages
|
||
|
</li>
|
||
|
<li>Commands run by a CL program are logged if it is allowed by the logging of CL programs job attribute and the log attribute of the CL program.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</dd>
|
||
|
<dt><b>4</b></dt>
|
||
|
<dd>The following information is logged:
|
||
|
<ul>
|
||
|
<li>All request messages and all messages with a severity greater than or equal to the message logging severity, including trace messages.
|
||
|
</li>
|
||
|
<li>Commands run by a CL program are logged if it is allowed by the logging of CL programs job attribute and the log attribute of the CL program.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 2: Severity </b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>0</u></b></dt>
|
||
|
<dd>A message severity level of 0 is used for jobs that use this job description.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>0-99</i></b></dt>
|
||
|
<dd>Specify the message severity level to be used in conjunction with the logging level to determine which error messages are logged in the job log.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p><b>Element 3: Text </b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*NOLIST</u></b></dt>
|
||
|
<dd>If the job ends normally, no job log is produced. If the job ends abnormally (if the job end code is 20 or higher), a job log is produced. The messages that appear in the job log contain both the message text and the message help.
|
||
|
</dd>
|
||
|
<dt><b>*MSG</b></dt>
|
||
|
<dd>Only the message text is written to the job log.
|
||
|
</dd>
|
||
|
<dt><b>*SECLVL</b></dt>
|
||
|
<dd>Both the message text and the message help (cause and recovery) of the error message are written to the job log.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.LOGCLPGM"></a>
|
||
|
<h3>Log CL program commands (LOGCLPGM)</h3>
|
||
|
<p>Specifies whether the commands that can be logged and were 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 *NO is specified, the logging flag status is <b>off</b> and CL commands are not logged. If *YES is specified here and *JOB is specified on the <b>Message logging (LOG)</b> parameter of the Create CL Program (CRTCLPGM) command, all commands in the CL program that can be logged are logged to the job log.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*NO</u></b></dt>
|
||
|
<dd>The commands in a CL program are not logged to the job log.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*YES</b></dt>
|
||
|
<dd>The commands in a CL program are logged to the job log.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.LOGOUTPUT"></a>
|
||
|
<h3>Job log output (LOGOUTPUT)</h3>
|
||
|
<p>Specifies how the job log will be produced when the job completes. This does not affect job logs produced when the message queue is full and the job message queue full action specifies *PRTWRAP. Messages in the job message queue are written to a spooled file, from which the job log can be printed, unless the Control Job Log Output (QMHCTLJL) API was used in the job to specify that the messages in the job log are to be written to a database file.
|
||
|
</p>
|
||
|
<p>The job log output value can be changed at any time until the job log has been produced or removed. To change the job log output value for a job, use the Change Job (QWTCHGJB) API or the Change Job (CHGJOB) command.
|
||
|
</p>
|
||
|
<p>The job log can be displayed at any time until the job log has been produced or removed. To display the job log, use the Display Job Log (DSPJOBLOG) command.
|
||
|
</p>
|
||
|
<p>The job log can be removed when the job has completed and the job log has not yet been produced or removed. To remove the job log, use the Remove Pending Job Log (QWTRMVJL) API or the End Job (ENDJOB) command.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The value specified in the system value QLOGOUTPUT is used.
|
||
|
</dd>
|
||
|
<dt><b>*JOBLOGSVR</b></dt>
|
||
|
<dd>The job log will be produced by a job log server. For more information about job log servers, refer to the Start Job Log Server (STRLOGSVR) command.
|
||
|
</dd>
|
||
|
<dt><b>*JOBEND</b></dt>
|
||
|
<dd>The job log will be produced by the job itself. If the job cannot produce its own job log, the job log will be produced by a job log server. For example, a job does not produce its own job log when the system is processing a Power Down System (PWRDWNSYS) command.
|
||
|
</dd>
|
||
|
<dt><b>*PND</b></dt>
|
||
|
<dd>The job log will not be produced. The job log remains pending until removed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.JOBMSGQMX"></a>
|
||
|
<h3>Job message queue maximum size (JOBMSGQMX)</h3>
|
||
|
<p>Specifies the maximum size of the job message queue.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The value in QJOBMSGQMX (system value) at the time the job is started is used as the maximum size of the job message queue.
|
||
|
</dd>
|
||
|
<dt><b><i>2-64</i></b></dt>
|
||
|
<dd>Specify the maximum size, in megabytes, of the job message queue.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.JOBMSGQFL"></a>
|
||
|
<h3>Job message queue full action (JOBMSGQFL)</h3>
|
||
|
<p>Specifies the action that should be taken when the job message queue is full.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The value specified for the QJOBMSGQFL system value is used.
|
||
|
</dd>
|
||
|
<dt><b>*NOWRAP</b></dt>
|
||
|
<dd>The message queue does not wrap when it is full. This action ends the job.
|
||
|
</dd>
|
||
|
<dt><b>*WRAP</b></dt>
|
||
|
<dd>The message queue wraps to the start of the message queue when it is full and starts filling the message queue again.
|
||
|
</dd>
|
||
|
<dt><b>*PRTWRAP</b></dt>
|
||
|
<dd>The message queue wraps the job message queue when it is full and prints the messages that are being overlaid because of wrapping.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.SYNTAX"></a>
|
||
|
<h3>CL syntax check (SYNTAX)</h3>
|
||
|
<p>Specifies whether requests placed on the job message queue (for jobs using this job description) are checked for syntax as CL commands. When syntax checking is specified, the commands are checked for syntax as they are submitted instead of when the job is run, thus providing an earlier diagnosis of syntax errors. If checking is specified, the message severity that causes a syntax error to end processing of a job is also specified.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*NOCHK</u></b></dt>
|
||
|
<dd>The request data is not checked for syntax as CL commands.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>0-99</i></b></dt>
|
||
|
<dd>Specify the lowest message severity that can cause running of a job to end. The request data is checked for syntax as CL commands. If a syntax error occurs that is equal to or greater than the error message severity specified here, the running of the job containing the erroneous command is suppressed.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.ENDSEV"></a>
|
||
|
<h3>End severity (ENDSEV)</h3>
|
||
|
<p>Specifies the message severity level of escape messages that can cause a batch job to be ended. The batch job is ended when a request in the batch input stream results in an escape message whose severity code is equal to or greater than that specified here being sent to the request processing program QCMD or QCL. This parameter value is compared with the severity of any escape message not monitored that occurs as a result of running a noncompiled CL command in a batch job.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>30</u></b></dt>
|
||
|
<dd>A batch input stream request that results in an escape message whose severity is equal to or greater than 30 causes the job to end.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>0-99</i></b></dt>
|
||
|
<dd>Specify the message severity of an escape message that results from a request in the batch input stream and that causes the jobs that use this job description to be ended. Because escape messages typically have a maximum severity level of 50, a value of 50 or lower must be specified in order for a job to be ended as a result of an escape message. An unhandled escape message whose severity is equal to or greater than the value specified causes the job to be ended.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.INQMSGRPY"></a>
|
||
|
<h3>Inquiry message reply (INQMSGRPY)</h3>
|
||
|
<p>Specifies the way that inquiry messages are answered for jobs that use this job description. You can specify that inquiry messages are to be answered in the usual manner, that a default reply be issued, or that if certain conditions are met, an answer is issued to the inquiry based on those conditions. The conditions met are listed in the system reply list entries of the Add Reply List Entry (ADDRPYLE) command.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*RQD</u></b></dt>
|
||
|
<dd>A reply is required for any predefined inquiry message that is issued by a job that uses this job description.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*DFT</b></dt>
|
||
|
<dd>The default message reply is used to answer any predefined inquiry messages issued during running of a job that uses this job description. The default reply is either defined in the message description or is the default system reply.
|
||
|
</dd>
|
||
|
<dt><b>*SYSRPYL</b></dt>
|
||
|
<dd>The system reply list is checked to determine whether an entry matches the message identifier and optional compare value for any inquiry message issued by a job that uses this job description. If a match occurs, the reply value in that reply list 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="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.HOLD"></a>
|
||
|
<h3>Hold on job queue (HOLD)</h3>
|
||
|
<p>Specifies whether jobs using this job description are put on the job queue in the hold condition. A job placed on the job queue in the hold condition is held until it is released by the Release Job (RLSJOB) command, or it is ended, either by the End Job (ENDJOB) command or by the Clear Job Queue (CLRJOBQ) command.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*NO</u></b></dt>
|
||
|
<dd>Jobs that use this job description are not held when they are put on the job queue.
|
||
|
</dd>
|
||
|
<dt><b>*YES</b></dt>
|
||
|
<dd>Jobs that use this job description are held when they are put on the job queue.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.DATE"></a>
|
||
|
<h3>Job date (DATE)</h3>
|
||
|
<p>Specifies the date that is assigned to the job that uses this job description when the job is started.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The value in the QDATE system value at the time the job is started is used as the job date.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>date</i></b></dt>
|
||
|
<dd>Specify the job date for the job being started. The format currently specified for the DATFMT job attribute must be used.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.SWS"></a>
|
||
|
<h3>Job switches (SWS)</h3>
|
||
|
<p>Specifies the initial switch settings for a group of eight job switches used for jobs that use this job description. These switches can be set or tested in a CL program and used to control the flow of the program. The only values that are valid for each single-digit switch are 0 (off) or 1 (on).
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>00000000</u></b></dt>
|
||
|
<dd>The first setting for the job switches is all zeros for jobs that use this job description.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>character-value</i></b></dt>
|
||
|
<dd>Specify any combination (enclosed in apostrophes if necessary) of eight 0's or 1's to change the job switch settings.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.DEVRCYACN"></a>
|
||
|
<h3>Device recovery action (DEVRCYACN)</h3>
|
||
|
<p>Specifies the recovery action to take for the job when an I/O error is encountered on the *REQUESTOR device for interactive jobs that use this job description. This attribute is ignored for non-interactive jobs.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The value in the system value QDEVRCYACN at the time the job is started is to be used as the device recovery action for this job description.
|
||
|
</dd>
|
||
|
<dt><b>*MSG</b></dt>
|
||
|
<dd>The application program requesting the I/O operation receives an error message indicating the operation has failed.
|
||
|
</dd>
|
||
|
<dt><b>*DSCMSG</b></dt>
|
||
|
<dd>The job is automatically disconnected. Once the job has reconnected, it receives an error message indicating an I/O error has occurred and the device has been recovered. Even though the device has been recovered, the contents of the screen prior to the error must be displayed again.
|
||
|
</dd>
|
||
|
<dt><b>*DSCENDRQS</b></dt>
|
||
|
<dd>The job is automatically disconnected. Once the job has reconnected, the End Request (ENDRQS) command will be issued specifying the processor that made the previous request. If there is no request processor, an error message will be issued.
|
||
|
</dd>
|
||
|
<dt><b>*ENDJOB</b></dt>
|
||
|
<dd>The job is ended with the *IMMED option. A job log is produced for the job.
|
||
|
</dd>
|
||
|
<dt><b>*ENDJOBNOLIST</b></dt>
|
||
|
<dd>The job is ended with the *IMMED option. No job log is produced for the job.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.TSEPOOL"></a>
|
||
|
<h3>Time slice end pool (TSEPOOL)</h3>
|
||
|
<p>Specifies whether interactive jobs are moved to another main storage pool when they reach the end of the time slice. The job is moved back to the pool in which it was originally running when a long wait occurs. This may help minimize the effect on interactive response time of other interactive jobs.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The value of the system value QTSEPOOL at the time the job is started is to be used as the time slice end pool action for this job description.
|
||
|
</dd>
|
||
|
<dt><b>*NONE</b></dt>
|
||
|
<dd>The job is not moved when the end of the time slice is reached.
|
||
|
</dd>
|
||
|
<dt><b>*BASE</b></dt>
|
||
|
<dd>The job is moved to the base pool when the end of the time slice is reached.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.AUT"></a>
|
||
|
<h3>Authority (AUT)</h3>
|
||
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
||
|
<dd>The authority to the object is the same as the value specified on the <b>Create authority (CRTAUT)</b> parameter of the library in which the object is being created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*CHANGE</b></dt>
|
||
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*ALL</b></dt>
|
||
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*USE</b></dt>
|
||
|
<dd>The user can perform basic operations on the object, such as displaying its contents. The user cannot change the object. *USE authority provides object operational authority, read authority, and execute authority.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
<dd>The user cannot access the object.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<dl>
|
||
|
<dt><b><i>name</i></b></dt>
|
||
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.ALWMLTTHD"></a>
|
||
|
<h3>Allow multiple threads (ALWMLTTHD)</h3>
|
||
|
<p>Specifies whether or not the job can run with multiple user threads. This attribute does not prevent the operating system from creating system threads in the job. This job attribute is not allowed to be changed once a job starts. This attribute applies to autostart jobs, prestart jobs, batch jobs submitted from job schedule entries and jobs started using the Submit Job (SBMJOB) and Batch Job (BCHJOB) commands. This attribute is ignored when starting all other types of jobs. This attribute should be set to *YES only in job descriptions used exclusively with functions that create multiple user threads.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*NO</u></b></dt>
|
||
|
<dd>The job cannot run with multiple user threads.
|
||
|
</dd>
|
||
|
<dt><b>*YES</b></dt>
|
||
|
<dd>The job can run with multiple user threads.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.SPLFACN"></a>
|
||
|
<h3>Spooled file action (SPLFACN)</h3>
|
||
|
<p>Specifies whether or not spooled files are accessed through job interfaces after the job ends. Keeping spooled files with jobs allows job commands such as the Work with Submitted Jobs (WRKSBMJOB) command to work with the spooled files even after the job has ended. Detaching spooled files from jobs reduces the use of system resources by allowing job structures to be recycled when the jobs end.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
<dd>The value specified in the system value QSPLFACN is used.
|
||
|
</dd>
|
||
|
<dt><b>*KEEP</b></dt>
|
||
|
<dd>When the job ends, as long as at least one spooled file for the job exists in the system auxiliary storage pool (ASP 1) or in a basic user ASP (ASPs 2-32), the spooled files are kept with the job and the status of the job is updated to indicate that the job has completed. When all remaining spooled files for the job are in independent ASPs (ASPs 33-255), the spooled files will be detached from the job and the job will be removed from the system.
|
||
|
</dd>
|
||
|
<dt><b>*DETACH</b></dt>
|
||
|
<dd>When the job ends, the spooled files are detached from the job and the job is removed from the system.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="CRTJOBD.DDMCNV"></a>
|
||
|
<h3>DDM conversation (DDMCNV)</h3>
|
||
|
<p>Specifies whether the connections using distributed data management (DDM) protocols remain active when they are not being used. The connections include APPC conversations, active TCP/IP conversations or OptiConnect connections. The DDM protocols are used in Distributed Relational Database Architecture (DRDA) applications, DDM applications, or DB2 Multisystem applications. For more information on distributed data management, see the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b><u>*KEEP</u></b></dt>
|
||
|
<dd>The system keeps DDM conversation connections active when they are no longer being used, except when:
|
||
|
<ul>
|
||
|
<li>The routing step ends on the source system.
|
||
|
</li>
|
||
|
<li>There is an explicit request that conversations be disconnected, using the Reclaim DDM Conversations (RCLDDMCNV) command or the Reclaim Resources (RCLRSC) command.
|
||
|
</li>
|
||
|
<li>There is a communications failure or internal failure.
|
||
|
</li>
|
||
|
<li>A DRDA connection to an application server not running on the iSeries ends.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</dd>
|
||
|
<dt><b>*DROP</b></dt>
|
||
|
<dd>The system ends a DDM-allocated conversation when it is no longer being used. Examples include when an application closes a DDM file, or when a DRDA application runs an SQL DISCONNECT statement.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="CRTJOBD.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
<p><b>Example 1: Creating a Job Description for Interactive Jobs</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
CRTJOBD JOBD(INT4) USER(*RQD) RTGDTA(QCMDI)
|
||
|
INQMSGRPY(*SYSRPYL)
|
||
|
TEXT('Interactive #4 JOBD for Department 127')
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command creates a job description named INT4 in the user's current library. This job description is for interactive jobs and is used by Department 127. When you sign on, you must type your password. The characters QCMDI are used as routing data that is compared with the routing table of the subsystem where the job is run. All inquiry messages are compared to the entries in the system reply list to determine whether a reply is issued automatically.
|
||
|
</p>
|
||
|
<p><b>Example 2: Creating a Job Description for Jobs on a Specified Queue</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
CRTJOBD JOBD(BATCH3) USER(*RQD) JOBQ(NIGHTQ) JOBPTY(4)
|
||
|
OUTPTY(4) ACGCDE(NIGHTQ012345) RTGDTA(QCMDB)
|
||
|
TEXT('Batch #3 JOBD for high priority night work')
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command creates a job description named BATCH3 in the user's current library. The jobs using this description are placed on the job queue NIGHTQ. The priority for jobs using this description and their spooled output is 4. QCMDB is the routing data that is compared with entries in the routing table of the subsystem where the job runs. The accounting code of NIGHTQ012345 is used when recording accounting statistics for jobs that use this job description.
|
||
|
</p>
|
||
|
<p><b>Example 3: Specifying Request Data</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
<pre>
|
||
|
CRTJOBD JOBD(PAYWK) USER(QPGMR) RTGDTA(QCMDB)
|
||
|
RQSDTA('CALL PAY025 PARM(WEEKLY UNION)')
|
||
|
</pre>
|
||
|
</p>
|
||
|
<p>This command creates a job description named PAYWK in the user's current library. Jobs using this job description run under the IBM-supplied user profile for the programmer, QPGMR, and use the accounting code found in that user profile. If the job is started via the SBMJOB command, the accounting code of the person submitting the command is automatically used. The routing data QCMDB is compared with entries in the routing table of the subsystem where the job is run. The request data passed to the command processing program is a CALL command that names the application program that is run and passes a parameter to it.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="CRTJOBD.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>CPF1621</b></dt>
|
||
|
<dd>Job description &1 not created in library &2.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#CRTJOBD.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</body>
|
||
|
</html>
|