IBM Support

PI98182: DFHSO0123 RC: 406 AND DFHWB0732 I/O ERROR ON SOCKET SEND.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After migration to CICS TS 5.4, you start receiving messages:
    .
    DFHSO0123 Return code 406 received from function
    gsk_secure_socket_init  of System SSL. Reason: An I/O
    error occurred. Peer: 9.1.1.100, TCPIPSERVICE:
    TCPServ.
    .
    DFHWB0732 CWXN CICS Web attach processing encountered a sockets
    I/O error while receiving a client request. Host IP address:
    9.1.1.150. Client IP address: 9.1.1.100. TCPIPSERVICE: TCPServ
    .
    The problem was introduced by work done during 5.4
    development to make the CICS sockets domain 64-bit.  CICS
    was changed to return -1 to System SSL for all exception cases.
    Importantly this included when a connection was closed.
    CICS should be returning 0 in this case, as it has done on all
    previous releases, instead of -1.
    .
    A prior APAR PI89854 was taken to address similar behavior on
    an SSL socket RECEIVE callback routine.  This APAR addresses a
    SEND.
    
    
    
    
    Additional Symptom(s) Search Keyword(s): KIXREVDAM
    DFHSO0002 SEVERE ERROR CODE 080C DFHSOSE
    GSK_RESPONSE(GSK_ERROR_IO) GSK_RETURN_CODE(196)
    HEX 196 IS DEC 406
    GSK_RESPONSE GSK_ERROR_IO GSK_RETURN_CODE 196
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHSO0123 and DFHWB0732 issued when an  *
    *                      SSL connection is closed.               *
    ****************************************************************
    A TCPIPSERVICE is installed that specifies SSL(YES). DFHSOCK
    makes a call to send SSL data. This returns
    sock_send_buffer_n equal to 0 and sock_response equal to
    sock_exception because the client had immediately closed the SSL
    connection without sending any data.
    
    DFHSOSE handles the return to System SSL and sets the return
    value to -1. This causes System SSL to return GSK_ERR_IO (406),
    causing CICS to issue messages DFHSO0123 and DFHWB0732.
    
    Additional keywords: msgDFHSO0123  SO0123  msgDFHWB0732
                         WB0732
    

Problem conclusion

  • DFHSOSE has been changed to return 0 to System SSL when a
    socket send request fails because the connection is closed.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI98182

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-05-21

  • Closed date

    2018-06-26

  • Last modified date

    2020-01-07

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

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

    UI56849

Modules/Macros

  • DFHSOAD  DFHSOCK  DFHSODM  DFHSODUF DFHSOIS  DFHSOL   DFHSOLI
    DFHSOLS  DFHSOLX  DFHSOLX6 DFHSOM01 DFHSOM02 DFHSOM03 DFHSOPL
    DFHSORD  DFHSOS00 DFHSOS01 DFHSOS02 DFHSOS03 DFHSOS04 DFHSOS05
    DFHSOS06 DFHSOS07 DFHSOS08 DFHSOS09 DFHSOS10 DFHSOS11 DFHSOS12
    DFHSOS13 DFHSOS14 DFHSOS15 DFHSOS16 DFHSOS17 DFHSOS18 DFHSOS19
    DFHSOS20 DFHSOS21 DFHSOS22 DFHSOS23 DFHSOSE  DFHSOSES DFHSOST
    DFHSOTB  DFHSOTI  DFHSOTRI DFHSOUE  DFHSOXM
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R100 PSY UI56849

       UP18/06/27 P F806

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

Document Information

Modified date:
07 January 2020