IBM Support

PI78771: DFHWB0002 MESSAGE AND DUMP ISSUED FOR GETSOCKNAME_FAILURE. DFHWBSR PEEK ROUTINE HANDLES THE GETSOCKNAME FAILURE AS DISASTER

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • A client disconnects and CICS issues a message and dump instead
    of handling the error silently by closing the socket.
    Code in DFHWBSR (PEEK) returns a non-zero return code that
    gets translated as WBSR_RESPONSE : WBSR_DISASTER (003) &
    WBSR_REASON : WBSR_LOGIC_ERROR (004). CSOL is running and the
    exception trace is :
    WB 0505 WBSR  *EXC* - WEBREQUEST_ERROR FUNCTION(PEEK)
    SOCKET_TOKEN()
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Message DFHWB0002 A severe error        *
    *                      (code X'0505') and system dump was      *
    *                      given in module DFHWBSR when client     *
    *                      has disconnected.                       *
    ****************************************************************
    * RECOMMENDATION: .                                            *
    ****************************************************************
    A DFHSOIS INQUIRE_CONNECTION call is made to get the server and
    client IP addresses. It failed in BPXGetSockName(BPX1GNM) and
    return ENOTCONN which means the client has disconnected. The
    DFHWBSR PEEK code is handling any INQUIRE_CONNECTION failure as
    unexpected and that leads to the severe error.
    

Problem conclusion

  • DFHWBSR has been changed so that the severe error and dump is
    not issued when the client has disconnected.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI78771

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-03-24

  • Closed date

    2017-07-18

  • Last modified date

    2017-08-02

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

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

    UI48884 UI48885

Modules/Macros

  • DFHWBA   DFHWBA1  DFHWBAP  DFHWBAPF DFHWBBLI DFHWBDM  DFHWBDUF
    DFHWBENV DFHWBPA  DFHWBPW  DFHWBSO  DFHWBSR  DFHWBTRI DFHWBTTA
    DFHWBXM  DFHWBXN
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R000 PSY UI48884

       UP17/07/21 P F707

  • R100 PSY UI48885

       UP17/07/22 P F707

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.



Document information

More support for: CICS Transaction Server

Software version: 5.3

Reference #: PI78771

Modified date: 02 August 2017


Translate this page: