IBM Support

Updates to IMS Fast Path Solution Pack V2.1 Supplementary Utilities User's Guide

Release Notes


Abstract

Updates that apply to IMS Fast Path Solution Pack V2.1 Supplementary Utilities User's Guide (SC27-9598-00).

Content

The most recent updates appear at the top of the list.

Update 1

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":

image 7001HFPAHST 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:

  • DSORG=PS
  • RECFM=FB
  • LRECL=100
  • BLKSIZE=user-specified

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/OSimage 7002
==========

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 has been updated as follows:

Example 2: HPFPU Hash Check and analysis of segment length distribution

image 7001This 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.image 7002

Figure. HPFPU Hash Check and analysis of segment length distribution
(Figure 93 in PDF)

image 7001

  //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
  /*
image 7002
==========

Topic: Troubleshooting > Messages > FABA messages

The following new message has been added:

image 7001

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.

image 7002

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSS8RM","label":"IMS Fast Path Solution Pack for z\/OS"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0"}]

Document Information

Modified date:
19 November 2020

UID

ibm16338557