A fix is available
APAR status
Closed as program error.
Error description
REMoval of SYSLINKS in a CICS region which is being decommissioned does not fully remove the SYSLINKS. When the CICS region is restarted the SYSLINKS are being reinstalled. You have requested that a CICS system be removed from the CICSPlex. In the process of removing the CSYSDEF, topology has to remove the SYSLINK association. If the CICS region happens to be the PRIMARY in a SYSLINK definition, the SYSLINK will be removed from the EYUDREP, but the referential records will not be removed. The LINKs will be re-established when the region is restarted. Additional Symptom(s) Search Keyword(s): KIXREVRBD
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: You decommission a MAS that connects * * to other MASes via SYSLINK definitions. * * After the CSYSDEF resource for the MAS * * is removed, you restart other MASes to * * which it connected, and in some of the * * CICS regions, a connection is installed * * for the removed MAS. You find that all * * SYSLINK resources which define links to * * the decommissioned MAS were properly * * removed from the data repository when * * the CSYSDEF resource was removed. * **************************************************************** * 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 a CSYSDEF resource is removed, referential integrity records (REFINTLKs) are scanned to locate and remove related resources in the data repository. EYU0BMLT (BMLT - BAS Man- agement Long Running Task) is then notified that a Topology resource has been removed, and EYU0BMSR (BMSR - BAS Remove CICS System) is called to remove the MAS from the resource install list and the association matrix. EYU0BMSR calls EYU0BMZR (BMZR - BAS Remove Association Elements) to remove association elements for related resources. A logic error in BMZR causes it to ignore associations for SYSLINKs in which the removed MAS was the SECONDARY system. If the PRIMARY MAS is restarted with START=COLD or INITIAL, the association matrix is scanned for SYSLINK associations, and a connection will be installed for a MAS which no longer exists.
Problem conclusion
Module EYU0BMZR has been modified to scan the BAS Association Matrix for SYSLINK associations in which the MAS being removed is the SECONDARY system, and to remove the association elements properly. In addition, EYU0BMZ2 (BMZ2 - BAS Process Extended SYSLINK Associations) and EYU0XCLR (XCLR - Cache List Remove Element) were modified to correct errors in standard trace levels.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
You decommission a MAS that connects to other MASes via SYSLINK definitions. After the CSYSDEF resource for the MAS is removed, you restart other MASes to which it connected, and in some of the CICS regions, a connection is installed for the removed MAS. You find that all SYSLINK resources which define links to the decommissioned MAS were properly removed from the data repository when the CSYSDEF resource was removed. When a CSYSDEF resource is removed, referential integrity records (REFINTLKs) are scanned to locate and remove related resources in the data repository. EYU0BMLT (BMLT - BAS Man- agement Long Running Task) is then notified that a Topology resource has been removed, and EYU0BMSR (BMSR - BAS Remove CICS System) is called to remove the MAS from the resource install list and the association matrix. EYU0BMSR calls EYU0BMZR (BMZR - BAS Remove Association Elements) to remove association elements for related resources. A logic error in BMZR causes it to ignore associations for SYSLINKs in which the removed MAS was the SECONDARY system. If the PRIMARY MAS is restarted with START=COLD or INITIAL, the association matrix is scanned for SYSLINK associations, and a connection will be installed for a MAS which no longer exists. Module EYU0BMZR has been modified to scan the BAS Association Matrix for SYSLINK associations in which the MAS being removed is the SECONDARY system, and to remove the association elements properly. In addition, EYU0BMZ2 (BMZ2 - BAS Process Extended SYSLINK Associations) and EYU0XCLR (XCLR - Cache List Remove Element) were modified to correct errors in standard trace levels.
APAR Information
APAR number
PK58581
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
2007-12-21
Closed date
2008-02-22
Last modified date
2008-03-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK58562 UK33945
Modules/Macros
EYUBBSPR EYU0BMZR EYU0BMZ2 EYU0XCLR
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK33945
UP08/02/27 P F802
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"}},"507":{"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}
Document Information
Modified date:
22 February 2023