Updates that apply to IMS Fast Path Solution Pack V2.1 Supplementary Utilities User's Guide (SC27-9598-00).
Date of change: November 2020
Change description: Documentation changes by APAR PH28270.This APAR enables HPFPU Hash Check support for IMS HP Image Copy to generate historical records in the HFPAHST data set when the DEDBPC=(Y,HISTORY) keyword is specified in the ICEIN control statements and the HFPAHST DD statement is specified in the JCL.
Topics: Changes apply to multiple topics.
Topic: Integration with IMS HP Image Copy > HPFPU Hash Check support for IMS HP Image Copy > Output for HPFPU Hash Check support for IMS HP Image Copy
The following new topic has been added after "SNAPDPIT DD data set":
HFPAHST DD data set
The HFPAHST DD data set defines an output data set that contains historical records. The HPFPU Hash Check support for IMS HP Image Copy adds one record for each DEDB area that it processes. The record contains the key space utilization and performance information for that area. This historical record is generated for the area that is specified by the DEDBPC=(Y,HISTORY) keyword.
If this feature is used, the HFPAHST data set must be preallocated with the following attributes:
The DD statement in the JOB stream is specified as:
//HFPAHST DD DSN=HPFP.HISTORY,DISP=(MOD,KEEP,KEEP)
For the record layout of the historical file, see the topic "History file records layout" in the IMS Fast Path Solution Pack: IMS High Performance Fast Path Utilities User's Guide.
Important: To create historical records, the following APARs must be applied:
- APAR PH28270 to IBM IMS Fast Path Solution Pack for z/OS
- APAR PH30776 to IBM IMS High Performance Image Copy for z/OS
Topic: Integration with IMS HP Image Copy > HPFPU Hash Check support for IMS HP Image Copy > Examples: HPFPU Hash Check support for IMS HP Image Copy
Example 2: HPFPU Hash Check and analysis of segment length distribution
This topic provides a JCL example to run an IMS HP Image Copy job, for a DEDB, with the HPFPU Hash Check support. This job takes image copies of two area data sets and generates a HASH evaluation report, a Segment Length Distribution report, and a historical record for each area.
Figure. HPFPU Hash Check and analysis of segment length distribution
(Figure 93 in PDF)
//HPICHASH EXEC PGM=FABJMAIN //STEPLIB DD DISP=SHR,DSN=HPFP.SHFPLMD0 // DD DISP=SHR,DSN=HPS.SHPSLMD0 // DD DISP=SHR,DSN=IMSVS.SDFSRESL //DFSRESLB DD DISP=SHR,DSN=IMSVS.SDFSRESL //SYSPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //ICEPRINT DD SYSOUT=* //DFSPRINT DD SYSOUT=* //MSGOUT DD SYSOUT=* //REPORTS DD SYSOUT=* //SNAPDPIT DD SYSOUT=* //HFPAHST DD DSN=&&SHST,DISP=(MOD,PASS,DELETE) //* //IMS DD DISP=SHR,DSN=IMSVS.DBDLIB //IMSDALIB DD DISP=SHR,DSN=IMSVS.MDALIB //ICEIN DD * GLOBAL DBRC=Y, DEDBPC=(Y,SEGLDIST,HISTORY), ICHLQ=ICOUT.HFP, UNIT=SYSDA, SPACE=(CYL,100,100) AIC DBD=DEDBJN23,AREA=DB23AR1 AIC DBD=DEDBJN23,AREA=DB23AR2 /*
Topic: Troubleshooting > Messages > FABA messages
The following new message has been added:
FABA4040E DEVTYPE FAILED FOR DDNAME HFPAHST
Explanation: The HPFPU Hash Check support for IMS HP Image Copy issued an SVC 24 (DEVTYPE) to obtain information about the HFPAHST DD data set, but the attempt failed.
System action: Processing ends with a return code of 16.
User response: Correct any errors, and rerun the job. If this situation persists, report it to systems operations personnel.
19 November 2020