IBM Support

PK86208: MISROUTES AFTER CHANGING YOUR APPLICATIONS TO USE CHANNELS AND CONATINERS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are changing your applications to use CHANNELS and
    CONTAINERS rather than COMMAREAS.  You have written your own
    EYU9WRAM program, and are checking for LINK (DPL) with CHANNEL
    (TDA_DYRTYPE_DPLCHA (X'F9')).  You have verified that you are
    getting to the DFHROUTE CONTAINER, but the TRANID is not getting
    updated in the TDA_LCL_TRANID.  This results in the default
    TRNGRP being used and the DPL is sent to default target region
    in error.
    EYU0WDTR needs to check for TDA_DYRTYPE_DPLCHA.
    Additional symptom(s):   KIXREVSCB
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V3R2M0 Users.                *
    ****************************************************************
    * PROBLEM DESCRIPTION: - If the CICSPlex SM EYU9WRAM (Workload *
    *                        Manager routing action module) is     *
    *                        customized to modify the transaction  *
    *                        used for a DPL request with channel,  *
    *                        then the modification is ignored.     *
    *                                                              *
    *                      - If a workload is using the Goal       *
    *                        algorithm, the transaction response   *
    *                        times calculated by CICSPlex SM as    *
    *                        a result of a DPL with channel        *
    *                        request may be incorrect.             *
    *                                                              *
    *                      - The response time of a statically     *
    *                        routed Non-terminal START with        *
    *                        channel requests may not be included  *
    *                        in CICSPlex SM Goal algorithm         *
    *                        workload calculations.                *
    *                                                              *
    *                      - Channel related WCOM_DYRTYPE          *
    *                        constants are missing from:           *
    *                                                              *
    *                         EYUAWCOD                             *
    *                         EYUBWCOD                             *
    *                         EYUCWCOD                             *
    *                         EYULWCOD                             *
    *                         EYUPWCOD                             *
    *                                                              *
    *                      - Channel related WTRA_DYRTYPE          *
    *                        constants are missing from:           *
    *                                                              *
    *                         EYUAWTRA                             *
    *                         EYUBWTRA                             *
    *                         EYUCWTRA                             *
    *                         EYULWTRA                             *
    *                         EYUPWTRA                             *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all MASes must be recycled to pick up  *
    *                 the new code.  Note that the restarts do     *
    *                 not need to be done at the same time.        *
    *                                                              *
    *                 If user customized EYU9WRAM routines or      *
    *                 user written routines that invoke EYU9XLOP   *
    *                 for WLM routing, need to use the updated     *
    *                 EYUxWCOD or EYUxWTRA copybooks, then those   *
    *                 routines will need to be rebuilt using the   *
    *                 libraries updated by the PTF that reolves    *
    *                 this APAR.                                   *
    ****************************************************************
    - EYU0WDTR (WDTR - WLM Dynamic Transaction Routing Mainline), is
      invoked when CICSPlex SM WLM API is used.
    
      On an SM_SCOPE request, WDTR checks for changes to
      WCOM_REM_TRANID for a DPL request, but not a DPL with
      channel request. This means that if a user customized
      EYU9WRAM routine is changing the transaction id to be used for
      a DPL with channel request, then the transaction
      modification will be ignored.
    
    - When a DPL request completes, EYU0WDIN (WDIN - WLM Dynamic
      Routing Initialization and Termination) is invoked to process
      the completion of the request.
    
      If the CICSPlex SM workload is running using the GOAL mode
      algorithm, WDIN may need to consider the response time of the
      DPL request in order to update the target system's response
      time for the transaction.
    
      WDIN is not performing this processing if the DPL request
      was made using a channel.
    
    - When WDIN is invoked to process a route notify of a non-
      terminal START with channel request, the work will not be
      classified into the workload. This means that the trans-
      actions response time will not be factored into the WLM
      calculations for the service class.
    
    - The EYUxWCOD copybooks are missing channel related constant
      definitions:
    
       WCOM_DYRTYPE_DPLCHA  - Dynamic routing of DPL request with
                              channel
       WCOM_DYRTYPE_TRMCHA  - Dynamic routing START request
                              with channel
       WCOM_DYRTYPE_NTISCHA - Non-terminal START
                              request with channel
    
    - The EYUxWTRA copybooks are missing channel related constant
      definitions:
    
       WTRA_DYRTYPE_DPLCHA  - Dynamic DPL with channel
       WTRA_DYRTYPE_TRMCHA  - Dynamic START with channel
       WTRA_DYRTYPE_NTISCHA - Non-terminal START with channel
    

Problem conclusion

  • - WDTR has been updated so that a transaction modification is
      honoured for a DPL with channel request.
    
    - WDIN has been updated so that DPL with channel requests are
      included in response time calculations.
    
    - Additionally, WDIN will treat a non-terminal START with
      channel, the same as a non-terminal start when it is invoked
      to classify work as the result of a route notify call.
    
    - The EYUxWCOD copybooks have been updated to define the channel
      related WCOM_DYRTYPE constants.
    
    - The EYUxWTRA copybooks have been updated to define the channel
      related WTRA_DYRTYPE constants.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK86208

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    50M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-05-08

  • Closed date

    2009-05-27

  • Last modified date

    2009-06-01

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

    PK86171

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

    PK87303 UK46885

Modules/Macros

  •    EYUAWCOD EYUAWTRA EYUBWCOD EYUBWTRA EYUCWCOD
    EYUCWTRA EYULWCOD EYULWTRA EYUPWCOD EYUPWTRA EYURWCOD EYURWTRA
    EYU0WDIN EYU0WDTR
    

Publications Referenced
SC34684501GC34686400   

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R50M PSY UK46885

       UP09/05/29 P F905

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:
01 June 2009