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

505 lines
18 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 RJE Job (SBMRJEJOB)</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="SBMRJEJOB.Top_Of_Page"></a>
<h2>Submit RJE Job (SBMRJEJOB)</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="#SBMRJEJOB.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SBMRJEJOB.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SBMRJEJOB.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SBMRJEJOB"></a>
<h3>Submit RJE Job</h3>
<p>The SBMRJEJOB command sends an input stream to the host subsystem.
</p>
<p>Through the OPTION parameter of this command, an input stream can be sent to the host subsystem immediately. Alternately, a batch job is placed on an RJE reader job queue, and the input stream is sent when the batch job runs.
</p>
<p>Through the FILE parameter (*), you can start an interactive reader for direct-workstation input.
</p>
<h3>Error messages for SBMRJEJOB</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>RJE0003</b></dt>
<dd>RJE session &amp;1 is not active.
</dd>
<dt><b>RJE0004</b></dt>
<dd>You are not permitted to access session description &amp;1.
</dd>
<dt><b>RJE0017</b></dt>
<dd>&amp;1 was not found in session description &amp;2.
</dd>
<dt><b>RJE0024</b></dt>
<dd>Errors found. Processing of request ended.
</dd>
<dt><b>RJE0035</b></dt>
<dd>&amp;1 in &amp;2 must be a data-base file.
</dd>
<dt><b>RJE0041</b></dt>
<dd>Remote job was not submitted.
</dd>
<dt><b>RJE0059</b></dt>
<dd>RJE cannot send host command to complete request.
</dd>
<dt><b>RJE0065</b></dt>
<dd>Reader &amp;1 can be used only for interactive jobs.
</dd>
<dt><b>RJE0067</b></dt>
<dd>No members were found in file &amp;1 in &amp;2.
</dd>
<dt><b>RJE0080</b></dt>
<dd>You must define at least one batch reader in session &amp;1.
</dd>
<dt><b>RJE0112</b></dt>
<dd>RJE reader &amp;1 is not available.
</dd>
<dt><b>RJE0113</b></dt>
<dd>No RJE readers are available.
</dd>
<dt><b>RJE0144</b></dt>
<dd>RJE device &amp;3 was not defined in RJE session &amp;1.
</dd>
<dt><b>RJE0204</b></dt>
<dd>FILE(*) is not valid on SBMRJEJOB in batch program.
</dd>
<dt><b>RJE0216</b></dt>
<dd>No SNA sessions are available now. Try later.
</dd>
<dt><b>RJE3041</b></dt>
<dd>&amp;1: Host subsystem rejected exchange record length.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SBMRJEJOB.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="#SBMRJEJOB.FILE"><b>FILE</b></a></td>
<td valign="top">Input file</td>
<td valign="top">Single values: *<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Input 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="#SBMRJEJOB.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b>, *ALL</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SBMRJEJOB.SSND"><b>SSND</b></a></td>
<td valign="top">RJE session description</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: RJE session description</td>
<td valign="top"><i>Name</i>, <b><u>QRJE</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="#SBMRJEJOB.RDR"><b>RDR</b></a></td>
<td valign="top">RJE reader identification</td>
<td valign="top"><b><u>*AUTO</u></b>, RD1, RD2, RD3, RD4, RD5, RD6, RD7, RD8, RD9, RD10, RD11, RD12, RD13, RD14, RD15</td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#SBMRJEJOB.CMD"><b>CMD</b></a></td>
<td valign="top">Command file</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SBMRJEJOB.OPTION"><b>OPTION</b></a></td>
<td valign="top">Submit RJE job</td>
<td valign="top"><b><u>*QUEUE</u></b>, *IMMED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SBMRJEJOB.SNDDLTRCD"><b>SNDDLTRCD</b></a></td>
<td valign="top">Send deleted records</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SBMRJEJOB.DTATYP"><b>DTATYP</b></a></td>
<td valign="top">Data type</td>
<td valign="top"><b><u>*CHAR</u></b>, *ANY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SBMRJEJOB.MAXRCDLEN"><b>MAXRCDLEN</b></a></td>
<td valign="top">Maximum record length</td>
<td valign="top">1-255, <b><u>*FIXED</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#SBMRJEJOB.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top">Single values: <b><u>*REQUESTER</u></b>, *RDRE, *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Message queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#SBMRJEJOB.RESUBMIT"><b>RESUBMIT</b></a></td>
<td valign="top">Resubmit RJE job</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SBMRJEJOB.FILE"></a>
<h3>Input File (FILE)</h3>
<p>Specifies the qualified name of the file that contains the input stream being submitted.
</p>
<p>The possible values are:
</p>
<ul>
<li>*: The input stream is entered at the workstation where the SBMRJEJOB command is issued. If this value is specified for the FILE parameter, OPTION(*IMMED) and CMD(*YES) must also be specified. For SNA, at least two LU sessions are required.
<p>An interactive input stream sends data one record at a time (each time the Enter key is pressed). The .. READFILE control statement embeds the data files and commands in the input stream. The .. EOF control statement is used to end the input stream. No other jobs are submitted to the reader.
</p>
<p>The possible library values are:
</p>
<ul>
<li>*LIBL: The library list for the job is used to locate the file.
</li>
<li>*CURLIB: The current library for the job is used to locate the file. If no current library is specified, QGPL is used.
</li>
<li><i>library-name:</i> Specify the name of the library where the file is located.
</li>
</ul>
</li>
<li><i>database-file-name:</i> Specify the name of the database file that contains the input stream being submitted to the host subsystem.
</li>
</ul>
<p>You cannot override the file parameter by specifying *ALL on the MBR parameter for the OVRDBF command. If you do this:
</p>
<ul>
<li>If the job is submitted with the *IMMED option, RJE issues an inquiry message prompting you to cancel the job or to continue it after this file
</li>
<li>If the job is submitted with the *QUEUE option, the override is ignored.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the member being sent to the host subsystem. This parameter applies only if you specified a database file with the FILE parameter.
</p>
<p>The possible values are:
</p>
<ul>
<li>*FIRST: The first member of the database file is sent to the host subsystem.
</li>
<li>*ALL: All members of the database file are sent to the host subsystem.
</li>
<li><i>member-name:</i> Specify the member name of the database file. If the member does not exist, an inquiry message is sent to the RJE message queue.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.SSND"></a>
<h3>RJE Session Desc (SSND)</h3>
<p>Specifies the qualified name of the session description that sends the input stream to the host.
</p>
<p>The possible values are:
</p>
<ul>
<li>QRJE: QRJE is the session description name.
<p>The possible library values are:
</p>
<ul>
<li>*LIBL: The library list for the job is used to locate the session description.
</li>
<li>*CURLIB: The current library for the job is used to locate the session description. If no current library is specified, QGPL is used.
</li>
<li><i>library-name:</i> Specify the name of the library where the session description is located.
</li>
</ul>
</li>
<li><i>session-description-name:</i> Specify the name of the session description.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.RDR"></a>
<h3>RJE Reader ID (RDR)</h3>
<p>Specifies the reader that is associated with the job being submitted.
</p>
<p>The possible values are:
</p>
<ul>
<li>*AUTO: The first available reader is used.
</li>
<li>RD1 - RD15: Specify a value between RD1 and RD15 to indicate the reader to be used.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.CMD"></a>
<h3>Command File (CMD)</h3>
<p>Specifies whether the file specified in the FILE parameter is searched for embedded RJE control statements (for example, .. READFILE or .. EOF).
</p>
<p>The possible values are:
</p>
<ul>
<li>*NO: The file is not searched. Records are re-blocked to 80-byte records.
</li>
<li>*YES: The file is searched. Records longer than 80 bytes are truncated.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.OPTION"></a>
<h3>Submit RJE Job (OPTION)</h3>
<p>Specifies whether the reader job is sent to a reader job queue or started immediately.
</p>
<p>The possible values are:
</p>
<ul>
<li>*QUEUE: The job is submitted to the job queue associated with the reader specified in the RDR parameter. The session does not have to be active. The reader job queue is released when the session starts and the STRRJERDR command is issued.
</li>
<li>*IMMED: Job processing starts immediately and control is not returned to the workstation until the job is complete. The session must be active. The specified reader must be started and not in use.
<p>OPTION(*IMMED) cannot be used with RESUBMIT(*YES).
</p>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.SNDDLTRCD"></a>
<h3>Send Del Records (SNDDLTRCD)</h3>
<p>Specifies whether blank records are sent to the host subsystem when deleted records are encountered in the database file member.
</p>
<p>The possible values are:
</p>
<ul>
<li>*NO: Blank records are not sent.
</li>
<li>*YES: Blank records are sent.
</li>
</ul>
<p>When files created through the database join function are submitted, deleted records will only be recognized in the primary part of the logically joined file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.DTATYP"></a>
<h3>Data Type (DTATYP)</h3>
<p>Specifies whether the file specified in the FILE parameter contains data characters less than hex 40.
</p>
<p>The possible values are:
</p>
<ul>
<li>*CHAR: The file does not contain data characters less than hex 40.
</li>
<li>*ANY: The file does contain data characters less than hex 40.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.MAXRCDLEN"></a>
<h3>Max Rcd Lngth (MAXRCDLEN)</h3>
<p>Specifies the maximum input record length for data sent to a host subsystem. The record length range which is supported depends on the type of host subsystem:
</p>
<ul>
<li>JES2, 1 to 252 bytes
</li>
<li>JES3, *FIXED
</li>
<li>VSE/POWER, 1 to 128 bytes
</li>
<li>RSCS, *FIXED
</li>
</ul>
<p>For BSC, only *FIXED is valid.
</p>
<p>RJE command files are read as 80-byte records. Command file records read from a file with a data record length greater than 80 bytes are truncated to 80 bytes. Command file records read from a file with a data record length less than 80 bytes are padded to 80 bytes. Command file records are always sent to the host as 80-byte records regardless of the value of the MAXRCDLEN parameter.
</p>
<p>The possible values are:
</p>
<ul>
<li>*FIXED: The data is re-blocked into 80-byte records when it is sent to the host subsystem.
</li>
<li><i>maximum-record-length:</i> This allows the user to define the maximum input record length that can be processed by the host subsystem. RJE data files with a data record length less than or equal to this value are sent unchanged. Conversely, if the data record length is greater, the data files are reblocked to the maximum input record length before they are sent.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.MSGQ"></a>
<h3>Message Queue (MSGQ)</h3>
<p>Specifies the qualified name of the message queue to which messages for the reader are sent.
</p>
<p>The possible values are:
</p>
<ul>
<li>*REQUESTER: Messages are sent to the requester's workstation message queue and the RJE message queue.
<p>If this command is run in a batch job, *REQUESTER is treated as *NONE (inquiry messages cannot be sent to a batch job).
</p>
</li>
<li>*RDRE: The message queue name is retrieved from the session description reader entry associated with this reader function.
</li>
<li>*NONE: A message queue is not used.
<p>The possible library values are:
</p>
<ul>
<li>*LIBL: The library list for the job is used to locate the message queue.
</li>
<li>*CURLIB: The current library for the job is used to locate the message queue. If no current library is specified, QGPL is used.
</li>
<li><i>library-name:</i> Specify the name of the library where the message queue is located.
</li>
</ul>
</li>
<li><i>message-queue-name:</i> Specify the name of the message queue.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SBMRJEJOB.RESUBMIT"></a>
<h3>Resubmit RJE Job (RESUBMIT)</h3>
<p>Specifies whether jobs in the queue are resubmitted if they end abnormally.
</p>
<p>
<b>Note: </b>The job sequence of each reader is preserved unless the jobs were submitted to the *AUTO reader. To use this parameter, a job submitted by CL commands must have a job priority (JOBPTY) of 6, and the user profile that submits reader jobs must have the priority limit (PTYLMT) parameter set from 1 through 5, inclusive. The MAXACT parameter of the reader job queue entries in the RJE subsystem description must be set to 1. A reader job submitted with this parameter can be canceled only from the job queue. Other commands, such as CNLRJERDR OPTION(*IMMED), cause the job to be resubmitted.
</p>
<p>The possible values are:
</p>
<ul>
<li>*NO: Files are not resubmitted.
</li>
<li>*YES: Files are resubmitted.
<p>RESUBMIT(*YES) cannot be used with OPTION(*IMMED).
</p>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SBMRJEJOB.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SBMRJEJOB.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>RJE0003</b></dt>
<dd>RJE session &amp;1 is not active.
</dd>
<dt><b>RJE0004</b></dt>
<dd>You are not permitted to access session description &amp;1.
</dd>
<dt><b>RJE0017</b></dt>
<dd>&amp;1 was not found in session description &amp;2.
</dd>
<dt><b>RJE0024</b></dt>
<dd>Errors found. Processing of request ended.
</dd>
<dt><b>RJE0035</b></dt>
<dd>&amp;1 in &amp;2 must be a data-base file.
</dd>
<dt><b>RJE0041</b></dt>
<dd>Remote job was not submitted.
</dd>
<dt><b>RJE0059</b></dt>
<dd>RJE cannot send host command to complete request.
</dd>
<dt><b>RJE0065</b></dt>
<dd>Reader &amp;1 can be used only for interactive jobs.
</dd>
<dt><b>RJE0067</b></dt>
<dd>No members were found in file &amp;1 in &amp;2.
</dd>
<dt><b>RJE0080</b></dt>
<dd>You must define at least one batch reader in session &amp;1.
</dd>
<dt><b>RJE0112</b></dt>
<dd>RJE reader &amp;1 is not available.
</dd>
<dt><b>RJE0113</b></dt>
<dd>No RJE readers are available.
</dd>
<dt><b>RJE0144</b></dt>
<dd>RJE device &amp;3 was not defined in RJE session &amp;1.
</dd>
<dt><b>RJE0204</b></dt>
<dd>FILE(*) is not valid on SBMRJEJOB in batch program.
</dd>
<dt><b>RJE0216</b></dt>
<dd>No SNA sessions are available now. Try later.
</dd>
<dt><b>RJE3041</b></dt>
<dd>&amp;1: Host subsystem rejected exchange record length.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SBMRJEJOB.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>