PH42847: ATYZ020E ENVIRONMENT DISCOVER FAILED OCCURS BECAUSE IMSACB IS NOT FOUND

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• ATYZ020E Environment discovery failed at registering IMS to IMS
  Administration Tool with ATY3004I - DD Name: IMSACB.
  .
  The message appears when IMSACB is not found in IMS control
  region JCL or MDA library. IMS Administration Tool checks IMSACB
  as required data set. However, IMS Administration Tool should
  not check it as required because IMSACB is optional to IMS.
  

Local fix

• Define "IMSACB" DD statement to IMS control region or create
  "IMSACB" DFSMDA TYPE=IMSACB member in MDA library.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Administration Tool for     *
  *                 z/OS (FMID=HALC110)                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: ATYZ020E Environment discovery failed   *
  *                      at registering IMS to IMS               *
  *                      Administration Tool with ATY3004I - DD  *
  *                      Name: IMSACB.                           *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF for this APAR.                 *
  ****************************************************************
  ATYZ020E Environment discovery failed at registering IMS to IMS
  Administration Tool with ATY3004I - DD Name: IMSACB.
  
  When IMS management of ACBs is not active, IMS Administration
  Tool looks for the IMSACB data set name in the following IMS
  resources:
   - IMSACB DD statement in the IMS control region JCL
   - IMSACB member in the MDA library
   - IMSACB DD statement in the OLCUTL member in IMS PROCLIB
  
  If IMSACB is not found, IMS Administration Tool issues the
  discover failed message because of assuming that IMSACB is
  a required data set. However, IMS Administration Tool should
  not check it as required because IMSACB is optional to IMS.
  
  Workaround is defining "IMSACB" DD statement to IMS control
  region, creating "IMSACB" DFSMDA TYPE=IMSACB member in MDA
  library, or defining "IMSACB" DD statement to OLCUTL JCL in
  IMS PROCLIB.
  

Problem conclusion

• IMS Administration Tool has been modified to skip IMSACB
  checking.
  

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:

  UI78674

Modules/Macros

• ATY#BRGN
  

Fix information

• Fixed component name

  IMS ADMIN TOOL

• Fixed component ID

  5655CAT00

Applicable component levels

• R110 PSY UI78674

     UP21/12/23 P F112

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.