PI62894: 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 V5R3M0 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

Comments

APAR Information

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

  PI58159

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

  UI38539

Modules/Macros

• EYU0BMDC EYU0BPMG EYU0BPMR EYU0BPMS
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI38539

     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.