IBM Support

PK66306: EYUTS0002E TOPOLOGY CONNECT FOR SYSNAME FAILED, FOLLOWED BY EYUO TRANSACTION ABENDS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An EYUTS0002E message may be issued for a MAS during CMAS
    restart.  A timing issue with component initialization may
    provide a window where a request may be sent to a MAS for a
    component that has not completed initialization yet.
    .
    An exception trace is issued with RESPONSE 5 and REASON 128
    (x'80').  In the situation for which this APAR was opened, the
    exception trace record is:
    .
    METHOD:XLOP   PRIOR:      DEBUG:TARGTMAL  POINTID:     1
    TRANID:COIE
    MAJOBJ:KNL    ENVRN:LMAS  TYPE:EXCEPTION
    UOW(CPSM):    SYSTM:xxxx  NAME:yyyyyyyy   CICS-TASK: zzzzz
    .
            MethName  XLOP
    .
            ODSBCBA    CALL BACK AREA
                       SEQ CALLING METHOD   CALLED    RESP    RESN
                       0001  XLOP(800AF630)             5     128
    .
            TRGTMAL    LEN:000037     ALET:00000000 ADDR:2C14005C
    .
            EYUQBNCC IN
               *FUN FUNCTION( BMASCRC )
               *CHR DEBUG( TSCIBNCC )
               *QID QTOKEN( 8023000B00001C80 )
               *NLS NAMELIST( A= 01FF002A O= 0012A000 L= 0000001010
    )
               *ENM STATECHK( NO )
               *ENM FAILACT( CONTINUE )
            OUT
               *RSP RESPONSE( *         )
               *RSN REASON( *                     )
               *STA STATUS( *                        )
    .
            XLTRRESP   LEN:000001     ALET:00000000 ADDR:2C7601B4
                   0 - 05
    .
            XLTRREAS   LEN:000001     ALET:00000000 ADDR:2C7601B5
                   0 - 80
    .
    It was the BAS component that had received work but was not yet
    fully initialized in the MAS.
    .
    When this problem occurs, the MAS will disconnect, as seen by
    messages:
       EYUXL0012I  applid   ESSS disconnect complete
       EYUXL0016I  applid   LMAS shutdown complete
    .
    If CPSM is used in this region for routing, by coding the
    following SIT parms:
    .
     DTRPGM=EYU9XLOP
     DSRTPGM=EYU9XLOP
    .
    The region may experience many EYUO abends.
    .
    Additional Symptom(s) Search Keyword(s):
    KIXREVEPH
    

Local fix

  • Restart MAS agent code by issuing transaction COLM.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION: Message EYUTS0002E may be issued to     *
    *                      indicate a Topology Connect failure     *
    *                      when a restarted CMAS attempts to       *
    *                      connect to MASes that were active       *
    *                      when the CMAS was restarted.            *
    *                                                              *
    *                      Examination of the CMAS's auxtrace      *
    *                      datasets will show an exception trace   *
    *                      issued by the MAS(s) that failed to     *
    *                      connect.  The trace will indicate the   *
    *                      Method is XLOP, will have a debug text  *
    *                      of "TARGTMAL" and a trace point Id of   *
    *                      1.  The full version of the trace       *
    *                      record will indicate a "XLTRRESP" of    *
    *                      x'05' and a "XLTRREAS" of x'80'.        *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all MASes must be restarted.  Note     *
    *                 that the restarts do not need to occur at    *
    *                 the same time.                               *
    ****************************************************************
    When the MAS agent is started in a MAS, module EYU0CLEV (CLEV)
    is started under a long running task to receive requests sent
    from the CMAS to the MAS.  When the MAS agent is restarted due
    to the connected CMAS being restarted, CLEV is started before
    component initialization is complete.  This can result in the
    MAS attempting to process a request before it is able to do so.
    If this occurs, the request will fail, and the CMAS will fail
    the Topology Connect of the MAS, issuing message EYUTS0002E.
    

