DD statements for the full-function database HASH Check option

To enable the HD Pointer Checker HASH Check option, you must specify in FABJMAIN JCL, the appropriate DD statements for the HD Pointer Checker HASH Check option.

The following table summarizes the DD statements for HD Pointer Checker.

Table 1. DD statements for HD Pointer Checker (HDPC=Y is specified)
DDNAME	Use	Format	Required or optional
DBDEFCTL	Output	LRECL=133	Required if run in multiple steps ^{(See Note 1)}
IMS2	Input	PDS	Required if you use FABPZWTO
FSESTAT	Input/Output	LRECL=134	Required if run in multiple steps ^{(See Note 2)}
HISTORY	Input/Output	KSDS	Required if run with the HISTORY option
PRIMAPRT	Output	LRECL=133	Required
STATIPRT	Output	LRECL=133	Required ^{(See Note 2)}
VALIDPRT	Output	LRECL=133	Required ^{(See Note 2)}
EVALUPRT	Output	LRECL=133	Required if run in single step
SUMMARY	Output	LRECL=133	Required if run in single step
SNAPPIT	Output	LRECL=133	Required ^{(See Note 2)}
SORTEX	Output	LRECL=40	Required if run in multiple steps ^{(See Note 3)}
SPMNIN	Input	LRECL=80	Optional
SPMNSPDT	Input/Output	Fixed record length	Optional
Notes: If you want to invoke HD Pointer Checker HASH Check in single step, do not specify this statement or specify DUMMY. Besides the data sets in this table, the following data sets are allocated dynamically as temporary data sets. You do not need to specify them in the JCL, but you must not use these names in your JCL statements because they are used by HD Pointer Checker. STATIP`nn` DD (`nn`=01, 02, 03, ...99) VALIDP`nn` DD (`nn`=01, 02, 03, ...99) SNAPPI`nn` DD (`nn`=01, 02, 03, ...99) FSESTA`nn` DD (`nn`=01, 02, 03, ...99) If you want to invoke HD Pointer Checker HASH Check in single step, do not specify the SORTEX DD statement nor specify DUMMY for the DD statement.

The following DD statements are applicable when HDPC=Y is specified.

DBDEFCTL DD

If HDPC=Y is specified in the ICEIN statement, either the single step or multiple steps HD Pointer Checker HASH Check is invoked. If this DD statement is specified, it means that multiple step is chosen, and so DBD Analysis and HASH evaluation steps become necessary. If you want to invoke HD Pointer Checker HASH Check in single step, delete this statement or specify DUMMY.

This statement defines the input partitioned data set created by the HD Pointer Checker DBD Analysis program. This data set contains:

Database definitions for each database as a PDS member named with each DBD name
The process control information for the HD Pointer Checker HASH Check option

To specify the member name of the process control information, use the DATASET (or DSN) keyword as follows:

   DBDEFCTL DD DISP=SHR,DSN=HPS.DBDEFCTL(member)

If the member named is omitted, as in the following example, the default member name PROCTL01 is used for the control information.

   DBDEFCTL DD DISP=SHR,DSN=HPS.DBDEFCTL

This data set lists all of the databases that take part in the logical relationship and must be evaluated at the same time. For details about preparing this data set, see DBD Analysis program reference.

IMS2 DD

This statement defines the library that contains the FABPZWTO user exit, the partition selection exit module, or both. The data set must reside on a direct-access volume. It is required if you want to use FABPZWTO, the partition selection exit, or both.

FSESTAT DD

This statement defines the work data set used by the HDAM, HIDAM, HDAM, and PHIDAM scan processes. The statement is required if you want to run the Image Copy function with the HD Pointer Checker HASH Check option in multiple steps. If BLKSIZE is coded on the DD statement, it must be a multiple of 134.

HISTORY DD

This optional data set defines the HISTORY data set (VSAM KSDS) that is used as input to the DB Historical Data Analyzer and Space Monitor of IMS HP Pointer Checker. When the HISTORY option is specified, this data set is required, and must be allocated and initialized by the DB Historical Data Analyzer utility before you run IMS HP Image Copy. DISP=SHR must be used. For more information, see the IMS High Performance Pointer Checker User's Guide.

PRIMAPRT DD

This statement defines the output data set that contains primary reports generated by the HISAM, INDEX, HDAM, HIDAM, PHDAM, and PHIDAM HASH Check option processes. The statement is required if you want to run the Image Copy function with the HD Pointer Checker HASH Check option. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

STATIPRT DD

This statement defines the output data set that contains the statistics reports generated for HISAM, HDAM, HIDAM, PHDAM, and PHIDAM. This statement is required if you want to run the Image Copy function with the HD Pointer Checker HASH Check option. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

VALIDPRT DD

This statement defines the output data set that contains the legend and the validation reports produced by the HISAM, INDEX, HDAM, HIDAM, PHDAM, and PHIDAM HASH Check option processes. The statement is required if you want to run the Image Copy function with the HD Pointer Checker HASH Check option. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

EVALUPRT DD

This statement defines the output data set containing the evaluation reports. It is required if you want to run the Image Copy function with the HD Pointer Checker HASH Check option in single step. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

SUMMARY DD

This statement defines the output data set containing the summary reports. It is optional. If BLOCKSIZE is coded on the DD statement, it must be a multiple of 133.

SNAPPIT DD

This statement defines the output data set that contains the block maps and block dumps that the HDAM, HIDAM, HDAM, and PHIDAM scan processes produce. The block maps and block dumps are produced when the HDAM HIDAM, HDAM, and PHIDAM scan process detects pointer errors, incorrect FSEAPs or FSEs, or T2 errors. The statement is required if you want to run the Image Copy function with the HD Pointer Checker HASH Check option. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

SORTEX DD

This statement defines the output data set that contains 40 byte sort records written by the HISAM, INDEX, HDAM, HIDAM, PHDAM, and PHIDAM processes. It contains pointer type records for both each segment type and each segment type records. This data set is used as the input data set for the subsequent EVALUATE process. The statement is required if you want to run the Image Copy function with the HD Pointer Checker HASH Check option in multiple steps. LRECL must be 40, and BLKSIZE must be a multiple of 40. If you want to invoke the HD Pointer Checker HASH Check option in single step, delete this statement. Do not specify "DUMMY" for the SORTEX DD.

SPMNIN DD

This optional input data set contains the control statements for Space Monitor of IMS HP Pointer Checker. For more information, see the IMS High Performance Pointer Checker User's Guide.

SPMNSPDT DD

This optional input/output sequential data set is the graph record data set for Space Monitor. For more information, see the IMS High Performance Pointer Checker User's Guide.