A fix is available
APAR status
Closed as program error.
Error description
A CICS LMAS region was suffering an 0C4/AKEA in program EYU0NQGF at offset x'272' when using the "Completed Task" view in CICS Explorer. The problem is that if history records from an earlier release are presented to CPSM, it isn't able to process them. CPSM does not have the data conversion routines available for earlier releases. The sequence of messages in the joblog are as follows: +EYUXL0900I Starting Environment Recovery +EYUXL0905E ASRA IN NQGF, OFFSET 0000027C PSW=07851000 9F483EAC LEVEL=JCI740M PFX=CJA +EYUXL0905E INTC=0004 ILC=6 TXCP=00000808 SCODE=S00C4 TRAN=COHT TASK=0000296 +EYUXL0905E Methods=NQGF,NQHT,XLOP +EYUXL0905E BEAR=1F483EB4, OFFSET=00000284 +EYUXL0906I Registers at ABEND Additional keywords: Abend0c4 abends0c4 in module EYU0NQGF EYU9NA01 COHT
Local fix
A circumvention is to delete/define/initialise the history datasets.
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM users * **************************************************************** * PROBLEM DESCRIPTION: When using WUI, CICS Explorer, or API * * to collect all completed tasks it is * * possible to get an S0C4 abend in * * EYU0NQGF with R1 containing an address * * just over x'0800'. * * This can happen if * * a) You have data from a prior release. * * and * * b) You are running z/OS 2.5 or above. * **************************************************************** * RECOMMENDATION: Apply to all CICS systems, in any order. * **************************************************************** A CICSPlex SM API request is made for the HTASK (Completed Tasks) resource table. In the MAS regions involved, a COHT task is run to retrieve the data. This task runs method NQHT (EYU0NQHT) to retrieve data from the EYUHIST data sets, then calls NQGF (EYU0NQGF) to convert each record to an HTASK resource table. CPSM contains processing routines for the current CICS release, either in CJx9NA01 OR EYU9NA01 modules. When reading history records it is possible to pick up records from earlier CICS releases shortly after CICS upgrade. CPSM abends S0C4 in EYU0NQGF trying to process these because the corresponding NAG table for that release is not loaded.
Problem conclusion
This fix recognises the missing NAG table and returns an error code for method NQHT to handle. The affected records will be removed from the result set because the EYUHIST records cannot be converted to an instance of the HTASK resource table without the appropriate NAG table entry.
Temporary fix
Comments
APAR Information
APAR number
PH61105
Reported component name
CICS TS Z/OS V6
Reported component ID
5655YA100
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2024-04-26
Closed date
2024-05-16
Last modified date
2024-06-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PH61193 UI96936
Modules/Macros
CJH0NQGF CJI0NQGF CJJ0NQGF EYU0NQGF
Fix information
Fixed component name
CICS TS Z/OS V6
Fixed component ID
5655YA100
Applicable component levels
R40M PSY UI96936
UP24/05/21 P F405
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":"BU048","label":"IBM Software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.1","Line of Business":{"code":"LOB70","label":"Z TPS"}}]
Document Information
Modified date:
03 June 2024