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 V3R2M0 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
PK56218
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
50M
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:
UK31207
Modules/Macros
EYU0TSDD EYU0XL90
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R50M PSY UK31207
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.
[{"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.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 December 2007