PH64373: ABEND ASRA IN EYU9XLOP OCCURS ON CICSSTOR VIEW

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When using the WUI EYUSTARTCICSSTOR.TABULAR view to summarize
  any displayed field, the following message is issued:  API
  command failed.  An Abend ASRA also occurs resulting in a dump
  taken with dump title:
      EYU9XLRV Dump,jobname,cpsmname,smfid,CMAS,XDNR,0012345,ASRA
  ,EYU9XLOP,date,time
  
  This is caused by a buffer overrun while trying to summarize
  the CICSSTOR resource table.  Method XDW3 is passing a buffer
  through to method XDW9, and that buffer is being
  overrun causing XDW9 to overlay its own stack header.
  
  This occurs due to the large size of the CICSSTOR table, and
  was introduced when the table was expanded in CPSM 6.1.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM users                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: A failure occurs when using the WUI to  *
  *                      summarise CICSSTOR table information.   *
  *                      This displays "API command failed" on   *
  *                      the WUI and generates an ASRA abend in  *
  *                      the CMAS.                               *
  *                                                              *
  *                      The same error could be generated       *
  *                      directly using the API.                 *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF which resolves        *
  *                 APAR PH64373, all CMAS regions should be     *
  *                 restarted to activate the fix.               *
  *                 This can be done in any order and at any     *
  *                 time.                                        *
  ****************************************************************
  A buffer overrun occurs when using the CICSPlex SM Web User
  Interface (WUI) to display the CICSSTOR resource table.
  I.e. CICS Operations screen, then CICS Region Operations,
  then Dynamic storage area global.
  The issue occurs when attempting to Summarise on any field.
  
  The summarisation fails with "API command failed"
  
  An ASRA abend happens in the CMAS.
  The abend happens because the buffer assigned to hold summarised
  values is not big enough for the fields that need to be
  summarised for the CICSSTOR table. These fields overlay a
  register savearea and result in random abends on return.
  
  The same error occurs when using the EXEC CPSM GROUP command
  in the CICSPlex SM API.
  

Problem conclusion

• Problem is due to the large number of fields that need to
  be summarised for the CICSSTOR table. This overflows the buffer,
  GRUP_CACHE_REC, assigned by EYU0XDW3 and passed to EYU0XDW9 and
  EYU0XCLV. The buffer overlays XDW9's stack storage and register
  savearea. When XCLV tries to return to XDW9 it picks up rubbish
  and does a random branch, in our case to low, odd, storage.
  
  EYU0XDW3 has been updated to
  1) Increase the buffer size to accommodate the CICSSTOR table
  and move it out of the stack to a separately allocated area so
  it can grow in future, if required.
  2) Check the number of summarised fields will fit in the buffer.
  

Temporary fix

Comments

APAR Information

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

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

  UO02449 UO02450

Modules/Macros

• EYU0XDW3 EYU0XDW9
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R40M PSY UO02450

     UP25/03/18 P F503

• R50M PSY UO02449

     UP25/03/18 P F503

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.