HASH Evaluation program reference

Utility control statements

No utility control statement is needed to run the HASH Evaluation program.

DD statements

To run the HASH Evaluation program, supply an EXEC statement and the appropriate DD statements that define the input and output data sets.

The following table summarizes the DD statements.

STEPLIB DD

This statement points to the load module library data set of HD Pointer Checker.

SYSPRINT DD

This statement defines the output messages data set. The data set can reside on a tape, a direct-access volume, or a printer, or it can be routed through the output stream (SYSOUT). SYSPRINT can be blocked but must be a multiple of 121.

SYSUDUMP DD

This statement defines the optional output data set that defines the output from a system ABEND dump routine. It is used only when a dump is required. Although this statement is optional, you should include this data set.

DBDEFCTL DD

This statement defines the required input partitioned data set created by a preceding DBD Analysis program job. This data set contains the database definition information for each database as a PDS member named with each DBD name, and the process control information for the HD Pointer Checker HASH Check function. Specify the member name of the process control information with the DSNAME (or DSN) keyword as follows:

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

If the member name is not specified (see the following example), the default member name PROCTL01 is used for the control information.

DBDEFCTL DD DISP=SHR,DSN=HPS.DBDEFCTL 

PRIMAPRT DD

This statement defines the output data set containing the primary reports. It is optional. If BLOCKSIZE 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 BLOCKSIZE 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.

SORTIN DD

This statement specifies the input HASH record data sets created by the preceding Image Copy function with the HASH Check function jobs. A complete set of the HASH record data sets must be concatenated on the DD statement. Otherwise, the HASH Evaluation program process might not be completed and erroneous pointer error messages might be issued.

IMS DD

This statement defines the library that contains the PSB library and the DBD library. It must contain all DBDs that are referred to by your PSB. If your PSB and DBDs are not in the same library, all appropriate libraries must be concatenated.

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.

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.

DFSRESLIB DD

This statement points to an authorized library that contains the IMS SVC modules.

DFSVSAMP DD

This statement describes the data set that contains the buffer information required by the DL/I buffer handler.

RECON1 DD

RECON2 DD

RECON3 DD

These statements specify the DBRC RECON data sets. These statements are required if HALDB exists in the databases and the RECON data sets are not allocated dynamically, or if DBRC parameter is Y and the RECON data sets are not allocated dynamically. Do not specify these RECON data set DD statements if you want RECON data sets allocated dynamically using the DFSMDA macro.