PH61193: 0C4/AKEA IN EYU0NQGF WHEN USING THE "COMPLETED TASK" VIEW IN CICS EXPLORER.

Obtain the fix for this APAR.

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 is sysrouted FROM one or more of the following:

  PH61105

• APAR is sysrouted TO one or more of the following:

  UI96934 UI96935

Modules/Macros

• CJE0NQGF CJF0NQGF CJG0NQGF CJH0NQGF CJI0NQGF EYU0NQGF
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R20M PSY UI96935

     UP24/05/23 P F405

• R30M PSY UI96934

     UP24/05/22 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.