PH68416: CATALOG MANAGER FAILED TO PROCESS PSB IN THE IMS DIRECTORY WHICHWAS CREATED BY DDL AND DID NOT HAVE THE XDBDREF TABLE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The Catalog Manager failed to process PSB in the IMS directory
  which was created by DDL and did not have the PSB XDBDREF VECTOR
  TABLE. The Catalog Manager assumes this table and fails to
  process decoding. When PSB is generated by ACBGEN, it has PSB
  XDBDREF VECTOR TABLE. The Catalog Manager can process it.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 2 (FMID=H27P220) users     *
  *                 who use the Catalog Manager utility.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: The Catalog Manager fails to decode or  *
  *                      compare a PSB in the IMS directory when *
  *                      processing a PSB created by DDL with    *
  *                      certain IMS APAR level that do not      *
  *                      create XDBDREF table (DBD reference     *
  *                      vector table) in a PSB.                 *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes the decode or compare function of the Catalog
  Manager utility not to fail to process a PSB in the IMS
  directory which is created by DDL using DFS3ID00 with certain
  IMS APAR level that do not create a "XDBDREF table (DBD
  reference vector table)" in a PSB.
  
  If the PSB include the "XDBDREF table", BLDLFLAG of the
  directory entry of the IMS directory has a value other than
  X'00' which indicates the "XDBDREF table" is exist.
  
  In 2015, PSB in the IMS directory which was updated by
  ACBGEN and the IMS Catalog Populate utility had BLDLFLAG X'00'
  which meant that the "XDBDREF table" did not exist, but the
  PSB had the "XDBDREF table" because a PSB which was generated
  by ACBGEN and the IMS Catalog Populate utility always had the
  "XDBDEF table".
  
  This conflict caused the Catalog Manager utility to end with
  ABEND. To resolve the conflict, the Catalog Manager utility
  was fixed to use alternative value for BLDLFLAG when BLDLFLAG
  is X'00'.
  
  Now this conflict does not occur and the fix of the Catalog
  Manager utility is not necessary.
  
  On the other hand, a PSB in the IMS directory which is created
  by DDL with certain IMS APAR level does not have the "XDBDREF
  table" and BLDLFLAG is X'00'. For this case, the Catalog
  Manager utility uses alternative value for BLDLFLAG
  incorrectly and it causes this issue.
  
  This APAR fixes the Catalog Manager utility to process PSB when
  BLDLFLAG is X'00'.
  
  This APAR also fixes the Catalog Manager utility to decode
  the INDICES parameter of the SENSEG statement with the dummy
  DBD name with FABN0055W when PSB does not have the "XDBDREF
  table". The Catalog Manager utility obtains the real DBD name
  from the "XDBDREF table". When the Catalog Manager utility
  cannot obtain the DBD name from the "XDBDREF table", it uses
  dummy DBD name.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IBM IMS Library Integrity Utilities for z/OS V2R2 User's Guide
  (SC19-3979)
  Refer to topic "What's new in IMS Library Integrity Utilities"
  (https://www.ibm.com/docs/en/ims-liu/2.2
  ?topic=overview-whats-new-in-ims-library-integrity-utilities)
  in IBM Documentation for doc changes associated with this APAR.
  

Problem conclusion

• The following modules have been changed to fix the problem:
   FABMREAF, FABNPCNF, FABNREAF
  

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:

  UO05605

Modules/Macros

• FABMREAF FABNPCNF FABNREAF
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R220 PSY UO05605

     UP25/10/31 P F510

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.