PI62216: FPA INDEXBLD ADDS AN OPTION TO CLEANUP SECONDARY INDEXES RFE83473

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• FPA INDEXBLD adds a new function to physically delete index
  pointer segments whose delete byte is on.
  This enhancement is being implemented as a result of RFE
  requirements 83473.
  

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).                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: FPA INDEXBLD adds a new function to     *
  *                      physically delete index pointer         *
  *                      segments whose delete byte is on.       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR adds a new Freespace Reclaim function to FPA.
  
  The Freespace Reclaim function reclaims CIs in secondary index
  database data sets without bringing the DEDB and the secondary
  index databases offline.
  This function is effective for secondary indexes that use a
  HISAM database with no overflow data set and when the HISAM
  database contains many index pointer segments whose delete byte
  flag is turned on.
  
  When IMS issues DL/I calls to delete the source segments in the
  primary DEDB, the index pointer segments in the secondary index
  databases are not physically deleted but their delete byte flag
  is turned on to indicate that the segment is no longer used.
  This results in many unused index pointer segments using up the
  space in the database.
  The Freespace Reclaim function issues DL/I GN calls to secondary
  index database to physically delete such unused index pointer
  segments.
  
  The Freespace Reclaim function is more effective if used in
  combination with the CA Reclaim function of z/OS. If CA Reclaim
  is enabled, after the Freespace Reclaim function deletes all
  index pointer segments in a VSAM Control Area (CA), CA Reclaim
  reclaims the CA for storing new index pointer segments. For more
  information about z/OS CA Reclaim, see z/OS DFSMS Using Data
  Sets.
  
  The Freespace Reclaim function is not effective for secondary
  indexes that use a SHISAM database or a HISAM database with
  overflow data set.
  
  To run the Freespace Reclaim function, specify INDEXBLD command
  in the HFPSYSIN data set and specify IDXPROC=FS_RECLAIM option
  for the INDEXBLD command.
  If the FS_RECLAIM_REPORT=YES is specified, the Freespace Reclaim
  function generates the Secondary Index Freespace Reclaim report
  and Result of Access Method Services report to provide the
  result of the Freespace Reclaim function.
  
  This enhancements are being implemented as a result of RFE
  requirements 83473.
  

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-02).
  
  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:

  UI41376

Modules/Macros

• HAHQ130J HFPBFMN0 HFPBLMN0 HFPBRDDB HFPBRDDC HFPBRDDD HFPBRDDE
  HFPBRDMB HFPBRDMC HFPBRDMD HFPBRDME HFPBRDS0 HFPBRMN0 HFPCCDT0
  HFPCDEF0 HFPCFLC0 HFPCFNI0 HFPCTSK0 HFPDFAL0 HFPDFUI0 HFPDFUO0
  HFPFIXL0 HFPFMAN0 HFPFTTT0 HFPGHKI0 HFPGPRS0 HFPLAMS0 HFPLCC10
  HFPLCC20 HFPLCC30 HFPLCC40 HFPLMAN0 HFPLOPT0 HFPLSIF0 HFPMCCC0
  HFPMDCB0 HFPUMVT0 HFPUROB0 HFPWMTB0 HFPWMTT0
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R130 PSY UI41376

     UP16/10/05 P F610

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.