362 lines
14 KiB
HTML
362 lines
14 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>Create RJE Communication File (CRTRJECMNF)</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="CRTRJECMNF.Top_Of_Page"></a>
|
||
|
|
<h2>Create RJE Communication File (CRTRJECMNF)</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="#CRTRJECMNF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTRJECMNF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTRJECMNF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTRJECMNF"></a>
|
||
|
|
<h3>Create RJE Comm File</h3>
|
||
|
|
<p>The CRTRJECMNF command creates a communications file, which is used by SNA devices to send records to and from the host subsystem in an RJE environment.
|
||
|
|
</p>
|
||
|
|
<p>The same communications file is used for input and output operations. It contains not data, but rather a file description that identifies the communications device. This information is specified both in the source file that contains the DDS statements, and in the CRTRJECMNF command.
|
||
|
|
</p>
|
||
|
|
<h3>Error messages for CRTRJECMNF</h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTRJECMNF.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="#CRTRJECMNF.FILE"><b>FILE</b></a></td>
|
||
|
|
<td valign="top">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: 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>*CURLIB</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTRJECMNF.SRCFILE"><b>SRCFILE</b></a></td>
|
||
|
|
<td valign="top">Source file containing DDS</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: Source file containing DDS</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QRJESRC</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="#CRTRJECMNF.SRCMBR"><b>SRCMBR</b></a></td>
|
||
|
|
<td valign="top">Source member containing DDS</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*FILE</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTRJECMNF.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Source listing options</td>
|
||
|
|
<td valign="top">Values (up to 2 repetitions): *SRC, *SOURCE, *NOSRC, *NOSOURCE, *LIST, *NOLIST</td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTRJECMNF.GENLVL"><b>GENLVL</b></a></td>
|
||
|
|
<td valign="top">Generation severity level</td>
|
||
|
|
<td valign="top">0, 10, <b><u>20</u></b>, 30</td>
|
||
|
|
<td valign="top">Optional, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTRJECMNF.LOGON"><b>LOGON</b></a></td>
|
||
|
|
<td valign="top">Host signon/logon command</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 6</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTRJECMNF.FMTLOG"><b>FMTLOG</b></a></td>
|
||
|
|
<td valign="top">Formatted SNA logon</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *YES, *NO</td>
|
||
|
|
<td valign="top">Optional, Positional 11</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTRJECMNF.LOGOFF"><b>LOGOFF</b></a></td>
|
||
|
|
<td valign="top">Logoff text</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 7</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTRJECMNF.BLKLEN"><b>BLKLEN</b></a></td>
|
||
|
|
<td valign="top">Block length</td>
|
||
|
|
<td valign="top">256-32767, <b><u>*CALC</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 8</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTRJECMNF.AUT"><b>AUT</b></a></td>
|
||
|
|
<td valign="top">Authority</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *ALL, *CHANGE, *USE, *EXCLUDE</td>
|
||
|
|
<td valign="top">Optional, Positional 9</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTRJECMNF.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SRCMBRTXT</u></b>, *BLANK</td>
|
||
|
|
<td valign="top">Optional, Positional 10</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTRJECMNF.FILE"></a>
|
||
|
|
<h3>File (FILE)</h3>
|
||
|
|
<p>Specifies the qualified name of the communications file being created. If a library name is not given, the file is stored in the user's current library (*CURLIB).
|
||
|
|
</p>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*CURLIB: The communications file is created in the current library for the job. If no current library is specified, QGPL is used.
|
||
|
|
</li>
|
||
|
|
<li><i>library-name:</i> Specify the name of the library where the communications file is located.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><i>communications-file-name:</i> Specify the name of the communications file being created.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.SRCFILE"></a>
|
||
|
|
<h3>File Contain DDS (SRCFILE)</h3>
|
||
|
|
<p>Specifies the qualified name of the source file containing the DDS statements that create the communications file.
|
||
|
|
</p>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*LIBL: The library list for the job is used to locate the source file.
|
||
|
|
</li>
|
||
|
|
<li>*CURLIB: The current library for the job is used to locate the source file. If no current library is specified, QGPL is used.
|
||
|
|
</li>
|
||
|
|
<li><i>library-name:</i> Specify the name of the library where the source file is located.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>QRJESRC: The IBM-supplied RJE source file QRJESRC contains the source descriptions used to create the communications file. The descriptions are contained in member QRJECMNSRC of QRJESRC.
|
||
|
|
</li>
|
||
|
|
<li><i>source-file-name:</i> Specify the name of the RJE source file.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.SRCMBR"></a>
|
||
|
|
<h3>Member Contain DDS (SRCMBR)</h3>
|
||
|
|
<p>Specifies the member name in the source file that contains the DDS for the communications file.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*FILE: The source file name is the same as that of the communications file specified in the FILE parameter.
|
||
|
|
</li>
|
||
|
|
<li><i>source-file-member-name:</i> Specify the name of the source file member.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.OPTION"></a>
|
||
|
|
<h3>Srce Listing Opt (OPTION)</h3>
|
||
|
|
<p>Specifies the type of printout produced when the file is created.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<p><b>Source Listing Options</b>
|
||
|
|
</p>
|
||
|
|
<li>*SRC or *SOURCE: A printout of source statements and errors that occur is produced.
|
||
|
|
</li>
|
||
|
|
<li>*NOSRC or *NOSOURCE: A printout is not created unless errors are detected. If errors are detected, they are listed, along with the word or record formats that caused them.
|
||
|
|
<p><b>Program Listing Options</b>
|
||
|
|
</p>
|
||
|
|
</li>
|
||
|
|
<li>*LIST: An expanded printout is produced, showing a detailed list of file specifications that result from the source statements and that refer to other file descriptions. The list shows the file and field keywords and attributes.
|
||
|
|
</li>
|
||
|
|
<li>*NOLIST: An expanded printout is not produced.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.GENLVL"></a>
|
||
|
|
<h3>Generation Sev Level (GENLVL)</h3>
|
||
|
|
<p>Specifies the severity level at which the creation operation will fail. If errors occur that have a severity level greater than or equal to this value, the operation ends.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>20: The severity level is 20.
|
||
|
|
</li>
|
||
|
|
<li>0: The severity level is 0.
|
||
|
|
</li>
|
||
|
|
<li>10: The severity level is 10.
|
||
|
|
</li>
|
||
|
|
<li>30: The severity level is 30.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.LOGON"></a>
|
||
|
|
<h3>Host Logon Command (LOGON)</h3>
|
||
|
|
<p>Specifies up to 80 characters of text that are sent to the host subsystem when the file is opened. The format is host-dependent.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*NONE: No signon text is specified.
|
||
|
|
</li>
|
||
|
|
<li><i>logon-characters:</i> Specify the signon text that is sent to the host subsystem when the file is opened.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.FMTLOG"></a>
|
||
|
|
<h3>Formatted SNA Logon (FMTLOG)</h3>
|
||
|
|
<p>Specifies whether the signon text is formatted.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*NONE: No signon text is specified.
|
||
|
|
</li>
|
||
|
|
<li>*NO: The signon text is not formatted.
|
||
|
|
</li>
|
||
|
|
<li>*YES: The signon text is formatted. This text must be entered in uppercase characters and must match the host system data.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.LOGOFF"></a>
|
||
|
|
<h3>Logoff Text (LOGOFF)</h3>
|
||
|
|
<p>Specifies up to 80 characters of text that are sent to the host subsystem when the file is closed. The format is host-dependent.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*NONE: No signoff text is specified.
|
||
|
|
</li>
|
||
|
|
<li><i>logoff-characters:</i> Specify the signoff text that is sent to the host subsystem when the file is closed.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.BLKLEN"></a>
|
||
|
|
<h3>Block Length (BLKLEN)</h3>
|
||
|
|
<p>Specifies the maximum block length (in bytes) of the data records being sent.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*CALC: The block length is determined by the system. The length is 512 bytes or the length of the DDS record, whichever is greater. The length of the DDS record is the sum of the field lengths, in bytes, within the record of the DDS source file.
|
||
|
|
</li>
|
||
|
|
<li><i>block-length:</i> Specify the maximum block length of the data records being sent. The value must be at least the size of the largest record sent. Valid values range from 256 through 8192.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.AUT"></a>
|
||
|
|
<h3>Authority (AUT)</h3>
|
||
|
|
<p>Specifies the authority given to users who themselves and whose user group do not have specific authority to the object.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*LIBCRTAUT: The public authority for the object is taken from the CRTAUT keyword of the target library (the library that is to contain the object). This value is determined when the object is created. If the CRTAUT value for the library changes after the object is created, the new value does not affect any existing objects.
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE: Public users can change the communications file.
|
||
|
|
</li>
|
||
|
|
<li>*ALL: Public users have all authority to the communications file.
|
||
|
|
</li>
|
||
|
|
<li>*EXCLUDE: Public users cannot use the communications file.
|
||
|
|
</li>
|
||
|
|
<li>*USE: Public users can use the communications file, but cannot change it.
|
||
|
|
</li>
|
||
|
|
<li><i>authorization-list-name:</i> Specify the name of an authorization list. Users included on the authorization list are granted authority to the object as specified on the list. The authorization list must exist when the object is created.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTRJECMNF.TEXT"></a>
|
||
|
|
<h3>Text Description (TEXT)</h3>
|
||
|
|
<p>Specifies text that briefly describes the communications file.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>*SRCMBRTXT: Text is taken from the source file member to create the communications file. To add or change text for a source member, issue either the Start Source Entry Utility (STRSEU) command, the Add Physical File Member (ADDPFM) command, or the Change Physical File Member (CHGPFM) command. If the source file is an inline file or a device file, the text is blank.
|
||
|
|
</li>
|
||
|
|
<li>*BLANK: No text is specified.
|
||
|
|
</li>
|
||
|
|
<li><i>'description':</i> Specify no more than 50 characters of text, enclosed in apostrophes.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTRJECMNF.COMMAND.EXAMPLES">Examples</a></h3>None
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTRJECMNF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTRJECMNF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|