PH12126: CATALOG MANAGER FAILS TO OBTAIN SENSEG NAME AND PROCOPT FOR DB PCB IN IMS DIRECTORY FROM MSDB WHEN MSDB IS NOT IN IMS DIRECTORY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the Catalog Manager utility processes a PSB which includes
  DB PCB for a MSDB in the IMS directory staging dataset and the
  MSDB which is referred by the PSB is not exist in the IMS
  directory staging dataset, Catalog Manager fails to obtain
  SENSEG name and PROCOPT from the MSDB. As a result of this,
  Catalog Manager cannot decode or compare such kind of PSB with
  FABN0036E message.
  
  This is because PSB type ACB in the IMS directory does not have
  SENSEG name and PROCOPT. Catalog Manager obtains these values
  from the MSDB. When the MSDB has not been changed and only the
  PSB which includes DB PCB for the MSDB has been changed, the IMS
  Catalog Populate utility adds only the PSB and the MSDB does not
  add to the IMS directory staging dataset. When the Catalog
  Manager processes such PSB, it fails to obtain these values from
  the MSDB because MSDB does not exist in the IMS directory
  staging dataset.
  
  Catalog Manager is fixed to obtain SENSEG name and PROCOPT from
  the Active MSDB in the IMS directory when MSDB does not exist in
  the IMS directory staging dataset.
  

Local fix

• N/A
  

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: When the Catalog Manager utility runs   *
  *                      with decode or compare function and     *
  *                      processes a PSB in the IMS directory    *
  *                      staging data set which includes DB PCB  *
  *                      for a MSDB and the MSDB does not exist  *
  *                      in the IMS directory staging data set,  *
  *                      the utility fails to obtain SENSEG name *
  *                      and PROCOPT from the MSDB. As a result  *
  *                      of this, Catalog Manager utility cannot *
  *                      decode or compare such kind of PSB with *
  *                      MSGFABN0036E.                           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes the decode or compare function of the Catalog
  Manager utility not to fail processing a PSB or DBD in the IMS
  directory staging data set with the following conditions:
   - The PSB met all of the following conditions;
       - The PSB has a DB PCB for a MSDB.
       - The MSDB which is referred from the PSB does not exist
         in the IMS directory stating data set.
   - The DBD met all of the following conditions;
       - The organization of the database is DEDB or MSDB.
       - The PSB which refers the DEDB or MSDB does not exist
         in the IMS directory staging data set.
  
  When the utility decodes a DBD or PSB and it detects missing
  parameters, it looks for the PSB that refers to the DBD or the
  DBD that the PSB refers to to supplement the missing parameters.
  
  Because a IMS directory staging data set does not store all the
  DBDs and PSBs - it stores modified DBDs and PSBs only - if the
  utility cannot find the relevant DBD or PSB in the IMS directory
  staging data set, it fails with MSGFABN0036E, MSGFABN0042E,
  MSGFABN0077W or MSGFABL1022E.
  
  The utility modified to supplement these missing parameters from
  the DBD or PSB in the active ACB data sets of the IMS directory
  when the utility cannot find the relevant DBD or PSB in the IMS
  directory staging data set. The utility informs it with new
  message MSGFABX0013I.
  

Problem conclusion

• The following modules and macro have been modified.
  
  FABLACB0 FABLADP0 FABLCOMP FABLREAD FABLREA2 FABLSTMS FABNACB0
  FABNDBLE FABNDBLF FABNDEDB FABNMSDB FABNMSGS FABNPCNE FABNPCNF
  FABNPCTL FABNPDBD FABNPPSB FABNREAE FABNREAF FABNTLES FABXAPI0
  FABXCAP4 FABXCAST FABXCATM FABXCTB0 FABXWMT
  FABLICB  FABNDMBR FABNDMY0 FABNDST0 FABNICB  FABXCTB  MMPSBD
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  
  The documentation "IBM IMS Library Integrity Utilities for z/OS
  V2R2, User's Guide (SC19-3979-04)" is changed.
  
  For all the documentation changes, see documentation updates
  on IMS Tools library site.
  
  http://www-01.ibm.com/support
  /docview.wss?uid=swg27020942#imsliu-lib
  

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:

  UI63574

Modules/Macros

• FABLACB0 FABLADP0 FABLCOMP FABLREA2 FABLREAD FABLSTMS FABNACB0
  FABNDBLE FABNDBLF FABNDEDB FABNMSDB FABNMSGS FABNPCNE FABNPCNF
  FABNPCTL FABNPDBD FABNPPSB FABNREAE FABNREAF FABNTLES FABXAPI0
  FABXCAP4 FABXCAST FABXCATM FABXCTB0 FABXWMT
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R220 PSY UI63574

     UP19/06/14 P F906

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.