A fix is available
APAR status
Closed as program error.
Error description
CMAS unnecessarily requests topology resource map data during topology join processing resulting in possible maxtask in CMAS and overhead in topology resmap hardening to the EYUDREP data repository. . Additional Symptom(s) Search Keyword(s): TSSJ TSMJ SETUP_LISTREQ TSLG TSG2 signature base active delta PROCESS_LISTS resmap RTDB
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V3R1M0 Users. * **************************************************************** * PROBLEM DESCRIPTION: Topology Join processing for a MAS may * * be elongated if a large number of * * MASes are being Joined concurrently. * * * * This can result in various problems if * * a CMAS must Join a great number of * * MASes when it initializes. * * * * Problems seen include, but are not * * limited to, the following: * * * * - the CMAS may go maxtask (MXT) * * - the CMAS may go short-on-storage * * (SOS). * * - the CMAS may experience connection * * problems with other CMASes. * * - some of the Join attempts may fail. * **************************************************************** * RECOMMENDATION: In a mixed CICSPlex SM V3R1M0 and V3R2M0 * * CMAS network, the PTF for CICSPlex SM V3R2M0 * * APAR PK49141 must be installed on all * * CICSPlex SM V3R2M0 CMASes before installing * * the PTF that resolves this APAR on any * * CICSPlex SM V3R1M0 CMASes. * * * * After applying the PTF that resolves this * * APAR, all CMASes, MASes and WUI servers must * * be restarted. * * * * The restarts need not be performed at the * * same time, however if systems are not * * restarted at the same time, the following * * rules apply: * * * * - Maintenance point CMASes must be restarted * * on the updated code before non Maintenance * * point CMASes, MASes and WUI Servers. * * * * If you have more than one Maintenance * * point CMAS and those Maintenance point * * CMASes are connected directly or * * indirectly, then these maintenance point * * CMASes must be restarted at the same time. * * * * - Before a MAS or WUI server runs with the * * updated code, the CMAS to which the MAS or * * WUI server connects must be restarted * * with the updated code. * * * **************************************************************** During Topology connect processing, the CMAS will build Topology Resource maps (Resmaps) for each MAS that connects. The Resmaps exist for each different CICS object type that is maintained within CICSPlex SM Topology, for example, Programs, Files, Transactions etc. When the Resmap is originally created, a base signature is generated. An additional signature, the current signature, is also created. The current signature is initially set to the base signature. The Resmap and the current signature are hardened to the CMASes data repository for later use on MAS restart. If a resource is installed or discarded, the CMAS will update its Resmap through the use of a delta list. This delta list identifies changes that must be applied to the Resmaps. When the Resmaps are updated, the current signature (but not the base signature) is updated. During Topology Join processing, the joining CMAS will check to see if it has the necessary Resmaps with the correct signatures. If they are correct, then the joining CMAS will use the Resmaps from its local data repository. If the Resmaps do not exist or do not have the correct signature, then the correct Resmaps must be requested from the CMAS that connected the MAS. In order to request the Resmaps for a MAS, the joining CMAS will send the connecting CMAS up to two requests (TSLG and TSG2). These requests will run under XLST transactions in the connecting CMAS. Because of a number of logic errors in the processing of the Resmaps, the joining CMAS may needlessly send the connecting CMAS the TSLG and TSG2 requests asking for Resmaps that are not necessary. If a number of CMASes are processing the join requests, the connecting CMAS may receive a large number of requests, which in turn may lead to the connecting CMAS reaching MXT, or the other symptoms described above.
Problem conclusion
A number of changes have been made to correct the Resmap processing: - A new object, TOPSIGNS has been created. This is used to store the current and base signatures for each Resmap along with a Resmap changed indicator. - During CICSPlex SM Network Topology import/export, each MAS's TOPSIGNS data will also be imported/exported when it is available. - A resmap's base signature will now be saved (along with the current signature) when the resmaps are hardened to the data repository. - During Topology Join processing, the new TOPSIGNS information will be used to determine if the TSLG and TSG2 requests should be sent to the connecting CMAS. These changes should insure that these requests only run when necessary. When they do run, they should only be retrieving the required data. - The CICSPlex SM online utility (COLU) will now include a MAS's Topology sign information when the COLU COM NETOP transaction is run.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
**** PE07/11/07 FIX IN ERROR. SEE APAR PK56147 FOR DESCRIPTION
APAR Information
APAR number
PK47823
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
2007-06-26
Closed date
2007-08-30
Last modified date
2008-01-14
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK49141 UK28703
Modules/Macros
CONNDSEG EYUCXXRS EYUC2436 EYUC2453 EYUC2644 EYUN2436 EYUN2453 EYUN2644 EYUQCPAM EYUQCPLM EYUQCPMI EYUQCPMX EYUQCPUM EYUQXCRB EYUQXCRS EYUQXLRD EYUQXXRC EYURCPAM EYURCPEQ EYURCPLM EYURCPMI EYURCPMX EYURCPUM EYURXCRB EYURXCRL EYURXCRS EYUR2436 EYUR2453 EYUR2644 EYUTMOMI EYUTMOSD EYUTRCHE EYUTRCOM EYUTRDIR EYUTVOSX EYUT2436 EYUT2453 EYUT2644 EYUUTPEQ EYUUXCEQ EYUUXXFI EYUUXXRS EYUUXXTC EYUYCPAM EYUYCPLM EYUYCPMI EYUYCPMX EYUYCPUM EYUYXCRB EYUYXCRS EYUY2436 EYUY2453 EYUY2644 EYUZCPAM EYUZCPLM EYUZCPMI EYUZCPMX EYUZCPUM EYUZXCRB EYUZXCRS EYU0CPAM EYU0CPAP EYU0CPBM EYU0CPCU EYU0CPDM EYU0CPDP EYU0CPEJ EYU0CPLM EYU0CPMI EYU0CPMX EYU0CPSL EYU0CPTI EYU0CPTX EYU0CPUM EYU0TICT EYU0TSCJ EYU0TSCM EYU0TSDD EYU0TSEM EYU0TSGC EYU0TSLM EYU0TSMB EYU0TSMC EYU0TSMD EYU0TSMH EYU0TSMI EYU0TSMJ EYU0TSMM EYU0TSMR EYU0TSMU EYU0TSRA EYU0TSRC EYU0TSRM EYU0TSSC EYU0TSSD EYU0TSSE EYU0TSSH EYU0TSSJ EYU0TSSM EYU0TSTP EYU0TSXC EYU0XCRB EYU0XCRS EYU0XL80 EYU9CMPU EYU9CMP3 EYU9CMP4 EYU9CMP5 EYU9CMRU EYU9CMR3 EYU9CMR4 EYU9CMR5 EYU9XCPU EYU9XCP3 EYU9XCP4 EYU9XCP5 HCP3100J MASDIR TOPRMINF TOPSIGNS
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK28703
UP07/08/31 P F708
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"}},"477":{"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}
Document Information
Modified date:
22 February 2023