PH55063: DRF MAY START DUPLICATE IB JOBS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When recovering multiple HALDBs with ADD IB, DRF may erroneously
  invoke duplicate IMS Index Builder jobs for the same DB.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS Recovery Solution Pack for z/OS      *
  *                 Version 2 Release 1 ( FMID=HAHM210 )         *
  *                 IMS Database Recovery Facility users.        *
  ****************************************************************
  * PROBLEM DESCRIPTION: When recovering multiple HALDBs by      *
  *                      specifying ADD IB, DRF may erroneously  *
  *                      invoke duplicate IMS Index Builder jobs *
  *                      for the same DB.                        *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  IMS Database Recovery Facility (DRF) may create duplicate
  "IIUIN" data sets to be passed to IMS Index Builder (IB) for the
  same DB when both of the following conditions are met:
  - DRF recovers multiple HALDBs with ADD IB by specifying the
    partition name in ADD DBDS or the master DB name in ADD DB
  - The master DB names that correspond to the partitions are
    nested when all partitions to be recovered are sorted by
    partition name
  
  This results in duplicate calls to IB jobs. Depending on how the
  master DB name is nested, there may be cases where an IB job is
  invoked for only one DB, even though multiple HALDBs have been
  recovered.
  DRF internally creates a "HALDB Master DB name table" during
  HALDB recovery. However, there are some logic problems related
  to the creation of this table, which caused this issue.
  
  This APAR also corrects the following issues that occur in cases
  where DFSPREC0 utility is scheduled for multiple HALDB
  recoveries with ADD IB (HALDB(ILEF/BOTHF)).
  - When specifying multiple partitions in ADD DBDS and specifying
    ADD IB (HALDB(ILEF/BOTHF)) for some of them and trying to
    schedule DFSPREC0 utility, DFSPREC0 may not be scheduled even
    though ADD IB is specified.
  - When recovering a HALDB with DSG (Data Set Group) by
    specifying a partition with ADD DBDS, if you try to schedule
    DFSPREC0 utility by specifying ADD IB (HALDB(ILEF/BOTHF)) for
    the second or later DBDS of DSG of the same partition,
    DFSPREC0 may not be scheduled even though ADD IB was
    specified.
  

Problem conclusion

• FRXVSTA2 is changed to correctly create "HALDB Master DB name
  Table" during HALDB recovery.
  
  FRXVSTA2 is also changed to correctly schedule DFSPREC0 utility
  when recovering multiple HALDB partitions with ADD IB
  (HALDB(ILEF/BOTHF)) specified.
  

Temporary fix

Comments

APAR Information

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

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

  UI92514

Modules/Macros

• FRXVSTA2
  

Fix information

• Fixed component name

  IMS RCVR SOLUTN

• Fixed component ID

  5655V8600

Applicable component levels

• R210 PSY UI92514

     UP23/06/30 P F306

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.