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

Obtain the fix for this APAR.

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 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.