Add RJE Writer Entry (ADDRJEWTRE)

Add RJE Writer Entry

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.

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.

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.

Several parameters of the writer entry can affect the processing of an output stream if any of the following conditions are true:

An FCT is not associated with the RJE session description
The PDIR or form-mount message from the host subsystem specifies a form type that does not exist as an entry in the FCT
The value *WTRE is specified for the FILE parameter of the FCT entry
The value *NONE is specified for the FILE parameter of the FCT entry
The default value of *WTRE is specified for any of the optional parameters of the Start RJE Writer (STRRJEWTR) command.

The parameter values specified for this writer entry can be overridden by parameter values specified in the STRRJEWTR command.

Error messages for ADDRJEWTRE

*ESCAPE Messages

RJE0018: &1 already exists in &2 in library &3.
RJE0024: Errors found. Processing of request ended.
RJE0067: No members were found in file &1 in &2.

Parameters

Keyword	Description	Choices	Notes
SSND	RJE session description	Qualified object name	Required, Positional 1
	Qualifier 1: RJE session description	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
WTR	RJE writer identification	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	Required, Positional 2
FILE	Output file	Qualified object name	Required, Positional 3
	Qualifier 1: Output file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
MBR	Member	Name, GEN, FIRST	Optional, Positional 4
SPLFNAME	BSC Spooled file name	DEVFNAME, JOBNAME	Optional
FSN	File member sequence number	0-999, 1	Optional
FORMTYPE	Host form type	Character value, *STD	Optional
DTAFMT	Data format	FCFC, DATA, *CMN	Optional
PGM	Program to call	Single values: NONE Other values: Qualified object name*	Optional
	Qualifier 1: Program to call	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
MSGQ	Message queue	Single values: NONE Other values: Qualified object name*	Optional
	Qualifier 1: Message queue	Name
	Qualifier 2: Library	Name, LIBL, CURLIB

Top

RJE Session Desc (SSND)

Specifies the qualified name of the session description to which the writer entry is added.

The possible library values are:

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

session-description-name: Specify the name of the session description.

Output File (FILE)

Specifies the qualified name of the file that receives the data from the host subsystem.

The possible library values are:

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

file-name: 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.

Member (MBR)

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.

The possible values are:

*GEN: Creates a member name formatted as either Affffffccc or Bffffffccc where:

A

Indicates that the file member contains print data.

B

Indicates that the file member contains punch data.

ffffff

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.

ccc

A three-digit FSN controlled by the session to maintain member uniqueness.

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.

If no member is created, the writer issues a message requesting you to either try again or to cancel this file.
*FIRST: The first member in the file is used.
member-name: Specify the name of the file member. If the member is not found, an inquiry message is sent to the RJE message queue.

BSC Spooled File (SPLFNAME)

Specifies the name of the spooled file for printer or punch device output. This parameter applies only to BSC sessions.

Note: SNA sessions use the job name in the peripheral data set information record (PDIR) sent from the host subsystem.

The possible values are:

*DEVFNAME: The spooled file name is the same as the printer file name.
*JOBNAME: The spooled file name is the same as the job name received in the job name message of the BSC host subsystem.

File Member Seq Number (FSN)

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.

The possible values are:

1: The three-digit FSN is 001.
file-sequence-number: Specify the initial three-digit FSN. Leading zeros are not required for FSNs less than 100.

Data Format (DTAFMT)

Specifies the format of the output data.

The possible values are:

*FCFC: The output data is in first-character forms control (FCFC) format. If DEVTYPE(*PUN) is specified, *FCFC is not valid.
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.
*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.
*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.

Program to Call (PGM)

Specifies the qualified name of a user program associated with the session description.

The possible values are:

*NONE: No user program is associated with the writer entry.
The possible library values are:
- *LIBL: The library list for the job is used to locate the user program.
- *CURLIB: The current library for the job is used to locate the user program. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the user program is located.
program-name: Specify the name of the user program associated with the session description.

Message Queue (MSGQ)

Specifies the qualified name of the message queue to which messages for the writer are sent.

The possible values are:

*NONE: A message queue is not specified.
The possible library values are:
- *LIBL: The library list for the job is used to locate the message queue.
- *CURLIB: The current library for the job is used to locate the message queue. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the message queue is located.
message-queue-name: Specify the name of the message queue.