IBM Support

PI76740: INCORRECT TASK LOAD FOR RS DOMAIN

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • XMAT increments and decrements the Task Load count for System
    Tasks for RS domain. These counts should only be adjusted for
    non-system tasks.
    .
    NOTE: This does NOT mean that regions with the fix applied and
    regions without the fix applied would have a dramatic task
    count difference. System tasks are not counted as part of the
    load count for CPSM WLM routing anyway. The problem being
    addressed here is that without the fix, when a system task
    ends, we incorrectly decrement the task count. However, upon
    the next attach of a user task, the count corrects itself. If
    the region is idle and no new user tasks are being attached,
    the count corrects itself at the next CPSM heartbeat, which
    occurs every 15 seconds. So in a region with a steady flow of
    work, there would only be a fraction of a second where the task
    count was too low by one task before the count was correct
    again.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of CICS Transaction Server for z/OS    *
    *                 V5.1, V5.2 and V5.3.                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: CPSM Workload Manager may be passed     *
    *                      incorrect CICS task counts when the     *
    *                      target region (AOR) is in Sysplex       *
    *                      Optimized Routing state.                *
    ****************************************************************
    CPSM Workload Manager is passed incorrect CICS task counts
    when the target region (AOR) is in Sysplex Optimized Routing
    state.  This can cause routing regions to perceive a target
    region as being more lightly loaded than it actually is.  This
    effect is caused by the initialisation and termination of a
    CICS system task which should have no recognizable effect on
    the task load count for a CICS region.  However, due to a
    logic error in the CICS Region Status Transaction Manager
    program (DFHXMTA), the region status transaction manager gate
    module (DFHRSXM), is being called both for initialisation and
    termination of a CICS system transaction causing the load
    count reported in the region status record to be one less than
    its actual value.
    

Problem conclusion

  • This has been addressed by adding a check to DFHXMTA to only
    call DFHRSXM if the task being initialised or terminated is
    not a CICS system task.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI76740

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-02-16

  • Closed date

    2017-04-03

  • Last modified date

    2017-05-01

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

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

    PI76937 UI46106 UI46107 UI46108 UI46111 UI46112 UI46113 UI46114
    UI46115 UI46116

Modules/Macros

  • DFHRSXM  DFHRSXMT DFHXMAB  DFHXMAT  DFHXMER  DFHXMERT DFHXMRSD
    DFHXMRSH DFHXMRSL DFHXMTA  DFHXMXE
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R000 PSY UI46114

       UP17/04/05 P F704 ¢

  • R002 PSY UI46115

       UP17/04/05 P F704 ¢

  • R003 PSY UI46116

       UP17/04/05 P F704 ¢

  • R800 PSY UI46106

       UP17/04/05 P F704 ¢

  • R802 PSY UI46107

       UP17/04/05 P F704 ¢

  • R803 PSY UI46108

       UP17/04/05 P F704 ¢

  • R900 PSY UI46111

       UP17/04/05 P F704 ¢

  • R902 PSY UI46112

       UP17/04/05 P F704 ¢

  • R903 PSY UI46113

       UP17/04/05 P F704 ¢

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:
01 May 2017