The EXEC statement for IEHMOVE can contain parameter information
that is used by the program to allocate additional work space or control
line density on output listings. You can also code the REGION subparameter
to control the region size that IEHMOVE operates in when you are moving
or copying sequential data sets.
The syntax of the EXEC statement is:
Label |
Statement |
Parameters |
---|
//[stepname] |
EXEC |
PGM=IEHMOVE |
|
|
[,PARM='[POWER=n] [,LINECNT=xx]'] |
|
|
[,REGION={nK|nM}] |
where:
- PGM=IEHMOVE
- specifies that you want to run IEHMOVE.
- PARM='[POWER=n] [,LINECNT=xx]'
- specifies optional parameter information to be passed to IEHMOVE.
- POWER=n
- specifies that you want to increase the size of the space allocated
to the work areas that IEHMOVE will use. You should use this parameter
when moving or copying partitioned data sets that have more than
750 members. N may be from 1 to 999. To
calculate it, divide the number of members by 750 and round the result
up to be an integer. Code that value or a larger value. For example,
code:
- POWER=2 when 750 to 1500 members are to be moved or copied.
- POWER=3 when 1501 to 2250 members are to be moved or copied.
- POWER=4 when 2251 to 3000 members are to be moved or copied.
The default value for N is 1.
Note that if you code a very large value, it probably will fail due
to running out of storage.
- LINECNT=xx
- specifies how many lines per page will be printed in the listing
of the SYSPRINT data set. Xx can be a two-digit number from
04 through 99.
- REGION={nK|nM}
- specifies the region size you want IEHMOVE to run in when you
are moving or copying sequential data sets.
You can use this parameter to enhance IEHMOVE performance, but it
is not a required parameter for moving or copying sequential data
sets.
The minimum number of buffers required for enhanced IEHMOVE
copy performance is 4: two for input and two for output. The size
of an input buffer is computed as:
(INPUT BLOCKSIZE + KEY LENGTH) + 24
The size of an output buffer is computed as:
(OUTPUT BLOCKSIZE + KEY LENGTH) + 40
The maximum number of input buffers used by IEHMOVE is
two times the number of buffers that will fit in the input track size.
The maximum number of output buffers used by IEHMOVE is two times
the number of buffers that will fit in the output track size.
If
space for the minimum of four buffers is not available, a single buffer
is used and message IEH476I is issued.
You can code this parameter
in the JOB statement rather than the EXEC statement, if you prefer.
Message IEH477I, describing the number and size of your buffers, will
be issued each time multiple BSAM buffers are used. If you do not
specify your region size to achieve the maximum number of buffers,
the last line of the message will indicate the amount by which the
value of the REGION parameter should be increased in order to obtain
the maximum number of buffers.
The execution time of an IEHMOVE
move or copy operation will vary with the number of buffers available,
the size of the data sets, and the block size.