Processing copy steps

Copy steps are identified by one of these EXECs:

EXEC PGM=IEBCOPY
EXEC PGM=copypgm [if the JCLIN specified COPY(PGM=copypgm)]
EXEC copyproc [if the JCLIN specified COPY(copyproc)]

When a copy step is encountered, SMP/E searches through the JCL looking for the SYSIN DD * statement. All records from the SYSIN DD * statement to the end of input (/* or //) are assumed to be the copy input control statements.

Note:

Copy input must be inline, not pointing to another data set.
The only copy utility control statements allowed are COPY (or C), COPYMOD (or CM), and SELECT (or S).
The COPYMOD control statement is used when processing program elements or copied modules.

When scanning the copy input, SMP/E assumes the ddnames of the statement are the same as the lowest-level qualifier of the data set referred to. If the COPY or COPYMOD statement is set up without this convention, SMP/E generates incorrect DLIB and SYSLIB names in the MOD and LMOD entries.

By scanning the IEBCOPY control statements, SMP/E knows which members of the DLIB are being copied (from the IEBCOPY SELECT MEMBER statements), from which DLIB they are being copied (the IEBCOPY INDD ddname), and to which target libraries they are going (the IEBCOPY OUTDD ddname).

The members can be macros, modules, source elements, or data elements. SMP/E has no way of determining the type from the standard IEBCOPY control statements. To find this information, SMP/E looks for the TYPE comment on the COPY (or COPYMOD) INDD=ddname,OUTDD=ddname control statement. The format of the TYPE comment on the COPY or COPYMOD statement is:

copystmt INDD=ddname,OUTDD=ddname   TYPE=type

where:

copystmt

is COPYMOD (for copied modules or program elements) or COPY (for all other elements)

type

indicates the type of element in the distribution library. It can be specified as:

DATA: for data elements. If DATA is specified, SMP/E skips to the next COPY or COPYMOD control statement without creating any entries for the data elements.
MAC: for macros.
MOD: for modules.
PROGRAM: for program elements.
SRC: for source elements.

If the TYPE=type parameter is not specified, the default is TYPE=MOD.

There must be at least one blank between the COPY or COPYMOD statement and the comment. TYPE=type must be the first character string in the comment, and no blanks must precede or follow the “=” sign. This information is used only if a SELECT statement follows the COPY or COPYMOD statement.

The SELECT statement can name either the member to be copied or an alias name for a member. The format of these SELECT statements is:

SELECT MEMBER=member
SELECT MEMBER=alias             ALIAS OF member

The first SELECT statement identifies a member to be copied. The second identifies an alias and names the associated member in the comment portion of the statement.

Note: A SELECT statement identifying an alias can specify only one name on the MEMBER operand and cannot specify RENAME.