PH26781: CPSM CACHE ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CPSM Cache enhancements
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R6M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: While operating a CICSPlex SM           *
  *                      environment with a BAS configuration    *
  *                      you may experience one or more of the   *
  *                      following:                              *
  *                                                              *
  *                      - When using the EYU9XDBT (CICSPlex SM  *
  *                        definition utility) to add CICS       *
  *                        System Definitions (CSYSDEF) into a   *
  *                        CICS System Group (CSYSGRP) or to     *
  *                        add CICS System Groups to other CICS  *
  *                        System Groups, it does not complete   *
  *                        or runs for extended periods of time. *
  *                                                              *
  *                      - During the cold start of a CICS TS    *
  *                        5.6 MAS region, you receive message:  *
  *                                                              *
  *                        EYUNL0906E The CMAS has initiated a   *
  *                        shutdown of the MAS  agent.  See the  *
  *                        CMAS job log for additional           *
  *                        information.                          *
  *                                                              *
  *                        This is followed by the following     *
  *                        message in the CMAS log:              *
  *                                                              *
  *                        EYUTS0002E Topology Connect for       *
  *                        xxxxxxxx Failed - APPLID(xxxxxxxx)    *
  *                        CICSplex(xxxxxxxx).                   *
  *                                                              *
  *                        After successfully restarting your    *
  *                        MAS region some CICS resources that   *
  *                        should have been installed by BAS     *
  *                        into that MAS region were missing.    *
  *                                                              *
  *                      - Errors may occur on a TSSC task       *
  *                        processing the connect of a MAS.      *
  *                        These include S0C4 abends, and        *
  *                        errors processing an XQPQ (CPSM       *
  *                        Put Queue) request, reported          *
  *                        from module EYU0XCLL, but with a      *
  *                        PSW showing the error occurred        *
  *                        from module BMES.                     *
  *                        This may result in a CMAS             *
  *                        outage, with message EYUXC0023S       *
  *                        reporting that the QUE data           *
  *                        cache has been filled.                *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves         *
  *                 APAR PH26781, all CMASes and MASes must      *
  *                 be restarted to pick up the new code.        *
  *                 The restarts need not be performed at        *
  *                 the same time.                               *
  ****************************************************************
  In CICS TS 5.6 the CICSPlex SM BAS Component was updated with
  the capability to use all available BAS data space storage
  by spreading large resource deployment lists for BAS across
  multiple data spaces, instead of being constrained to a
  single data space. This capability was enabled by default in
  CICS TS 5.6, but with the application of this APAR
  the default will be changed to disabled. The feature
  can be disabled or enabled manually by setting feature toggle
  com.ibm.cics.cpsm.bas.largecicsplex in a CMAS region
  to either false or true.
  .
  With this CICSPlex SM BAS component capability active in a
  CICSPlex SM CMAS region, errors processing the structures used
  to manage the BAS resource deployment internal Cache List may
  lead to corruption of the Cache List contents leading to
  irregular behaviour by the CICSPlex SM BAS component.
  

Problem conclusion

• The CICSPlex SM BAS component has been updated to interact
  with the CHE component Cache List structures with reduced
  overhead, including reduced method call overhead and usage
  of direct Cache List data space storage access CHE component
  interfaces.
  .
  The CICSPlex SM CHE component has been updated to provide
  support for multiple Cache List operations under a single
  method call as well as a safe direct access interface for
  Cache List storage access by a different CICSPlex SM
  component. Additionally updates were also made to correct
  erroneous updates to the Cache List structures themselves.
  

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:

  UI74164

Modules/Macros

• CJF9DBUG CJG9DBUG CJH9DBUG CJI9DBUG EYU0BADE EYU0BAIN EYU0BASE
  EYU0BIBD EYU0BINT EYU0BMBA EYU0BMIN EYU0BMRA EYU0BMRV EYU0BMZ3
  EYU0BMZ6 EYU0DTXT EYU0DVAD EYU0DVAF EYU0DVAP EYU0DVBF EYU0DVCF
  EYU0DVCL EYU0DVDF EYU0DVEF EYU0DVHF EYU0DVJF EYU0DVKF EYU0DVKW
  EYU0DVLQ EYU0DVMF EYU0DVML EYU0DVMP EYU0DVNF EYU0DVNT EYU0DVOF
  EYU0DVQD EYU0DVQF EYU0DVQL EYU0DVRC EYU0DVRF EYU0DVRP EYU0DVSF
  EYU0DVSR EYU0DVST EYU0DVTF EYU0DVWF EYU0DVWI EYU0DVWJ EYU0DVWT
  EYU0UCDC EYU0UCL1 EYU0UCL2 EYU0UCLA EYU0UCLB EYU0UCLC EYU0UCLD
  EYU0UCLE EYU0UCLF EYU0UCLG EYU0UCLI EYU0UCLK EYU0UCLL EYU0UCLM
  EYU0UCLO EYU0UCLP EYU0UCLR EYU0UCLU EYU0UCLV EYU0UCLW EYU0UCLX
  EYU0UCLY EYU0UCLZ EYU0XCDC EYU0XCL1 EYU0XCL2 EYU0XCLA EYU0XCLB
  EYU0XCLC EYU0XCLD EYU0XCLE EYU0XCLF EYU0XCLG EYU0XCLH EYU0XCLI
  EYU0XCLK EYU0XCLL EYU0XCLM EYU0XCLO EYU0XCLP EYU0XCLR EYU0XCLS
  EYU0XCLU EYU0XCLV EYU0XCLW EYU0XCLX EYU0XCLY EYU0XCLZ EYU0XCRB
  EYU0XCRS EYU0XCX3 EYU0XL10 EYU0XL40 EYU0XL50 EYU0XL70 EYU0XL80
  EYU0XLUT EYU9D560 EYU9DBG0 EYU9DBG1 EYU9DBG2 EYU9DBG3 EYU9DBUG
  EYU9XCP3 EYU9XCP4 EYU9XCP6 EYU9XCPU EYU9XCR3 EYU9XCR4 EYU9XCR6
  EYU9XCRU EYU9XLOP EYU9XMAL EYULXCLT EYUTXLOD EYUTXLUK
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R30M PSY UI74164

     UP21/02/27 P F102 ¢

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.