Start RJE Writer (STRRJEWTR)

Start RJE Writer

The STRRJEWTR command starts either all writers, or a specific writer, which allows them to receive writer output from the host subsystem.

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.

Error messages for STRRJEWTR

*ESCAPE Messages

RJE0003: RJE session &1 is not active.
RJE0004: You are not permitted to access session description &1.
RJE0017: &1 was not found in session description &2.
RJE0024: Errors found. Processing of request ended.
RJE0034: No writers were defined in session &1.
RJE0059: RJE cannot send host command to complete request.
RJE0067: No members were found in file &1 in &2.
RJE0146: You do not have authority to message queue &1.
RJE0147: RJE did not find message file QRJEMSG.

Parameters

Keyword	Description	Choices	Notes
WTR	RJE writer identification	Qualifier list	Required, Positional 1
WTR	Qualifier 1: RJE writer identification	*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	Required, Positional 1
SSN	Active RJE session	Qualifier list	Required, Positional 2
SSN	Qualifier 1: Active RJE session	Name	Required, Positional 2
FORMTYPE	Host form type	Character value, *WTRE	Optional
FILE	Output file	Qualified object name	Optional
	Qualifier 1: Output file	Name, *WTRE
	Qualifier 2: Library	Name, LIBL, CURLIB
MBR	Member	Name, WTRE, FIRST, *GEN	Optional
FSN	File member sequence number	0-999, *WTRE	Optional
DTAFMT	Data format	WTRE, DATA, FCFC, CMN	Optional
PGM	Program to call	Qualified object name	Optional
	Qualifier 1: Program to call	Name, WTRE, NONE
	Qualifier 2: Library	Name, LIBL, CURLIB
MSGQ	Message queue	Qualified object name	Optional
	Qualifier 1: Message queue	Name, WTRE, NONE
	Qualifier 2: Library	Name, LIBL, CURLIB

Top

RJE Writer ID (WTR)

Specifies the writer that is started.

The possible values are:

*ALL: All writers in the session are started.
PR1 - PR15: Specify a value between PR1 and PR15 to indicate the printer to be started.
PU1 - PU15: Specify a value between PU1 and PU15 to indicate the punch to be started.

Host Form Type (FORMTYPE)

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.

The possible values are:

*WTRE: The form type specified in the session description writer entry is used.
form-type: 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.

Output File (FILE)

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

The possible values are:

*WTRE: The file specified in the session description writer entry is used.
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 specified a DDM, physical, or source physical file in the FILE parameter of this command or in the associated session description writer entry.

The possible values are:

*WTRE: Members are created according to the method specified in the session description writer entry.
*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 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

Indicates a three-digit FSN controlled by the session to maintain file member uniqueness.

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.

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 of the file is used.
member-name: Specify the name of the member. If the member does not exist, an inquiry message is sent to the RJE message queue.

File Mbr Seq Number (FSN)

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.

The possible values are:

*WTRE: The FSN in the session description writer entry is used.
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:

*WTRE: The output format specified in the session description writer entry is used.
*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 for processing 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 writer.

The possible values are:

*WTRE: The program specified in the session description writer entry is used.
*NONE: No user program is associated with the writer.
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.

Message Queue (MSGQ)

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

The possible values are:

*WTRE: The message queue specified in the session description writer entry is used.
*NONE: A message queue is not used.
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.

Error messages

*ESCAPE Messages

RJE0003: RJE session &1 is not active.
RJE0004: You are not permitted to access session description &1.
RJE0017: &1 was not found in session description &2.
RJE0024: Errors found. Processing of request ended.
RJE0034: No writers were defined in session &1.
RJE0059: RJE cannot send host command to complete request.
RJE0067: No members were found in file &1 in &2.
RJE0146: You do not have authority to message queue &1.
RJE0147: RJE did not find message file QRJEMSG.