IBM Support

PI85188: CICS: DYNAMIC ROUTING PROGRAM NOT CALLED WHEN NO AORS ARE AVAILABLE AND PROGRAM NOT AVAILABLE IN DEFAULT TOR

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When a TERMINAL STARTED transaction is routed, if there are no
    target AOR regions available and the PROGRAM specified for the
    transaction is not installed in the default TOR, the dynamic
    routing program (DTRPGM) does not get called.  The DYRFUNC
    parameter is not set to a value to indicate that the attempted
    route of the transaction was not successful.  Therefore, this
    can prevents the DTRPGM from handling the route as needed and
    may prevent any proper clean up from occurring.  This can lead
    to control blocks becoming orphaned in storage
    .
    As an example, when the DTRPGM=EYU9XLOP, CPSM will not be
    called to clean up the WAOW (WorkLoad Manager AOR Work Element)
    control blocks residing in the WLM dataspace.  This can
    eventually lead to the WLM maximum data cache limit being
    reached (message EYUXC0023S).
    .
    .
    .
    Additional Symptom(s) Search Keyword(s): KIXREVCTC
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: The dynamic transaction routing         *
    *                      program (DTRPGM) is not called for      *
    *                      task termination if the task runs       *
    *                      locally and the initial program is      *
    *                      unavailable.                            *
    ****************************************************************
    * RECOMMENDATION: .                                            *
    ****************************************************************
    A dynamic routing URM (DTRPGM) requested notification on
    transaction termination (DYROPTER=Y). All the candidate AORs
    for the transaction were unavailable and the DTRPGM requested
    that the transaction be run locally on the TOR.
    The initial program for the transaction was not available on
    the TOR and the task terminated without invoking the URM.
    
    Additional keywords: DFHDYP EYU9XLOP EYUXC0023S MSGEYUXC0023S
    

Problem conclusion

  • CICS has been changed to call the DTRPGM for task termination
    when DYROPTER=Y is specified and a dynamic transaction fails
    to run locally because the initial program for the task is
    unavailable.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI85188

  • 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-07-28

  • Closed date

    2017-08-04

  • Last modified date

    2017-09-02

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

    PI84247

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

    010PC2Ÿ UI49326 UI49327 UI49328 UI49329

Modules/Macros

  • DFHAPRT
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R000 PSY UI49327

       UP17/08/09 P F708 ¢

  • R100 PSY UI49329

       UP17/08/09 P F708 ¢

  • R800 PSY UI49326

       UP17/08/09 P F708 ¢

  • R900 PSY UI49328

       UP17/08/09 P F708 ¢

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 2017