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