IBM Support

PK77657: DYRLEVEL INCORRECT DYNAMIC DISTRIBUTED ROUTING FOR REQUESTSTREAM

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Your dynamically routable webservices transactions are
    intermittently running in the requesting or default CICS region
    instead of being dynamically distributed to the eligible target
    AORs by the CICSPlex SM DSRTPGM program EYU9XLOP.
    .
    A CPSM level 27 WLM trace of the DFHDYPDS shows the DYRLEVEL
    as X'01' indicating the target region must be CICS TS V2.2.  The
    CPSM level 26 WLM trace of the scope vector elements will show
    the target regions marked as WSVE_SEL_NOT if they are not at
    level E620.  The DYRCOMP value is 'RZ' for the request stream
    domain.
    .
    A CICS trace shows DFHPIPM issuing a DFHRZSOM macro to create
    the request stream instance.  Trace id RZ 0110 RZSO shows the
    RZSO_PARMS being passed.  At offset x'F8' in the failing
    scenario, the RZSO_USER_KEY_VERSION field is a X'01', but the
    RZSO_USER_KEY_VERSION_X existence bit is not set.
    .
    The rzso_open method in the so1_create proc within DFHRZSO1
    does not check the rzso_user_key_version_x existence bit before
    copying the rzso_user_key_version value into the version field
    in the rzrs_open parmlist.  The version field is used later in
    the rzrt_route proc as the user_key_version.  DFHRZRTX copies
    the user_key_version into the DFHDYPDS field cics_level which
    maps to the DYRLEVEL passed to the distributed routing program.
    .
    DFHRZSO1 for the so1_create proc needs to only set the version
    if the rzso_user_key_version_x existence bit is set as the
    DFHRZSO_ARG is only cleared for the first x'18' bytes.
    .
    Additional Symptom(s) Search Keyword(s): cpsm xlop wlm workload
    tor wor web owning region KIXREVCEW
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: DYRLEVEL may be incorrect for dynamic   *
    *                      routing of a Web Servics request.       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When CICS is acting as a Web Service provider, it is possible
    for there to be a residual value such as 01 in the DFHRZSO
    parameter list field that is used to set the DYRLEVEL value for
    the dynamic routing program such as CPSM EYU9XLOP.
    
    This can cause an error when a CICS region of that version and
    release does not exist e.g. 01 is equivalent to CICS TS V2.2.
    

Problem conclusion

  • DFHRZSO1 has been changed to check the existence bit that says a
    CICS level has been passed in the DFHRZSO parameter list, and
    only copy the CICS level to DYRLEVEL if it is on. If the
    existence bit is not set, DYRLEVEL is set to 00 to ensure that
    any CICS version and release may be used.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK77657

  • 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

    2008-12-17

  • Closed date

    2009-03-02

  • Last modified date

    2009-04-02

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

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

    UK44479 UK44480

Modules/Macros

  •    DESRZST  DFHRZSO  DFHRZSO1 DFHRZTA
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK44479

       UP09/03/05 P F903

  • R500 PSY UK44480

       UP09/03/05 P F903

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 April 2009