Problem conclusion

  • The following changes have been made so that CLEV startup will
    now be synchronized with component initialization:
    
    -  the Kernel component anchor block, EYURXLWA, has been updated
       to define a synchronization event control block (ECB).
    
    -  method EYU0XLBV (XLBV), which calls the Communications
       component initialization routine which will start CLEV, has
       been updated to clear the new ECB before the call.
    
    -  method EYU0XLBI (XLBI), which is called after XLBV completes
       to perform initialization for external components, has been
       updated to post the new ECB when component initialization is
       complete.
    
    -  method EYU0CLEV (CLEV) has been updated to wait on the new
       ECB during initialization.  Once the ECB has been posted,
       CLEV will start processing incoming requests from the CMAS.
    

Temporary fix

  •             *********
                * HIPER *
                *********
    FIX AVAILABLE BY PTF ONLY
    

Comments

  • Message EYUTS0002E may be issued to
    indicate a Topology Connect failure
    when a restarted CMAS attempts to
    connect to MASes that were active
    when the CMAS was restarted.
    
    Examination of the CMAS's auxtrace
    datasets will show an exception trace
    issued by the MAS(s) that failed to
    connect  The trace will indicate the
    Method is XLOP, will have a debug text
    of "TARGTMAL" and a trace point Id of
    1.  The full version of the trace
    record will indicate a "XLTRRESP" of
    x'05' and a "XLTRREAS" of x'80'.
    
    
    When the MAS agent is started in a MAS, module EYU0CLEV (CLEV)
    is started under a long running task to receive requests sent
    from the CMAS to the MAS.  When the MAS agent is restarted due
    to the connected CMAS being restarted, CLEV is started before
    component initialization is complete.  This can result in the
    MAS attempting to process a request before it is able to do so.
    If this occurs, the request will fail, and the CMAS will fail
    the Topology Connect of the MAS, issuing message EYUTS0002E.
    
    
    The following changes have been made so that CLEV startup will
    now be synchronized with component initialization:
    
    -  the Kernel component anchor block, EYURXLWA, has been updated
       to define a synchronization event control block (ECB).
    
    -  method EYU0XLBV (XLBV), which calls the Communications
       component initialization routine which will start CLEV, has
       been updated to clear the new ECB before the call.
    
    -  method EYU0XLBI (XLBI), which is called after XLBV completes
       to perform initialization for external components, has been
       updated to post the new ECB when component initialization is
       complete.
    
    -  method EYU0CLEV (CLEV) has been updated to wait on the new
       ECB during initialization.  Once the ECB has been posted,
       CLEV will start processing incoming requests from the CMAS.
    

APAR Information

  • APAR number

    PK66306

  • Reported component name

    CPSM CICS 3.1

  • Reported component ID

    5655M1501

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2008-05-19

  • Closed date

    2008-06-23

  • Last modified date

    2008-07-01

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

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

    PK66244 UK37572

Modules/Macros

  •    EYURXLWA EYU0CLEV EYU0XLBI EYU0XLBV
    

Fix information

  • Fixed component name

    CPSM CICS 3.1

  • Fixed component ID

    5655M1501

Applicable component levels

  • R100 PSY UK37572

       UP08/06/24 P F806

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.

