PM97067: DFHSO0001 REPORTING ABEND ASOB DURING SHUTDOWN OF CICS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• During shutdown, the following message is issued:
  DFHSO0001 An abend (code ---/ASOB) has occurred at offset
  X'124A' in module DFHSOS23.
  .
  There appears to be a timing issue at shutdown between CWXN
  tasks having their receives cancelled and CSOL closing all
  sockets and freemaining the storage.
  .
  The error is occuring because a completed async receive is
  being processed after its socket block has been freed and its
  locks released. Attempting to obtain one of the freed locks
  causes the error.
  .
  This apar is open for the same issue as reported by PM35385
  which has been closed as RET.
  .
  Additonal Keyword(s):  CLOSE_EXIT RETURN_VALUE(-1)
  RETURN_CODE(113) REASON_CODE(0523011C)
  113 equats to EBADF
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: MSGDFHSO0001 abend ASOB has occurred    *
  *                      at offset X'124A' in module DFHSOS23.   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A socket is being closed and deleted as part of closing a
  TCPIPSERVICE. The CSOL task cancels an outstanding async
  receive and the socket is closed. Usually the close occurs
  so soon after the cancel that CICS is not notified of the
  receive completing. However, in this problem case, the cancel
  is processed very quickly and the receive completes just before
  the socket is closed. DFHSOLX does not run immediately so the
  socket is not found when checking the receiver chain while
  deleting the socket. At a later point during the deletion,
  DFHSOLX runs and adds the socket to the receive chain.
  After the deletion, CSOL starts processing the completed async
  receive leading to a lock failure in the notify code and giving
  the ASOB abend.
  
  Additional keywords: ABENDASOB SO0001
  

Problem conclusion

• The notify code in DFHSOS23 has been changed to check if the
  socket token is valid before attempting to obtain the lock
  for the socket.
  
  If the socket token is invalid a new sockets domain exception
  trace is issued, with trace id X'0D2B'.
  
  The CICS TS 4.2 Trace Entries (SC34-7187-01) will be updated
  to add the new trace entry as follows:
  
  Point ID: SO 0D2B
  Module  : DFHSOSO
  Lvl     : Exc
  Type    : Invalid socket token
  Data    : 1 Socket object
            2 SSL data
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  PM98716 UI13307

Modules/Macros

•    DFHCZTRI DFHSOAD  DFHSOCK  DFHSODM  DFHSODS
  DFHSODUF DFHSOIS  DFHSOL   DFHSOLI  DFHSOLS  DFHSOLX  DFHSOM01
  DFHSOM02 DFHSOM03 DFHSOPL  DFHSORD  DFHSORL  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  DFHSPEJB DFHSPEJC DFHSPEJE DFHSPISB DFHSPISC DFHSPISE
  DFHSPSOB DFHSPSOC DFHSPSOE DFHSPWBB DFHSPWBC DFHSPWBE DFHTCDUF
  DFHWBDUF
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R700 PSY UI13307

     UP13/12/13 P F312

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.