PI31150: CPSM HANG DURING MAS OR CMAS STARTUP AT CPSM 5.2

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When a CPSM MAS or CMAS gets canceled or goes to end of memory,
  the z/OS exits that CPSM has registered for End Of Task
  (EYU9XEET) and End Of Memory (EYU9XEEM) are supposed to be
  called to perform lock recovery. However, in CPSM 5.2 there may
  be instances where this cleanup does not run completely. As a
  result, upon startup of the region later, it may hang.
  .
  Additional Symptoms/Keywords
  KIXREVSVR
  .
  At CMAS recycle after this problem is encountered, the XLEV
  task may hang trying to add a cache block. In an SVC dump of
  the CMAS,  IPCS output for   VERBX EYU9D520 'TASKS' may show an
  XLEV task with the following list of methods:
  .
  Kernel linkage summary for component - KNL / Kernel Linkage
  Task Meth Load-Pt  OSSB     Stack    Mal      MODB     MOEB
    40 XLEV 1EAF8300 21500758 21500780 00000000 2153ACF0 1FADD170
    40 XLBV 209CE5F8 21500758 215008C8 215001E8 2153ACF0 1FADD170
    40 CIIN 2171AE50 21500758 21500D80 21500CD0 215423F0 00000000
    40 CTIN 2177F958 21500758 21501188 21501088 215423F0 0006D390
    40 XCLB 213DDE88 21500758 21501668 21501438 2153F0F0 1FADD690
    40 XCBA 213D41A0 21500758 215018B8 21501788 2153F0F0 1FADD690
    40 XSRA 207E4E50 21500758 21501CB8 21501AB8 2153DFF0 00062DB0
    40 XSWX 207E8F50 21500758 21501F60 21501E10 2153DFF0 00062DB0
  .
  .
  While the output from  VERBX EYU9D520 'LOCKS' may show an XSRQ
  for the "Active Queue - Global Resources" and have an address
  for the Hold Chain and Wait Chain, but no list of holders and
  waiters is formatted below it.
  .
  .
  Additional symptoms...this problem can also occur during MAS
  termination where the TIST tasks within the CMAS hangs waiting
  to acquire a lock.  The task stack may resemble the following:
  .
  Kernel linkage summary for component - TOP / Topology
  Task Meth Load-Pt  OSSB     Stack    Mal      MODB     MOEB
   101 XLOP 000AF040 333AF758 333AF780 00000000 32B0DE60 31B581E0
   101 TIST 32E06570 333AF758 333AF8C8 33347ECC 32B16660 332FD000
   101 TSST 32E0AEC0 333AF758 333AFF68 333AF9F8 32B16660 332FD000
   101 TSSE 32E9D4D0 333AF758 333B0240 333B0128 32B16660 332FD000
   101 XMSM 31EE97A0 333AF758 333B0538 333B0360 32B10060 31B58600
   101 XQPQ 32591EF8 333AF758 333B1DE0 333B1AE0 32B14460 31B58770
   101 XSRA 32551750 333AF758 333B20F0 333B1FB0 32B11160 00053150
   101 XSWX 32555850 333AF758 333B2398 333B2248 32B11160 00053150
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R2M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a CICS region running as a CPSM    *
  *                      CMAS or MAS terminates abnormally       *
  *                      without going through CICS recovery,    *
  *                      CPSM global lock recovery processing    *
  *                      will not process correctly for the      *
  *                      region.  That means that any locks held *
  *                      or being waited on by the region at the *
  *                      time it terminated will not be          *
  *                      resolved.  Subsequent attempts to       *
  *                      acquire any affected locks by other     *
  *                      regions will result in those regions    *
  *                      hanging on the lock request until they  *
  *                      are terminated.                         *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, the CPSM ESSS (Environment Service     *
  *                 System Services) subsystem address space     *
  *                 (EYUX520) must be terminated on every MVS    *
  *                 image where a CMAS has executed, since the   *
  *                 last IPL.                                    *
  *                                                              *
  *                 This can be accomplished in either of two    *
  *                 ways:                                        *
  *                                                              *
  *                   1 - Insure that module EYU9X520 in the     *
  *                       linklist concatenation is replaced by  *
  *                       the updated version from SEYULINK.     *
  *                                                              *
  *                     - IPL the MVS Image.                     *
  *                                                              *
  *                 Or:                                          *
  *                                                              *
  *                   2 - Stop all CMASes and MASes on an MVS    *
  *                       image.                                 *
  *                                                              *
  *                     - Use EYU9XENF to check that no address  *
  *                       spaces are connected to the ESSS       *
  *                       subsystem.                             *
  *                                                              *
  *                     - Use the EYU9XEUT TERMINATE function to *
  *                       stop the ESSS.                         *
  *                                                              *
  *                     - Insure that module EYU9X520 in the     *
  *                       linklist concatenation is replaced by  *
  *                       the updated version from SEYULINK.     *
  *                                                              *
  *                     - Refresh LLA to ensure the updated      *
  *                       version of EYU9X520 is picked up.      *
  *                                                              *
  *                 Restart any CMASes and MASes which execute   *
  *                 on the MVS image, insuring that updated      *
  *                 libraries are being picked up.  When the     *
  *                 first CMAS is started the EYUX520 address    *
  *                 space will be started automatically.         *
  *                                                              *
  *                 For details on EYU9XENF and the EYU9XEUT     *
  *                 TERMINATE function refer to "CICS            *
  *                 Transaction Server for z/OS CICSPlex SM      *
  *                 Problem Determination Version 5 Release 2"   *
  *                 (GC34-7313-xx).                              *
  *                                                              *
  *                 Note that each MVS image can be updated      *
  *                 separately, and systems on an MVS image that *
  *                 are using the new code can communicate with  *
  *                 systems on other MVS images that are not yet *
  *                 using the new code.                          *
  ****************************************************************
  When a CICS region running as a CPSM CMAS or MAS terminates
  without going through CICS recovery, CPSM's zOS end-of-task
  (EYU9XEET) or end-of-memory (EYU9XEEM) routine will get control,
  and will issue a ESSS TERMINATE PC routine to EYUTXEPC for the
  region.  As part of this processing ESSS TERMINATE will call the
  ESSS LOCK_RECOVERY PC routine to resolve any existing holds or
  waits the region may have for CPSM global locks.
  
  Changes made in the development of CPSM 5.2 to both these PC
  routines will result in lock recovery not being performed
  properly for the region.  As a result, subsequent requests for
  any affected locks will never be resolved.  Additionally, if the
  EYU9XEUT utility is executed with the DUMP LOCKS option, it may
  abend S0C4 while trying to process data for the now terminated
  region.
  

Problem conclusion

• Copybook EYU2XELK, which is included in EYUTXEPC and processes
  the ESSS LOCK_RECOVERY PC routines, has been updated to correct
  the problem introduced at CPSM 5.2 GA.
  

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UI24252

Modules/Macros

• EYU9X520 EYUTXEPC
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R90M PSY UI24252

     UP15/01/10 P F501 ¢

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.