PH10940: DFHMP3002 TASK XXXXX(AAAA) EXCEEDED A POLICY THRESHOLD AND IS ABENDED WITH ABEND CODE ZSTG.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The customer had a large number of task that were purged by
  policy action which caused performance of CICS to decline. The
  purge of the transaction lead to the user defined abend code
  ZSTG for the policy triggering which was capture in message
  DFHMP3002.
  .
  Additional Keywords:
  DFHMP3002 ZSTG
  KIXREVSVR
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Transactions may be abended and message *
  *                      DFHMP3002 issued for exceeding a        *
  *                      storage policy limit invalidly.         *
  ****************************************************************
  A CICS application issues a DPL to a program in a remote region
  connected by LU6.2 which is then transaction routed to a third
  CICS system over either MRO or LU6.2. This requires CICS to
  create a LU6.2 Surrogate TCTTE in the third region. To create
  the Surrogate TCTTE requires the acquiring of an RRAB and RDUB,
  however this storage is acquired before a policy is bound to the
  task.
  This task storage is not counted toward the policy threshold.
  Later during task initialisation, a Task Storage policy is bound
  to the task.
  The application includes an EXEC CICS SYNCPOINT and the DPL
  specified SYNCONRETURN.
  When the syncpoint is done it will free the task storage
  which is seen by the task's policy , so the storage policy count
  for this task may now go negative.
  A following getmain is subject to the storage policy. The policy
  limit now appears to have been exceeded due to the negative
  storage count. The policy fires, and the policy action is taken.
  
  Keywords: msgDFHMP3002 MP3002 abendAMPB AMPB
  

Problem conclusion

• The DFHMPUCI macro used by DFHSMGF, DFHS2GF, DFHSMMF and DFHSMMG
  has been updated to prevent the storage policy count being
  reduced to a negative value.
  
  A new exception trace entry has been added:
  
  MP 07FF MPUCI  Exc Policy_unmatched Counter Decrement Current
                      _subtract                          _value
  
  which will be issued should the counter wrap.
  

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:

  UI63460 UI63461 UI63462

Modules/Macros

• DFHMPTRI DFHS2GF  DFHSMGF  DFHSMMF  DFHSMMG
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI63461

     UP19/06/07 P F906

• R100 PSY UI63460

     UP19/06/07 P F906

• R200 PSY UI63462

     UP19/07/01 P F906

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.