A fix is available
APAR status
Closed as program error.
Error description
Various errors detected when attempting to use WSAT from CICS 3.1 to WAS 6.1 with security active.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: Various restart and recovery problems * * when using WS-AT. * **************************************************************** * RECOMMENDATION: * **************************************************************** This APAR addresses a number of issues relating to Web Services Atomic Transactions (WS-AT) resync work within CICS TS 3.1. It also addresses some further problems when interoperating with WebSphere Application Server. These problems include: - The <wsa:ReferenceProperties> element sent out by CICS contains a token to enable the correct task to be identified when future WS-AT messages are received. CICS is unable to distinguish between tokens issued for this run of CICS and tokens relating to tasks from previous runs of CICS which have been restored from the log and are undergoing resync processing. - The pipeline resync task (CPIS) was being attached at startup once for every task recovered from the log that had PIRS links. However the first CPIS task processed all PIRS links in the system making the other tasks redundant. - CICS was not sending <wsa:Replay> messages to the correct endpoint in this customer's case. This was because CICS was using the endpoint from the original Web service request which is for the registration service instead of using the endpoint from the RegisterResponse message which is for the coordination service. - WebSphere Application Server 6.0.2.15 onwards supplies both <wsa:ReferenceProperties> and <wsa:ReferenceParameters> elements. CICS was not able to return these correctly when both were in the same message leading to XML parsing errors in WebSphere. - CICS as a WS-AT participant did not handle WS-AT transaction timeout correctly when waiting for the next protocol message. - CICS did not issue any informational messages when backing out the unit of work as a WS-AT participant. The unit of work was still backed out correctly though. - If a <wsa:Replay> message was received by CICS it sent the required reply to the specified endpoint address and then returned an HTTP 200 OK response to the original message. This ordering caused locking problems in WebSphere and the first message, which the transaction in WebSphere needs to continue processing, gets discarded. Additional Keywords: ReferenceProperties ReferenceParameters Replay
Problem conclusion
The CICS WS-AT support has been enhanced to correct these issues. The CICS Transaction Server for z/OS Version 3 Release 1 CICS Trace Entries manual (SC34-6443-03) will be updated as follows: Add the following new trace entries to the end of Chapter 28 'Pipeline manager domain trace points' Point ID Module Lvl Type Data PI 1804 DFHPIIM PI 2 Recreate token 1 - Token 2 - Object Address PI 1805 DFHPIIM PI 2 Create CTX token 1 - Token 2 - Object Address PI 1806 DFHPIIM PI 2 Lookup CTX token 1 - Token 2 - Object Address PI 1807 DFHPIIM PI 2 Update CTX token 1 - Token 2 - Object Address PI 1808 DFHPIIM PI Exc CTX Function Fail 1 - Function Name 2 - Token PI 1809 DFHPIIM PI 2 Destroy CTX token 1 - Token PI 1810 DFHPIIM PI 2 Recreate CTX token 1 - Token 2 - Object Address The CICS Transaction Server for z/OS Version 3 release 1 CICS Messages and Codes manual (GC34-6442-03) will be updated as follows: Add the following two new messages at the appropriate place in chapter 1 'DFH messages', section 'DFHPIxxxx messages'. DFHPI0732 DATE TIME APPLID A REQUEST TO ROLLBACK UNIT OF WORK - X'UOWID' HAS BEEN RECEIVED FROM A REMOTE WS-AT COORDINATING TRANSACTION. EXPLANATION: During processing of an atomic transaction the remote WS-AT coordinating task has requested that CICS rolls back the specified unit of work. SYSTEM ACTION: The specified unit of work will be rolled back. USER RESPONSE: None. DESTINATION: CPIO MODULE: DFHPIRS XMEOUT PARAMETERS: date, time, applid, X'uowid' **************************************************************** DFHPI0733 DATE TIME APPLID A TRANSACTION TIMED OUT WHILE WAITING FOR A PREPARE MESSAGE FROM A REMOTE WS-AT COORDINATOR. THE UNIT OF WORK - X'UOWID' WILL BE ROLLED BACK. EXPLANATION: A CICS transaction waiting for a Prepare message from a remote WS-AT coordinator has timed out. SYSTEM ACTION: The specified unit of work will be rolled back. USER RESPONSE: None. DESTINATION: CPIO MODULE: DFHPIPM XMEOUT PARAMETERS: date, time, applid, X'uowid' The CICS Transaction Server for z/OS Version 3 Release 1 Supplementary Data Areas manual (LY33-6108-00) will be updated as follows; In section 1.126 'PIDCC Pipeline Manager Control Blocks' change the PI_PIPE_MANAGER field at offset x'2C' in the PI domain anchor block and all subsequent fields to read as follows; --------------------------------------------------------------- Pipeline Manager Object --------------------------------------------------------------- (2C) CHARACTER 1152 PI_PIPE_MANAGER --------------------------------------------------------------- Tokens and flags --------------------------------------------------------------- (4AC) ADDRESS 4 PIA_LOCK_TOKEN Domain lock token (4B0) UNSIGNED 4 PIA_DIR_TOKEN Directory token (4B4) UNSIGNED 4 PIA_WS_DIR_TOKEN Webservice directory (4B8) CHARACTER 1 PIA_FLAGS Flags 1... .... PIA_LOCK_HELD lock held .1.. .... PIA_COLD_START cold start indicator ..1. .... PIA_STATE state of PI anchor ...1 .... PIA_IN_RESYNC in resync processing .... 1111 * reserved (4B9) CHARACTER 8 PIA_AP_ RZ_NOTIFY_TOKEN LSTN RZ callback (4C1) CHARACTER 0 * In the 'Constants' section after TID_PILN_INVALID_BROWSE 2 HEX 1105 TID_PILN_ INVALID_BROWSE_ Add the following; 2 HEX 1800 TID_PIIM_CREATE 2 HEX 1801 TID_PIIM_LOOKUP 2 HEX 1802 TID_PIIM_UPDATE 2 HEX 1803 TID_PIIM_DESTROY 2 HEX 1804 TID_PIIM_RECREATE 2 HEX 1805 TID_PIIM_CREATE_CTX 2 HEX 1806 TID_PIIM_LOOKUP_CTX 2 HEX 1807 TID_PIIM_UPDATE_CTX 2 HEX 1808 TID_PIIM_CTX_FUNC_FAILED 2 HEX 1809 TID_PIIM_DESTROY_CTX 2 HEX 1810 TID_PIIM_RECREATE_CTX
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK42688
Reported component name
CICSTS 3.1 Z/OS
Reported component ID
5655M1500
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2007-04-05
Closed date
2007-06-21
Last modified date
2007-07-19
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK26333 UK26334 PK49217
Modules/Macros
DESPIAT DESPICC DESPIDC DESPIDM DESPIDUF DESPIII DESPIIM DESPIIS DESPIIW DESPILN DESPIPL DESPIPM DESPIRE DESPIRM DESPIRS DESPISC DESPISF DESPISN DESPIST DESPITH DESPITL DESPITQ DESPITRI DESPIWR DESPIWT DESRMUW1 DESRMUW3 DESRMUW4 DESRUTK DESRZDM DESRZDUF DESRZIS DESRZLN DESRZNR DESRZOFX DESRZRG DESRZRJ DESRZRM DESRZRS DESRZRT DESRZRTX DESRZSK DESRZST DESRZTC DESRZTR DESRZTRI DESRZVPX DESRZXM DESSOAD DESSOCK DESSODM DESSODUF DESSOIS DESSOLS DESSOLT DESSOMG DESSORD DESSOSO DESSOST DESSOTB DESSOTD DESSOTI DESSOUS DESSOXM DESWSATH DESWSATR DFHMEPIC DFHMEPIE DFHMEPIK DFHPIAP DFHPIAT DFHPIATC DFHPICC DFHPIDCC DFHPIDCD DFHPIDM DFHPIDSH DFHPIDUF DFHPIII DFHPIIMC DFHPIIMI DFHPIISC DFHPIISI DFHPIIW DFHPILN DFHPIPL DFHPIPM DFHPIRE DFHPIRI DFHPIRM DFHPIRS DFHPIRT DFHPISB DFHPISC DFHPISF DFHPISN DFHPISN1 DFHPISN2 DFHPIST DFHPITH DFHPITL DFHPITQ DFHPITQ1 DFHPITRI DFHPIUCC DFHPIUCD DFHPIWR DFHPIWT DFHPIXC DFHPIXC@ DFHRMUWB DFHRMUWE DFHRMUWF DFHRMUWH DFHRMUWJ DFHRMUWL DFHRMUWN DFHRMUWP DFHRMUWQ DFHRMUWS DFHRMUWU DFHRMUWV DFHRMUWW DFHRMUW0 DFHRMUW1 DFHRMUW3 DFHRMU1C DFHRMU1D DFHRMU1E DFHRMU1G DFHRMU1J DFHRMU1K DFHRMU1L DFHRMU1N DFHRMU1R DFHRMU1S DFHRMU1U DFHRUTKC DFHRZDM DFHRZDMC DFHRZDMD DFHRZDUF DFHRZISC DFHRZIX DFHRZLN DFHRZNRC DFHRZNR2 DFHRZOFI DFHRZRGC DFHRZRG2 DFHRZRJ DFHRZRJA DFHRZRJM DFHRZRJT DFHRZRM DFHRZRMC DFHRZRMD DFHRZRSC DFHRZRSD DFHRZRS1 DFHRZRT DFHRZRTA DFHRZRTC DFHRZRTM DFHRZRT1 DFHRZRT2 DFHRZSKC DFHRZSO DFHRZSOA DFHRZSOJ DFHRZSOM DFHRZSOT DFHRZSOV DFHRZSO1 DFHRZTA DFHRZTAA DFHRZTAM DFHRZTAT DFHRZTCC DFHRZTCX DFHRZTRC DFHRZTRD DFHRZTRI DFHRZTR1 DFHRZVP1 DFHRZXM DFHSOAD DFHSOCK DFHSODM DFHSODUF DFHSOIS DFHSOLS DFHSOLTC DFHSOMGC DFHSOM01 DFHSOM02 DFHSOM03 DFHSORD DFHSOSOC DFHSOST DFHSOS00 DFHSOS01 DFHSOS02 DFHSOS03 DFHSOS04 DFHSOS05 DFHSOS06 DFHSOS07 DFHSOS08 DFHSOS09 DFHSOS10 DFHSOS11 DFHSOS12 DFHSOS13 DFHSOS14 DFHSOS15 DFHSOS16 DFHSOS17 DFHSOS18 DFHSOS19 DFHSOS20 DFHSOS21 DFHSOS22 DFHSOS23 DFHSOTB DFHSOTDC DFHSOTDD DFHSOTI DFHSOUSC DFHSOXM DFHWSATH DFHWSATR DFH42688 MFHMEPIE
SC34644303 | GC34644203 | LY33610800 |
Fix information
Fixed component name
CICSTS 3.1 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.1","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.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
19 July 2007