{"0":{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},"380":{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Line of Business":{"code":"LOB35","label":"Mainframe SW"}},"1":null,"2":null,"3":null,"4":null,"5":null,"6":null,"7":null,"8":null,"9":null,"10":null,"11":null,"12":null,"13":null,"14":null,"15":null,"16":null,"17":null,"18":null,"19":null,"20":null,"21":null,"22":null,"23":null,"24":null,"25":null,"26":null,"27":null,"28":null,"29":null,"30":null,"31":null,"32":null,"33":null,"34":null,"35":null,"36":null,"37":null,"38":null,"39":null,"40":null,"41":null,"42":null,"43":null,"44":null,"45":null,"46":null,"47":null,"48":null,"49":null,"50":null,"51":null,"52":null,"53":null,"54":null,"55":null,"56":null,"57":null,"58":null,"59":null,"60":null,"61":null,"62":null,"63":null,"64":null,"65":null,"66":null,"67":null,"68":null,"69":null,"70":null,"71":null,"72":null,"73":null,"74":null,"75":null,"76":null,"77":null,"78":null,"79":null,"80":null,"81":null,"82":null,"83":null,"84":null,"85":null,"86":null,"87":null,"88":null,"89":null,"90":null,"91":null,"92":null,"93":null,"94":null,"95":null,"96":null,"97":null,"98":null,"99":null,"100":null,"101":null,"102":null,"103":null,"104":null,"105":null,"106":null,"107":null,"108":null,"109":null,"110":null,"111":null,"112":null,"113":null,"114":null,"115":null,"116":null,"117":null,"118":null,"119":null,"120":null,"121":null,"122":null,"123":null,"124":null,"125":null,"126":null,"127":null,"128":null,"129":null,"130":null,"131":null,"132":null,"133":null,"134":null,"135":null,"136":null,"137":null,"138":null,"139":null,"140":null,"141":null,"142":null,"143":null,"144":null,"145":null,"146":null,"147":null,"148":null,"149":null,"150":null,"151":null,"152":null,"153":null,"154":null,"155":null,"156":null,"157":null,"158":null,"159":null,"160":null,"161":null,"162":null,"163":null,"164":null,"165":null,"166":null,"167":null,"168":null,"169":null,"170":null,"171":null,"172":null,"173":null,"174":null,"175":null,"176":null,"177":null,"178":null,"179":null,"180":null,"181":null,"182":null,"183":null,"184":null,"185":null,"186":null,"187":null,"188":null,"189":null,"190":null,"191":null,"192":null,"193":null,"194":null,"195":null,"196":null,"197":null,"198":null,"199":null,"200":null,"201":null,"202":null,"203":null,"204":null,"205":null,"206":null,"207":null,"208":null,"209":null,"210":null,"211":null,"212":null,"213":null,"214":null,"215":null,"216":null,"217":null,"218":null,"219":null,"220":null,"221":null,"222":null,"223":null,"224":null,"225":null,"226":null,"227":null,"228":null,"229":null,"230":null,"231":null,"232":null,"233":null,"234":null,"235":null,"236":null,"237":null,"238":null,"239":null,"240":null,"241":null,"242":null,"243":null,"244":null,"245":null,"246":null,"247":null,"248":null,"249":null,"250":null,"251":null,"252":null,"253":null,"254":null,"255":null,"256":null,"257":null,"258":null,"259":null,"260":null,"261":null,"262":null,"263":null,"264":null,"265":null,"266":null,"267":null,"268":null,"269":null,"270":null,"271":null,"272":null,"273":null,"274":null,"275":null,"276":null,"277":null,"278":null,"279":null,"280":null,"281":null,"282":null,"283":null,"284":null,"285":null,"286":null,"287":null,"288":null,"289":null,"290":null,"291":null,"292":null,"293":null,"294":null,"295":null,"296":null,"297":null,"298":null,"299":null,"300":null,"301":null,"302":null,"303":null,"304":null,"305":null,"306":null,"307":null,"308":null,"309":null,"310":null,"311":null,"312":null,"313":null,"314":null,"315":null,"316":null,"317":null,"318":null,"319":null,"320":null,"321":null,"322":null,"323":null,"324":null,"325":null,"326":null,"327":null,"328":null,"329":null,"330":null,"331":null,"332":null,"333":null,"334":null,"335":null,"336":null,"337":null,"338":null,"339":null,"340":null,"341":null,"342":null,"343":null,"344":null,"345":null,"346":null,"347":null,"348":null,"349":null,"350":null,"351":null,"352":null,"353":null,"354":null,"355":null,"356":null,"357":null,"358":null,"359":null,"360":null,"361":null,"362":null,"363":null,"364":null,"365":null,"366":null,"367":null,"368":null,"369":null,"370":null,"371":null,"372":null,"373":null,"374":null,"375":null,"376":null,"377":null,"378":null,"379":null}

Document Information

Modified date:
22 February 2023