PM97584: PROVIDE A NEW FUNCTION TO REPAIR HALDBS WITH DUPLICATE ILKS BY HDPC AND DBRF

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Provide a new function to repair HALDBs with duplicate ILKs by
  HDPC and DBRF
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS High Performance Pointer Checker for *
  *                 z/OS Version 3 Release 1 (FMID=HPC2310)      *
  *                 users who run HD Pointer Checker (HDPC) with *
  *                 the Standard Check function for HALDB        *
  *                 processing.                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: By this APAR and IMS Database Repair    *
  *                      Facility APAR PM97585, the new function *
  *                      is provided to repair HALDBs that       *
  *                      contain corrupted HALDB partition       *
  *                      reorganization numbers, duplicate ILKs, *
  *                      or potentially duplicate ILKs.          *
  *                                                              *
  *                      Additionally, this APAR fixes the       *
  *                      following problems:                     *
  *                      - HDPC with HASH=NO and EPSCHK=YES      *
  *                        erroneously issues MSGFABP3590E and   *
  *                        ends with ABENDU3590 in stand-alone   *
  *                        (FABPMAIN) jobs.                      *
  *                      - HDPC with DUPILKCHK=YES erroneously   *
  *                        issues MSGFABP2147E in stand-alone    *
  *                        (FABPMAIN) jobs.                      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  By applying both this APAR and IMS Database Repair Facility
  (DBRF) APAR PM97585, you can repair HALDB databases that contain
  corrupted HALDB partition reorganization numbers, duplicate
  ILKs, or potentially duplicate ILKs (these problems are
  indicated by MSGFABP2147E, MSGFABP2148E, or MSGFABP2149E).
  
  This APAR adds a new keyword "REPARILK" to HDPC. When you
  specify REPARILK=YES, you can make HDPC generate repair
  information records that are used as input to DBRF to repair
  HALDB databases that have such problems.
  
  For information about how to specify the new keyword and repair
  such problems in HALDB databases by using HDPC and DBRF, see
  documentation updates for IMS High Performance Pointer Checker
  User's Guide on IMS Tools library site:
    http://www-01.ibm.com/software/data/db2imstools/
    imstools-library.html
  
  Additionally, this APAR fixes the following two problems:
  1. HDPC wrongly issues MSGFABP3590E and ends with ABENDU3590
     when all of the following conditions are met:
     - HDPC is run for HALDBs that have logical relationships in
       stand-alone (FABPMAIN) jobs.
     - The logical child segments are split.
     - HASH=NO and EPSCHK=YES are specified on the PROC statement.
  2. When HDPC with DUPILKCHK=YES is run for HALDBs that have
     logical relationships or secondary index (PSINDEX) databases
     in stand-alone (FABPMAIN) jobs, HDPC wrongly issues
     MSGFABP2147E against ILKs that have the same values in
     different segments. HDPC should not consider such ILKs as
     duplicate.
  

Problem conclusion

Temporary fix

Comments

• Documentation Changes:
  
  The documentation "IMS High Performance Pointer Checker for
  z/OS, V3R1, User's Guide (SC19240102)" is changed.
  
  For details about the documentation changes, see documentation
  updates on IMS Tools library site:
    http://www-01.ibm.com/software/data/db2imstools/
    imstools-library.html
  

APAR Information

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

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

  UI13103

Modules/Macros

• FABPADBS FABPADEF FABPAPRS FABPDILK FABPEALC
  FABPECTL FABPESTM FABPE15G FABPE35G FABPKCTL FABPLINK FABPMAIN
  FABPMSGT FABPPSDA FABPRDEF FABPRPTH FABPUCB0 FABPURTO FABPXCTL
  HPC2310J
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R310 PSY UI13103

     UP13/12/04 P F312

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.