The Member-Selection Exit

IEBCOPY passes a list of the member names in an array to the member-selection exit. The exit can decide and choose which member names to include or exclude from the current copy operation.

Restrictions:

IEBCOPY will put out a new message and fail if a SELECT or EXCLUDE statement is processed and a member exit exists.
Members will be presented in alphameric order within each input data set in the "concatenation."
Only names eight characters or less will be passed.
New name will be limited to eight characters.

EBCPLST parameter list fields that are filled in by IEBCOPY:

PLST_PARMLIST_HDR
CPLST_PARMLIST_USR
CPLST_PARMLIST_ENTRY_ADD CPLST_PARMLIST_COUNT (value will be the count of member entries in the member array).
CPLST_PARMLIST_FLAGS
CPLST_MEMBER_NAME
CPLST_MEMBER_DIR_ADDR
CPLST_MEMBER_DIR_LEN

IEBCPLST parameter list fields that are filled in by the member-selection exit:

CPLST_PARMLIST_DSNUMBER

Input DS number for current copy operation (origin 1).

CPLST_PARMLIST_RC

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

00 = OK
36 = Severe error - Do not call again.

CPLST_MEMBER_RC

00 = member selected. Must call exit for next member.
04 = member excluded. Must call exit for next member.
08 = member selected including all remaining members in this input data set. No need to call exit again for this input data set.
12 = member excluded including all remaining members in this input data set. No need to call exit again for this input data set.

CPLST_MEMBER_OFLAGS

Flags set by the member-selection exit.

CPLST_MEMBER_NEWNAME

Filled in if CPLST_MEMBER_RENAME flag bit is set on.