PI49799: FPA BUILD INDEX AND ONLINE RESYNC FUNCTIONS TO ADD AN OPTION TO SPECIFY A MAXIMUM ALLOWABLE NUMBER OF DUPLICATE KEYS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• FPA BUILD INDEX and ONLINE RESYNC functions will add an option
  to specify a maximum allowable number of duplicate keys.
  If the number of duplicate keys reaches this value, the job will
  skip processing of subsequent indexes, and end with a return
  code of 8.
  
  These enhancements are being implemented as a result of RFE
  65344.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HPFPU Fast Path Advanced Tool   *
  *                 (FPA) in Fast Path Solution Pack Version 1   *
  *                 Release 3 (FMID: HAHQ130) who use the Build  *
  *                 Index function or the Resync function.       *
  ****************************************************************
  * PROBLEM DESCRIPTION: The FPA Build Index function and the    *
  *                      FPA Resync function add a keyword to    *
  *                      specify whether to end the job step     *
  *                      when the number of duplicate keys       *
  *                      reaches the threshold defined by the    *
  *                      DUPKEYMAX keyword.                      *
  *                                                              *
  *                      The FPA Resync function supports the    *
  *                      DUPKEYMAX keyword that can be specified *
  *                      on the Build Index function.            *
  *                                                              *
  *                      This APAR also fixes problems that the  *
  *                      HFPB3514E or the HFPT0009E message is   *
  *                      issued when running the Resync function *
  *                      with RESYNCMODE=VERIFYUPDATE or UPDATE. *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  A new keyword PROC_AFT_DUPKEY is added for the FPA Build Index
  function and the FPA Resync function.
  
  This keyword is used when the FPA detects the number of
  duplicate keys, which is specified by DUPKEYMAX keyword, for a
  Fast Path Secondary Index (FPSI) without an overflow data set.
  
   - When PROC_AFT_DUPKEY=CONT, which is the default, is
     specified, the FPA continues processing the subsequent
     secondary index databases even when the number of duplicate
     keys reaches the threshold.
   - When PROC_AFT_DUPKEY=STOP is specified, the FPA stops the job
     when the the number of duplicate keys reaches the threshold.
  
  The keyword DUPKEYMAX, which can be specified for the Build
  Index function, can also be specified for the FPA Resync
  function.
  
  The DUPKEYMAX keyword specifies the threshold for the number of
  duplicate keys per FPSI database. When the threshold is reached,
  FPA stops processing that FPSI database.  Whether FPA continues
  processing the remaining FPSI databases or stops the job is
  controlled by the PROC_AFT_DUPKEY keyword.
  
  The FPA Resync function generates the Secondary Index Duplicate
  Key report about the FPSIs that have duplicate keys.
  
  This APAR also resolves following problems.
  1. When the Resync function is performed with
  RESYNCMODE=VERIFYUPDATE and the CI or CA split occurs, the FPA
  Resync function may issue HFPB3514E message and ends with an
  abend code of U3003.
  2. When the multiple Resync jobs are running concurrently with
  RESYNCMODE=VERIFYUPDATE or UPDATE, the Resync function may issue
  following message and end with RC=08.
   HFPT0009E DL/I GHU  CALL FAILED STATUS='FD'
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS Fast Path Solution Pack for z/OS Version 1 Release 3
  IMS High Performance Fast Path Utilities User's Guide
  (SC19-4010-01).
  
  For the documentation changes made by this APAR, see
  http://www-304.ibm.com/support/docview.wss?uid=swg27041865
  

APAR Information

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

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

  UI35100

Modules/Macros

• HAHQ130J HFPBLDS0 HFPBLIL0 HFPBLMN0 HFPBLNI0
  HFPBLRR0 HFPBLTR0 HFPBRDDB HFPBRDDC HFPBRDDD HFPBRDDE HFPBRDMB
  HFPBRDMC HFPBRDMD HFPBRDME HFPBRDP0 HFPBRDS0 HFPBRDU0 HFPBRDV0
  HFPBRMN0 HFPBRTR0 HFPCCDT0 HFPCDEF0 HFPFIXL0 HFPFIXS0 HFPFSFA0
  HFPFSFO0 HFPLCC30 HFPLMAN0 HFPLSIB0 HFPLSIC0 HFPLSIK0 HFPLSIO0
  HFPLSIP0 HFPLSIQ0 HFPLSIR0 HFPLSIS0 HFPUMVT0 HFPUROB0 HFPWMTB0
  HFPWMTT0
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R130 PSY UI35100

     UP16/02/09 P F602

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.