PI83584: TERMINATION IN A MAS USES EXEC CICS SET TASK() FORCEPURGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Termination in a MAS uses EXEC CICS SET TASK() FORCEPURGE
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R4M0 Users.                *
  ****************************************************************
  * PROBLEM DESCRIPTION: During termination or restart of the    *
  *                      CPSM agent in a MAS, WUI or SMSS        *
  *                      region, one or more MAS tasks may not   *
  *                      be properly terminated.  When that      *
  *                      occurs, one or both of the following    *
  *                      messages will be issued:                *
  *                                                              *
  *                        EYUNL0914E Unable to purge CICSPlex   *
  *                                   SM system task -           *
  *                                   TRANID(<tranid>)           *
  *                                   TASKID(<taskid>).          *
  *                                                              *
  *                        EYUXL0160E Unable to purge CICSPlex   *
  *                                   SM system task -           *
  *                                   TRANID(<tranid>)           *
  *                                   TASKID(<taskid>).          *
  *                                                              *
  *                      If the above messages occur when the    *
  *                      region is being terminated, the tasks   *
  *                      will terminate at region termination.   *
  *                                                              *
  *                      If the above messages occur when the    *
  *                      CPSM agent is being terminated but the  *
  *                      region remains active, then subsequent  *
  *                      attempts to restart the CPSM agent in   *
  *                      the region using the COLM transaction   *
  *                      may result in abends or further         *
  *                      failures.  This will require that the   *
  *                      region be terminated in order for the   *
  *                      CPSM agent to be restarted.             *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes, MASes and SMSS regions     *
  *                 must be restarted.  Note that the restarts   *
  *                 do not need to occur at the same time.       *
  ****************************************************************
  With CICS TS V5.4, tasks that are internally initiated by
  CICSPlex SM in a MAS, WUI server or SMSS running CICS 0710, are
  changed to run under a CICS system transaction.
  
  During termination or restart of the CPSM agent in a MAS, WUI or
  SMSS region, CICSPlex SM will notify all components to
  terminate.  For components with tasks that fail to terminate
  gracefully in a timely manner, CICSPlex SM will eventually issue
  an EXEC CICS SET TASK SPI command to force purge the tasks.
  
  As force purge requests against tasks running under system
  transactions are not possible through the CICS SPI, such
  requests will fail against those tasks, resulting in one or more
  of the following messages:
  
    EYUNL0914E Unable to purge CICSPlex SM system task -
               TRANID(<tranid>) TASKID(<taskid>).
  
    EYUXL0160E Unable to purge CICSPlex SM system task -
               TRANID(<tranid>) TASKID(<taskid>).
  
  The tasks will remain active until the region terminates.  If
  the region remains active, any attempt to restart the CPSM agent
  using the COLM transaction may fail, requiring the region to be
  restarted to allow the CPSM agent to start.
  

Problem conclusion

• To allow CICSPlex SM to force purge system transactions that
  fail to terminate, the following changes have been made:
  
  - Domain gate DFHXMIQ has been updated to allow CICSPlex SM to
    force purge CICSPlex SM tasks that fail to terminate in time.
  
  - Method EYU0NLRT has been updated to call domain gate DFHXMIQ
    to force purge CICSPlex SM tasks when the CICS release is
    greater than CICS 0700. If this is the first force purge
    issued during termination by either method NLRT or method
    XLTP, a system dump is requested first.
  
  - Method EYU0XLTP has been updated to call domain gate DFHXMIQ
    to force purge CICSPlex SM tasks when the CICS release is
    greater than CICS 0700. If this is the first force purge
    issued during termination by either method XLTP or method
    NLRT, a system dump is requested first.
  
  - Method EYU9XLEV has been updated to reset the dump flags in a
    MAS region, when the MAS agent is being restarted because of
    the connected CMAS terminating.
  
  - MAS shutdown program EYU9NXTM has been updated to detect
    immediate shutdowns and bypass waiting for the MAS agent to
    terminate before returning to CICS.
  
  - Messages EYUXL0033I and EYUNL0148W have been updated to
    reflect the new system dump that may be taken when those
    messages are issued.
  
  - Field level help for resource tables WLMATARG (Active target
    regions)and WLMAWAOR (Target region in active workload) has
    been updated for the ROUTINGLOAD field in both resource
    tables. The update reflects changes to routing behaviour
    related to the usage of system transactions within CICS TS
    V5.4.
  

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:

  UI50943 UI50944 UI50945

Modules/Macros

• CJC0NLRT CJC0XLTP CJC9XLEV CJD0NLRT CJD0XLTP CJD9XLEV CJE0NLRT
  CJE0XLTP CJE9XLEV CJF0NLRT CJF0XLTP CJF9XLEV CJG0NLRT CJG0XLTP
  CJG9XLEV CJH9XLEV DFHXMATH DFHXMIQ  DFHXMIQH DFHXMIQT DFHXMIQX
  DFHXMIQY DFHXMTRI EYU0NLRT EYU0XLTP EYU9NXTM EYUE2484 EYUE2659
  EYUK2484 EYUK2659 EYUMCNLC EYUMCNLE EYUMCNLK EYUMCXLC EYUMCXLE
  EYUMCXLK EYUS2484 EYUS2659
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI50943

     UP17/10/16 P F710

• R103 PSY UI50945

     UP17/10/16 P F710

• R10M PSY UI50944

     UP17/10/16 P F710

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.