A fix is available
APAR status
Closed as new function.
Error description
Further enhancements to WS-AT support within CICS.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: WS-AT enhancements and defect fixes. * **************************************************************** * RECOMMENDATION: * **************************************************************** This APAR provides enhancements and defect fixes to the Web Services Atomic Transactions (WS-AT) support within CICS.
Problem conclusion
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
The Web Services Atomic Transcations support within CICS has been enhanced. A new transaction, CPIA, has been introduced to allow manual resync of WS-AT units of work. Prior to this resync was only possible by restarting CICS. A new file, DFHPIDIR, is introduced and is required when using WS-AT in CICS. The CICS Transaction Server Version 3 Release 2 Messages and Codes manual (GC34-6827-00) will be updated with the following new and changed messages and abend codes. APIR EXPLANATION: The Web Services Atomic Transaction (WS-AT) handler has detected a problem. The WSAT application handler program has encountered an attempt to use one-way messages in a WS-AT message. This combination is not permitted in WS-AT. SYSTEM ACTION: The program is abnormally terminated. USER RESPONSE: Examine the trace and associated messages to determine which messages are at fault. MODULE: DFHWSATH. APIS EXPLANATION: CICS detected an error during transaction initialization for a Web services task. SYSTEM ACTION: The transaction is abnormally terminated. USER RESPONSE: Examine the trace to determine the root cause of this problem. MODULE: DFHPIXM. DFHPI0801I E DATE TIME APPLID A ONE WAY MESSAGE HAS BEEN FOUND IN AN ATOMIC TRANSACTION MESSAGE EXCHANGE FOR TRANSACTION TRAN . EXPLANATION: The Web service atomic transactions header handler in the pipeline has detected that a one way message flow has been sent as part of the atomic transaction message flows. This is not permitted. SYSTEM ACTION: The Web service atomic transactions handler has issued a trace and abended with an APIR abend. A SOAP fault message has also been sent to the client to indicate that CICS has detected an error. USER RESPONSE: The error is in the client that sent an invalid atomic transactions message to CICS. If you have control over the client system, investigate why it is attempting to use one way messages as part of the atomic transaction. DESTINATION: CPIO MODULE: DFHWSATH XMEOUT PARAMETERS: date, time, applid, TRAN DFHPI0911 E DATE TIME APPLID USERID WEBSERVICE WEBSERVICE WITHIN PIPELINE PIPELINE WAS NOT CREATED BECAUSE: {THERE IS INSUFFICIENT STORAGE | THERE IS A DIRECTORY DOMAIN ERROR | THE SPECIFIED PIPELINE IS NOT INSTALLED | A LOCK CANNOT BE OBTAINED | THERE IS A DUPLICATE RESOURCE ERROR} . EXPLANATION: WEBSERVICE WebService was not created. This error may be caused if the specified PIPELINE is not installed. SYSTEM ACTION: The WEBSERVICE is not created. USER RESPONSE: Ensure that the specified PIPELINE resource is installed and try again. DESTINATION: CPIO MODULE: DFHPIWR XMEOUT PARAMETERS: date, time, applid, userid, WebService, Pipeline, {1=there is insufficient storage, 2=there is a directory domain error, 3=the specified PIPELINE is not installed, 4=a lock cannot be obtained, 5=there is a duplicate resource error} DFHPI0995 DATE TIME APPLID TRANID THE CICS PIPELINE MANAGER HAS ENCOUNTERED A PROBLEM WITH FILE DFHPIDIR: {THE FILE WAS NOT FOUND | THE FILE KEY LENGTH WAS TOO SMALL | THE FILE RECORD SIZE WAS TOO SMALL | THE FILE IS FULL | THE FILE CONTROL RECORD IS FULL | FILE RECOVERY MODE WAS NOT BACKOUT | THERE WAS AN INTERNAL ERROR | FILE FAILED TO OPEN OR CONNECT} . EXPLANATION: The pipeline manager encountered a problem attempting to open file DFHPIDIR. This might be due to one of the following: o The file might not exist. o The file definition might not have been installed. o The file key length is too small. o The file record length is too small. o The file is full. o The file control record is full. o The file recovery mode was not specified as backout. o The file could not be connected to or opened. o An internal error occurred. SYSTEM ACTION: Processing is aborted. A SOAP fault is returned to the client. USER RESPONSE: Examine the trace to determine why the pipeline manager failed. DESTINATION: CPIO MODULE: XMEOUT PARAMETERS: date, time, applid, tranid, {1=the file was not found, 2=the file key length was too small, 3=the file record size was too small, 4=the file is full, 5=the file control record is full, 6=file recovery mode was not backout, 7=there was an internal error, 8=file failed to open or connect} DFHPI0997 DATE TIME APPLID TRANID PIPELINE THE CICS PIPELINE MANAGER HAS ENCOUNTERED AN ERROR: {PIPELINE NOT FOUND | PIPELINE NOT ACTIVE | PIPELINE MODE MISMATCH | UNHANDLED NODE FAILURE | CONTEXT SWITCH FAILED | REQUEST STREAM CREATION FAILURE | REQUEST STREAM TRANSPORT ERROR | TARGET PROGRAM UNAVAILABLE | CHANNEL ERROR | CHANNEL NOT FOUND | URI NOT FOUND | INVALID URI | AUTHORIZATION FAILURE | PROGRAM ABEND | UNIDENTIFIED PROBLEM | TIMEOUT OCCURRED | NO REQUEST MESSAGE | THERE WAS A PROBLEM WITH FILE PIDIR | ATTEMPT TO REGISTER A WS-AT CONTEXT TWICE} . EXPLANATION: The Pipeline Manager encountered a problem whilst attempting to process a message. This can be due to one of the following; o A configuration error or an unexpected event. o An exceeded timeout. o An abandoned connection attempt due to an exceeded DTIMEOUT. This causes message DFHPI0400 to be issued. o An exceeded RESPWAIT timeout while waiting for a response. SYSTEM ACTION: None. USER RESPONSE: Examine the trace to determine why the Pipeline Manager failed. DESTINATION: CPIO MODULE: DFHPIPM XMEOUT PARAMETERS: date, time, applid, tranid, pipeline, {1=PIPELINE not found, 2=PIPELINE not active, 3=PIPELINE mode mismatch, 4=unhandled node failure, 5=context switch failed, 6=request stream creation failure, 7=request stream transport error, 8=target program unavailable, 9=channel error, 10=channel not found, 11=URI not found, 12=invalid URI, 13=authorization failure, 14=program abend, 15=unidentified problem, 16=timeout occurred, 17=no request message, 18=there was a problem with file PIDIR, 19=attempt to register a WS-AT context twice} The following manuals are also updated with WS-AT related changes. The updates will appear in the next refresh of the infocenter. CICS Supplied Transactions (SC34-6817-00) Trace Entries (SC34-6828-00) Web Services Guide (SC34-6838-00) Supplementary Data Areas (GC34-6864-00) System Definition Guide (SC34-6813-00) RACF Security Guide (SC34-6835-00)
APAR Information
APAR number
PK56777
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-11-20
Closed date
2008-02-20
Last modified date
2008-03-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
CHAPT024 DESDOMS DESPIAT DESPICC DESPIDC DESPIDM DESPIDUF DESPIII DESPIIM DESPIIS DESPIIW DESPILN DESPIPL DESPIPM DESPIRE DESPIRM DESPIRS DESPISC DESPISF DESPISN DESPIST DESPITC DESPITE DESPITH DESPITL DESPITQ DESPITRI DESPIUE DESPIWR DESPIWT DESPIXM DESWSATH DESWSATR DESWSATX DESXMAT DFH$CAT2 DFHCURDD DFHCURDI DFHCURDM DFHCURDS DFHDEFDS DFHFORMS DFHMEPIC DFHMEPIE DFHMEPIK DFHPIAP DFHPIAT DFHPIATA DFHPIATC DFHPIATM DFHPIATT DFHPICC DFHPICCA DFHPICCM DFHPICCT DFHPIDCC DFHPIDCD DFHPIDM DFHPIDUF DFHPIII DFHPIIIA DFHPIIIM DFHPIIIT DFHPIIMC DFHPIIMI DFHPIISC DFHPIISI DFHPIIW DFHPIIWA DFHPIIWM DFHPIIWT DFHPILN DFHPIMM DFHPIPL DFHPIPLA DFHPIPLM DFHPIPLT DFHPIPM DFHPIPMA DFHPIPMM DFHPIPMT DFHPIRE DFHPIREA DFHPIREM DFHPIRET DFHPIRM DFHPIRS DFHPISC DFHPISCA DFHPISCM DFHPISCT DFHPISF DFHPISFA DFHPISFC DFHPISFD DFHPISFM DFHPISFT DFHPISN DFHPISNA DFHPISNC DFHPISND DFHPISNM DFHPISNT DFHPISN1 DFHPISN2 DFHPIST DFHPITC DFHPITCA DFHPITCM DFHPITCT DFHPITE DFHPITH DFHPITL DFHPITLA DFHPITLM DFHPITLT DFHPITQ DFHPITQ1 DFHPITRI DFHPIUCC DFHPIUCD DFHPIWR DFHPIWRA DFHPIWRJ DFHPIWRM DFHPIWRT DFHPIWRV DFHPIWT DFHPIXC DFHPIXC@ DFHPIXI DFHPIXM DFHPIXMA DFHPIXMM DFHPIXMT DFHPIXO DFHSTNDC DFHSTNDD DFHSTNDV DFHWSATH DFHWSATR DFHWSATX DFHXMAB DFHXMAT DFHXMER DFHXMERA DFHXMERI DFHXMERM DFHXMERT DFHXMIXN DFHXMRSC DFHXMRSD DFHXMTA DFHXMXE DFH56777 HCI6500J
GC34682700 | SC34681700 | SC34682800 | SC34683800 | GC34686400 |
SC34681300 | SC34683500 |
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:
03 March 2008