JCL requirements4
The Image Copy function, which is included with MAXM Reorg solutions, runs under the Online Reorg function or Reorg function only; it does not run as a stand-alone utility.
The BMC Image Copy utility, which is included with the Backup and Recovery Solution for IMS product and the IMAGE COPY PLUS product, can be executed as a stand-alone utility. The Image Copy function is required for the Online Reorg function. It is optional for the Reorg function.
The Image Copy function has many of the same JCL requirements as IMAGE COPY PLUS. If you have existing IMAGE COPY PLUS JCL, you might be able to copy statements (such as ICPSYSIN) into the JCL for the executing the Online Reorg function or Reorg function.
The following DD statements are specific to the Image Copy function. For more information about other DD statements, see JCL-requirements5.
ICPSYSIN DD | Optional. Contains the commands and keywords for the Image Copy function. The IC or AIC command is required for each database that is being reorganized and is registered as RECOV in DBRC. If the ICPSYSIN DD statement is omitted, the Online Reorg function will automatically create an IMAGE COPY for all databases being reorganized that are registered as RECOV in DBRC. For more information, see ICPSYSIN-statements. |
|---|---|
output image copy DD | Required unless it is dynamically allocated (through keywords in the ICPSYSIN data set). Describes a data set to contain the output image copy created by the Image Copy function. The IC keyword value in the ICPSYSIN data set identifies the ddname of this data set. One statement of this type is required for each explicitly allocated output image copy. Do not specify DISP=(...,...,DELETE) for this data set. (This specification deletes the data set if the job step terminates abnormally.) If you are running multiple tasks per step and one of those tasks abends, the entire job step ends with the return code of the abended task. The other tasks in the job probably created good data sets (which the Image Copy function recognizes as good data sets). However, if these data sets were specified with DELETE, they are all deleted if any task abends, even though the task that created the data set did not itself abend. BMC recommends that you use dynamic allocation or specify the data sets with DISP=(...,...,KEEP) or DISP=(...,...,CATLG). BLKSIZE and BUFNO specifications on this DD statement might affect the determination of output block sizes and buffer pool sizes. If you do not specify a block size on the DD statement, Image Copy function optimizes the block size for the device to which it writes the data. Therefore, as a general rule, omit the block size specification for best performance. If you do specify a block size and the data set is fixed-block (FB or FBS), the block size must be a multiple of the LRECL; otherwise, the Image Copy function PLUS uses the optimum block size for the device. |
PLUSDUMP DD | Optional. This statement is a trigger to cause diagnostic information to be written to the PLUSOUT data set. If the PLUSOUT DD statement is not in the JCL, the output of PLUSDUMP is dynamically allocated as SYSOUT=*. |
REPORTS DD | Optional. Defines the output data set that contains the Image Copy function statistical reports. Normally, this statement defines a SYSOUT data set. If you do not include a REPORTS DD statement, the reports are directed to the ICPPRINT DD data set. The default DCB parameters are LRECL=121 and BLKSIZE=1210. To override these defaults, you must provide values for both parameters. However, Image Copy function only formats the first 121 positions of each record, even if you specify an LRECL greater than 121. |