A fix is available
APAR status
Closed as program error.
Error description
You have recently migrated to CICS/TS 3.2. Your CICS region uses SSL connections. Your CICS region has been running fine for several days. Then all of a sudden you see frequent messages and dumps for the following message: DFHDS0002 "A severe error (code X'0137') has occurred in module DFHDSIT " Verfication steps: 1- Do verbx dfhpd650 'trs=<exception,full>' 2- Find the 'DS 0137 DSIT' trace entry and verify that the IDENTITY is (S8 -OPEN) 3- If so do Summ Format 4- Find the PRB for DFHKEATT. Then scroll back to the beginning of the TCB to get the TCB address xxxxxx. 5- Do verbx ceeerrip 'tcb(xxxxxx) all' 6- Find on 'CTHD: ' to get to the CTHD:. 7- In that control block see if the CERRNO: is 00000070 and the ERRNO_JR: is 0B51025D. If it is then this APAR addresses the problem . The problem is caused by reaching the omvs MAXTHREADS limit. MAXTHREADS limits the number of threads a process can create. You can check out how close you are to the limit by doing some omvs displays. 1) Do d omvs,a=all This will display all the processes of all the jobs. 2) Find on the CICS jobname to get the 1st process for that CICS job. Then in all the processes for that CICS job, find the one that specifies CMD=DFHKEATT . For that process, note the PID number, xxx. 3) Do d omvs,l,pid=xxx to display the limits for that process. 4) On the MAXTHREADS line, note Current Usage and Process Limit. 5) Logon to the CICS region and do CEMT INQ DISPATCHER and note the value for Actssltcbs. If you are not having a problem, the Actssltcbs number will match the Current Usage MAXTHREADS number. If you are having the problem, the Current Usage MAXTHREADS number will be larger. When the Current Usage number reaches the MAXTHREADS limit, the DFHDS0002 problem will begin.
Local fix
Increase the MAXTHREADS limit value as follows: SETOMVS MAXTHREADS=nnnn
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: "MSGDFHDS0002 A severe error (code * * X'0137') has occurred in module * * DFHDSIT" when CICS tries to attach an * * S8 TCB. * **************************************************************** * RECOMMENDATION: * **************************************************************** A pthread_create fails when CICS is attempting to add a new S8 TCB in a CICS-SSL region. The USS MAXTHREADS limit has been hit even though the number of S8 TCBs in CICS is well below this limit. Over a period of time S8 TCBs have been added and deleted by CICS. Each time an S8 TCB terminates, the number of TCBs in the pool which is governed by SIT parameter MAXSSLTCBS gets reduced. However, CICS never detaches the pthread associated with the S8 TCB. This leads to a gradual creep of pthreads as S8 TCBs are deleted and added.
Problem conclusion
DFHLEPTC has been changed to alter the attribute of each pthread to have the detached state, which means the pthread is automatically detached at TCB termination.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK79354
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-01-26
Closed date
2009-02-06
Last modified date
2009-03-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK43857 UK43858
Modules/Macros
DESLEPT DFHLEPT@ DFHLEPTC
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R503 PSY UK43858
UP09/02/11 P F902
R500 PSN UP
AK79354
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:
03 March 2009