Utility Control Statements

IEBCOPY is controlled by the utility control statements in Table 1.

Table 1. IEBCOPY utility control statements. The minor statements (SELECT or EXCLUDE) can follow each major statement to restrict the scope of the major statements.
Statement	Use
Major Statements
ALTERMOD	Indicates the beginning of an alter-in-place operation for load modules.
COPY	Indicates the beginning of a COPY operation.
COPYGRP	Indicates the beginning of a COPYGRP operation.
COPYGROUP	Indicates the beginning of a COPYGROUP operation.
COPYMOD	Indicates the beginning of a copy and load module reblock operation.
INDD=	Indicates the beginning of another copy step.
Minor Statements
EXCLUDE	Specifies members in the input data set to be excluded from the copy step.
SELECT	Specifies which members in the input data set are to be copied.

COPY will accept the first letter as an abbreviation for all its key words, except MINBLK. COPYMOD may be abbreviated CM. COPYGRP may be abbreviated CG. COPYGROUP may be abbreviated CP.

To continue the copy control statement, stop at a comma. Put any nonblank character in column 72 and start in column 16 on the next record.

To make a comment statement, place an asterisk (*) in the left column where the label field goes. The record will be printed, then ignored. You may also place a comment on any control statement which also has an operand. Leave 1 or more spaces after the operand, and then start your comment.

To request a COPY operation, specify partitioned data sets as input and output.
To request an UNLOAD operation, specify a partitioned input data set and a sequential output data set.
To request a LOAD operation, specify a sequential input data set and a partitioned output data set.

IEBCOPY uses a copy operation/copy step concept. A copy operation starts with a COPY, COPYGRP, COPYGROUP, COPYMOD, or ALTERMOD statement, and continues until another COPY, COPYGRP, COPYGROUP, COPYMOD, or ALTERMOD statement is found, or the end of the control data set is found. Within each copy operation, one or more copy steps are present. Any INDD statement directly following a SELECT or EXCLUDE statement marks the beginning of the next copy step and the end of the preceding copy step within the copy operation. If such an INDD statement cannot be found in the copy operation, the copy operation will consist of only one copy step.

Table 2 shows the copy operation/copy step concept. Two copy operations are shown in the figure. The first begins with the statement named COPOPER1, and the second begins with the statement named COPOPER2.

Table 2. Multiple copy operations within a job step
Step	Label	Command	Parameters
First Copy Operation
STEP 1	COPOPER1	COPY	OUTDD=AA INDD=ZZ INDD=(BB,CC) INDD=DD INDD=EE
		SELECT	MEMBER=(MEMA,MEMB)
		SELECT	MEMBER=(MEMC)

STEP 2			INDD=GG INDD=HH
		EXCLUDE	MEMBER=(MEMD,MEMH)
Second Copy Operation
STEP 1	COPOPER2	COPY	OUTDD=YY INDD=(MM,PP) LIST=NO
		SELECT	MEMBER=MEMB

STEP 2			INDD=KK INDD=(LL,NN)

The first copy operation shown in Table 2 is copying two groups of members. The first begins with the COPY statement and continues through the two SELECT statements. The second begins with the first INDD statement following the two SELECT statements and continues through the EXCLUDE statement preceding the second COPY statement.

The second copy operation has two steps. The first step begins with the COPY statement and continues through the SELECT statement. The second begins with the INDD statement immediately following the SELECT statement.