A fix is available
APAR status
Closed as program error.
Error description
If a CPSM TOR routing region is restarted immediately using automation or an ARM policy to connect to another CMAS and the MASDIR still indicates the MAS is remote, the MAS may fail to connect to the CMAS and message EYUCL0107E may be issued with text insert indicating "MAS ALREADY EXISTS". If the MAS is restarted again to connect it is possible for the TOR to not be assigned a TOR number from the WPLX_TORNUM_BIT bitmap. The WTOR_TOR_NUM value will be zero. If another TOR has been assigned TOR number zero, when the TOR is terminated at some future time, the other TOR may also have its connection array entry cleared in the WAOR target AOR structures resulting in transactions running in the default or local TOR and not being dynamically routed. . When method WMTJ (WLM TOR Join) runs if the workload is not frozen yet, checking for a TOR being restarted from another CMAS is bypassed. The workload frozen bit would have been set when the CMAS was notified that the connection to the remote CMAS was gone. If the LOST_CON option is not set when the topology stop event is driven, the workload will not be frozen. . Method WMTJ should verify the status of the MAS by invoking the CPLM (Connection Services Locate MAS) method to determine the current status of the MAS being joined to the workload. . Additional Symptom(s) Search Keyword(s): abend fail fails EYUWM0420I EYUWM0421I
Local fix
Shutdown all routing regions connected the CMAS. When all TORs are down at the same time, they may then be restarted.
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: - When a routing region which is also * * a target region disconnects from one * * CMAS and restarts and connects to a * * second CMAS, it may not be * * recognized as a routing region by * * other active CMASes, if those CMASes * * are not connected (directly or * * indirectly) to the second CMAS when * * the routing region is restarted. * * * * - When a routing region that had been * * connected to a CMAS is restarted and * * connects to a second CMAS, invalid * * routing may occur for other routing * * regions connected to the second * * CMAS. * * * * Additionally, when a routing region * * connected to the second CMAS * * subsequently terminates, routing * * from other routing regions connected * * to the second CMAS may cease. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes must be restarted. Note * * that the restarts do not need to occur at * * the same time. After all CMASes have been * * restarted with the PTF applied, the problems * * described above will no longer occur. * * * * If the first problem described above exists * * at the time a CMAS is restarted with the PTF * * applied, the problem will be resolved at the * * time of restart. * * * * If the second problem described above exists * * at the time a CMAS is restarted with the PTF * * applied, then all routing regions connected * * to that CMAS must be terminated at the same * * time, and then can be restarted, at which * * point the problem will be resolved. * **************************************************************** - When a routing region becomes active in a workload, other CMASes that manage the same workload will join the routing region to the workload at the same time if they are connected (directly or indirectly) to the CMAS which the routing region is connected to. If they are not connected, then they should workload join the routing region when they subsequently connect to the CMAS which the routing region is connected to. A logic error in method EYU0WMEV (WMEV) will cause the workload join process to be bypassed if the routing region is also a target region. - When a routing region connects locally to a CMAS, it is given a unique numeric identifier, from 0 through 1023, which is placed in the ID field of the TOR descriptor (EYURWTOR) for the region. This identifier is used as an index when the CMAS builds additional structures that are used to determine which target regions the routing region sends work to. For routing regions that are remote to the CMAS, no identifier is assigned, and 0 is placed in the EYURWTOR ID field, since the local CMAS does not build routing structures for a remote routing region. When a remote routing region terminates and is restarted locally, method EYU0WMTJ (WMTJ) should recognize this, and assign an identifier for the EYURWTOR. A logic error in WMTJ may result in an identifier not being assigned, and the current value of 0 being used instead. Since another routing region probably already uses the value 0, this can cause problems if the routing regions have different routing rules. Additionally, when one routing region with the 0 identifier terminates, the clean up performed will stop routing from any other routing region(s) that have a EYURWTOR ID of 0.
Problem conclusion
- WMEV has been updated to ensure that the workload join process is driven regardless of whether the routing region is also a target region. - WMTJ has been updated to ensure that it always recognizes when a local routing region was previously remote, and always assigns a unique identifier.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
- When a routing region which is also a target region disconnects from one CMAS and restarts and connects to a second CMAS, it may not be recognized as a routing region by other active CMASes, if those CMASes are not connected (directly or indirectly) to the second CMAS when the routing region is restarted. - When a routing region that had been connected to a CMAS is restarted and connects to a second CMAS, invalid routing may occur for other routing regions connected to the second CMAS. Additionally, when a routing region connected to the second CMAS subsequently terminates, routing from other routing regions connected to the second CMAS may cease. - When a routing region becomes active in a workload, other CMASes that manage the same workload will join the routing region to the workload at the same time if they are connected (directly or indirectly) to the CMAS which the routing region is connected to. If they are not connected, then they should workload join the routing region when they subsequently connect to the CMAS which the routing region is connected to. A logic error in method EYU0WMEV (WMEV) will cause the workload join process to be bypassed if the routing region is also a target region. - When a routing region connects locally to a CMAS, it is given a unique numeric identifier, from 0 through 1023, which is placed in the ID field of the TOR descriptor (EYURWTOR) for the region. This identifier is used as an index when the CMAS builds additional structures that are used to determine which target regions the routing region sends work to. For routing regions that are remote to the CMAS, no identifier is assigned, and 0 is placed in the EYURWTOR ID field, since the local CMAS does not build routing structures for a remote routing region. When a remote routing region terminates and is restarted locally, method EYU0WMTJ (WMTJ) should recognize this, and assign an identifier for the EYURWTOR. A logic error in WMTJ may result in an identifier not being assigned, and the current value of 0 being used instead. Since another routing region most likely already uses the value 0, this can cause problems if the routing regions have different routing rules. Additionally, when one routing region with the 0 identifier terminates, the clean up performed will stop routing from any other routing region(s) that have a EYURWTOR ID of 0. - WMEV has been updated to ensure that the workload join process is driven regardless of whether the routing region is also a target region. - WMTJ has been updated to ensure that it always recognizes when a local routing region was previously remote, and always assigns a unique identifier.
APAR Information
APAR number
PK36132
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
2006-12-13
Closed date
2007-07-23
Last modified date
2007-08-03
APAR is sysrouted FROM one or more of the following:
PK36102
APAR is sysrouted TO one or more of the following:
PK49148 UK27345
Modules/Macros
EYUQWMAD EYURWMAD EYUTRWLM EYUYWMAD EYUZWMAD EYU0WMAD EYU0WMEV EYU0WMTJ EYU9WMRU EYU9WMR3 EYU9WMR4 EYU9WMR6
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK27345
UP07/07/26 P F707
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"}},"448":{"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}
Document Information
Modified date:
22 February 2023