Create RJE Communication File (CRTRJECMNF)

Create RJE Comm File

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.

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.

Error messages for CRTRJECMNF

None

Parameters

Keyword	Description	Choices	Notes
FILE	File	Qualified object name	Required, Positional 1
	Qualifier 1: File	Name
	Qualifier 2: Library	Name, *CURLIB
SRCFILE	Source file containing DDS	Qualified object name	Optional, Positional 2
	Qualifier 1: Source file containing DDS	Name, QRJESRC
	Qualifier 2: Library	Name, LIBL, CURLIB
SRCMBR	Source member containing DDS	Name, *FILE	Optional, Positional 3
OPTION	Source listing options	Values (up to 2 repetitions): SRC, SOURCE, NOSRC, NOSOURCE, LIST, NOLIST	Optional, Positional 4
GENLVL	Generation severity level	0, 10, 20, 30	Optional, Positional 5
LOGON	Host signon/logon command	Character value, *NONE	Optional, Positional 6
FMTLOG	Formatted SNA logon	Character value, NONE, YES, *NO	Optional, Positional 11
LOGOFF	Logoff text	Character value, *NONE	Optional, Positional 7
BLKLEN	Block length	256-32767, *CALC	Optional, Positional 8
AUT	Authority	Name, LIBCRTAUT, ALL, CHANGE, USE, *EXCLUDE	Optional, Positional 9
TEXT	Text 'description'	Character value, SRCMBRTXT, BLANK	Optional, Positional 10

Top

File (FILE)

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).

The possible library values are:

*CURLIB: The communications file is created in the current library for the job. If no current library is specified, QGPL is used.
library-name: Specify the name of the library where the communications file is located.

communications-file-name: Specify the name of the communications file being created.

File Contain DDS (SRCFILE)

Specifies the qualified name of the source file containing the DDS statements that create the communications file.

The possible library values are:

*LIBL: The library list for the job is used to locate the source file.
*CURLIB: The current library for the job is used to locate the source file. If no current library is specified, QGPL is used.
library-name: Specify the name of the library where the source file is located.

The possible values are:

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.
source-file-name: Specify the name of the RJE source file.

Member Contain DDS (SRCMBR)

Specifies the member name in the source file that contains the DDS for the communications file.

The possible values are:

*FILE: The source file name is the same as that of the communications file specified in the FILE parameter.
source-file-member-name: Specify the name of the source file member.

Srce Listing Opt (OPTION)

Specifies the type of printout produced when the file is created.

The possible values are:

Source Listing Options

*SRC or *SOURCE: A printout of source statements and errors that occur is produced.
*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.
Program Listing Options
*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.
*NOLIST: An expanded printout is not produced.

Generation Sev Level (GENLVL)

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.

The possible values are:

20: The severity level is 20.
0: The severity level is 0.
10: The severity level is 10.
30: The severity level is 30.

Host Logon Command (LOGON)

Specifies up to 80 characters of text that are sent to the host subsystem when the file is opened. The format is host-dependent.

The possible values are:

*NONE: No signon text is specified.
logon-characters: Specify the signon text that is sent to the host subsystem when the file is opened.

Formatted SNA Logon (FMTLOG)

Specifies whether the signon text is formatted.

The possible values are:

*NONE: No signon text is specified.
*NO: The signon text is not formatted.
*YES: The signon text is formatted. This text must be entered in uppercase characters and must match the host system data.

Logoff Text (LOGOFF)

Specifies up to 80 characters of text that are sent to the host subsystem when the file is closed. The format is host-dependent.

The possible values are:

*NONE: No signoff text is specified.
logoff-characters: Specify the signoff text that is sent to the host subsystem when the file is closed.

Block Length (BLKLEN)

Specifies the maximum block length (in bytes) of the data records being sent.

The possible values are:

*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.
block-length: 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.

Authority (AUT)

Specifies the authority given to users who themselves and whose user group do not have specific authority to the object.

The possible values are:

*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.
*CHANGE: Public users can change the communications file.
*ALL: Public users have all authority to the communications file.
*EXCLUDE: Public users cannot use the communications file.
*USE: Public users can use the communications file, but cannot change it.
authorization-list-name: 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.

Text Description (TEXT)

Specifies text that briefly describes the communications file.

The possible values are:

*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.
*BLANK: No text is specified.
'description': Specify no more than 50 characters of text, enclosed in apostrophes.