PM24216: DFHSO0106 OPENEDITION ASSEMBLER CALLABLE SERVICE ERROR CODE 0C36 FOLLOWED BY DFHSO0001 ABEND0C4'S AND DFHSM0002 0305

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS Transaction Server 3.2 and receive
  the following error messages:
  DFHSO0106 An OpenEdition Assembler Callable Service
            error (code X'0C36') has occurred in
            module DFHSOLS.
  DFHME0116 CICS symptom string for message DFHSO0106
            is PIDS/5655M1500 LVLS/650 MS/DFHSO0106
            RIDS/DFHSOLS PTFS/UK55731 PRCS/00000C36
  DFHSO0001 An abend (code 0C4/AKEX) has occurred at
            offset X'0196' in module DFHSOS23.
  DFHSO0001 An abend (code 0C4/AKEX) has occurred at
            offset X'0248' in module DFHSOS03.
  DFHSM0002 A severe error (code X'0305') has occurred
            in module DFHSMGF.
  The 0C36 error code indicates- EINVAL which means there
  was an invalid parameter in a request we sent to  TCP/IP.
  .
  Looking at a dump you will see the following exception
  trace entries:
  First is the TImer task running on the SO tcb processing
  a CANCEL request due to a socketclose timeout:
  SO 0E02 SOUS  *EXC* - ASYNCIO_ERROR RETURN_VALUE(-1)
         RETURN_CODE(121) REASON_CODE(11780416)
  TASK-TI    KE_NUM-0009 TCB-SO
  Above corresponds to trace point TID_SOUS_ ASYNCIO_FAILURE
  in CICS.  This is followed by:
  .
  SO 0B0B SOTI  *EXC* - IO_CANCEL_EXCEPTION
  TASK-TI    KE_NUM-0009 TCB-QR   /009C2E88
  .
  Then the CSOL task also receives the following exception,
  that has the same return code/reason code as above:
  SO 0E0F SOUS *EXC* - GETCLIENTID_FAILURE
         RETURN_VALUE(-1) RETURN_CODE(121)
         REASON_CODE(11780416)
   TASK-00004 KE_NUM-0018 TCB-SL
  This corresponds to CICS trace point
  TID_SOUS_ GETCLIENTID_FAILURE.
  .
  There is a timing problem where CSOL has freemained a socket
  that is still being referenced by the TImer task, and happens
  to be getmained by the CSOL task again. Both are updating
  the same area used for the BPX_interface, which causes the
  requests to fail with EINVAL.
  .
  Additional keywords: C36 0305 AKEX recursive
  KIXREVRJL
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: MSGDFHSO0106 An OpenEdition Assembler   *
  *                      Callable Service error code 0C36 occurs *
  *                      in module DFHSOLS.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  SOCKETCLOSE timeout runs under a timer domain task. The token
  for the timed out socket is validated and DFHSOS09 is called to
  cancel the ASYNC RECEIVE which the socket is waiting on. Before
  the receive can be cancelled, it completes because the client
  closes the socket. This triggers the sockets listener task
  ( CSOL ) to tidy up the socket. The socket object is eventually
  freemained. As soon as tidy up completes, CSOL processes a new
  socket connection and a new socket object is getmained. The
  socket address is the same address as the one which has just
  been freemained. CSOL performs socket initialization for the new
  socket. A BPX1GCL call is issued by CSOL. This uses a parameter
  area in the socket object called BPXPARMS. At the same time, the
  timer domain task regains control and issues a BPX1AIO to cancel
  the ASYNC receive which is no longer in progress. This call also
  uses the BPXPARMS area of the same socket object. This results
  in an EINVAL error because the 2 tasks corrupt each others
  BPXPARMS parameter list for their respective socket calls.
  This error triggers message DFHSO0106 with error code 0C36 and a
  series of further severe errors culminating in an ABEND ASOL
  which causes the CSOL task to terminate abnormally. From this
  point no further sockets workload can be processed and the CICS
  region has to be recycled.
  
  ADDITIONAL KEYWORDS :- ABENDASOL DFHSOS23 DFHSOLS DFHSOS03
                         ABEND0C4 ABENDS0C4 0C4 S0C4 DFHSO0001
                         MSGDFHSO0001 SO0001 DFHSM0002
                         MSGDFHSM0002 SM0002
  

Problem conclusion

• DFHSOTI - the SOCKETCLOSE timeout module has been changed to
  pass the unique socket token to DFHSOS09.
  DFHSOS09 confirms that a socket receive is still active and
  re-validates the socket token while running on the SO (socket)
  TCB before proceeding to cancel the receive.
  

Temporary fix

•             *********
              * HIPER *
              *********
  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:

  PM28222 UK63747

Modules/Macros

•    DESSOCK  DESSOLS  DESSOSO  DESSOTI  DFHSOCK
  DFHSOLS  DFHSOSOC DFHSOS00 DFHSOS01 DFHSOS02 DFHSOS03 DFHSOS04
  DFHSOS05 DFHSOS06 DFHSOS07 DFHSOS08 DFHSOS09 DFHSOS10 DFHSOS11
  DFHSOS12 DFHSOS13 DFHSOS14 DFHSOS15 DFHSOS16 DFHSOS17 DFHSOS18
  DFHSOS19 DFHSOS20 DFHSOS21 DFHSOS22 DFHSOS23 DFHSOTI
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK63747

     UP11/01/12 P F101

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.