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

408 lines
15 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>Start RJE Writer (STRRJEWTR)</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="STRRJEWTR.Top_Of_Page"></a>
<h2>Start RJE Writer (STRRJEWTR)</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="#STRRJEWTR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRRJEWTR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRRJEWTR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRRJEWTR"></a>
<h3>Start RJE Writer</h3>
<p>The STRRJEWTR command starts either all writers, or a specific writer, which allows them to receive writer output from the host subsystem.
</p>
<p>If the host subsystem writer is already started, some host subsystems return error messages, which RJE ignores. If the STRRJESSN command is issued with WTRS(*NO) and SNDSTRCMD(*NO), a start command is not sent to the host subsystem the first time the writer is started.
</p>
<h3>Error messages for STRRJEWTR</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>RJE0034</b></dt>
<dd>No writers were defined in session &amp;1.
</dd>
<dt><b>RJE0059</b></dt>
<dd>RJE cannot send host command to complete request.
</dd>
<dt><b>RJE0067</b></dt>
<dd>No members were found in file &amp;1 in &amp;2.
</dd>
<dt><b>RJE0146</b></dt>
<dd>You do not have authority to message queue &amp;1.
</dd>
<dt><b>RJE0147</b></dt>
<dd>RJE did not find message file QRJEMSG.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRRJEWTR.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="2"><a href="#STRRJEWTR.WTR"><b>WTR</b></a></td>
<td valign="top">RJE writer identification</td>
<td valign="top"><i>Qualifier list</i></td>
<td valign="top" rowspan="2">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: RJE writer identification</td>
<td valign="top">*ALL, PR1, PR2, PR3, PR4, PR5, PR6, PR7, PR8, PR9, PR10, PR11, PR12, PR13, PR14, PR15, PU1, PU2, PU3, PU4, PU5, PU6, PU7, PU8, PU9, PU10, PU11, PU12, PU13, PU14, PU15</td>
</tr><tr>
<td valign="top" rowspan="2"><a href="#STRRJEWTR.SSN"><b>SSN</b></a></td>
<td valign="top">Active RJE session</td>
<td valign="top"><i>Qualifier list</i></td>
<td valign="top" rowspan="2">Required, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Active RJE session</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top"><a href="#STRRJEWTR.FORMTYPE"><b>FORMTYPE</b></a></td>
<td valign="top">Host form type</td>
<td valign="top"><i>Character value</i>, <b><u>*WTRE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRRJEWTR.FILE"><b>FILE</b></a></td>
<td valign="top">Output file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Output file</td>
<td valign="top"><i>Name</i>, <b><u>*WTRE</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="#STRRJEWTR.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>*WTRE</u></b>, *FIRST, *GEN</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRRJEWTR.FSN"><b>FSN</b></a></td>
<td valign="top">File member sequence number</td>
<td valign="top">0-999, <b><u>*WTRE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRRJEWTR.DTAFMT"><b>DTAFMT</b></a></td>
<td valign="top">Data format</td>
<td valign="top"><b><u>*WTRE</u></b>, *DATA, *FCFC, *CMN</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRRJEWTR.PGM"><b>PGM</b></a></td>
<td valign="top">Program to call</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Program to call</td>
<td valign="top"><i>Name</i>, <b><u>*WTRE</u></b>, *NONE</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="#STRRJEWTR.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top"><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>, <b><u>*WTRE</u></b>, *NONE</td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRRJEWTR.WTR"></a>
<h3>RJE Writer ID (WTR)</h3>
<p>Specifies the writer that is started.
</p>
<p>The possible values are:
</p>
<ul>
<li>*ALL: All writers in the session are started.
</li>
<li>PR1 - PR15: Specify a value between PR1 and PR15 to indicate the printer to be started.
</li>
<li>PU1 - PU15: Specify a value between PU1 and PU15 to indicate the punch to be started.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRJEWTR.SSN"></a>
<h3>Active RJE Session (SSN)</h3>
<p>Specifies the name of the active session that contains the writer being started.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRJEWTR.FORMTYPE"></a>
<h3>Host Form Type (FORMTYPE)</h3>
<p>Specifies the initial type of form on which to print the output if no PDIR or form-mount message is received from the host. The identifiers used to indicate the type of forms are user-defined, and can be up to eight characters in length.
</p>
<p>The possible values are:
</p>
<ul>
<li>*WTRE: The form type specified in the session description writer entry is used.
</li>
<li><i>form-type:</i> Specify the initial form type. Valid entries are from one to eight alphanumeric characters in length. This value corresponds to a valid entry in the FCT specified either in the CRTSSND or CRTRJECFG command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRJEWTR.FILE"></a>
<h3>Output File (FILE)</h3>
<p>Specifies the qualified name of the file that receives the data from the host subsystem.
</p>
<p>The possible values are:
</p>
<ul>
<li>*WTRE: The file specified in the session description writer entry is used.
<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>file-name:</i> Specify the name of the diskette, DDM, physical, printer, or source physical file that receives the data from the host subsystem. Diskette and printer files must be program described.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRJEWTR.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the file member to which output is directed. This parameter applies only if you specified a DDM, physical, or source physical file in the FILE parameter of this command or in the associated session description writer entry.
</p>
<p>The possible values are:
</p>
<ul>
<li>*WTRE: Members are created according to the method specified in the session description writer entry.
</li>
<li>*GEN: Creates a member name formatted as either Affffffccc or Bffffffccc where:
<dl>
<dt><b>A</b></dt>
<dd>Indicates that the file member contains print data.
</dd>
<dt><b>B</b></dt>
<dd>Indicates that the file member contains punch data.
</dd>
<dt><b>ffffff</b></dt>
<dd>Up to the first six non-blank characters of the form type that was received from the host subsystem. Only A through Z, 0 through 9, $, #, @, and _ are valid in the form type that is used to generate member names.
</dd>
<dt><b>ccc</b></dt>
<dd>Indicates a three-digit FSN controlled by the session to maintain file member uniqueness.
</dd>
</dl>
<p>If a member name already exists in the file, the three-digit sequence number is incremented by one until a unique name is reached and a member is created, or until sequence numbers up to and including 999 have been tried without creating a member.
</p>
<p>If no member is created, the writer issues a message requesting you to either try again or to cancel this file.
</p>
</li>
<li>*FIRST: The first member of the file is used.
</li>
<li><i>member-name:</i> Specify the name of the member. 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="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRJEWTR.FSN"></a>
<h3>File Mbr Seq Number (FSN)</h3>
<p>Specifies the initial three-digit FSN that is used to create member names. This parameter applies only if *GEN is specified for the MBR parameter of this command or in the session description writer entry.
</p>
<p>The possible values are:
</p>
<ul>
<li>*WTRE: The FSN in the session description writer entry is used.
</li>
<li><i>file-sequence-number:</i> Specify the initial three-digit FSN. Leading zeros are not required for FSNs less than 100.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRJEWTR.DTAFMT"></a>
<h3>Data Format (DTAFMT)</h3>
<p>Specifies the format of the output data.
</p>
<p>The possible values are:
</p>
<ul>
<li>*WTRE: The output format specified in the session description writer entry is used.
</li>
<li>*FCFC: The output data is in first-character forms control (FCFC) format. If DEVTYPE(*PUN) is specified, *FCFC is not valid.
<p>The data can be written to a physical file in FCFC format and printed later using the Copy File (CPYF) command, specifying an FCFC printer file for the TOFILE parameter. The record length of the physical file must include one extra byte for the FCFC code.
</p>
</li>
<li>*DATA: The output data is in data format. No FCFC codes are embedded in the data. Specify *DATA to send data to a physical file for processing by a program.
</li>
<li>*CMN: The output data is in communications format (256-character records). *CMN format decreases communications time. Before using the data, issue the CVTRJEDTA command to convert it to either FCFC format or data format. If you specify *CMN, the output file must be a physical file with a record length of 256 bytes.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRJEWTR.PGM"></a>
<h3>Program to Call (PGM)</h3>
<p>Specifies the qualified name of a user program associated with the writer.
</p>
<p>The possible values are:
</p>
<ul>
<li>*WTRE: The program specified in the session description writer entry is used.
</li>
<li>*NONE: No user program is associated with the writer.
<p>The possible library values are:
</p>
<ul>
<li>*LIBL: The library list for the job is used to locate the user program.
</li>
<li>*CURLIB: The current library for the job is used to locate the user program. If no current library is specified, QGPL is used.
</li>
<li><i>library-name:</i> Specify the name of the library where the user program is located.
</li>
</ul>
</li>
<li><i>program-name:</i> Specify the name of the user program.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRRJEWTR.MSGQ"></a>
<h3>Message Queue (MSGQ)</h3>
<p>Specifies the qualified name of the message queue to which messages for the writer are sent.
</p>
<p>The possible values are:
</p>
<ul>
<li>*WTRE: The message queue specified in the session description writer entry is used.
</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="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRRJEWTR.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRRJEWTR.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>RJE0034</b></dt>
<dd>No writers were defined in session &amp;1.
</dd>
<dt><b>RJE0059</b></dt>
<dd>RJE cannot send host command to complete request.
</dd>
<dt><b>RJE0067</b></dt>
<dd>No members were found in file &amp;1 in &amp;2.
</dd>
<dt><b>RJE0146</b></dt>
<dd>You do not have authority to message queue &amp;1.
</dd>
<dt><b>RJE0147</b></dt>
<dd>RJE did not find message file QRJEMSG.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRRJEWTR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>