IBM Support

PK70552: DFHTM1797 SYSTEM TERMINATION PROGRAM HAS ABENDED. DFHKE1800 ABNORMAL TERMINATION OF CICS IS COMPLETE.

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • DFHTM1797 after a transaction that has a DB2 thread issues a
'CEMT SHUTDOWN IMMEDIATE'.DFHSTP ABENDS WHEN IT FORCE-PURGES A
USER TASK THAT HAS A DB2 THREAD.

Local fix

  • HAVE THE TASK THAT HOLDS THE DB2 THREAD START A NEW TASK AND
HAVE THE NEW TASK LINK TO DFHSTP. THE DB2 THREAD TASK WILL HANG
AFTER IT LINKS TO DFHSTP.

Problem summary

  • ****************************************************************
* USERS AFFECTED: All.                                         *
****************************************************************
* PROBLEM DESCRIPTION: CICS shutdown abnormally terminates     *
*                      with DFHTM1797.                         *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
A task owned a DB2 thread and requested a SHUTDOWN IMMEDIATE via
the DFHEMTA interface. This caused the shutdown assist
transaction CESD to get driven as a new task. Due to timing
issues, it was possible for CESD to FORCE PURGE the transaction
that requested the shutdown. As a consequence, it is abnormally
terminated with MSGDFHTM1797.

Keywords: TM1797 1797

Problem conclusion

  • DFHD2TM and DFHSTP have been modified. Should a SHUTDOWN task
own a DB2 thread and a SHUTDOWN IMMEDIATE is requested, DFHD2TM
will no longer force purge it as part of shutting down the CICS
DB2 attachment.

The following documentation change will be made to the CICS
Transaction Server for z/OS Version 3 Release 2 Data Areas
manual GC34-6863-00.  The field TCAGFLG1 in dsect DFHTCAPS
will now read as follows:
                                                               .
Offset Hex  Type      Len  Name (dim) Description
  6         Unsigned   1   TCAGFLG1   TCA general flag1
            1... ....      TCAACPAC   DFHACP active for WEB
            .1.. ....      TCASDTSK   Shutdown task
            ..11 1111      *          Reserved

Temporary fix

  • FIX AVAILABLE BY PTF ONLY

Comments

  • 



APAR Information




    

  • APAR number
    PK70552
    • 

  • Reported component name
    CICSTS V3 Z/OS
    • 

  • Reported component ID
    5655M1500
    • 

  • Reported release
    500
    • 

  • Status
    CLOSED  PER
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    NoSpecatt
    • 

  • Submitted date
    2008-08-14
    • 

  • Closed date
    2008-10-15
    • 

  • Last modified date
    2008-11-03
    • 





    

  • APAR is sysrouted FROM one or more of the following:
    

    • 

  • APAR is sysrouted TO one or more of the following:
    

    
UK40725
    

    • 



Modules/Macros


    

  •    DESD2TM  DFHD2TM  DFHSTP   DFHTCA   DFHTCAPS

    




Publications Referenced


GC34686300    





Fix information


    

  • Fixed component name
    CICSTS V3 Z/OS
    • 

  • Fixed component ID
    5655M1500
    • 



Applicable component levels


    

  • R500  PSY  UK40725
       UP08/10/17  P  F810
    • 



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 November 2008
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback