PK55910: INTERMITTENT ABENDA03 DURING SHUTDOWN OF REGION WHICH USES SSL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A CICS region that uses SSL intermittently receives an abendA03
  at shutdown.  Before the shutdown was initiated a SOCKET has
  timed out and caused the CSOL task to be notified to close a
  SOCKET.  During SOCK_CLOSE, a call is made to SOSE
  secure_soc_close which does a TCB switch to S8.  Upon return
  from the SOSE secure_soc_close, there is no TCB switch to the
  caller mode.
  The sock_close completes and before DFHSOCK returns to the
  caller it does a TCB switch back to the caller mode, SL, without
  the disassociate_tcb (YES) parameter.  Thus, leaving the S8 TCB
  associated to the CSOL task.
  The problem is that the S8000 should not have been associated
  to the CSOL task during shutdown.  It is only during shutdown
  that the error occurs.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: AbendsA03 during normal shutdown when   *
  *                      CICS uses SSL.                          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CSOL is notified to close a secure socket due to a socket
  timeout prior to shutdown. The secure_sock_close routine
  runs on an S8 TCB but the switch back to caller mode does not
  include disassociate_tcb(YES). This leaves the S8 TCB owned
  by the CSOL task.
  During shutdown an attempt is made to delete all the open TCBs
  before deleting the mother, SP, TCB. If CSOL has not yet
  completed its termination the S8 TCB owned by it cannot
  be deleted, but is marked for deletion when it is disassociated
  from the CSOL task. Shutdown processing goes ahead to try to
  delete the SP TCB but this fails with an A03 abend as one of
  the daughter S8 TCBs has not yet been deleted.
  Alternatively, abendU4094 may occur, if the S8 TCB is deleted
  during the terminate_le_enclave processing stage of deletion of
  the SP TCB.
  The failure to disassociate an S8 TCB during secure_soc_close
  can also leave an S8 TCB associated with a Web Client
  transaction on completion of an EXEC CICS WEB CLOSE command.
  Additional keywords: CEEPIPI_RESPONSE(A03000) abendA03 sA03
  CEEPIPI_RESPONSE U4094 4094 CWXN SSL_POOL DISPATCH
  

Problem conclusion

• DFHSOSE has been altered to switch back to the calling
  TCB with a disassociate for the S8 TCB following a call
  to close a secure socket.
  

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:

  UK36714 UK36715

Modules/Macros

•    DESSOSE  DFHSOSE
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK36714

     UP08/05/29 P F805

• R500 PSY UK36715

     UP08/05/29 P F805

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.