A fix is available
APAR status
Closed as program error.
Error description
You start a CICS region COLD as part of normal operation. Later on in its life, if, due to problems, you need to stop and restart the CPSM agent code via COSH & COLM transaction. When the COLM transaction starts, there is an attempt to reinstall all of the business application services (BAS) resources. The CICS system definition is defined to only install resources on a COLD start (CSYSDEF AUTOINST - Install Resources -> COLDONLY). This generates a lot of EYUBN0005E messages. This also circumvents change control, in that a program may have been deleted since the COLDSTART, and now is reinstalled when COLM is entered. Additional Symptom(s) Search Keyword(s): EYUBN0012W, DFHAM4838 KIXREVSPW
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: You start a CICS region COLD as part * * of normal operations. Later on in its * * life, you need to stop and restart the * * CPSM agent code via the COSH and COLM * * transactions. When the MAS Agent is * * restarted, CPSM attempts to reinstall * * CICS resource which were installed at * * startup by BAS (Business Application * * Services). The CICS system is defined * * to install BAS resources on COLD start * * only. * * . * * (CSYSDEF_AUTOINST - Install Resources * * -> COLDONLY). * * . * * This may circumvent change control, * * in that resources could be discarded or * * modified after the COLDSTART, and re- * * installed with the original attributes * * when the MAS agent restarts. It also * * results in message EYUBN0005E for any * * resources which could not reinstall in * * an active CICS region. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and MASes must be recycled * * to pick up the new code. Note that the * * restarts do not need to be done at the same * * time. However, the fix will not take effect * * for a given MAS until the MAS and the CMAS * * that it connects to have been restarted. * **************************************************************** When the MAS agent is stopped by the COSH transaction or by the STOP action against the MAS resource, state information that would show that the CPSM MAS agent had been active in the current CICS region is not retained. Thus when the MAS Agent is restarted by transaction COLM, resources are installed as if the region was starting for the first time. This results in reinstallation of CICS resources that were installed during the original start of the MAS agent.
Problem conclusion
Module EYU9XLEV (XLEV - Kernel Linkage Environment) was modi- fied to retrieve the CICS Dispatcher Start Time from Dispatcher statistics, and store the value in the Kernel Work Area (XLWA). Module EYU0CLIN (CLIN - Protocol Services Initialization) was modified to place the Start Time into the initial contact ele- ment which is passed to the CMAS, instead of the current time. This time is placed in the EENDCONN (Network Endpoint Connect) notification block, and copied to the CICS System Descriptor Block (CSDB) in module EYU0TIST (TIST - Topology Long-Running Task). Module EYU0TSSC has been modified to compare the saved Start Time with the time the MAS Agent last became active (MAS Agent Active Time), before the Active Time is reset. If the Start Time is earlier than the Active Time for the last MAS agent execution, then this connect will be treated as a restart and BAS will not be called to install CICS resources. If the Start Time is later than the Active Time for the previous MAS Agent instance, then the region was restarted, and resources must be installed.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
You start a CICS region COLD as part of normal operations. Later on in its life, you need to stop and restart the CPSM agent code via the COSH and COLM transactions. When the MAS Agent is restarted, CPSM attempts to reinstall CICS resource which were installed at startup by BAS (Business Application Services). The CICS system is defined to install BAS resources on COLD start only. . (CSYSDEF_AUTOINST - Install Resources -> COLDONLY). . This may circumvent change control, in that resources could be discarded or modified after the COLDSTART, and re- installed with the original attributes when the MAS agent restarts. It also results in message EYUBN0005E for any resources which could not reinstall in an active CICS region. When the MAS agent is stopped by the COSH transaction, state information which would show that the CPSM MAS agent had been active in the current CICS region is not retained. Thus when the MAS Agent is restarted by transaction COLM, resources are installed as if the region was starting for the first time. This results in reinstallation of CICS resources which were in- stalled during the original start of the MAS agent. Module EYU9XLEV (XLEV - Kernel Linkage Environment) was modi- fied to retrieve the CICS Dispatcher Start Time from Dispatcher statistics, and store the value in the Kernel Work Area (XLWA). Module EYU0CLIN (CLIN - Protocol Services Initialization) was modified to place the Start Time into the initial contact ele- ment which is passed to the CMAS, instead of the current time. This time is placed in the EENDCONN (Network Endpoint Connect) notification block, and copied to the CICS System Descriptor Block (CSDB) in module EYU0TIST (TIST - Topology Long-Running Task). Module EYU0TSSC has been modified to compare the saved Start Time with the time the MAS Agent last became active (MAS Agent Active Time), before the Active Time is cleared. If the Start Time is earlier than the Active Time for the last MAS Agent execution, then this connect will be treated as a restart and BAS will not be called to install CICS resources. If the Start Time is later than the Active Time for the previous MAS Agent instance, then the region was restarted, and resources must be installed.
APAR Information
APAR number
PK61159
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
2008-02-15
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:
PK61072 UK35938
Modules/Macros
EYURTISD EYURXLWA EYU0CLIN EYU0TSSC EYU0TSSE EYU9XLEV
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK35938
UP08/04/30 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"}},"518":{"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,"515":null,"516":null,"517":null}
Document Information
Modified date:
22 February 2023