IBM Support

PI64604: POLICY RULE FOR TASK STORAGE IS TRIGGERED INVALIDLY (DFHMP3001) BECAUSE MP DOMAIN COUNT OF GETMAINED STORAGE IS NEGATIVE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A storage policy is defined to check transactions that are
    allocating more than 200 MB, but the message DFHMP3001 is fired:
    
    DFHMP3001 07/06/2016 09:14:16 A03CILFP Task 01100(ADJR) exceeded
      a policy threshold. BundleId=, PolicyName=mem200mb,
      RuleName=mem200mb, RuleType=storage, Category=task31,
      Threshold=209715200 (Value=200, Unit=M), CurrentCount=256.
    
    In spite of that transaction has not requested more than 200 MB.
    
    Monitor entry shows an incorrect (negative) current count:
    
     CURRENT_COUNT(FFFFFFFFFFFFFF00) ===> -256
    
    DFHXFP Transformer_2 is being driven out of the APPG
    INITIAL_LINK to DFHMIRS for a mirror transaction servicing a
    DPL. That has to issue a GETMAIN for some PC-COMM storage, but
    this is occurring before MPMO SELECT_MODEL is driven, so this
    getmain is not counted by the Policy checking. When that mirror
    completes the storage is freed, causing the MP domain count of
    getmained storage to go negative (since we subtract a number
    that was never added to the count). The mirror task does not
    end, and is reused by a second DPL request. This one does a
    smaller getmain for a PC-COMM storage, and causes the Policy to
    fire.
    

Local fix

  • No Local Fix
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHMP3001 issued invalidly after a      *
    *                      mirror task is reused.                  *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A CICS application issues a DPL to a program in a remote region,
    passing a COMMAREA. A mirror task runs in the remote region, and
    issues a PC-COMM GETMAIN for COMMAREA storage. This occurs
    before a policy is bound to the task, so this GETMAIN is not
    counted toward any policy threshold.
    Later during task initialisation, a Task Storage policy is bound
    to the task.
    When the mirror task completes its work, it issues a FREEMAIN
    for the PC-COMM commarea storage. This FREEMAIN is seen by the
    task's policy, so the storage policy count for this task is
    reduced, and goes negative.
    The task is re-used on a later DPL link for the same initiating
    task. A GETMAIN for PC-COMM commarea storage is performed once
    again, but this time the task is already subject to the storage
    policy. This policy limit now appears to have been exceeded due
    to the negative storage count. The policy fires, and the policy
    action is taken.
    This problem affects only CICS TS V5.1. In CICS TS V5.2 and
    above, the policy would be bound to the task much earlier.
    .
    Additional Keywords: MP3001 msgDFHMP3001 AMPB abendAMPB
    

Problem conclusion

  • The DFHMPUCI macro used by DFHSMGF has been updated to prevent
    the storage policy count being reduced to a negative value.
    .
    The CICS Transaction Server for z/OS Version 5 Release 1
    Trace Entries manual (SC34-2873-00) will be updated in
    Chapter 23 Managed platform domain trace points (table 163)
    with a new trace entry:
    MP  07FF  DFHMPUCI  Exc  Policy Unmatched Storage Reduction
      1 Counter
      2 Length
      3 Current Value
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI64604

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-06-22

  • Closed date

    2016-08-17

  • Last modified date

    2016-09-02

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

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

    UI40178

Modules/Macros

  • DFHMPTRI DFHSMGF  DFHSMMF  DFHS2GF
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UI40178

       UP16/08/26 P F608

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 September 2016