A fix is available
APAR status
Closed as program error.
Error description
When a CMAS is shut down and message EYUCL0005I is issued, the status of the shared queue that MAS' use to send data to the CMAS is put into RESET status. In the MAS (in CTBT), we attempt to ADD an item to this shared queue -- however, the requested ADD is invalid for a queue that is in RESET status. This results in an invalid transition status which causes EYUCL0105E. If PQ69893 is present, this will also cause message EYUNL0905E and a system dump. This is a timing-related error.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: During CMAS termination, the CPSM MAS * * agent in a CICS region connected to the * * CMAS may terminate invalidly. The MAS * * will receive messages EYUCL0005E and * * EYUNL0905E along with the dump taken by * * method EYU0XZSD (XZSD) for method * * EYU0NLSD (NLSD). * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and MASes must be * * restarted. Note that the restarts do not * * need to occur at the same time. * **************************************************************** When a CMAS terminates, method EYU0CLET (CLET) is called in the CMAS to post all connected MASes to inform them of the CMAS termination. At this point, the MASes should enter restart state as indicated by message EYUXL0018I. At the same time as this is occurring, method EYU0CLER (CLER) also runs in the CMAS. CLER resets the receive status for the CMAS. As such, any attempt to send data from a MAS will fail. If a MAS is attempting to return data to a CMAS as the CMAS is terminating, it is possible that method EYU0CLEV (CLEV) will encounter an error due to CLER's processing. When this occurs, CLEV does not check to see if it has been posted to enter restart state. Instead, it issues message EYU0CL0005E, and then calls NLSD, which issues message EYUNL0905E and the dump, and then terminates the MAS agent.
Problem conclusion
No serialization occurs with the processing performed by CLET and CLER at CMAS termination. Both methods have been changed to ensure CLET posts connected MASes before CLER resets the CMAS's receive state. CLEV has been updated to check the restart ECB if it encounters an error returning data to a CMAS. If the ECB is posted, CLEV will initiate normal termination for restart. The serialization changes to CLET and CLER ensure that the ECBs will be posted before the receive state is reset.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
During CMAS termination, the CPSM MAS agent in a CICS region connected to the CMAS may terminate invalidly. The MAS will receive messages EYUCL0005E and EYUNL0905E along with the dump taken by method EYU0XZSD (XZSD) for method EYU0NLSD (NLSD). When a CMAS terminates, method EYU0CLET (CLET) is called in the CMAS to post all connected MASes to inform them of the CMAS termination. At this point, the MASes should enter restart state as indicated by message EYUXL0018I. At the same time as this is occurring, method EYU0CLER (CLER) also runs in the CMAS. CLER resets the receive status for the CMAS. As such, any attempt to send data from a MAS will fail. If a MAS is attempting to return data to a CMAS as the CMAS is terminating, it is possible that method EYU0CLEV (CLEV) will encounter an error due to CLER's processing. When this occurs, CLEV does not check to see if it has been posted to enter restart state. Instead, it issues message EYU0CL0005E, and then calls NLSD, which issues message EYUNL0905E and the dump, and then terminates the MAS agent. No serialization occurs with the processing performed by CLET and CLER at CMAS termination. Both methods have been changed to ensure CLET posts connected MASes before CLER resets the CMAS's receive state. CLEV has been updated to check the restart ECB if it encounters an error returning data to a CMAS. If the ECB is posted, CLEV will initiate normal termination for restart. The serialization changes to CLET and CLER ensure that the ECBs will be posted before the receive state is reset.
APAR Information
APAR number
PK27500
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-06-30
Closed date
2006-12-12
Last modified date
2007-01-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK20549
Modules/Macros
EYURCOEB EYU0CLER EYU0CLET EYU0CLEV
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK20549
UP06/12/14 P F612
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"}},"418":{"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}
Document Information
Modified date:
22 February 2023