EXEC Statement

The syntax of the EXEC statement is:

Label	Statement	Parameters
//[stepname]	EXEC	[,PGM=IEBCOPY.
		[,REGION={n\|nK\|nM}]
		[,PARM=<parms>]

where:

PGM=IEBCOPY

specifies that you want to run the IEBCOPY program.

REGION={n|nK|nM}

specifies the amount of storage to be made available to IEBCOPY by the operating system. Specify 1M if you are only using partitioned data sets. If you are using any PDSE, then specify 2M.

Notes:

The number n can be any number of digits, and is specified in decimal. The K causes the number to be multiplied by 1024 bytes (1 kilobyte) and M causes the number to be multiplied by 1024K or 1048576.
Specifying a larger REGION size might not have an effect unless the WORK= value is also increased.
Specifying a REGION size on the JOB statement will override any REGION specified on the EXEC statement.

PARM=

You may specify any of the parameters in any order to IEBCOPY. Separate multiple parameters with a comma between each one.

ALTERMOD or AM

If you direct IEBCOPY to generate a control statement, specify this parameter to make the control statement perform an ALTERMOD operation instead of a COPY operation.

BYPASS_AUTH

Specify this parameter if you wish to direct IEBCOPY to bypass RACF authorization checking for a DASD sequential or partitioned (PDS or PDSE) data set. This option does not apply to tape, spooled data sets, work data sets, or data set password checking. If the BYPASS_AUTH option is specified, IEBCOPY must be invoked by an APF-authorized caller. If the parameter is passed from a non APF-authorized caller, abend 913-80 will be issued.

CMWA=nK

Specify this parameter to increase the COPYMOD work area size of 120K if larger load modules are being processed. This will be evident because message IEB1133E will be issued in this instance.

COMPRESS

If you direct IEBCOPY to generate a control statement, specify this parameter to make the control statement perform a compress-in-place operation instead of a COPY operation.

COPY or C

If you wish to direct IEBCOPY to generate a control statement, specify this parameter to make the control statement perform a COPY operation.

COPYGROUP or CP

If you wish to direct IEBCOPY to generate a control statement, specify this parameter to make the control statement perform a COPYGROUP operation.

COPYGRP or CG

If you wish to direct IEBCOPY to generate a control statement, specify this parameter to make the control statement perform a COPYGRP operation.

COPYMOD

If you wish to direct IEBCOPY to generate a control statement, specify this parameter to make the control statement perform a COPYMOD operation.

LC=n

LPP=n

LINECOUNT=n

n is the number of lines, including headings, to print on each page of the SYSPRINT output listing. Default is 60.

LIST=NO

LIST=YES

sets the default value for the LIST= operand when it is omitted from the COPY, COPYMOD, or ALTERMOD statement. Default is LIST=YES.

RC4NOREP

Use of this parameter will cause IEBCOPY to set a return code of X'04' when a module is not copied from the source data set to the target data set because REPLACE was not specified. When 'RC4NOREP' is specified, message IEB1067W will be issued for each module NOT copied due to the REPLACE option not being specified. Note: Message IEB1067W will be issued regardless of the LIST option requested.

REPLACE

If you wish to direct IEBCOPY to generate a control statement, specify this parameter to make the control statement perform a copy with replace operation.

SIZE={n|nK|nM}

specifies the maximum number of bytes of virtual storage that IEBCOPY may use as a buffer.

It is best to let IEBCOPY choose buffer sizes by not using this parameter.

The minimum buffer size is approximately 4 times the largest track size of the devices being used, plus about 3%. There is no maximum for this value, but IEBCOPY cannot use more than the quantity available in the work area.

The number n can be any number of digits, and is specified in decimal. The K causes the number to be multiplied by 1024 bytes (1 kilobyte) and M causes the number to be multiplied by 1024K or 1048576.

SPCLCMOD

specifies that when a member is found to be ineligible for COPYMOD, processing (for example, the module is page aligned) and the module is scheduled for processing as a normal COPY, the detection of a record larger than the blocksize of the target data set will cause the entire operation to be terminated (no fat blocks will be created).

If the COPY operation resulting from COPYMOD ineligibility is successful, the return code of the operation will be set to zero instead of four (normally return code is set to 4 to indicate that a COPY instead of a COPYMOD was done for the affected modules, if LIST=YES is in effect).

WORK={n|nK|nM|1M}

specifies the number of bytes of virtual storage to request for a work area to hold directory entries, internal tables, and I/O buffers. The default request will be for 1M. The actual amount obtained will not exceed the space available in the REGION.

Related reading: For more information, see: