IBM Support

PM19582: LOOP WHEN TRYING TO RUN A REQUEST STREAM LOCALLY AFTER SETTING UP A DISTRIBUTED ROUTING PROGRAM AFTER CICS STARTUP.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You get a loop when trying to invoke a request stream
    transaction.  You are using a Distributed Routing Program that
    was not setup via the DSRTPGM SIT parm.  Instead, you use CPSM
    or EXEC CICS SET SYSTEM DSRTPROGRAM to name the Distributed
    Routing Program later after startup.  Then when the request
    stream arrives, the Distributed Routing Program requests that
    the transaction run locally.  In that situation, the loop
    occurs.
    

Local fix

  • Use SIT parm DSRTPGM to establish the Distributed Routing
    Program.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: A loop occurs when trying to invoke a   *
    *                      webservice locally after setting up a   *
    *                      distributed routing program after CICS  *
    *                      startup.                                *
    *                                                              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    CICS is being used as a Web Service Provider. A context switch
    occurs as part of the pipeline processing. If the context switch
    specifies a new transaction and the new transaction is defined
    as Dynamic=Yes request streams has to call the Distributed
    Routing Program to determine which region the new task is going
    to be run in.
    
    An earlier EXEC CICS SET SYSTEM DSRTPROGRAM had been issued to
    set the name of the Distributed Routing Program. As part of that
    DFHRZRT FUNCTION(SET_EXIT_PROGRAM) was called to set the request
    streams copy of the routing program name. This routine also
    incorrectly cleared out the request streams copy of the local
    sysid.
    
    When the routing program is called it returns the local sysid.
    DFHRZRT compares the sysid with the request streams copy of the
    local sysid and finds that they don't match, it then attempts to
    run the task remotely. This fails because the sysid is not a
    remote system.
    
    The routing program is called again for the route selection
    error. If it returns the local sysid again, then a loop of
    routing failure and calling the routing program occurs.
    

Problem conclusion

  • Module DFHRZRT has been changed to update the local sysid when a
    new (e.g. non-null) value has been passed in so that EXEC CICS
    SET SYSTEM DSRTPROGRAM only updates the program name.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM19582

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-07-30

  • Closed date

    2010-09-27

  • Last modified date

    2010-11-02

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

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

    PM19802 UK60935 UK60936

Modules/Macros

  •    DESRZRT  DESRZRTX DESRZST  DFHRZRT  DFHRZRTC
    DFHRZRT1 DFHRZRT2 DFHRZSO  DFHRZSO1 DFHRZTA
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK60935

       UP10/10/06 P F010

  • R500 PSY UK60936

       UP10/10/06 P F010

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

Document Information

Modified date:
02 November 2010