259 lines
10 KiB
HTML
259 lines
10 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>Submit Data Base Jobs (SBMDBJOB)</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="SBMDBJOB.Top_Of_Page"></a>
|
|
<h2>Submit Data Base Jobs (SBMDBJOB)</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="#SBMDBJOB.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#SBMDBJOB.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#SBMDBJOB.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="SBMDBJOB"></a>
|
|
<p>The Submit Database Jobs (SBMDBJOB) command allows you to submit jobs to job queues so they can be run as batch jobs. The input stream is read either from a physical database file or from a logical database file that has a single-record format. This command allows you to specify the name of this database file and its member, the name of the job queue to be used, and to decide whether jobs being submitted can be displayed by the Work with Submitted Jobs (WRKSBMJOB) command
|
|
</p>
|
|
<p>A Submit Database Jobs operation reads the file once and ends when the end-of-file is read or when an End Input (ENDINP) command is encountered. The ENDINP command (a delimiter) is not recognized if it is within an inline file that ends with characters that are not default ending characters (as specified in the ENDCHAR parameter of the Data (DATA) command). The SBMDBJOB operation can be canceled either by canceling the request from the system request menu or by canceling the job in which the process is running.
|
|
</p>
|
|
<p>In contrast to a spool reader started with the Start Database Reader (STRDBRDR) command, the SBMDBJOB command operates in the same process as the requesting function and does not do syntax checking on the input stream.
|
|
</p>
|
|
<p><b>Restriction:</b> The specified database file either must consist of single-field records and must have an arrival sequence access path, or it must be a standard database source file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SBMDBJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="SBMDBJOB.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="#SBMDBJOB.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Data base file</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: Data base file</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="#SBMDBJOB.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SBMDBJOB.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="#SBMDBJOB.DSPSBMJOB"><b>DSPSBMJOB</b></a></td>
|
|
<td valign="top">Show on submitted job list</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SBMDBJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="SBMDBJOB.FILE"></a>
|
|
<h3>Data base file (FILE)</h3>
|
|
<p>Specifies the database file from which the input stream is read.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Data base file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the database file that contains the input stream that you want to read.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the file. If no current library entry exists in the library list, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SBMDBJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SBMDBJOB.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the member in the specified file that contains the input stream to be read.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>No member name is specified; the first member in the file is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the member that contains the input stream to read.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SBMDBJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SBMDBJOB.JOBQ"></a>
|
|
<h3>Job queue (JOBQ)</h3>
|
|
<p>Specifies the job queue on which the job entries are placed. A job entry is placed on this queue for each job in the input stream that has JOBQ(*RDR) specified on the Batch Job (BCHJOB) command. If *RDR is not specified on the BCHJOB command, the job queue specified on the BCHJOB command or in the job description is used. (The job queue for each job in the input stream can be different.) This parameter is valid only if ACTION(*SUBMIT) is specified in the existing network job entry or in a subsequent Change Network Job Entry (CHGNETJOBE) command.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If both the user identified in the job description of the job being read and the user processing the Submit Database Job (SBMDBJOB) command are not authorized to the job queue on which the job should be placed, the job ends and a diagnostic message is placed in the job log. The input stream, continues to be processed, starting with the next job. If either user is authorized to the job queue, the job runs without error.
|
|
</p>
|
|
<p><b>Qualifier 1: Job queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QBATCH</u></b></dt>
|
|
<dd>The job entry is to be placed on the QBATCH job queue, which is the default job queue. This will happen if *RDR is specified on the <b>Job queue (JOBQ)</b> parameter of the Batch Job (BCHJOB) command. The Batch Job (BCHJOB) command is contained in the input stream itself.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job queue to which each job in the input stream will be sent. This will happen if *RDR is specified on the JOBQ parameter of the Batch Job (BCHJOB) command.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the job queue.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the job queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SBMDBJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SBMDBJOB.DSPSBMJOB"></a>
|
|
<h3>Show on submitted job list (DSPSBMJOB)</h3>
|
|
<p>Specifies whether the jobs being submitted are displayed on the submitted jobs display. If *YES is specified here, these submitted jobs can be displayed when the Work with Submitted Jobs (WRKSBMJOB) command is used.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>This job can be displayed by the Work with Submitted Jobs (WRKSBMJOB) command.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>This job is not displayed on any display produced by the Work with Submitted Jobs (WRKSBMJOB) command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SBMDBJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SBMDBJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
SBMDBJOB FILE(QGPL/BILLING)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits jobs using input from the database file named BILLING, which is in the QGPL library. The first member in the BILLING file contains the input stream to be processed. The default system-supplied job queue QBATCH is used.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SBMDBJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SBMDBJOB.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1751</b></dt>
|
|
<dd>Error while processing job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1754</b></dt>
|
|
<dd>File &1 in library &2 not database file or DDM file.
|
|
</dd>
|
|
<dt><b>CPF1760</b></dt>
|
|
<dd>Submit jobs command not allowed.
|
|
</dd>
|
|
<dt><b>CPF2207</b></dt>
|
|
<dd>Not authorized to use object &1 in library &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF3307</b></dt>
|
|
<dd>Job queue &1 in &2 not found.
|
|
</dd>
|
|
<dt><b>CPF3330</b></dt>
|
|
<dd>Necessary resource not available.
|
|
</dd>
|
|
<dt><b>CPF3363</b></dt>
|
|
<dd>Message queue &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9815</b></dt>
|
|
<dd>Member &5 file &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
</dl>
|
|
<p><b><u>*STATUS Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1762</b></dt>
|
|
<dd>Reading job &3/&2/&1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SBMDBJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|