IBM Support

PK79354: DFHDS0002 CODE 0137 . PROBLEM HAPPENS AFTER CICS HAS BEEN UP FOR A WHILE.

A fix is available

Subscribe

You can track all active APARs for this component.

 

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