IBM Support

PH69315: IMS DIRECTORY/BSDS BACKUP AND RESTORE ENHANCEMENTS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • This APAR updates IMS directory/BSDS backup and restore function
    of IMS Administration Tool:
    
     - Enable specification of the IMSID at any position within the
    HLQ of backup data sets
     - Support Generation Data Group (GDG) as backup data sets
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Users of IMS Administration Tool for z/OS                    *
    * (FMID=HALC110) who use the IMS directory/BSDS                *
    * backup function.                                             *
    *                                                              *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * IMS Administration Tool does not                             *
    * support the use of GDGs for IMS                              *
    * Directory/BSDS backup data sets.                             *
    * This APAR provides new function to                           *
    * enable the use of GDGs for these                             *
    * backup data sets.                                            *
    *                                                              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply the maintenance for this APAR.                         *
    *                                                              *
    ****************************************************************
    IMS catalog and directory management enhancement. The following
    enhancements are made to the IMS directory and BSDS backup and
    restore function:
    
     - Backup data sets can use a generation data set group (GDG).
     - The IMSID, which is required in the high level qualifier of
       the backup data sets, can be placed in any position within
       that high level qualifier.
     - The setting parameters are applied to all IMS systems in the
       same IMS data sharing group.
    
    Perform the following procedure after the PTF of this APAR is
    applied:
    
    - Copy the ATYOPST0 module from smphlq.SATYLOAD to CUSTLOAD.
    - Issue BPE REFRESH USEREXIT command to refresh OM output
      type exit routines.
    
    ========================
    = 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

    PH69315

  • 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-12-09

  • Closed date

    2026-05-27

  • Last modified date

    2026-06-02

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

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

    UO07995

Modules/Macros

  • ATY#AMS  ATY#BCOM ATY#CLNT ATY#CSI  ATY#MENU ATY$AIMQ ATY$APRQ
    ATY$GVAR ATY$IDCD ATY$M510 ATY$M520 ATY$M530 ATY$M5S0 ATY$SDBK
    ATY$VBKP ATY@OBJU ATY@PROD ATY@SKEL ATY@SSID ATYHM520 ATYHM52X
    ATYHM530 ATYHM53I ATYHM53X ATYHM53Y ATYHM5S0 ATYHM5SC ATYHM5SG
    ATYHM5SN ATYHM5SS ATYLINK  ATYM05   ATYOPST0 ATYPA2C3 ATYPM510
    ATYPM520 ATYPM52X ATYPM530 ATYPM53I ATYPM53S ATYPM53X ATYPM53Y
    ATYPM5DB ATYPM5DR ATYPM5S0 ATYPM5SC ATYPM5SG ATYPM5SN ATYPM5SS
    

Fix information

  • Fixed component name

    IMS ADMIN TOOL

  • Fixed component ID

    5655CAT00

Applicable component levels

  • R110 PSY UO07995

       UP26/06/02 I 1000  

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 June 2026