Read a File (READFILE)

.. READFILE Control Stmnt

Use the .. READFILE control statement to include a new file in the input stream. This control statement can be placed in a command file, issued using direct-workstation input, or issued from the RJE console.

Parameters

Keyword	Description	Choices	Notes
FILE	Input file	Qualified object name	Required, Positional 1
	Qualifier 1: Input file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
MBR	Member	Name, FIRST, ALL	Optional, Positional 2
CMD	Command file	NO, YES	Optional, Positional 3
SNDDLTRCD	Send deleted records	NO, YES	Optional, Positional 4
DTATYP	Data type	CHAR, ANY	Optional, Positional 5
RLS	Release Control	NO, YES	Optional, Positional 6
MSGQ	Message queue	Qualified object name	Optional, Positional 7
	Qualifier 1: Message queue	Name, PRV, NONE, *RDRE
	Qualifier 2: Library	Name, LIBL, CURLIB

Top

Input File (FILE)

Specifies the qualified name of the file that contains the input stream being included.

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.

database-file-name: Specify the name of the database file that contains the input stream.

Member (MBR)

Specifies the database file member being sent to the host subsystem.

The possible values are:

*FIRST: The first member of the database file is sent to the host subsystem.
*ALL: All members of the database file are sent to the host subsystem.
member-name: Specify the member name of the database file. If the member does not exist, an inquiry message is sent to the RJE message queue.

Command File

Specifies whether the file specified in the FILE parameter is searched for embedded RJE control statements.

The possible values are:

*NO: The file is not searched. Records are re-blocked to 80-byte records.
*YES: The file is searched. Records longer than 80 bytes are truncated.

Send Del Records (SNDDLTRCD)

Specifies whether blank records are sent to the host subsystem when deleted records are found in the database file member.

The possible values are:

*NO: Blank records are not sent.
*YES: Blank records are sent.

Data Type (DTATYP)

Specifies whether the file specified in the FILE parameter contains data characters less than hex 40.

The possible values are:

*CHAR: The file does not contain data characters less than hex 40.
*ANY: The file does contain data characters less than hex 40.

Release Control (RLS)

Specifies whether RJE will process the rest of the current file (that is, the file from which .. READFILE was issued) after the included file is processed. If not, the file is released from the nested stack of the files being read.

The possible values are:

*NO: RJE will continue to process the current file after the included file is processed.
*YES: RJE will not process the current file after the included file is processed. Processing reverts to the previous file. In other words, the current file is released from the nested stack of files. This improves performance, as each file left open in a nested stack has an impact on system resources. Do not specify *YES if this control statement is entered using direct-workstation input.

Message Queue (MSGQ)

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

The possible values are:

*PRV: The message queue specified with the previous .. READFILE control statement is used.
*NONE: A message queue is not used.
*RDRE: The message queue name is retrieved from the session description reader entry.

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.