IBM Support

PK56777: WEB SERVICES ATOMIC TRANSACTIONS ENHANCEMENTS

A fix is available

Subscribe

You can track all active APARs for this component.

 

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
    

Publications Referenced
GC34682700SC34681700SC34682800SC34683800GC34686400
SC34681300SC34683500   

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK33821

       UP08/02/29 P F802

  • R502 PSY UK33822

       UP08/02/29 P F802

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