PM90763: SOAPFAULT SHOWS WRONG ERROR MESSAGE AFTER A USER ABEND WITH A HTTP TRANSPORT HANDLER PROGRAM ACTIVE.

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • If a CICS-Webservice throws an user-abend (EXEC CICS ABEND...)
    and that service runs with "Identity Propagation", then the
    SOAPFault shows the wrong "program" in the
     SOAPFault-details-section.
    
    In our environment, we've configured a "transport-http-handler"
     in the provider-pipeline.
    That handler makes some security-checks and builds then the
    container: DFHWS-ICRX.
    If that container is present, then "Identity Propagation"
    starts.
    Our webservice is a java-module (ABCDFUN3), that throws an
    user abend (code: EFGH).
    
    If we use "Identity Propagation", then the SOAPFAULT
    details-section shows the application-handler (DFHPITP) as
    the cics-program:
     <SOAP-ENV:Detail>
      <cics:FaultDetail xmlns:cics="http://www.ibm.
    com/software/htp/cics/fault">
       <cics:Error>
    The soap fault should contain our program ABCDFUN3 not
    DFHPITP.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: SOAP fault contains the wrong program   *
    *                      name after an abend is issued in a      *
    *                      user program.                           *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    CICS is acting as a web service provider and the context-switch
    is performed during request processing. When a web request is
    received, source task is invoked which then attaches target
    task to handle this request. During the target task processing,
    the requested user program in turn gets executed.
    
    In the user program, EXEC CICS ABEND is issued according to its
    application logic. This LINK_ABEND exception is then passed back
    to source task. Because of the exception, a SOAP fault message
    which contains the ABEND information (ABEND code and failing
    program name) is created in DFHPISN and then sent back to
    requester side. But the failing program name which is used to
    create the SOAP fault message is the name of the application
    handler instead of the name of the program which abended.
    
    Additional keywords: SOAPFAULT apphandler DFHPI0997
                         msgDFHPI0997 DFHPITP
    

Problem conclusion

  • DFHPISN has been changed to retrieve the failing program name
    and abend code from the most recent abend record when creating
    a SOAP fault as a result of an abend in the target task.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM90763

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-06-10

  • Closed date

    2013-08-05

  • Last modified date

    2013-09-03

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    PM92431 UK96535

Modules/Macros

  •    DFHPISN
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R700 PSY UK96535

       UP13/08/15 P F308

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.



Rate this page:

(0 users)Average rating

Document information


More support for:

CICS Transaction Server

Software version:

4.2

Reference #:

PM90763

Modified date:

2013-09-03

Translate my page

Machine Translation

Content navigation