IBM Support

PI62040: TRANSACTION MANAGER TRANSACTION CLASS STATISTICS FIELD XMCTAPT -TIMES AT PURGE THRESHOLD INCORRECTLY SET TO VALUE OF 1

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Transaction manager transaction class (TCLASS) statistics for
    field XMCTAPT are incorrect.
    Field XMCTAPT represents:
       The number of separate times that the purge threshold of the
       transaction class has been reached (times at purge
       threshold).
    The report shows column 'Times PrgThr ' has a value of 1
    incorrectly.
    When a transaction class is defined and installed and has been
    configured with a Purge Threshold value of exactly 1 then the
    number of times at purge threshold is incorrectly also set to a
    value of 1.
    Additional Symptom(s) Search Keyword(s): KIXREVSWM
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS Transaction Manager statistics     *
    *                      field XMCTAPT is incorrect when used    *
    *                      with a Transaction Class defined with   *
    *                      PURGETHRESH=1.                          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The CICS Statistics field XMCTAPT, representing the number of
    times a transaction class has reached its purge threshold,
    reports incorrect values when viewed for a transaction class
    which specifies PURGETHRESH=1. Setting the PURGETHRESH value
    to 1 means that any transaction which queues for membership
    of the transaction class will be purged.
    When a transaction class is installed with PURGETHRESH=1, or
    modified to PURGETHRESH=1 from another value, or a statistics
    reset is performed, then the XMCTAPT statistics field will
    report that the transaction class has been at its purge
    threshold, even though no work may have run in that transaction
    class. Furthermore, the value of XMCTAPT was not correctly
    incremented when the max active limit was reached. A transaction
    class with PURGETHRESH=1 is at its purge threshold when the
    MAXACTIVE value is reached.
    

Problem conclusion

  • DFHXMCL and DFHXMST have been updated to ensure that the times
    at purge threshold statistic (XMCTAPT) is set correctly for
    transaction classes which specify PUGETHRESH=1.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI62040

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-05-06

  • Closed date

    2016-09-23

  • Last modified date

    2016-10-03

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

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

    PI68634 UI41030

Modules/Macros

  • DFHXMAT  DFHXMCL  DFHXMIQ  DFHXMQC  DFHXMST  DFHXMTA
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R900 PSY UI41030

       UP16/09/28 P F609

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.2","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.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 October 2016