PH06728: FIXES OF IMS LIBRARY INTEGRITY UTILITIES FOR IMS CATALOG MANAGEMENT OF IMS ADMINISTRATION TOOL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When LIU is called in the DAI SOT for IMS catalog management of
  IMS Administration Tool, the following problems occur:
  1. IMS catalog database space analysis was failed with FABX0507E
  DYNALLOC failed message. This problem occurs in the
  Administration Tool ISPF and the Management Console.
  2. ?Show Full DBD List? or ?Show Full PSB List? was failed with
  'An unidentified occurred'. This problem occurs in the
  Management Console.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 2 (FMID=H27P220) users     *
  *                 who use IBM IMS Administration Tool and      *
  *                 the Catalog Manager utility.                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When LIU runs under IMS Administration  *
  *                      Tool to show IMS Catalog Analysis, the  *
  *                      following problems occur:               *
  *                                                              *
  *                      - IMS Catalog database space analysis   *
  *                        is failed with MSGFABX0507E when DBD  *
  *                        library can not be discovered.        *
  *                      - "Show Full DBD List" or "Show Full    *
  *                        PSB List" in Program and Database     *
  *                        Instances in IMS Catalog Databases is *
  *                        failed to identify ACBGEN timestamp   *
  *                        when IMS catalog database contains an *
  *                        entry whose ACBGEN timestamp is null. *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When LIU is callied in the DAI SOT for IMS Catalog Analysis
  function of IMS Catalog and ACB management of the IMS
  Administration Tool, the following problems occur:
  
  - IMS Catalog database space analysis is failed with
    MSGFABX0507E when DBD library can not be discovered.
    This problem occurs both Web interface and ISPF interface.
  
  - "Show Full DBD List" or "Show Full PSB List" in the Program
    and Database Instances in IMS Catalog Databases is failed to
    identify ACBGEN timestamp when IMS catalog database contains
    an entry whose ACBGEN timestamp is null. In this case, Web
    interface of IMS Administration Tool shows the message
    "An unidentified error occurred.".
  
  
  This APAR fixes LIU not to dynamically allocate a DBD library
  when DBD library is not needed. If LIU can not allocate a DBD
  library, LIU issues MSGFABX0537E.
  
  This APAR also fixes LIU to show 'NO DATE' or 'NO TIME' when
  LIU is run for "Show Full DBD List" or "Show Full PSB List"
  and LIU finds ACBGEN timestamp which is saved in the IMS
  catalog database has null value.
  
  This APAR also fixes the following problem. When the user does
  not specify alphanumeric characters and special character like
  $, #, @, % and * for the parameter for keyword in FABXCIN
  control statement, it shows MSGFABX0521E SYNTAX ERROR IN THE
  CONTROL STATEMENT. This APAR modified to output another new
  message MSGFABX0528E.
  

Problem conclusion

• The following modules have been modified to fix the
  problems:
  
  FABXADSC FABXATY0 FABXCAP1 FABXSTMP FABXWMT
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The documentation is modified as follows:
  ==============================================================
  IBM IMS Library Integrity Utilities for z/OS V2R2,
  User's Guide (SC19-3979-04)
  ==============================================================
  > Troubleshooting
  >> IMS Library Integrity Utilities messages
  >>> FABX messages
  << The following message is added. >>
  |FABX0528E THE PARAMETER FOR keyword MUST CONSIST ONLY OF
  |ALPHANUMERIC CHARACTERS, $, #, @, %, AND *.
  |
  |Explanation
  |The parameter specified for the indicated keyword
  |contains one or more unsupported characters.
  |
  |System action
  |The Catalog Manager utility ends with a return code of 8.
  |
  |User response
  |Correct the parameter and rerun the job.
  
  << The following message is modified. >>
  FABX0537E IMS CATALOG IS NOT DEFINED TO THE IMS.
  FABX0537E THE IMS MANAGEMENT OF ACBS IS NOT ENABLED. IMS
  DIRECTORY IS NOT DEFINED TO THE IMS.
  |FABX0537E [ACBLIB | DBDLIB] IS NOT DEFINED TO THE IMS.
  
  Explanation
  The reqested function requires the IMS catalog, IMS directory,
  |DBD library, or ACB library. However, none of these were found
  in the specified IMS subsystem.
  
  System action
  IMS Library Integrity Utilities ends with a return code of 12.
  
  User response
  Select the correct IMS ID.
  

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:

  UI60791

Modules/Macros

• FABXADSC FABXATY0 FABXCAP1 FABXSTMP FABXWMT
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R220 PSY UI60791

     UP19/01/19 P F901

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.