A fix is available
APAR status
Closed as program error.
Error description
After applying PM08183 several customers have reported the following abend in DFHTFIQ: DFHTF0001 An abend (code 0C4/AKEA) has occurred at offset X'058C' in module DFHTFIQ. PIDS/5655M1500 LVLS/650 MS/DFHTF0001 RIDS/DFHTFIQ PTFS/HCI6500 AB/S00C4 AB/UAKEA ADRS/0000058C Additional symptoms: DFHTFIQ is attempting to increment a storage violation count- SET_TERMINAL_FACILITY COUNT_STORAGE_VIOLATION(YES) R10 the tctte pointer contains 000A0000. With XM tracing off, module DFHZTSP is setting XM_TXN_FACILITY_TOKEN to a value of x'000A0000' a local fix for this problem is to turn on XM level 1 tracing. Second problem: --------------- When installing a remote terminal using EXEC CICS CREATE or CEDA INSTALL the terminal associated with the task is not released on task termination and a hang occurs. tf_tctte_ptr zero zeroes zeros TFRF RELEASE_FACILITY DFHLTRC LIFO Third problem: --------------- When using CEDA . Messages: --------- DFHAP0001 abend code 0C4/AKEA occurred at offset X'0000221E' in module DFHZISP DFHTF0001 An abend (code 0C4/AKEA) has occurred at offset X'02F4' in module DFHTFIQ DFHXM0002 severe error code X'100B' occurred in module DFHXMIQ DFHAP0001 abend code 0C1/AKEA occurred at offset X'0344' in module DFHLTRC DFHRM0002 severe error code X'020B' occurred in module DFHRMUO AP0001 TF0001 XM0002 RM0002 . Trace entries: -------------- AP 0790 SRP *EXC* PROGRAM_CHECK AP 0781 SRP *EXC* ABEND_ASRA DFHZISP,0000221E,CICS AP 1702 TFIQ *EXC* Recovery_entered INQUIRE_TERMINAL_FACILITY,000A0000 XM 100B XMIQ *EXC* Unexpected_return_code_from_ TFIQ_INQUIRE_TERMINAL_request INQUIRE_TRANSACTION AP 1712 TFRF *EXC* Recovery_entered RELEASE_FACILITY,NO,NORMAL,000A0000 AP 1762 LTRC *EXC* Recovery_entered PERFORM_COMMIT,NO,FORWARD RM 020B RMUO *EXC* Bad_response_from_client COMMIT_UOW,NO . Multiple abends for one task causes the CICS region to end (crash) IEF450I ABEND=S000 U1800 REASON=00000000
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users with the PTF of APAR PM08183 * * applied. * **************************************************************** * PROBLEM DESCRIPTION: DFHTFIQ abends 0C4 at offset X'058C' * * when there is a storage violation in * * a routed transaction. * * A terminal hangs when running a task * * installing a remote terminal using * * CEDA or EXEC CICS CREATE. * **************************************************************** * RECOMMENDATION: * **************************************************************** There are two problems caused by code added in APAR PM08183 to clear the facility token when issuing a freemain for a surrogate terminal in the DFHZTSP SKELCOM code. In cases when the principal facility is the surrogate terminal, the SKELCOM code sets the facility token to nulls when XM tracing it turned ON. However, when XM tracing is turned OFF the facility token is set to the value within the 4 bytes at address X'00000000' This typically has a value other than nulls. If CICS detects a storage violation in task storage during task termination there is an attempt to update the TCTTE storage violation count using the invalid facility token as the TCTTE address which resulted in an abend0C4 in DFHTFIQ. When a CEDA INSTALL or EXEC CICS CREATE request is made to install a remote terminal the terminal associated with the task issuing the request hangs on task termination. In this case the facility token should not have been cleared in SKELCOM because the principal facility was the terminal associated with the CEDA or EXEC CICS request rather than the surrogate. Additional keywords: MSGDFHTF0001 DFHTF0001 TF0001 S0C4 abendS0C4
Problem conclusion
UK56620 DFHZTSP has been changed to clear the current transaction's facility token correctly when appropriate.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM25940
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
YesPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-11-05
Closed date
2010-12-21
Last modified date
2013-05-08
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PM26424 UK63392
Modules/Macros
DFHZTSP
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK63392
UP10/12/30 P F012
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":"3.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
08 May 2013