PH45119: CPSM RULE RESOURCE TABLE FIELDS INCORRECTLY BEING RESET AT STATISTICS INTERVAL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The CICSPlex SM RULE resource table contains two fields which
  are being reset at the CICS statistics interval, but are
  expected to contain values which are not reset.
  The affected fields are :
  COUNT = Action count
  TIME  = Last action time
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: CICSPlex SM V5R5M0 and V5R6M0 users          *
  ****************************************************************
  * PROBLEM DESCRIPTION: The CICSPlex SM RULE resource table     *
  *                      fields COUNT and TIME are being reset   *
  *                      at the CICS statistics interval.        *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes, including MASes  *
  *                 running as WUI servers, must be recycled to  *
  *                 pick up the new code.                        *
  *                                                              *
  *                 The restarts need not be performed at the    *
  *                 same time, however if systems are not        *
  *                 restarted at the same time, the following    *
  *                 rules apply:                                 *
  *                                                              *
  *                 - Maintenance Point (MP) CMASes must be      *
  *                   restarted with the updated code before     *
  *                   non-MP CMASes.                             *
  *                                                              *
  *                 - If you have more than one MP CMAS and any  *
  *                   of those MP CMASes are connected directly  *
  *                   or indirectly, then those MP CMASes must   *
  *                   be restarted with the updated code at the  *
  *                   same time.                                 *
  *                                                              *
  *                 - Before a MAS, regardless of whether it is  *
  *                   running as a WUI server, is restarted with *
  *                   the updated code, the CMAS to which the    *
  *                   MAS connects must be running with the      *
  *                   updated code.                              *
  *                                                              *
  *                 - This fix is being provided to the          *
  *                   following supported releases of CPSM:      *
  *                                                              *
  *                   -  CPSM V5R5M0 - APAR PH45119              *
  *                   -  CPSM V5R6M0 - APAR PH45119              *
  *                                                              *
  *                   Before a CMAS running with the PTF that    *
  *                   resolves this APAR for its release         *
  *                   connects directly or indirectly to a CMAS  *
  *                   running a higher release of CPSM, the      *
  *                   higher release CMAS must be restarted so   *
  *                   that it is running with the appropriate    *
  *                   PTF for its release.                       *
  *                                                              *
  *                                                              *
  *                 Additionally, all API programs that access   *
  *                 the RULE resource table should be            *
  *                 reassembled or recompiled pointing to the    *
  *                 libraries updated by the PTF that resolves   *
  *                 this APAR. The use of the COUNT and TIME     *
  *                 fields in any such API program should be     *
  *                 reviewed, and updated as necessary.          *
  *                                                              *
  *                 Additionally, where a MAS is running the     *
  *                 CICSPlex SM V5.6 MAS agent code, but the     *
  *                 CICS region is running CICS TS V5.5, then    *
  *                 both the V5.6 CPSM PTF (JCI730M) and V5.5    *
  *                 CICS PTF (HCI7200) should be applied at the  *
  *                 same time. Otherwise incomplete information  *
  *                 will be provided through the RULE resource   *
  *                 table.                                       *
  ****************************************************************
  The CICSPlex SM RULE resource table contains two fields which
  are being reset at the CICS statistics interval, but are
  expected to contain values which are not reset.
  The affected fields are :
  COUNT = Action count
  TIME  = Last action time
  This is inconsistent with the function at V5R4M0 and earlier.
  

Problem conclusion

• The fields COUNT and TIME on the RULE resource table are
  updated so that they are not reset at the CICS statistics
  interval.
  This provides consistency with CICSPlex SM V5.4 and earlier.
  
  Two new fields COUNTSTAT and TIMESTAT are added to RULE
  resource table, these two contain values which are reset
  at the CICS statistics interval.
  

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:

  UI80143 UI80144 UI80309 UI80310

Modules/Macros

• CJE0NQPU CJF0NQPU CJG0NQPU CJH0NQPU CJI0NQPU DFHMPAC  DFHMPDD
  DFHMPDE  DFHMPDM  DFHMPDUF DFHMPIB  DFHMPIBT DFHMPMO  DFHMPRL
  DFHMPSC  DFHMPST  DFHMPTRI DFHMPUE  DFHMPXM  DFJ@H531 DFJ@H532
  DFJ@H533 DFJ@H583 EYU0NQPU EYUA0215 EYUC0215 EYUL0215 EYUP0215
  EYUT0215 EYUY0215
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI80143

     UP22/04/21 P F204

• R20M PSY UI80144

     UP22/04/21 P F204

• R300 PSY UI80309

     UP22/04/28 P F204

• R30M PSY UI80310

     UP22/04/28 P F204

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.