PH30776: THIS APAR ENABLES HISTORY OPTION OF DEDB HASH CHECK

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables HISTORY option of DEDB HASH Check that records
  DEDB history data during HASH check.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS High Performance Image Copy for z/OS     *
  *                 Version 4 Release 2 ( FMID=H1J0420 ) users   *
  *                 who use HASH check option for DEDB           *
  *                 ( DEDBPC ).                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR introduces the HISTORY        *
  *                      option for the DEDBPC keyword. If the   *
  *                      HISTORY option is enabled, IMS HP       *
  *                      Image Copy (FABJMAIN) records DEDB      *
  *                      history data during DEDB HASH Check.    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR introduces the HISTORY option for the DEDBPC keyword.
  If the HISTORY option is enabled, IMS HP Image Copy (FABJMAIN)
  records DEDB history data during DEDB HASH Check.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS High Performance Image Copy for z/OS Version 4
  Release 2 User's Guide (SC19-2756-03) should be changed as
  follows:
  
  Running IMS HP Image Copy
  > Taking image copies
   > DD statements for the Image Copy function
    > DD statements for the DEDB HASH Check option
  
    Table. DD statements for DEDB Pointer Checker (DEDBPC=Y or
           DEDBPC=S is specified)
           (Table 11 in PDF)
    +---------+--------+-----------+-------------------------+
    | DNAME   | Use    | Format    | Required or optional    |
    +---------+--------+-----------+-------------------------+
  | | HISTORY | Output | LRECL=100 | Required if run with    |
  | |         |        |           | the HISTORY option      |
    +---------+--------+-----------+-------------------------+
    | ...     |        |           |                         |
    +---------+--------+-----------+-------------------------+
  
    The following DD statements are applicable when DEDBPC=Y
    or S is specified.
  
    HISTORY DD
      This statement defines the output data set that contains
      historical records. A historical record is generated for
      each area if the HISTORY parameter is specified for the
      DEDBPC keyword.
      For more information, see the IMS Fast Path Solution
      Pack IMS High Performance Fast Path Utilities User's
      Guide.
  
  Taking image copies
   > Control statements and keywords
    > ICEIN control statement keywords
     > DEDBPC keyword
  
  This topic has been updated as follows:
    The DEDBPC keyword enables the HASH Check option of the DEDB
    Pointer Checker utility.
    ...
    Format
      >> DEDBPC= --+-----N------------------------------+
                   |-----Y------------------------------|
  |                |-----S------------------------------|
  |                +--(--+--Y--+--,--+--SEGLDIST--+--)--+
  |                      |     |     |            |
  |                      +--S--+     +--HISTORY---+
  
    Y
      Enables the DEDB HASH pointer check option.
    N
      Does not enable the DEDB HASH pointer check option.
  | S
      Enables the DEDB HASH pointer check option.
      SSP pointers are also evaluated during DEDB HASH
      pointer check.
    SEGLDIST
      Requests the DEDB Pointer Checker utility to print
      the Segment Length Distribution report. For more
      information about this report, see the IMS Fast Path
      Solution Pack IMS High Performance Fast Path Utilities
      User's Guide.
  |  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.
  |    For details about the HISTORY option, see the IMS Fast
  |    Path Solution Pack IMS High Performance Fast Path Utilities
  |    User's Guide.
  |    Note: To enable the HISTORY option, APAR PH30776 must be
  |          applied to IMS HP Image Copy and APAR PH28270 must be
  |          applied to IMS Fast Path Solution Pack.
  

Problem conclusion

Temporary fix

Comments

• This APAR introduces the HISTORY option for the DEDBPC keyword.
  To enable the HISTORY option, APAR PH28270 must be applied to
  IMS Fast Path Solution Pack.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI72602

Modules/Macros

• FABJGLRP FABJGVT0 FABJMAIN FABJPARM FABJSTMD FABJTGEN
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI72602

     UP20/11/18 P F011

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.