PI76937: INCORRECT TASK LOAD FOR RS DOMAIN

Obtain the fix for this APAR.

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    *
  *                 V4.1 and V4.2.                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: CPSM Workload Manager may be passed     *
  *                      incorrect CICS task counts when the     *
  *                      target region (AOR) is in Sysplex       *
  *                      Optimized Routing state.                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  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 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 on 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 terminated is not a CICS system
  task.
  

Temporary fix

• *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PI76740

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

  UI46076 UI46077

Modules/Macros

• DFHRSXM  DFHRSXMT DFHXMTA
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UI46076

     UP17/04/24 P F704 ¢

• R700 PSY UI46077

     UP17/04/24 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.