411 lines
15 KiB
HTML
411 lines
15 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>Add RJE Writer Entry (ADDRJEWTRE)</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="ADDRJEWTRE.Top_Of_Page"></a>
|
||
|
<h2>Add RJE Writer Entry (ADDRJEWTRE)</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="#ADDRJEWTRE.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
<a href="#ADDRJEWTRE.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
<a href="#ADDRJEWTRE.ERROR.MESSAGES">Error messages</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<div> <a name="ADDRJEWTRE"></a>
|
||
|
<h3>Add RJE Writer Entry</h3>
|
||
|
<p>The ADDRJEWTRE command adds a writer entry to an existing session description. If an entry is added to a session description while the session is active, the change does not take effect until the session is ended and started again.
|
||
|
</p>
|
||
|
<p>Each SNA writer entry can point to a single communications entry, although for performance reasons this method is not recommended. Each writer entry for BSC requires a corresponding communications entry as described in the ADDRJECMNE command.
|
||
|
</p>
|
||
|
<p>The maximum number of writers supported depends on the host subsystem. For SNA, RJE supports up to 15 printers and 15 punches. The total number of printers and punches is 30, depending on the host subsystem. For BSC, RJE supports up to seven printers and seven punches, but the total number of writers cannot exceed eight.
|
||
|
</p>
|
||
|
<p>Several parameters of the writer entry can affect the processing of an output stream if any of the following conditions are true:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>An FCT is not associated with the RJE session description
|
||
|
</li>
|
||
|
<li>The PDIR or form-mount message from the host subsystem specifies a form type that does not exist as an entry in the FCT
|
||
|
</li>
|
||
|
<li>The value *WTRE is specified for the FILE parameter of the FCT entry
|
||
|
</li>
|
||
|
<li>The value *NONE is specified for the FILE parameter of the FCT entry
|
||
|
</li>
|
||
|
<li>The default value of *WTRE is specified for any of the optional parameters of the Start RJE Writer (STRRJEWTR) command.
|
||
|
</li>
|
||
|
</ul>
|
||
|
<p>The parameter values specified for this writer entry can be overridden by parameter values specified in the STRRJEWTR command.
|
||
|
</p>
|
||
|
<h3>Error messages for ADDRJEWTRE</h3>
|
||
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>RJE0018</b></dt>
|
||
|
<dd>&1 already exists in &2 in library &3.
|
||
|
</dd>
|
||
|
<dt><b>RJE0024</b></dt>
|
||
|
<dd>Errors found. Processing of request ended.
|
||
|
</dd>
|
||
|
<dt><b>RJE0067</b></dt>
|
||
|
<dd>No members were found in file &1 in &2.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
|
||
|
<div>
|
||
|
<h3><a name="ADDRJEWTRE.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="#ADDRJEWTRE.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">Required, Positional 1</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Qualifier 1: RJE session description</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="#ADDRJEWTRE.WTR"><b>WTR</b></a></td>
|
||
|
<td valign="top">RJE writer identification</td>
|
||
|
<td valign="top">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>
|
||
|
<td valign="top">Required, Positional 2</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="3"><a href="#ADDRJEWTRE.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">Required, Positional 3</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top">Qualifier 1: Output 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="#ADDRJEWTRE.MBR"><b>MBR</b></a></td>
|
||
|
<td valign="top">Member</td>
|
||
|
<td valign="top"><i>Name</i>, <b><u>*GEN</u></b>, *FIRST</td>
|
||
|
<td valign="top">Optional, Positional 4</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#ADDRJEWTRE.SPLFNAME"><b>SPLFNAME</b></a></td>
|
||
|
<td valign="top">BSC Spooled file name</td>
|
||
|
<td valign="top"><b><u>*DEVFNAME</u></b>, *JOBNAME</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#ADDRJEWTRE.FSN"><b>FSN</b></a></td>
|
||
|
<td valign="top">File member sequence number</td>
|
||
|
<td valign="top">0-999, <b><u>1</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#ADDRJEWTRE.FORMTYPE"><b>FORMTYPE</b></a></td>
|
||
|
<td valign="top">Host form type</td>
|
||
|
<td valign="top"><i>Character value</i>, <b><u>*STD</u></b></td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top"><a href="#ADDRJEWTRE.DTAFMT"><b>DTAFMT</b></a></td>
|
||
|
<td valign="top">Data format</td>
|
||
|
<td valign="top"><b><u>*FCFC</u></b>, *DATA, *CMN</td>
|
||
|
<td valign="top">Optional</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
<td valign="top" rowspan="3"><a href="#ADDRJEWTRE.PGM"><b>PGM</b></a></td>
|
||
|
<td valign="top">Program to call</td>
|
||
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <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></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="#ADDRJEWTRE.MSGQ"><b>MSGQ</b></a></td>
|
||
|
<td valign="top">Message queue</td>
|
||
|
<td valign="top">Single values: <b><u>*NONE</u></b><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></table>
|
||
|
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<div> <a name="ADDRJEWTRE.SSND"></a>
|
||
|
<h3>RJE Session Desc (SSND)</h3>
|
||
|
<p>Specifies the qualified name of the session description to which the writer entry is added.
|
||
|
</p>
|
||
|
<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>
|
||
|
<p><i>session-description-name:</i> Specify the name of the session description.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.WTR"></a>
|
||
|
<h3>RJE Writer ID (WTR)</h3>
|
||
|
<p>Specifies the writer entry that is added.
|
||
|
</p>
|
||
|
<p>The possible values are:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>PR1 - PR15: Specifies the number of the printer being added.
|
||
|
</li>
|
||
|
<li>PU1 - PU15: Specifies the number of the punch being added.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.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 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>
|
||
|
<p><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.
|
||
|
</p>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.MBR"></a>
|
||
|
<h3>Member (MBR)</h3>
|
||
|
<p>Specifies the file member to which output is directed. This parameter applies only if you specify a DDM, physical, or source physical file in the FILE parameter.
|
||
|
</p>
|
||
|
<p>The possible values are:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<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 host 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>A three-digit FSN controlled by the session to maintain member uniqueness.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
<p>If a member name already exists in the file, the three-digit FSN is incremented by one until either a unique name is reached and a member is created, or 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 in the file is used.
|
||
|
</li>
|
||
|
<li><i>member-name:</i> Specify the name of the file member. If the member is not found, an inquiry message is sent to the RJE message queue.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.SPLFNAME"></a>
|
||
|
<h3>BSC Spooled File (SPLFNAME)</h3>
|
||
|
<p>Specifies the name of the spooled file for printer or punch device output. This parameter applies only to BSC sessions.
|
||
|
</p>
|
||
|
<p>
|
||
|
<b>Note: </b>SNA sessions use the job name in the peripheral data set information record (PDIR) sent from the host subsystem.
|
||
|
</p>
|
||
|
<p>The possible values are:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>*DEVFNAME: The spooled file name is the same as the printer file name.
|
||
|
</li>
|
||
|
<li>*JOBNAME: The spooled file name is the same as the job name received in the job name message of the BSC host subsystem.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.FSN"></a>
|
||
|
<h3>File Member 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 on the MBR parameter.
|
||
|
</p>
|
||
|
<p>The possible values are:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>1: The three-digit FSN is 001.
|
||
|
</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="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.FORMTYPE"></a>
|
||
|
<h3>Host Form Type (FORMTYPE)</h3>
|
||
|
<p>Specifies the initial form type used if no form-mount message is received from the host subsystem.
|
||
|
</p>
|
||
|
<p>The possible values are:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>*STD: The initial form type used is *STD.
|
||
|
</li>
|
||
|
<li><i>form-type:</i> Specify the initial form type. Valid entries range from one to eight alphanumeric characters.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.DTAFMT"></a>
|
||
|
<h3>Data Format (DTAFMT)</h3>
|
||
|
<p>Specifies the format of the output data.
|
||
|
</p>
|
||
|
<p>The possible values are:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<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 being processed 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="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.PGM"></a>
|
||
|
<h3>Program to Call (PGM)</h3>
|
||
|
<p>Specifies the qualified name of a user program associated with the session description.
|
||
|
</p>
|
||
|
<p>The possible values are:
|
||
|
</p>
|
||
|
<ul>
|
||
|
<li>*NONE: No user program is associated with the writer entry.
|
||
|
<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 associated with the session description.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<div> <a name="ADDRJEWTRE.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>*NONE: A message queue is not specified.
|
||
|
<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="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div>
|
||
|
<h3><a name="ADDRJEWTRE.COMMAND.EXAMPLES">Examples</a></h3>None
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
<hr size="2" width="100%">
|
||
|
<div><h3><a name="ADDRJEWTRE.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
</p>
|
||
|
<dl>
|
||
|
<dt><b>RJE0018</b></dt>
|
||
|
<dd>&1 already exists in &2 in library &3.
|
||
|
</dd>
|
||
|
<dt><b>RJE0024</b></dt>
|
||
|
<dd>Errors found. Processing of request ended.
|
||
|
</dd>
|
||
|
<dt><b>RJE0067</b></dt>
|
||
|
<dd>No members were found in file &1 in &2.
|
||
|
</dd>
|
||
|
</dl>
|
||
|
</div>
|
||
|
<table width="100%">
|
||
|
<tr><td align="right"><a href="#ADDRJEWTRE.Top_Of_Page">Top</a></td></tr>
|
||
|
</table>
|
||
|
</body>
|
||
|
</html>
|