A fix is available
APAR status
Closed as program error.
Error description
User tasks are failing with AETK abends. CICS issues message: . DFHAP0002 A severe error (code X'2526') has occurred in DFHERM. . CICS trace shows: . AP 2526 ERM *EXC* - RMLN_SET_LINK_FAILED FUNCTION(SET_LINK) RESPONSE(EXCEPTION) REASON(LINK_UNKNOWN) . The LINK token being passed on the SET_LINK request (field TIELTOK ) is zeroes. The problem occurs because the number of token slots for RMLK 's has hit it's maximum. The Link Summary in the RM domain is filled with RMLK 's with Link ID SOCKLINK and almost all of them are associated with the same UOW associated with a long-running task. This task does iterations of WEB OPEN and WEB CLOSE, followed by a SYNCPOINT, however the RMLK 's are not being deleted until task termination. . Additional Symptom(s) Search Keyword(s): KIXREVRJL DFHSOCK abendAETK abendUAETK
Local fix
The application can periodically restart itself and then go through task termination which will free off these links.
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: MSGDFHAP0002 a severe error (CODE * * X'2526') has occurred in module DFHERM * * following an earlier DFHRMLN ADD_LINK * * failure. * **************************************************************** * RECOMMENDATION: * **************************************************************** Message DFHAP0002 A severe error (code X'2526') has occurred in DFHERM together with user tasks abending AETK. This situation occurs because the allocation limit of RM LINK tokens ( 65535 ) has been breached. Nearly all the allocated RM LINKs are owned by a single task. This task repeats iterations of EXEC CICS WEB OPEN followed later by EXEC CICS WEB CLOSE and EXEC CICS SYNCPOINT. Each EXEC CICS WEB OPEN allocates a new RM LINK to the task. However, these LINKs are not deleted by EXEC CICS WEB CLOSE and are retained until task termination. ADDITIONAL KEYWORDS :- AP0002 ABENDAETK
Problem conclusion
DFHWBCL CLOSE_SESSION processing has been changed to call sockets domain to relinquish the current task's interest in the socket before it is closed. This ensures that the previously allocated RM LINK token is deleted.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK99723
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2009-10-27
Closed date
2010-01-11
Last modified date
2010-04-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
DESWBCL DFHWBCL
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK53496
UP10/01/19 P F001
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:
07 April 2010