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.
- 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
- If you wish to direct IEBCOPY to generate a control statement,
specify this parameter to make the control statement perform a COPY
operation.
- COPYGRP
- 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.
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.
Related reading: For more information, see: