PI58159: EYUBI0102E BAS INIT FAILED, CNX0592E WHEN DISCARDING CLOUD RELATED OBJECTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are using the CICS Explorer or z/OS Explorer with CICS
  plug-in are and attempting to DISCARD a cloud-related object,
  but it is failing with error message CNX0592E.
  .
  If you look in the CMAS's EYULOG, you may see a message similar
  to the following:
  .
  EYUBI0102E BAS initialization for CICSplex <plexname>
             has failed.
  .
  Once BAS initialization fails, it is then possible for CPSM
  method EYU0BPMS to return a null plex descriptor e-pointer to
  its calling method. Discarding a cloud-related object at this
  point is not possible without encountering the error.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R1M0 and V5R2M0 Users      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Random BAS related functions may fail   *
  *                      inexplicably. Problems experienced may  *
  *                      manifest from, but are not restricted   *
  *                      to, manipulation of Cloud related       *
  *                      resources through the CICS Explorer.    *
  *                                                              *
  *                      Looking back through the CICSPlex SM    *
  *                      EYULOG, you will find that a BAS        *
  *                      initialization error had previously     *
  *                      occurred for the CICSplex which         *
  *                      encapsulates the BAS objects being      *
  *                      actioned.                               *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be recycled to pick    *
  *                 up the new code.  Note that regions do not   *
  *                 need to be brought down and restarted at     *
  *                 the same time.                               *
  *                                                              *
  ****************************************************************
  EYU0TSXR (TSXR) is the CPSM Topology method that furnishes BAS
  callers with the address of the BAS CICSplex Descriptor block.
  Following each call to TSXR, the caller should check the call
  RESPONSE and STATUS code from TSXR, and then verify that the
  returned address is non-zero.
  
  If all three checks are not performed by the caller of
  TSXR, then the caller may proceed to use (what it thinks is)
  the returned CICSplex Descriptor address, but will in fact
  be pointing to uninitialized storage.
  

Problem conclusion

• Four BAS modules were found to have insufficient address
  checking following a call to TSXR, and have been modified:
  
  EYU0BPMG - BAS Frontend Management Part Get Method
  - Updated to verify that the TSXR STATUS code
    is OK (in addition to the RESPONSE code).
  
  EYU0BPMR - BAS Management Part Remove method
  - Updated to verify that the TSXR STATUS code
    is OK (in addition to the RESPONSE code).
  
  EYU0BPMS - BAS Management Part Disable Method
  - Updated to ensure that the returned BAS CICSplex Descriptor
    address is non-zero.
  
  EYU0BMDC - BAS Management EdefChg process method
  - Updated to verify that the TSXR STATUS code
    is OK (in addition to the RESPONSE code).
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  PI62894 UI38492 UI38493

Modules/Macros

• EYU0BMDC EYU0BPMG EYU0BPMR EYU0BPMS
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R80M PSY UI38492

     UP16/06/10 P F606

• R90M PSY UI38493

     UP16/06/10 P F606

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.