IBM Support

PM92431: 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

    PM92431

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-07-05

  • Closed date

    2013-08-05

  • Last modified date

    2015-03-04

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

    PM90763

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

    UK96537

Modules/Macros

  • DFHPISN
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UK96537

       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.

[{"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":"5.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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
04 March 2015