PK16215: BAS TRANDEF UPDATE FAILS. EYUEI0558E AN INTERNAL ERROR HAS OCCURRED. METHOD BACN IN LMAS1 :2 (EXCEPTION) 3(METHOD_FAILED)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You update BAS TRANDEF runaway value from the EUI and get
  message  EYUEI0558E An internal error has occurred. Method BACN
  in UC00CMM1: 2 (EXECEPTION ), 3 (METHOD_FAILED)
  
  The update is successful to the EYUDREP (data respository)
  however, the update does not take effect in the LMAS.
  
  Additional Symptom(s) and Keyword(s): 5697E9301 R300 230
  CMAS Aux trace entries :
  TASK  MTD  PREV TRAN OBJ LEVL PT-ID   DEBUG   UOW CMAS/USR ENVR
  54711 XCL2 XCLR XLST CHE EXCP.   108 DUPE_ELE EUI T220496  CMAS
  54711 XCLR BMRV XLST CHE EXCP.   107 REMSORTF EUI T220496  CMAS
  54711 BMRV BMRA XLST BAS EXCP.     3 BMRVXCLR EUI T220496  CMAS
  54711 BMRA BMCP XLST BAS EXCP.     7 BMRABMRV EUI T220496  CMAS
  54711 BMCP BMCU XLST BAS EXCP.     5 BMCPBMRA EUI T220496  CMAS
  54711 BMCU XDCR XLST BAS EXCP.     4 BMCUBMCP EUI T220496  CMAS
  54711 XDCR XDUP XLST DAT EXCP.    41 DRCRXCP  EUI T220496  CMAS
  54711 BACN XLSD XLST BAS EXCP.    12 BACNBMCU EUI T220496  CMAS
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You update a BAS CICS resource       *
  *                      definition (for example, a TRANDEF)     *
  *                      from the EUI and receive message:       *
  *                      .                                       *
  *                         EYUEI0558E An internal error has     *
  *                              occurred. Method BACN in        *
  *                              <cmasname>: 2 (EXECEPTION),     *
  *                              3 (METHOD_FAILED)               *
  *                      .                                       *
  *                      From the API, the same function fails   *
  *                      with:                                   *
  *                      .                                       *
  *                         RESPONSE=FAILED,REASON=EXCEPTION     *
  *                      .                                       *
  *                      The resource definition is linked to    *
  *                      two RESGROUPs, both of which are in     *
  *                      turn linked to the same RESDESC.        *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be recycled  *
  *                 to pick up the new code.  Note that the      *
  *                 restarts do not need to be done at the same  *
  *                 time.                                        *
  ****************************************************************
     When a resource definition is updated, all instances of the
  resource in the BAS Install List are removed and readded, to
  insure that filters and overrides are applied properly to the
  new definition, and to allow inconsistent set processing to
  occur.  When resources which are managed through RESINDSCs are
  added to or removed from the Install List, the name of the
  RESDESC is placed in the MGMTNAME field instead of the name of
  the RESGROUP.  If the resource is linked to a RESDESC via more
  than one RESGROUP, this results in duplicate entries in the
  remove control list processed by module EYU0BMRA (BMRA - BAS
  Management List Processor).
  

Problem conclusion

•    Modules EYU0BMCP (BMCP - BAS Management Definition List
  Processor) and EYU0BMZ3 (BMZ3 - BAS Management Resource List
  Processor) were modified to set MGMTNAME to the name of the
  managing RESGROUP for resources linked to a RESDESC via one
  or more RESINDSCs.  Modules EYU0BMRA, EYU0XCL1 (XCL1 - Fast
  Path Cache List Add) and EYU0XCL2 (XCL2 - Fast Path Cache List
  Remove) were modified to produce additional diagnostics if
  errors are detected in management lists.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

•    You update a BAS CICS resource definition (for example, a
  TRANDEF) from the EUI and receive message
  .
     EYUEI0558E An internal error has occurred. Method BACN
          in xxxxxxxx: 2 (EXECEPTION), 3 (METHOD_FAILED)
  .
  From the API, the same function fails with
  .
     RESPONSE=FAILED,REASON=EXCEPTION;
  .
  The resource definition is linked to two RESGROUPs, both of
  which are in turn linked to the same RESDESC.
  
     When a resource definition is updated, all instances of the
  resource in the BAS Install List are removed and readded, to
  insure that filters and overrides are applied properly to the
  new definition, and to allow inconsistent set processing to
  occur.  When resources which are managed through RESINDSCs are
  added to or removed from the Install List, the name of the
  RESDESC is placed in the MGMTNAME field instead of the name of
  the RESGROUP.  If the resource is linked to a RESDESC via more
  than one RESGROUP, this results in duplicate entries in the
  remove control list processed by module EYU0BMRA (BMRA - BAS
  Management List Processor).
  
     Modules EYU0BMCP (BMCP - BAS Management Definition List
  Processor) and EYU0BMZ3 (BMZ3 - BAS Management Resource List
  Processor) were modified to set MGMTNAME to the name of the
  managing RESGROUP for resources linked to a RESDESC via one
  or more RESINDSCs.  Modules EYU0BMRA, EYU0XCL1 (XCL1 - Fast
  Path Cache List Add) and EYU0XCL2 (XCL2 - Fast Path Cache List
  Remove) were modified to produce additional diagnostics if
  errors are detected in management lists.
  

APAR Information

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

  PK16250

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

  UK10377

Modules/Macros

•    EYUBBOEB EYU0BMCP EYU0BMRA EYU0BMZ3 EYU0UCL1
  EYU0UCL2 EYU0XCL1 EYU0XCL2
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK10377

     UP06/01/05 P F601

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.