IBM Support

PH65962: SUPPORT CROSS-REFERENCE BETWEEN DBDS AND PSBS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • This APAR provides the following enhancements to the IMS Catalog
    Space and DBD/PSB Analysis function:
     - Generate a batch JCL that creates DBD and PSB cross-reference
    reports and CSV files
     - Display DBD and PSB cross reference reports on ISPF panels
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of IMS Administration Tool for z/OS    *
    *                 (FMID=HALC110).                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Functions of IMS Administration Tool    *
    *                      are enhanced as follows:                *
    *                      1. The IMS catalog and ACB library      *
    *                         management function is renamed to    *
    *                         the IMS catalog and directory        *
    *                         management function.                 *
    *                      2. Cross-reference between DBDs and     *
    *                         PSBs in IMS catalog                  *
    *                      3. Provide CSV format files of DBD      *
    *                         list, PSB list, and cross-reference  *
    *                      4. Strengthen syntax error checking in  *
    *                         the ATY@OBJU JCL                     *
    ****************************************************************
    * RECOMMENDATION: Apply the maintenance for this APAR.         *
    ****************************************************************
    The following functional enhancements are applied:
    1. The IMS catalog and ACB library management function is
       renamed to the IMS catalog and directory management function
       because enablement of IMS management of ACBs is necessary in
       IMS 15.6. The existing functions for ACB libraries in IMS
       Administration Tool are kept as is.
    2. The IMS catalog space and DBD/PSB analysis function is
       enhanced to report cross-reference information between DBD
       and PSB instances in the IMS catalog. By identifying
       dependencies between DBDs and PSBs, you can maintain
       relationship integrity and determine which DBDs and PSBs
       might be affected when modifying or deleting DBDs or PSBs.
    3. Generates downloadable CSV files:
       - List of DBDs with attributes and consistency checking
           (contains equivalent information to DBD detail report)
       - List of PSBs with attributes and consistency checking
           (contains equivalent information to PSB detail report)
       - Cross-reference between DBDs and PSBs in IMS catalog
    4. The following specification the ATYMSGI control statements
       in the ATY@OBJU JCL are checked as error:
       - FUNCTION=IMPORT and ACB=N
       - FUNCTION=IMPORT and INACTACB=Y
       - FUNCTION=IMPORT and ACTACB=Y
         The changes prevent incorrect updating the control
         statements.
    
    Refer IMS Administration Tool User's Guide (SC27901134) for
    more information of the functions.
    To enable this APAR's enhancement, apply the PTF for
    APAR PH65973 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.
    

Problem conclusion

Temporary fix

Comments

APAR Information

  • APAR number

    PH65962

  • Reported component name

    IMS ADMIN TOOL

  • Reported component ID

    5655CAT00

  • Reported release

    110

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2025-04-02

  • Closed date

    2025-06-27

  • Last modified date

    2025-07-02

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

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

    UO03858

Modules/Macros

  • ATY#CSI  ATY#EMSG ATY#MENU ATY$IDCD ATY$MRP1 ATY$MRP2 ATY$MRP3
    ATY$PURG ATY$REDT ATY@OBJU ATYHM000 ATYHM1B1 ATYHM1R1 ATYHM1R2
    ATYHM1R3 ATYHM1V1 ATYHM1V2 ATYHM1V4 ATYHM1V5 ATYHM1V7 ATYHM1VD
    ATYHM1VP ATYHM1W1 ATYHM1W2 ATYHPRIM ATYKEYS  ATYLINK  ATYM01
    ATYPM000 ATYPM1B1 ATYPM1R1 ATYPM1R2 ATYPM1R3 ATYPM1S2 ATYPM1V1
    ATYPM1V2 ATYPM1V3 ATYPM1V4 ATYPM1V5 ATYPM1V7 ATYPM1W1 ATYPM1W2
    ATYPPRIM
    

Fix information

  • Fixed component name

    IMS ADMIN TOOL

  • Fixed component ID

    5655CAT00

Applicable component levels

  • R110 PSY UO03858

       UP25/07/01 P F506  

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.

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCD9F6","label":"IMS Administration Tool"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]

Document Information

Modified date:
02 July 2025