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

226 lines
8.6 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Submit CODE Batch Job (SBMCODEJOB)</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="SBMCODEJOB.Top_Of_Page"></a>
<h2>Submit CODE Batch Job (SBMCODEJOB)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>
<ul><li>Batch job (*BATCH)</li>
<li>Interactive job (*INTERACT)</li>
<li>Batch program (*BPGM)</li>
<li>Interactive program (*IPGM)</li>
<li>Batch REXX procedure (*BREXX)</li>
<li>Interactive REXX procedure (*IREXX)</li>
<li>Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)</li>
</ul><b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#SBMCODEJOB.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SBMCODEJOB.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SBMCODEJOB.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SBMCODEJOB"></a>
<p>The CL command SBMCODEJOB submits a command to be run in batch, and optionally informs the work station when the job is complete and returns error feedback information from certain compile commands to the work station.
</p>
<p>This command is intended to be used by the "CoOperative Development Environment/400" and "VRPG Client/2" features of the "IBM Application Development ToolSet Client Server/400" (ADTS CS/400) program product.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SBMCODEJOB.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="#SBMCODEJOB.CMD"><b>CMD</b></a></td>
<td valign="top">Command to run</td>
<td valign="top"><i>Command string</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SBMCODEJOB.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>*USRPRF</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#SBMCODEJOB.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>*JOBD</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#SBMCODEJOB.NOTIFY"><b>NOTIFY</b></a></td>
<td valign="top">Notification message</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#SBMCODEJOB.SERVER"><b>SERVER</b></a></td>
<td valign="top">Host server name</td>
<td valign="top"><i>Character value</i>, <b><u>OS400</u></b></td>
<td valign="top">Optional, Positional 5</td>
</tr>
<tr>
<td valign="top"><a href="#SBMCODEJOB.ADDPARMS"><b>ADDPARMS</b></a></td>
<td valign="top">Additional SBMJOB parameters</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional, Positional 6</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SBMCODEJOB.CMD"></a>
<h3>Command to run (CMD)</h3>
<p>Specifies the CL command that is to be run in batch.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMCODEJOB.JOBD"></a>
<h3>Job description (JOBD)</h3>
<p>Specifies the name that is associated with the job when it is processed by the system.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*USRPRF</u></b></dt>
<dd>The job description in the user profile under which the submitted job runs is used as the job description of the submitted job.
</dd>
<dt><b>job-description-name</b></dt>
<dd>Specify the name (library-name/job-description-name) of the job description used for the job.
</dd>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the job description name. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b>library-name</b></dt>
<dd>Specify the name of the library where the job description name is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMCODEJOB.JOBQ"></a>
<h3>Job queue (JOBQ)</h3>
<p>Specifies the name of the job queue in which this job is placed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*JOBD</u></b></dt>
<dd>The submitted job is placed on the job queue named in the specified job description.
</dd>
<dt><b>job-queue-name</b></dt>
<dd>Specify the name (library-name/job-queue-name) of the job queue on which the submitted job is placed.
</dd>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the job queue name. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b>library-name</b></dt>
<dd>Specify the name of the library where the job queue name is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMCODEJOB.NOTIFY"></a>
<h3>Notification message (NOTIFY)</h3>
<p>Specify Yes to have the batch job inform the work station of the completion of the submitted command.
</p>
<p>To use this option, an ICF file named EVFCICFF must be found in the library list of the batch job. This identifies the location of the work station. See the CODE/400 Installation Guide for more information on setting up the ICF file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMCODEJOB.SERVER"></a>
<h3>Host server name (SERVER)</h3>
<p>Specifies the name of a CODE/400 or VRPG/2 server that has already been started by the Start CODE (STRCODE) command.
</p>
<p>This parameter is only used when the command being submitted generates error feedback information for use by the CODE/400 workstation editor. Only commands with the parameters OPTION(*SRCDBG), OPTION(*LSTDBG) and OPTION(*EVENTF) generate such error feedback.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMCODEJOB.ADDPARMS"></a>
<h3>Additional SBMJOB parameters (ADDPARMS)</h3>
<p>Specifies parameters to be used in the Submit Job (SBMJOB) command.
</p>
<p>The SBMCODEJOB command invokes SBMJOB for you. It uses the system defaults for all SBMJOB parameters except CMD, JOBD and JOBQ. This parameter allows you to specify additional parameters for the SBMJOB command in order to override the system default. For example, to use your job description's library list in the batch job, specify 'INLLIBL(*JOBD)' in this parameter.
</p>
<p>You can specify multiple SBMJOB parameters, but each must be separated by one or more blanks.
</p>
<p>If 'INLLIBL(*JOBD)' is specified, that job description's library list must include a library with an EVFCICFF ICF file in it.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SBMCODEJOB.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SBMCODEJOB.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMCODEJOB.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>