A fix is available
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
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