HDPC keyword

This keyword is effective when the executing function is batch image copy or concurrent image copy.

Functions that support this keyword

Image Copy function

Statements that support this keyword

• GLOBAL statement
• GROUP statement
• IC/AIC statement
• CIC/ACIC statement

Site default option

Supported

Related keyword

None.

Format

Y

Enables the HD Pointer Checker HASH Check option during the execution of the Image Copy function.

If HDPC=Y is specified for a database that is not supported by the HD Pointer Checker HASH Check option, an image copy of the database is created but no pointer checking is done.

O

Enables the HD Pointer Checker HASH Check option, but output image copy is not created, and therefore not notified as UIC for primary and secondary index data set.

If HDPC=O is specified for data sets other than the primary or the secondary index data set, the Image Copy function runs the same process as if HDPC=Y is specified.

N

Does not enable the HD Pointer Checker HASH Check option.

HISTORY

Requests to update the HISTORY data set of the database data sets to analyze. If the HISTORY option is specified, the HISTORY data set is required.

This option can be specified when HDPC=Y is specified and the DBDEFCTL data set is not specified or dummy; that is, when the HASH Check option runs in single step. This option cannot be specified for multiple-step HASH Check runs. If you want to specify the HISTORY option for multiple-step HASH Check runs, specify HISTORY=YES on the PROCCTL statement.

For details about the HISTORY option, see the IMS High Performance Pointer Checker User's Guide.

BITMAP

Generates a Bit Map Display report for the HDAM, HIDAM, PHDAM, or PHIDAM database.

This option is effective for the single-step HD Pointer Checker HASH Check option. For multiple-step HASH Check runs, specify REPORT BITMAP in the PROCCTL data set for the DBD Analysis program.

FSEMAP

Generates a Free Space Map report for the HDAM, HIDAM, PHDAM, or PHIDAM database.

This option is effective for the single-step HD Pointer Checker HASH Check option. For multiple-step HASH Check runs, specify REPORT FSEMAP in the PROCCTL data set for the DBD Analysis program.

MAXFSD

Generates a Maximum Free Space Distribution report for the HDAM, HIDAM, PHDAM, or PHIDAM database.

This option is effective for the single-step HD Pointer Checker HASH Check option. For multiple-step HASH Check runs, specify REPORT MAXFSD in the PROCCTL data set for the DBD Analysis program.

DBDIST

Generates the DB Record Distribution Statistics report. It is available for HDAM, HIDAM, PHDAM, and PHIDAM databases. This report contains the following information:

TOTAL NUMBER OF SEGMENTS (ROOTS + DEPENDENTS) IN THE DATA SET MAXIMUM ROOTS PER BLOCK

DBDIST is not supported under the following conditions:

• Multiple-step HASH Check
• Concurrent image copy process
• The HASH Check option is called from an IMS Database Reorganization Expert job

DEPDIST

Prints the following three parts about dependent segments, in the DB Record Distribution Statistics report:

• Distribution summary of dependent segments
• Distribution of dependent segments in root block
• Distribution of dependent segments by segment code

The DBDIST option controls whether to print the DB Record Distribution Statistics report. If you specify DEPDIST, you must also specify DBDIST. If DEPDIST is specified, but DBDIST is not specified, it is assumed that both DEPDIST and DBDIST are specified, thus the above three parts and DB Record Distribution Statistics report are printed.

CHAINDIST

Prints the Distribution of RAP Chain Lengths part in the DB Record Distribution Statistics report. This part is printed for HDAM or PHDAM databases.

Randomizer module is used for this option. Specify the data set name that contains the randomizer module on the STEPLIB DD statement.

If a segment edit/compression exit routine is defined to the root segment, the segment edit/compression exit module is used for this option. Specify the data set name that contains the segment edit/compression exit on the STEPLIB DD statement.

It is supported for the single-step HASH Check option that is called from an IMS HP Image Copy job.

CHAINDIST is not supported under the following conditions:

• Multiple-step HASH Check
• Concurrent image copy process
• The HASH Check option is called from an IMS Database Reorganization Expert job

COMPFACT

Prints the compression factor in the Partition Statistics report and the Database Statistics report. A segment edit/compression routine is used for this option.

Specify the data set name that contains the exit load module to the STEPLIB DD statement. It is supported in the single-step HASH Check under IMS HP Image Copy job.

COMPFACT is not supported under the following conditions:

• Multiple-step HASH Check
• Concurrent image copy process
• The HASH Check option is called from an IMS Database Reorganization Expert job

SEGIO

Prints the Rate of Segment I/O occurrence part in the Partition Statistics report and the Database Statistics report. It is available for HDAM, HIDAM, PHDAM, and PHIDAM databases.

If SEGIO is specified for databases other than the above, it is ignored.

SEGIO is supported for the single-step HASH Check option that is called in an IMS HP Image Copy job. It is not supported for multiple-step HASH Check runs.

VLSSUMM

Prints the summary of VL segment sizes in the Partition Statistics report and Database Statistics report.

VLSSUMM is supported for the single-step HASH Check option that is called in an IMS HP Image Copy job. It is not supported for multiple-step HASH Check runs.

If VLSSUMM is specified for multiple database data sets, this option is effective for all of those database data sets.

Default value

HDPC=N

Usage note

DBDIST, CHAINDIST, COMPFACT, and DEPDIST parameters of the HDPC keyword cannot be specified with CIC, ACIC, GROUP FUNC=CIC, or GROUP FUNC=ACIC statement. If these parameters are specified in the GLOBAL statement, they are ignored in subsequent CIC, ACIC, GROUP FUNC=CIC, and GROUP FUNC=ACIC statements.