Invoking the Image Copy function through stand-alone DFSUDMP0

To invoke the stand-alone DFSUDMP0 to take image copies, complete the following steps.

Procedure

In the DFSUDMP0 JCL, code the EXEC statement as follows:
```
// EXEC PGM=DFSUDMP0,PARM='options'
```
where options can be:

CIC

Creates concurrent image copies of OSAM and VSAM ESDS database data sets.

If you specify CIC, you must specify DBRC=Y for full-function databases. For Fast Path databases, CIC can be specified with DBRC=N. However, the generated image copies are not to be used for database recovery.

COMPMODE=COND|N

The COMPMODE keyword controls the priority of the compression methods for compressing the output image copy data sets. This keyword also controls the Improved Data Recording Capability (IDRC) feature for the tape volume where the output image copies are generated.

DBRC=Y | N

Specifies whether or not the Image Copy function uses DBRC.

HPIO=Y | N

Specifies whether or not to use the HP Input/Output interface to read a database.

Y specifies that the HP Input/Output methods are to be used.

HP Input/Output uses EXCP for input and output OSAM data sets and for input VSAM ESDS data sets. This keyword is ignored for other types of data sets and for concurrent image copy generation for VSAM ESDS of full-function databases.

The basic access methods are used in these cases.

If you specify HPIO=Y, all the load libraries of IMS HP Image Copy must be APF-authorized.

If you specify a value other than Y or N, the Image Copy function issues messages DFS310A and DFS391I and ends with an error.

ZIIPMODE=COND | NEVER

Specifies whether to offload some workload to zIIP processors.

COND

Specifies that IMS HP Image Copy offloads some workload to zIIP processors. COND is effective only when available zIIP processors are found. Otherwise, the job is run on the main CPs.

NEVER

Specifies that IMS HP Image Copy does not offload any workload to zIIP processors. NEVER is the default to avoid unexpected performance degradation.

If you specify ZIIPMODE=COND, you must add the SGLXLOAD library of IMS Tools Base to the STEPLIB. All the load libraries of IMS HP Image Copy must be APF-authorized.

For considerations for using zIIP processors, see Offload workload to zIIP processors.

GSGNAME=gsgname

An optional 1- to 8-character name that identifies the global service group.

IMSPLEX=plexname

Specifies which IMSplex DBRC should join.

The IMSPLEX parameter can be specified on all job steps that use DBRC.

DBRCGRP=xxx

Specifies the DBRC group ID defined in the RECON data set used by the DBRC group.
Code the load module library in the STEPLIB DD statement.

STEPLIB DD statement points to two load module library data sets. These module library data sets must be in the following sequence:
```
//STEPLIB  DD   DISP=SHR,DSN=HPS.SHPSLMD0
//         DD   DISP=SHR,DSN=IMS.SDFSRESL
```
where:

HPS.SHPSLMD0

The name of the library that contains the IMS HP Image Copy load modules.

IMS.SDFSRESL

The name of the library that contains the IMS nucleus and required action modules.

If you want to use the site default table to apply the control statement parameters that you defined in the table, specify the library that contains the site default table to the STEPLIB concatenation.

Important: Ensure that you specify the site default table that is created for IMS compatible JCL jobs. For more information about creating a site default table and setting default values for IMS compatible JCL jobs, see Setting default values (IMS compatible JCL).

If you specify HPIO=Y, the load module libraries of IMS HP Image Copy must be APF-authorized.
When you enable the HASH Check option of IMS HP Image Copy, you must concatenate the following libraries to the STEPLIB DD statement:
- If the HASH Check option is enabled for full-function databases, the load module library of IMS HP Pointer Checker.
- If the HASH Check option is enabled for Fast Path databases, the load module library of IMS HP Fast Path Utilities.
If IMS HP Pointer Checker is called with HOMECHK, CHAINDIST, or COMPFACT option, you must specify the library that contains the randomizer or the segment edit/compression routine.
When you request to schedule the compression routine of IMS HP Image Copy in zIIP processor, you must concatenate the SGLXLOAD library of IMS Tools Base to the STEPLIB, and APF-authorize all the libraries that are specified to the STEPLIB.

If STEPLIB is unauthorized because it specifies the libraries concatenated to IMS.SDFSRESL, you must include a DFSRESLB DD statement.
Code the appropriate DD statements. For a list of DD statements, see DD statements for the Image Copy function (DFSUDMP0 JCL).
Code the corresponding control statement in the SYSIN data set. For control statements, see Control statements for the Image Copy function (DFSUDMP0 JCL).

Examples are provided in Examples for taking image copies with DFSUDMP0 JCL.
Submit the JCL.