A fix is available
APAR status
Closed as program error.
Error description
When starting up multiple CMAS's at the same time, there may be a timing window that will cause the Quiet Side CMAS to have the receive link task wait for CMAS initialization to complete (XLOP_ENVIR_WAIT). EYU9XLOP gets the XLWA (EYURXLWA) address from TCBCAUF (EYURXECB) at +x'28' (XECB_XLWA). If this field is zeros due to the XECB being initialized, but NOT the XLWA, the LNMI or LNCI task could time out. The connection between the CMAS's will eventually be made, but could take up to 5 minutes.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: CMAS initialization may be delayed if * * the CMAS specifies START=AUTO in its * * CICS SIT parms, and another CMAS with * * a lower alphanumeric SYSID to which * * it should connect (both CMASes have * * CMTCMDEFs to each other) is already * * active. * * * * The delay will last for approximately * * five minutes, after which the CMAS will * * complete initialization. * * * * The CMAS will receive the following * * message just before it completes * * initialization: * * * * EYUCS0108E The initialization wait * * for CMAS connections to * * complete has terminated * * before all connections * * have completed * * * * which will be followed by a dump with a * * title similar to the following: * * * * EYU0XZPT Dump,<cmasjobn>,<cmasname>, * * <lpar>,CMAS,LSRT,<tasknum>,TRAC, * * EYU0CSLT,<date>,<time> * * * * Examination of the EYULOG of the * * partner CMAS will show the following * * message: * * * * EYUCS0010I Enhanced <type> Network * * connection to CMAS <name> * * being initialized * * * * where type is either MRO or CPI-C. The * * partner CMAS will eventually fail or * * retry the connection. If the * * connection is failed, the following * * messages will be displayed in the * * partner CMAS's EYULOG: * * * * EYUCS0204W A timeout has occurred * * with CMAS <name> * * * * EYUCL0016I Send Link Task terminated * * for <type> Network * * connection with CMAS * * <name> * * * * If the connection is retried, the * * following messages will be displayed in * * the partner CMAS's EYULOG: * * * * EYUCS0009I Message received from CMAS * * <name> : EYUXL0152I CMAS * * not available * * * * EYUCS0205W Connection to CMAS <name> * * being retried due to: * * Partner System request * * * * at which point the connection will * * either complete, fail, or be retried * * again. * **************************************************************** * 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. * **************************************************************** When two CMASes which have CMTCMDEF definitions to each other become active, the CMAS with the lower alphanumeric CICS SYSID will send a request to start transaction LNMI (MRO) or LNCI (CPI-C) in the partner CMAS, where module EYU9XLOP will run to start the CPSM environment for the task. EYU9XLOP performs checking to verify if the CMAS has completed CPSM initialization and if so, allows the task to continue. If not, EYU9XLOP will either fail the request, or if the PTF for APAR PK03349 is applied, will issue a delay for one second and recheck. If after 225 delay loops the CMAS is still not initialized, EYU9XLOP will fail the task, asking the originating CMAS to retry the connection attempt. Part of the determination as to whether the CMAS is initialized is for EYU9XLOP to retrieve the address of the CPSM Kernel Anchor block (XLWA). Depending upon when the LNxI task starts, the location from which EYU9XLOP retrieves the XLWA address may have not yet been set. As a result, EYU9XLOP will retrieve low values as the XLWA address. This will cause unpredictable results, usually leading to the CMAS delaying initialization for approximately five minutes waiting for the connection to complete.
Problem conclusion
EYU9XLOP has been updated to verify that it has retrieved a non-zero address for the XLWA. If not, it will delay for one second and try again. If after 225 delay loops the address of the XLWA is still zero, EYU9XLOP will fail the task, asking the originating CMAS to retry the connection attempt.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
CMAS initialization may be delayed if the CMAS specifies START=AUTO in its CICS SIT parms, and another CMAS with a lower alphanumeric SYSID to which it should connect (both CMASes have CMTCMDEFs to each other) is already active. The delay will last for approximately five minutes, after which the CMAS will complete initialization. If the PTF for APAR PK05183 is applied, the CMAS will receive the following message just before it completes initialization: EYUCS0108E The initialization wait for CMAS connections to complete has terminated before all connections have completed which will be followed by a dump with a title similar to the following: EYU0XZPT Dump,<cmasjobn>,<cmasname>, <lpar>,CMAS,LSRT,<tasknum>,TRAC, EYU0CSLT,<date>,<time> Examination of the EYULOG of the partner CMAS will show the following message: EYUCS0010I Enhanced <type> Network connection to CMAS <name> being initialized where type is either MRO or CPI-C. The partner CMAS will eventually fail or retry the connection. If the connection is failed, the following messages will be displayed in the partner CMAS's EYULOG: EYUCS0204W A timeout has occurred with CMAS <name> EYUCL0016I Send Link Task terminated for <type> Network connection with CMAS <name> If the connection is retried, the following messages will be displayed in the partner CMAS's EYULOG: EYUCS0009I Message received from CMAS <name> : EYUXL0152I CMAS not available EYUCS0205W Connection to CMAS <name> being retried due to: Partner System request at which point the connection will either complete, fail, or be retried again. When two CMASes which have CMTCMDEF definitions to each other become active, the CMAS with the lower alphanumeric CICS SYSID will send a request to start transaction LNMI (MRO) or LNCI (CPI-C) in the partner CMAS, where module EYU9XLOP will run to start the CPSM environment for the task. EYU9XLOP performs checking to verify if the CMAS has completed CPSM initialization and if so, allows the task to continue. If not, EYU9XLOP will either fail the request, or if the PTF for APAR PK03349 is applied, will issue a delay for one second and recheck. If after 225 delay loops the CMAS is still not initialized, EYU9XLOP will fail the task, asking the originating CMAS to retry the connection attempt. Part of the determination as to whether the CMAS is initialized is for EYU9XLOP to retrieve the address of the CPSM Kernel Anchor block (XLWA). Depending upon when the LNxI task starts, the location from which EYU9XLOP retrieves the XLWA address may have not yet been set. As a result, EYU9XLOP will retrieve low values as the XLWA address. This will cause unpredictable results, usually leading to the CMAS delaying initialization for approximately five minutes waiting for the connection to complete. EYU9XLOP has been updated to verify that it has retrieved a non-zero address for the XLWA. If not, it will delay for one second and try again. If after 225 delay loops the address of the XLWA is still zero, EYU9XLOP will fail the task, asking the originating CMAS to retry the connection attempt.
APAR Information
APAR number
PK35277
Reported component name
CPSM CICS 3.1
Reported component ID
5655M1501
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2006-11-28
Closed date
2007-03-22
Last modified date
2007-04-01
APAR is sysrouted FROM one or more of the following:
PK35305
APAR is sysrouted TO one or more of the following:
UK23246
Modules/Macros
EYU9XLOP
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK23246
UP07/03/24 P F703
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"}},"445":{"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}
Document Information
Modified date:
22 February 2023