A fix is available
APAR status
Closed as program error.
Error description
When issuing COLU TOP PLEX(plexname,scope) you receive a program check abend0c4 protection exception in EYU0XLUS (HCP3100) at offset+3C4 on a MVC instruction (D21F D3CC 9000).
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: You invoke the COLU transaction in * * a CMAS to dump topology resource maps * * for the local MASes: * * . * * COLU TOP PLEX(plexname,scope) * * . * * You receive abend ASRA (S0C4) at offset * * +03C4 in module EYU0XLUS (XLUS - CPSM * * Utility Transaction Service Routines). * **************************************************************** * 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. * **************************************************************** Module EYU0XL90 (XL90 - CPSM Utility Transaction Topology Processor) is the primary processor for requests for TOP data. XL90 calls Topology module EYU0TSDD (TSDD - Top Resource Diag- nostic Data Collector) to retrieve a queue of Topology Resource Map data for the requested context and scope. XL90 then reads records from the returned queue and dumps the resource maps to a spool file. XL90 makes calls to XLUS to perform utility func- tions including formatting and output of report data. TSDD should not write a block to the queue if there is no data to be passed, but a logic error makes it possible that the last block in the queue returned to XL90 may not contain any resource data. XL90 does not check the count of objects in a queue block to see if there is any data to process. The object count is loaded into a register, and used as index in a Branch- on-Count loop. If the initial count was zero, XL90 will loop through storage, passing successive addresses to XLUS to dump the addressed storage, until encountering a page which is not allocated, or which is allocated with a different protection key.
Problem conclusion
Module EYU0TSDD was modified to check the count of resource objects before writing a final block to the queue. If the count is zero, the final write is bypassed. Module EYU0XL90 was modified to check the resource count ie each block read from the queue, and ignore the block if the count is zero. In addition, module EYU0XL90 was modified to issue message EYUXU0011W if the COLU utility transaction is invoked in a MAS to dump topology resource data.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
You invoke the COLU transaction in a CMAS to dump topology resource maps for the local MASes: . COLU TOP PLEX(plexname,scope) . You receive abend ASRA (S0C4) at offset +03C4 in module EYU0XLUS (XLUS - CPSM Utility Transaction Service Routines). Module EYU0XL90 (XL90 - CPSM Utility Transaction Topology Processor) is the primary processor for requests for TOP data. XL90 calls Topology module EYU0TSDD (TSDD - Top Resource Diag- nostic Data Collector) to retrieve a queue of Topology Resource Map data for the requested context and scope. XL90 then reads records from the returned queue and dumps the resource maps to a spool file. XL90 makes calls to XLUS to perform utility func- tions including formatting and output of report data. TSDD should not write a block to the queue if there is no data to be passed, but a logic error makes it possible that the last block in the queue returned to XL90 may not contain any resource data. XL90 does not check the count of objects in a queue block to see if there is any data to process. The object count is loaded into a register, and used as index in a Branch- on-Count loop. If the initial count was zero, XL90 will loop through storage, passing successive addresses to XLUS to dump the addressed storage, until encountering a page which is not allocated, or which is allocated with a different protection key. Module EYU0TSDD was modified to check the count of resource objects before writing a final block to the queue. If the count is zero, the final write is bypassed. Module EYU0XL90 was modified to check the resource count ie each block read from the queue, and ignore the block if the count is zero. In addition, module EYU0XL90 was modified to issue message EYUXU0011W if the COLU utility transaction is invoked in a MAS to dump topology resource data.
APAR Information
APAR number
PK56300
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-11-09
Closed date
2007-11-16
Last modified date
2007-12-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK56218 UK31325
Modules/Macros
EYU0TSDD EYU0XL90
Fix information
Fixed component name
CPSM CICS 3.1
Fixed component ID
5655M1501
Applicable component levels
R100 PSY UK31325
UP07/11/17 P F711
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"}},"501":{"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}
Document Information
Modified date:
22 February 2023