PH38517: IMS ADMINISTRATION TOOL ENHANCEMENT FOR AUTOMATIC BACKUP OF IMS DIRECTORY AND BSDS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The new function is automatic backup for IMS directory, staging,
  and bootstrap data sets at every successful IMPORT DEFN
  SOURCE(CATALOG) command.
  .
  This APAR is the solution for RFE 147776.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Administration Tool for     *
  *                 z/OS (FMID=HALC110)                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: IMS directory/BSDS backup enhancement.  *
  *                      Automatic backup (Auto Backup) is       *
  *                      supported. By enabling automatic        *
  *                      backup, a backup of the IMS directory   *
  *                      is taken after a successful completion  *
  *                      of the IMPORT DEFN command.             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  IMS directory/BSDS backup enhancement. Automatic backup
  (Auto Backup) is supported. By enabling automatic backup, a
  backup of the IMS directory is taken after a successful
  completion of the IMPORT DEFN command.
  Also, the naming rules for the backup data set are changed as
  follows:
  
  - IMS ID is added to the data set name.
  - The maximum number of characters for the high-level
    qualifier (HLQ) is changed from 32 to 27.
  
  The enhancement is being implemented as a result of RFE 147776.
  
  ========================
  = ACTION AFTER APPLY   =
  ========================
  After the PTF of this APAR PH38517 is applied, do the following
  tasks:
  
  - Copy the ATYOPST0 module from smphlq.SATYLOAD to CUSTLOAD, and
    issue BPE REFRESH USEREXIT command.
  
    ATYOPST0 is the part of the output type OM exit, and it is
    changed by the PTF. ATYOPST0 is included in the CUSTLOAD data
    set that was created by Tools Base SETUP. The CUSTLOAD is
    specified to the OM region STEPLIB.  You need to copy and
    refresh ATYOPST0 to enable the auto backup of IMS
    Directory/BSDS function.
  
  - Change the high-level qualifier (HLQ) of IMS Directory/BSDS
    backup data set.
  
    The maximum number of characters for HLQ is changed from 32
    to 27 by the PTF. If you defined the HLQ over 27 characters,
    change the HLQ.
  
  ========================
  = 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

• IMSMGDACBS/K
  

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:

  UI76962

Modules/Macros

• ATY#CLNT ATY#EMSG ATY#MENU ATY$APRQ ATY$M510 ATY$M520 ATY$M530
  ATY$M5S0 ATY$SDBK ATY@IMSI ATY@OBJU ATY@OPT  ATY@PROD ATY@SKEL
  ATYHM500 ATYHM510 ATYHM52A ATYHM52Y ATYHM530 ATYHM5S0 ATYLINK
  ATYM05   ATYOPST0 ATYPM510 ATYPM52A ATYPM52Y ATYPM530 ATYPM53S
  ATYPM5S0
  

Fix information

• Fixed component name

  IMS ADMIN TOOL

• Fixed component ID

  5655CAT00

Applicable component levels

• R110 PSY UI76962

     UP21/09/02 P F109  

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.