A fix is available
APAR status
Closed as program error.
Error description
After recycling your CMASs and LMASs, Topology connect fails for one of your LMASs. You receive messages: EYUTS0002E Topology Connect for CICSXXX FAILED - APPLID(CICSXXX) CICSPLEX(plexname) EYUWM0403E Workload Manager Task has reported an error processing event (SysGroup) for CICS Group ( CICSGRP ) . After you receive these messages, all attemps to connect the LMAS fail. Additional Keyword(s) and Symptom(s): KIXREVSVR CPSM trace shows : 00102 TSFD TSCN TIST TOP EXCP. 5 SCOPEUNK CPSM CICMS CMAS 00102 TSGR TIST TIST TOP EXCP. 16 TSGRTSCN CPSM CICMS CMAS 00102 XCLD TSGR TIST CHE EXCP. 40 INVLSTID CPSM CICMS CMAS 00102 TIST XLOP TIST TOP EXCP. 15 TISTTSGR CPSM CICMS CMAS 00180 WMUA WMEV WMGR WLM EXCP. 9 ........ CPSM CICMS CMAS 00180 WMEV WMGR WMGR WLM EXCP. 13 WMEVWMUA CPSM CICMS CMAS
Local fix
Remove the LMAS from the CICS system group CICSGRP and re-add the LMAS to the CICSGRP. Restart the LMAS.
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Topology Connect fails for one of * * your MASes, as indicated by message * * . * * +EYUTS0002E Topology Connect for * * <lmas> Failed - * * APPLID(<appl>) CICSplex(<plex>) * * . * * When you enter the COLM transaction to * * restart the MAS agent, Topology Connect * * fails again, and message * * . * * EYUTS0004I Topology Found <lmas> * * already Active * * . * * is written to EYULOG in the CMAS. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes must be recycled to pick * * up the new code. Note that the restarts * * do not need to be done at the same time. * **************************************************************** When Topology Connect fails, module EYU0TSSE (TSSE - Topology Complete MAS Termination) is called from EYU0TSSC (TSSC - Top- ology Connect) to clean up resource allocated during the connect process. If an exception occurs in TSSE or a method called by TSSE, the CICS System Descriptor Block (CSDB) for the MAS may be left in an inconsistent state. If the MAS agent is restarted, Topology Connect will continue to fail because the CSDB indi- cates that the MAS is already connecting. The initial exception which caused Topology Connect to fail was a response and reason of INVALID / INVALID_LIST_ATTRIBUTES returned to EYU0TSRC (TSRC - Topology Refresh CSDB) by EYU0XCLK (XCLK - Cache Compare Search Lists).
Problem conclusion
Module EYU0TSSE was modified to tolerate exceptions returned from methods called to clean up resources on behalf of the MAS whose connection is terminating. This will allow the MAS agent to be restarted via the COLM transaction, once the MAS initial- ization timeout limit (MASINITTIME) has passed. Code was added to TSRC to produce an SDUMP containing the CMAS and ESSS address spaces and the TOP and Cache data spaces to facilitate diagnosis of the exception in XCLK. EYU0TSGR (TSGR - TOP System Group Remove) was modified to fix a problem which could result in attempts to generate notifi- cations for a null scope, resulting in message . EYUTS0013E CICS System Not Found . with a null system name. TSGR was also updated to prevent incorrect deletion of a cache list allocated by another method.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
Topology Connect fails for one of your MASes, as indicated by message . +EYUTS0002E Topology Connect for <lmas> Failed - APPLID(<appl>) CICSplex(<plex>) . When you enter the COLM transaction to restart the MAS agent, Topology Connect fails again, and message . EYUTS0004I Topology Found <lmas> already Active . is written to EYULOG in the CMAS. When Topology Connect fails, module EYU0TSSE (TSSE - Topology Complete MAS Termination) is called from EYU0TSSC (TSSC - Top- ology Connect) to clean up resource allocated during the connect process. If an exception occurs in TSSE or a method called by TSSE, the CICS System Descriptor Block (CSDB) for the MAS may be left in an inconsistent state. If the MAS agent is restarted, Topology Connect will continue to fail because the CSDB indi- cates that the MAS is already connecting. The initial exception which caused Topology Connect to fail was a response and reason of INVALID / INVALID_LIST_ATTRIBUTES returned to EYU0TSRC (TSRC - Topology Refresh CSDB) by EYU0XCLK (XCLK - Cache Compare Search Lists). Module EYU0TSSE was modified to tolerate exceptions returned from methods called to clean up resources on behalf of the MAS whose connection is terminating. This will allow the MAS agent to be restarted via the COLM transaction, once the MAS initial- ization timeout limit (MASINITTIME) has passed. Code was added to TSRC to produce an SDUMP containing the CMAS and ESSS address spaces and the TOP and Cache data spaces to facilitate diagnosis of the exception in XCLK. EYU0TSGR (TSGR - TOP System Group Remove) was modified to fix a problem which could result in attempts to generate notifi- cations for a null scope, resulting in message . EYUTS0013E CICS System Not Found . with a null system name. TSGR was also updated to prevent incorrect deletion of a cache list allocated by another method.
APAR Information
APAR number
PK60515
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-02-05
Closed date
2008-04-28
Last modified date
2008-05-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK60407 UK35924
Modules/Macros
EYU0TSGR EYU0TSRC EYU0TSSE
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK35924
UP08/04/29 P F804
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"}},"515":{"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,"380":null,"381":null,"382":null,"383":null,"384":null,"385":null,"386":null,"387":null,"388":null,"389":null,"390":null,"391":null,"392":null,"393":null,"394":null,"395":null,"396":null,"397":null,"398":null,"399":null,"400":null,"401":null,"402":null,"403":null,"404":null,"405":null,"406":null,"407":null,"408":null,"409":null,"410":null,"411":null,"412":null,"413":null,"414":null,"415":null,"416":null,"417":null,"418":null,"419":null,"420":null,"421":null,"422":null,"423":null,"424":null,"425":null,"426":null,"427":null,"428":null,"429":null,"430":null,"431":null,"432":null,"433":null,"434":null,"435":null,"436":null,"437":null,"438":null,"439":null,"440":null,"441":null,"442":null,"443":null,"444":null,"445":null,"446":null,"447":null,"448":null,"449":null,"450":null,"451":null,"452":null,"453":null,"454":null,"455":null,"456":null,"457":null,"458":null,"459":null,"460":null,"461":null,"462":null,"463":null,"464":null,"465":null,"466":null,"467":null,"468":null,"469":null,"470":null,"471":null,"472":null,"473":null,"474":null,"475":null,"476":null,"477":null,"478":null,"479":null,"480":null,"481":null,"482":null,"483":null,"484":null,"485":null,"486":null,"487":null,"488":null,"489":null,"490":null,"491":null,"492":null,"493":null,"494":null,"495":null,"496":null,"497":null,"498":null,"499":null,"500":null,"501":null,"502":null,"503":null,"504":null,"505":null,"506":null,"507":null,"508":null,"509":null,"510":null,"511":null,"512":null,"513":null,"514":null}
Document Information
Modified date:
22 February 2023