IBM Support

PM42260: 0C4 IN DFHTISR OFFSET X'61E' WHEN SHUTTING DOWN TCPIP SOCKETS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Abend0C4 in DFHTISR offset x'61E' followed by another 0C4 in
    DFHKEDCL leads to a KERNDUMP. Problem occurs when shutting down
    TCPIP Sockets. The 0C4's occur under the CSOL task who is
    running on the SL TCB. CICS trace shows that module DFHSOS23
    issued a call to DFHTISR to cancel a NOTIFY passing an invalid
    TIMER_TOKEN. The TIMER_TOKEN is set up by DFHSOS23 using
    parameters passed from DFHSOLS during a socket.notify call.
    The problem appears to be that the 'self' parameter passed to
    DFHSOS23 was previously freed by DFHSOLS. This freed area has
    then been reused as an RMUW for a CIST task. So when the NOTIFY
    call to DFHTISR is issued, DFHTISR picks up invalid characters
    from this reused storage and program checks.
    .
    Additional Symptom(s) Search Keyword(s):
    KIXREVWJB S0C4 0C4 abendS0C4 Cancel closed INVALID_TOKEN
    REQUEST_NOT_FOUND
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: The SOCKET listener task, CSOL,         *
    *                      abended 0C4/AKEX in DFHTISR doing a     *
    *                      CANCEL TIMER_TOKEN when TCPIP is        *
    *                      being shutdown.                         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When issue "CEMT SET TCPIP CLOSE" in terminal, DFHSOLS will
    be notified and prepare to invoke sols_quiesce. In the window
    after the actions selected and ahead entering the sols_quiesce
    proc. There is DPL request issued, so SOA_SOLS_DATA_RECV is set
    immediately.
    After the sols_quiesce finishes, all object of sockets  will be
    freemained. Then the storage freemained were allocated by other
    proc.
    Then DFHSOLS listen loop start a new iteration to handle the
    SOA_SOLS_DATA_RECV event. Later, socket.notify() is issued ,
    which finally invoke the domain call DFHTISR(CANCEL) with
    input timer_token of the freed socket. Because the socket has
    been freed and the storage can be reused by other process.
    timer_token contains invalid value and eventually cause an
    exception " TISR  *EXC* INVALID-TOKEN " in trace and
    eventually cause an 0C4 abend.
    Key words: DFHSOMG  ,DFHTISR ,CANCEL.
    

Problem conclusion

  • DFHSOMG has been changed to add a proc remove_from_recv_chain
    which is used to clean the receive data elements related to the
    outbound sockets.
    DFHSOMG proc terminate_all has been changed to invoke the
    remove_from_recv_chain before destroy the outbound sockets.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM42260

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-06-22

  • Closed date

    2011-09-15

  • Last modified date

    2011-10-03

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

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

    UK72108 UK72109

Modules/Macros

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

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK72108

       UP11/10/01 P F109

  • R700 PSY UK72109

       UP11/10/01 P F109

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

Document Information

Modified date:
03 October 2011