A fix is available
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:
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
SC34684501 | GC34686400 |
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