1061 lines
44 KiB
HTML
1061 lines
44 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>Batch Job (BCHJOB)</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="BCHJOB.Top_Of_Page"></a>
|
||
|
|
<h2>Batch Job (BCHJOB)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>
|
||
|
|
<ul><li>Batch job (*BATCH)</li>
|
||
|
|
</ul><b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#BCHJOB.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#BCHJOB.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#BCHJOB.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="BCHJOB"></a>
|
||
|
|
<p>The Batch Job (BCHJOB) command indicates the beginning of a batch job in a batch input stream. It can also specify different values for the attributes for the job instead of the ones specified in the job description or user profile for this job. The values contained in the job description or in the user profile named in that job description are used for most parameters not coded in the BCHJOB command.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<p>The user that issues the Start Data Base Reader (STRDBRDR), Submit Data Base Jobs (SBMDBJOB), Start Diskette Reader (STRDKTRDR), or Submit Diskette Jobs (SBMDKTJOB) command is considered the user issuing the the BCHJOB command.
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>To use this command, the user that issues the BCHJOB command must have:
|
||
|
|
<ul>
|
||
|
|
<li>use (*USE) authority to the job description (JOBD) and execute (*EXECUTE) authority to the library that contains that job description.
|
||
|
|
</li>
|
||
|
|
<li>use (*USE) authority to the job queue (JOBQ) and execute (*EXECUTE) authority to the library that contains that job queue.
|
||
|
|
</li>
|
||
|
|
<li>use (*USE) authority to all libraries specified for the system value QSYSLIBL, the <b>Current library (CURLIB)</b> parameter, and the <b>Initial library list (INLLIBL)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li>use (*USE) and add (*ADD) authority to the message queue (MSGQ) and execute (*EXECUTE) authority to the library. that contains that message queue.
|
||
|
|
</li>
|
||
|
|
<li>use (*USE) authority to the user profile in the job description.
|
||
|
|
</li>
|
||
|
|
<li>execute (*EXECUTE) authority to all of the device descriptions in the auxiliary storage pool (ASP) group of the job's name space.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>The user specified in the job description of the submitted job must have:
|
||
|
|
<ul>
|
||
|
|
<li>use (*USE) authority to the job description (JOBD).
|
||
|
|
</li>
|
||
|
|
<li>read (*READ) authority to the output queue (OUTQ) and execute (*EXECUTE) authority to the library that contains that output queue.
|
||
|
|
</li>
|
||
|
|
<li>use (*USE) authority to all libraries specified for the system value QSYSLIBL, the <b>Current library (CURLIB)</b> parameter, and the <b>Initial library list (INLLIBL)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li>use (*USE) authority to the sort sequence table (SRTSEQ) and execute (*EXECUTE) authority to the library that contains that sort sequence table.
|
||
|
|
</li>
|
||
|
|
<li>use (*USE) authority to all of the device descriptions in the <b>Initial ASP group (INLASPGRP)</b> of the job description.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>The BCHJOB command cannot be used from a work station.
|
||
|
|
</li>
|
||
|
|
<li>Two slashes must precede this command name when entering it in the data record: //BCHJOB or // BCHJOB. (The user can separate the slashes from the command name with blank spaces).
|
||
|
|
</li>
|
||
|
|
<li>The current value of the auxiliary storage pool (ASP) group for the thread issuing the Submit Data Base Jobs (SBMDBJOB) or Submit Diskette Jobs (SBMDKTJOB) command is used for the initial ASP group parameter of the submitted batch job. Similarly, the current value of the ASP group for the thread issuing the Start Data Base Reader (STRDBRDR) or Start Diskette Reader (STRDKTRDR) command is used for the initial ASP group parameter of the spool reader job and is used for the initial ASP group parameter of the submitted batch job. The initial ASP group value in the job description is ignored. The processing of the BCHJOB command and the processing of spool reader functions such as syntax checking must operate in the name space used by the batch job.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="BCHJOB.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"><a href="#BCHJOB.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*JOBD</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#BCHJOB.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">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Job description</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" rowspan="3"><a href="#BCHJOB.JOBQ"><b>JOBQ</b></a></td>
|
||
|
|
<td valign="top">Job queue</td>
|
||
|
|
<td valign="top">Single values: <b><u>*RDR</u></b>, *JOBD<br>Other values: <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></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="#BCHJOB.PRTDEV"><b>PRTDEV</b></a></td>
|
||
|
|
<td valign="top">Print device</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*USRPRF</u></b>, *SYSVAL, *JOBD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#BCHJOB.OUTQ"><b>OUTQ</b></a></td>
|
||
|
|
<td valign="top">Output queue</td>
|
||
|
|
<td valign="top">Single values: <b><u>*USRPRF</u></b>, *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="#BCHJOB.JOBPTY"><b>JOBPTY</b></a></td>
|
||
|
|
<td valign="top">Job priority (on JOBQ)</td>
|
||
|
|
<td valign="top">1-9, <b><u>*JOBD</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.OUTPTY"><b>OUTPTY</b></a></td>
|
||
|
|
<td valign="top">Output priority (on OUTQ)</td>
|
||
|
|
<td valign="top">1-9, <b><u>*JOBD</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.PRTTXT"><b>PRTTXT</b></a></td>
|
||
|
|
<td valign="top">Print text</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*JOBD</u></b>, *BLANK, *SYSVAL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.RTGDTA"><b>RTGDTA</b></a></td>
|
||
|
|
<td valign="top">Routing data</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>QCMDB</u></b>, *JOBD, *RQSDTA</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.RQSDTA"><b>RQSDTA</b></a></td>
|
||
|
|
<td valign="top">Request data or command</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*</u></b>, *JOBD, *NONE, *RTGDTA</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.SYNTAX"><b>SYNTAX</b></a></td>
|
||
|
|
<td valign="top">CL syntax check</td>
|
||
|
|
<td valign="top">0-99, <b><u>*JOBD</u></b>, *NOCHK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.CURLIB"><b>CURLIB</b></a></td>
|
||
|
|
<td valign="top">Current library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*USRPRF</u></b>, *CRTDFT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.INLLIBL"><b>INLLIBL</b></a></td>
|
||
|
|
<td valign="top">Initial library list</td>
|
||
|
|
<td valign="top">Single values: <b><u>*JOBD</u></b>, *SYSVAL, *NONE<br>Other values (up to 25 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.ENDSEV"><b>ENDSEV</b></a></td>
|
||
|
|
<td valign="top">End severity</td>
|
||
|
|
<td valign="top">0-99, <b><u>*JOBD</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#BCHJOB.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>*JOBD</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Severity</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99, <b><u>*JOBD</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Text</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*JOBD</u></b>, *MSG, *SECLVL, *NOLIST</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.LOGCLPGM"><b>LOGCLPGM</b></a></td>
|
||
|
|
<td valign="top">Log CL program commands</td>
|
||
|
|
<td valign="top"><b><u>*JOBD</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.INQMSGRPY"><b>INQMSGRPY</b></a></td>
|
||
|
|
<td valign="top">Inquiry message reply</td>
|
||
|
|
<td valign="top"><b><u>*JOBD</u></b>, *RQD, *DFT, *SYSRPYL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.HOLD"><b>HOLD</b></a></td>
|
||
|
|
<td valign="top">Hold on job queue</td>
|
||
|
|
<td valign="top"><b><u>*JOBD</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.DATE"><b>DATE</b></a></td>
|
||
|
|
<td valign="top">Job date</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*JOBD</u></b>, *SYSVAL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.SWS"><b>SWS</b></a></td>
|
||
|
|
<td valign="top">Job switches</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*JOBD</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#BCHJOB.MSGQ"><b>MSGQ</b></a></td>
|
||
|
|
<td valign="top">Message queue</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</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: 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" rowspan="3"><a href="#BCHJOB.SRTSEQ"><b>SRTSEQ</b></a></td>
|
||
|
|
<td valign="top">Sort sequence</td>
|
||
|
|
<td valign="top">Single values: <b><u>*USRPRF</u></b>, *SYSVAL, *HEX, *LANGIDUNQ, *LANGIDSHR<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Sort sequence</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="#BCHJOB.LANGID"><b>LANGID</b></a></td>
|
||
|
|
<td valign="top">Language ID</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*USRPRF</u></b>, *SYSVAL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.CNTRYID"><b>CNTRYID</b></a></td>
|
||
|
|
<td valign="top">Country or region ID</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*USRPRF</u></b>, *SYSVAL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.CCSID"><b>CCSID</b></a></td>
|
||
|
|
<td valign="top">Coded character set ID</td>
|
||
|
|
<td valign="top">1-65535, <b><u>*USRPRF</u></b>, *SYSVAL, *HEX</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.JOBMSGQMX"><b>JOBMSGQMX</b></a></td>
|
||
|
|
<td valign="top">Job message queue maximum size</td>
|
||
|
|
<td valign="top">2-64, <b><u>*JOBD</u></b>, *SYSVAL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#BCHJOB.JOBMSGQFL"><b>JOBMSGQFL</b></a></td>
|
||
|
|
<td valign="top">Job message queue full action</td>
|
||
|
|
<td valign="top"><b><u>*JOBD</u></b>, *SYSVAL, *NOWRAP, *WRAP, *PRTWRAP</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="BCHJOB.JOB"></a>
|
||
|
|
<h3>Job name (JOB)</h3>
|
||
|
|
<p>Specifies the name that is associated with the job when it is processed by the system.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOBD</u></b></dt>
|
||
|
|
<dd>The simple name of the job description used with this job is the name of the job itself.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the simple name of the job used while it is being processed by the system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.JOBD"></a>
|
||
|
|
<h3>Job description (JOBD)</h3>
|
||
|
|
<p>Specifies the job description used with the job.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Job description</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QBATCH</u></b></dt>
|
||
|
|
<dd>The IBM-supplied job description QBATCH in library QGPL is used for the job. (The QGPL library must be in the library list used by the spooling reader that reads the job's input.)
|
||
|
|
</dd>
|
||
|
|
<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>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the library list are searched until a match is found. If the <b>Initial library list (INLLIBL)</b> parameter specifies *JOBD, the library list used to find the job description is the library list for the thread in which the BCHJOB command processing is done. If the INLLIBL parameter specifies a value other than *JOBD, the library list used to find the job description consists of the libraries named in the QSYSLIBL system value and the libraries specified by the INLLIBL parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>If the INLLIBL parameter specifies *JOBD, the library list used to find the job description is the library list for the thread in which the BCHJOB command processing is done. The current library for the library list is searched. If no library is specified as the current library for the library list, the QGPL library is used. If the INLLIBL parameter specifies a value other than *JOBD, the QGPL library is used because the library list used to find the job description does not have a current library.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the library where the job description is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.JOBQ"></a>
|
||
|
|
<h3>Job queue (JOBQ)</h3>
|
||
|
|
<p>Specifies the job queue in which this job is placed.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RDR</u></b></dt>
|
||
|
|
<dd>The job queue specified in the Start Data Base Reader (STRDBRDR), Submit Data Base Jobs (SBMDBJOB), Start Diskette Reader (STRDKTRDR), or Submit Diskette Jobs (SBMDKTJOB) command that reads this job, is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBD</b></dt>
|
||
|
|
<dd>The job queue named in the job description used with this job is used.
|
||
|
|
</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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the new job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the new job is used to locate the 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 library where the job queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.PRTDEV"></a>
|
||
|
|
<h3>Print device (PRTDEV)</h3>
|
||
|
|
<p>Specifies the name of the default printer device for this job.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*USRPRF</u></b></dt>
|
||
|
|
<dd>The printer device name specified for the job's user profile is used. The user profile is specified in the job description, which is specified on the <b>Job description (JOBD)</b> parameter. The printer device name is taken from the profile when this command is run.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The printer device specified in the system value, QPRTDEV, when this command is run is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBD</b></dt>
|
||
|
|
<dd>The printer device specified in the job description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the printer device used for this job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.OUTQ"></a>
|
||
|
|
<h3>Output queue (OUTQ)</h3>
|
||
|
|
<p>Specifies the name of the default output queue that is used for spooled output produced by this 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>*USRPRF</u></b></dt>
|
||
|
|
<dd>The output queue specified for the job's user profile is used. The user profile is specified in the job description, which is specified on the <b>Job description (JOBD)</b> parameter. The output queue name is taken from the profile when this command is run.
|
||
|
|
</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 this job is used.
|
||
|
|
</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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the new job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the new job is used to locate the 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 library where the output queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.JOBPTY"></a>
|
||
|
|
<h3>Job priority (on JOBQ) (JOBPTY)</h3>
|
||
|
|
<p>Specifies the job queue scheduling priority. The highest priority is 1 and the lowest priority is 9.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOBD</u></b></dt>
|
||
|
|
<dd>The scheduling priority specified in the job description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-9</i></b></dt>
|
||
|
|
<dd>Specify the scheduling priority.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.OUTPTY"></a>
|
||
|
|
<h3>Output priority (on OUTQ) (OUTPTY)</h3>
|
||
|
|
<p>Specifies the output priority for spooled output files that are produced by this job. Valid values range from 1 through 9, where the highest priority is 1 and the lowest priority is 9.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOBD</u></b></dt>
|
||
|
|
<dd>The output priority specified in the job description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-9</i></b></dt>
|
||
|
|
<dd>Specify the priority of this job's output files.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.PRTTXT"></a>
|
||
|
|
<h3>Print text (PRTTXT)</h3>
|
||
|
|
<p>Specifies the text that is printed at the bottom of each page of printed output and on separator pages.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOBD</u></b></dt>
|
||
|
|
<dd>The value specified in the job description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BLANK</b></dt>
|
||
|
|
<dd>No text is printed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The print text is obtained from the system value, QPRTTXT.
|
||
|
|
</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 if necessary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.RTGDTA"></a>
|
||
|
|
<h3>Routing data (RTGDTA)</h3>
|
||
|
|
<p>Specifies the routing data used to start the next 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>QCMDB</u></b></dt>
|
||
|
|
<dd>The routing data used by the IBM-supplied batch subsystem to route batch jobs to the IBM-supplied control language processor QCMD is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBD</b></dt>
|
||
|
|
<dd>The routing data used to start the first routing step is in the job description.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RQSDTA</b></dt>
|
||
|
|
<dd>The first 80 characters of the request data specified in the <b>Request data or command (RQSDTA)</b> parameter of this command are also used as the routing data.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the character string that is used as the routing data for starting the first routing step. 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="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.RQSDTA"></a>
|
||
|
|
<h3>Request data or command (RQSDTA)</h3>
|
||
|
|
<p>Specifies the request data that is placed as the last entry in this job's message queue. The request data can be a CL command to be run or a string of characters used by another program.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The data following this command is inserted into this job's message queue as request data. For example, the request data may be a group of CL commands that constitute the job.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBD</b></dt>
|
||
|
|
<dd>The request data specified in the job description used by this job is placed as the last entry in this job's message queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No request data is placed in the job's message queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RTGDTA</b></dt>
|
||
|
|
<dd>The routing data in the <b>Routing data (RTGDTA)</b> parameter of this command 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. A maximum of 256 characters can be entered, enclosed in apostrophes if necessary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.SYNTAX"></a>
|
||
|
|
<h3>CL syntax check (SYNTAX)</h3>
|
||
|
|
<p>Specifies whether requests placed on the job's message queue are checked for syntax as CL commands. When checking for syntax is specified, the commands are checked for syntax when they are submitted instead of when the job is run, providing an earlier diagnosis of syntax errors. This parameter is used only if an asterisk (*) is specified for the <b>Request data or command (RQSDTA)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The Start Data Base Reader (STRDBRDR) and Start Diskette Reader (STRDKTRDR) commands support syntax checking. This provides the ability to check authorizations to commands.
|
||
|
|
</li>
|
||
|
|
<li>The user must have use (*USE) authority to the command and execute (*EXECUTE) authority to the library that contains that command.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOBD</u></b></dt>
|
||
|
|
<dd>The value in the job description used with this job determines whether the request data is checked for syntax and the message severity that is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOCHK</b></dt>
|
||
|
|
<dd>The request data for this job is not checked for syntax as CL commands.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-99</i></b></dt>
|
||
|
|
<dd>Specify the lowest message severity that causes the running of the job to be suppressed. The request data is checked for syntax as CL commands. If a syntax error occurs with a severity that is equal to or greater than the error message severity specified, the running of the job that contains the command with errors is suppressed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.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>*USRPRF</u></b></dt>
|
||
|
|
<dd>The current library in the user profile, under which the batch job runs, is the current library for the batch job. The user profile is specified in the job description, which is specified on the <b>Job description (JOBD)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CRTDFT</b></dt>
|
||
|
|
<dd>There is no current library for the batch 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 library that is used as the current library of the batch job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.INLLIBL"></a>
|
||
|
|
<h3>Initial library list (INLLIBL)</h3>
|
||
|
|
<p>Specifies the initial user part of the library list that is used to search for any object names that were specified without a library qualifier.
|
||
|
|
</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>*JOBD</u></b></dt>
|
||
|
|
<dd>The user library list in the job description used with this job is used as the initial user part of the library list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The system default user library list is used. 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 is empty.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 25 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the names of one or more libraries that are the user portion of the library list and are used by this job. The libraries are searched in the same order as they are listed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.ENDSEV"></a>
|
||
|
|
<h3>End severity (ENDSEV)</h3>
|
||
|
|
<p>Specifies the message severity level of escape messages that can cause a batch job to end. The batch job is ended when a request in the batch input stream sends to the request processing program an escape message whose severity code is equal to or greater than that specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOBD</u></b></dt>
|
||
|
|
<dd>The severity limit specified in the job description used with this batch job determines when the job is ended.
|
||
|
|
</dd>
|
||
|
|
<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 job to end. Because escape messages sent to users typically have a maximum severity level of 50, a value of 50 or lower must be specified for a job being ended as a result of an escape message. An escape message whose severity is equal to or greater than the value specified that is not handled causes the job to end.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.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>*JOBD</u></b></dt>
|
||
|
|
<dd>The value specified for message logging level in the job description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-4</i></b></dt>
|
||
|
|
<dd>Specifies the message logging level used for this job's messages. The possible logging levels are:
|
||
|
|
<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>*JOBD</u></b></dt>
|
||
|
|
<dd>The value specified for message logging severity in the job description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-99</i></b></dt>
|
||
|
|
<dd>Specify the message severity that is 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>*JOBD</u></b></dt>
|
||
|
|
<dd>The value specified for message logging text in the job description is used.
|
||
|
|
</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>
|
||
|
|
<dt><b>*NOLIST</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>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.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 <b>Message logging (LOG)</b> parameter in the Create CL Program (CRTCLPGM) command, the flag set in the <b>Log CL program commands (LOGCLPGM)</b> parameter is used. Other values for the <b>Message logging (LOG)</b> parameter override the <b>Log CL program commands (LOGCLPGM)</b> parameter. The commands are logged in the same manner as the requests.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOBD</u></b></dt>
|
||
|
|
<dd>The value in the job description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The commands in a CL program are not logged to the job log.
|
||
|
|
</dd>
|
||
|
|
<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="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.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 the inquiry message reply control is taken from the job description, 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>*JOBD</u></b></dt>
|
||
|
|
<dd>The inquiry message reply control specified in the job description used with this job is started.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RQD</b></dt>
|
||
|
|
<dd>A reply is required by the receiver of the inquiry message for all inquiry messages that occur during the running of this job.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFT</b></dt>
|
||
|
|
<dd>The default message reply is used to answer any inquiry messages issued during the running of this job.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSRPYL</b></dt>
|
||
|
|
<dd>The system reply list is checked to see if there is an entry for any inquiry message 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="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.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>*JOBD</u></b></dt>
|
||
|
|
<dd>The value specified in the job description determines whether this job is held when it is put on the job queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The job is not 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 or ended.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.DATE"></a>
|
||
|
|
<h3>Job date (DATE)</h3>
|
||
|
|
<p>Specifies the date that is assigned to the job when it is started.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOBD</u></b></dt>
|
||
|
|
<dd>The date specified in the job description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The value in the QDATE system value at the time the job is started is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the value that is used as the job date when the job is started. The value must be entered using the date format specified by the DATFMT job attribute.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.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>*JOBD</u></b></dt>
|
||
|
|
<dd>The value specified in the job description is the first settings for this 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 this job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.MSGQ"></a>
|
||
|
|
<h3>Message queue (MSGQ)</h3>
|
||
|
|
<p>Specifies 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>*NONE</u></b></dt>
|
||
|
|
<dd>No completion message is sent.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USRPRF</b></dt>
|
||
|
|
<dd>The message queue specified on the user profile of the user submitting this job is used.
|
||
|
|
</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 where the completion message is sent.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the new job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the new job is used to locate the queue. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the library where the message queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.SRTSEQ"></a>
|
||
|
|
<h3>Sort sequence (SRTSEQ)</h3>
|
||
|
|
<p>Specifies the sort sequence table to be used for string comparisons for this job.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*USRPRF</u></b></dt>
|
||
|
|
<dd>The sort sequence table specified for the job's user profile is used. The user profile is specified in the job description, which is specified on the <b>Job description (JOBD)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The system value QSRTSEQ is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HEX</b></dt>
|
||
|
|
<dd>A sort sequence table is not used. The hexadecimal values of the characters are used to determine the sort sequence.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LANGIDUNQ</b></dt>
|
||
|
|
<dd>A unique-weight sort table is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LANGIDSHR</b></dt>
|
||
|
|
<dd>A shared-weight sort table is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Sort sequence</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the sort sequence table.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the new job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the new job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the library where the sort sequence table is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.LANGID"></a>
|
||
|
|
<h3>Language ID (LANGID)</h3>
|
||
|
|
<p>Specifies the language identifier to be associated with this job. The language identifier is used when *LANGIDUNQ or *LANGIDSHR is specified on the <b>Sort sequence</b> (SRTSEQ) parameter. If the job CCSID is 65535, this parameter is also used to determine the value of the job default CCSID (DFTCCSID).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*USRPRF</u></b></dt>
|
||
|
|
<dd>The language ID specified for the job's user profile is used. The user profile is specified in the job description, which is specified on the <b>Job description (JOBD)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The system value QLANGID is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the language identifier to be used by the job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.CNTRYID"></a>
|
||
|
|
<h3>Country or region ID (CNTRYID)</h3>
|
||
|
|
<p>Specifies the country or region identifier to be used by the job.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*USRPRF</b></dt>
|
||
|
|
<dd>The country or region ID specified for the job's user profile is used. The user profile is specified in the job description, which is specified on the <b>Job description (JOBD)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The system value QCNTRYID is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the country or region identifier to be used by the job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.CCSID"></a>
|
||
|
|
<h3>Coded character set ID (CCSID)</h3>
|
||
|
|
<p>Specifies the coded character set identifier (CCSID) to be used for the job.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*USRPRF</u></b></dt>
|
||
|
|
<dd>The CCSID specified for the job's user profile is used. The user profile is specified in the job description, which is specified on the <b>Job description (JOBD)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The CCSID specified for the system value QCCSID is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HEX</b></dt>
|
||
|
|
<dd>The CCSID 65535 is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-65535</i></b></dt>
|
||
|
|
<dd>Specify the CCSID.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.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>*JOBD</u></b></dt>
|
||
|
|
<dd>The value specified in the job description determines the maximum size of the job message queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SYSVAL</b></dt>
|
||
|
|
<dd>The value in system value QJOBMSGQMX, at the time the job is started determines 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="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="BCHJOB.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>*JOBD</u></b></dt>
|
||
|
|
<dd>The value specified in the job description determines the action that should be taken.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSVAL</b></dt>
|
||
|
|
<dd>The value specified for the system value QJOBMSGQFL 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 full and starts filling the message queue again.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRTWRAP</b></dt>
|
||
|
|
<dd>The message queue wraps the job message queue when full and prints the messages that are being overlaid because of wrapping.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="BCHJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Checking System Reply List for Inquiry Message Entries</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
BCHJOB JOBD(PAYROLL) INQMSGRPY(*SYSRPYL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command begins the batch job called PAYROLL. An inquiry message that is sent (as a result of running this job) that has an entry in the system reply list is answered according to the reply in that reply list entry. For any inquiry message not represented in the reply list, a reply is required.
|
||
|
|
</p>
|
||
|
|
<p>The job name is the same as the name of the job description used with the job. The library search list of the thread in which the BCHJOB command is processed determines where the job description PAYROLL is found. The auxiliary storage pool (ASP) group of the thread in which the BCHJOB command is processed is used as the initial ASP group of the new job. Values for other job attributes are taken from the job description PAYROLL or from the user profile named in the job description PAYROLL.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Setting Job Switches</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
BCHJOB JOBD(QGPL/QBATCH) JOB(PAYROLL) JOBQ(BATCH2)
|
||
|
|
INLLIBL(PAYLIB) SWS(00101100) DATE(010188)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command begins a batch job called PAYROLL, which is run using attributes from the IBM-supplied job description for batch jobs, QBATCH. The job is placed on the job queue BATCH2. The library PAYLIB is the only library in the user portion of the library list. Switches are set for use in the job, and the date is set at January 1, 1988.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Specifying Severity Levels</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
BCHJOB JOBD(COMPILE) JOBPTY(5) SYNTAX(10)
|
||
|
|
INLLIBL(MYCMDS) ENDSEV(40)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command begins a batch job called COMPILE. The job is run using all of the attributes described in the job description also named COMPILE, except for the initial ASP group and the parameters that are specified by this command. The library MYCMDS is the only library in the user portion of the library list to be used when the commands are checked for syntax or run. Syntax errors with a value equal to or greater than 10 end processing of the job. The job is assigned a scheduling priority of 5 and is run as long as no errors are encountered that cause an escape message to be sent that has a severity level of 40 or higher.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="BCHJOB.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF1374</b></dt>
|
||
|
|
<dd>BCHJOB command not valid in current environment.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#BCHJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|