The Control Statement Exit

IEBCOPY will call this exit each time that it needs to read a control statement. If this exit is supplied, IEBCOPY will not use SYSIN or a DD substituted for it. On each call to this exit, the exit can return one control statements or zero or more lines to be printed to SYSPRINT. Note: control statement record returned to IEBCOPY may be a "SYSIN statement record" or a "SYSPRINT report record".

Restriction: The storage containing control statements or messages must not be deleted until next control statement exit call or IEBCOPY termination

EBCPLST parameter list fields that are filled in by IEBCOPY:

CPLST_PARMLIST_HDR
CPLST_PARMLIST_USR
CPLST_PARMLIST_ENTRY_ADD
CPLST_PARMLIST_COUNT (value is always one )
CPLST_PARMLIST_FLAGS

IEBCPLST parameter list fields that are filled in by the control statement exit:

CPLST_PARMLIST_DATA

31-bit address of control statement which must be in the format of an IEBCOPY control statement (including continuation characters if necessary) and will be logically padded on the right with blanks to 80 characters or address of print line which must not include a control character.

CPLST_PARMLIST_DATA_LEN

Length of control statement must be 72-80 or 0 when omitted. length of print line must be 60-120 or 0 when omitted.

CPLST_PARMLIST_RC

Return code in the parameter list, not in register 15:

00 = Control Statement exit: One control statement returned. Count is number of input records to process (must be 1)
00 = Member-Selection exit: Successful processing.
04 = Zero or more control statement returned. End of group - Process previous and new records and execute the group returned.
08 = A user exit successfully processed an initialization call and should be called again for the next control statement or member array.
16 = Print zero or more lines (length may be zero). Count is number of print lines to process (must be 1).
20 = Start a new page and print zero or more lines. Count is number of print lines to process (must be 1).
32 = Exit IEBCOPY. Data record is ignored (IEBCOPY only prints final message(s) and exits.)
36 = Severe error - Do not call again - IEBCOPY exits with return code 16.