PH61724: ABEND0C4 OR ABENDU3303 OCCURS WHEN IMS CATALOG IS NOT REGISTEREDIN DBRC

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When IMS catalog is not registered in DBRC, the following errors
  occur:
  - When a blank exists between "UNREGCATLG=" and "(' in the DFSDF
  member, ABEND0C4 occurs at ATY#TRAC and FABXADSC.
  - When IMS Administration Tool calls DFSRRC00 with BMP region
  type, DFSRRC00 issues a DFS047A message with a reason code = 20
  and then ABENDU3303.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IMS Administration Tool for z/OS    *
  *                 (FMID=HALC110) who use an unregistered IMS   *
  *                 catalog.                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: ABEND0C4 or ABENDU3303 occurs when IMS  *
  *                      catalog is not registered in DBRC.      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When IMS catalog is not registered in DBRC, the following errors
  occur:
  
    - When blank exists between "UNREGCATLG=" and "(' in the DFSDF
      member, ABEND0C4 occurs at ATY#TRAC and FABXADSC.
    - When IMS Administration Tool calls DFSRRC00 with BMP region
      type, DFSRRC00 issues a DFS047A message with a reason code =
      20 and then ABENDU3303.
  

Problem conclusion

• IMS Administration has been modified as follows:
   - Parse UNREGCATLG= keyword of DFSDF member correctly to
     resolve ABEND0C4.
   - DFSRRC00 is called with DL/I and DBRC=N instead of BMP when
     the IMS catalog database is not registered to DBRC. ABEND
     U3303 is resolved by this change in the following functions.
     - Database and Application Administration > Object Explorer
     - Database and Application Administration > Compare >
       Compare IMS Directory and IMS Catalog
     - IMS Catalog and ACBLIB Management > IMS Catalog Space and
       DBD/PSB Analysis
     - IMS Catalog and ACBLIB Management > Import Objects
   - The following functions are changed not to be invoked when
     the IMS catalog database is not registered to DBRC to avoid
     Abend 3303. It is because they need to run in BMP, however,
     IMS does not support BMP with the unregistered IMS catalog
     and issues ABEND U3303. The functions are now documented as
     restrictions for the unregistered IMS catalog in the
     Administration Tool's users guide.
     - IMS Catalog and ACBLIB Management > IMS Catalog Space and
       DBD/PSB Analysis > View DBD/PSB Detail Report
       Delete All and Delete Instance commands
     - Database and Application Administration > DBD/PSB Resource
       Change
       IMS Catalog Populate
     - IMS SPUFI
  
  To resolve the abends, apply the PTF for APAR PH61716 to IMS
  Library Integrity Utilities.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Administration Tool for z/OS Version 1 Release 1 User's
  Guide and Reference (SC27-9011) is updated.
  Refer to topic "What's new in IMS Administration Tool"
  (https://www.ibm.com/docs/en/ims-admintool/1.1?topic=overview
  -whats-new-in-ims-administration-tool) in IBM Documentation
  for doc changes associated with this APAR.
  

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:

  UI97451

Modules/Macros

• ATY#BDIR ATY#BRGN ATY#XACB ATY$AIMQ ATY$CATP ATY$I200 ATY$PURG
  ATY@OBJU ATY@SSID ATYI00
  

Fix information

• Fixed component name

  IMS ADMIN TOOL

• Fixed component ID

  5655CAT00

Applicable component levels

• R110 PSY UI97451

     UP24/06/27 P F406

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.