PI67206: DFHXM0002 A SEVERE ERROR (CODE X'1007') HAS OCCURRED IN MODULE DFHXMIQ.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Soon after startup of your CICS 5.3 region you receive the
  following errors, which repeat until the region is shutdown:
  .
  DFHXM0002 APPLID A severe error (code X'1007') has occurred in
            module DFHXMIQ.
  EYUXL0900I   Starting Environment Recovery
  EYUXL0905E APPLID AEXZ IN NLHS,OFFSET ????????
  EYUXL0905E INTC=0000 ILC=0 TXCP=00000000 SCODE=S???? TRAN=COIE
  EYUXL0905E Methods=NLHS,NLHD,XLOP
  EYUXL0910I  EYU9XLRV
  Dump,APPLID,APPLID,DV21,LMAS,COIE,0000094,AEXZ
  EYUXL0999I XLRV Exiting Successfully
  
  Looking at the CICS Internal Trace we see the COIE
  task doing the following:
  
  1001 XMIQ  ENTRY - FUNCTION(GET_NEXT_TRANSACTION)
                     BROWSE_TOKEN(36C05C00)
  
  0010 DSBR  ENTRY - FUNCTION(INQUIRE_TASK)
                     INPUT_TASK_TOKEN(0082000F)
                                      ********
  0011 DSBR  EXIT - FUNCTION(INQUIRE_TASK) RESPONSE(EXCEPTION)
                    REASON(INVALID_TASK_TOKEN) STATE()
                    PRIORITY(0) RESOURCE_NAME()
                    RESOURCE_TYPE() RESOURCE_TIME(0)
  .
  However, prior to this GET_NEXT_TRANSACTION by COIE, A user task
  number 00420 owned this Task_TOKEN (TS_TOKEN.), as seen in the
  XM domain:
  
  AABB 00420 36C07D00 C    No   ACT      0082000F
                                         ********
  This TASK had abended AKEC prior to this.
  .
  0C02 SJTH  EXIT    FUNCTION(RUN_SERVICE) RESPONSE(EXCEPTION)
                     REASON(TRANSACTION_ABENDED)
                     ABEND_CODE(AKEC)
  .
  Task 00420 is no longer in the KE Domain, however it does
  still show up in the PG Domain.
  .
  ==PG: PTA SUMMARY FOR TRAN NUM : 00420,  PTA ADDRESS : 3893
  LOG-LVL : 1         SYS-LVL : 0
  PROG DFHSJTHP LVL   1 LD 00000000 ENT 0000000  LEN 000000
  Program DFHSJTHP is not found in CPE search.
  .
  .
  The problem seen in the dump is that a runaway abend happens
  for a CICS task that gets created to process Liberty
  Unclassified Work.  The way that CICS Liberty transactions work
  in 5.3 is that the T8 TCBs always have DS tasks associated with
  them and they get XM tasks associated when user work is run on
  that thread.  On completion of the user work the XM task is
  terminated and the T8 TCB is returned to the pool.  That XM
  task termination only gets driven from Java running in Liberty.
  After the runaway happens control never returns to the Java
  thread in Liberty and therefore the XM task termination does not
  happen.
  .
  When the JVM gets recycled as a result of the runaway the T8
  gets deleted.  This causes the DS task to get removed but does
  not drive any XM task termination code.  Consequently the XM
  task still exists even though the task has really completed and
  left the system.
  
  Additional Symptom(s) Search Keyword(s): KIXREVSCB
  DFHXM0002 severe error (code X'0604') in module DFHKEDD
  occurs after attempting to forcepurge a task.
  task_reply_gate  dfhdsat_gate
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHXM0002 A severe error code x'1007'   *
  *                      in DFHXMIQ.                             *
  ****************************************************************
  When using a Liberty JVM server and a task is timed out the
  CICS task enters recovery. The JVM server is recycled which
  starts disabling, this causes all the T8 TCBs to be deleted.
  However, in this situation DFHXMAT TERMINATE_TRANSACTION is
  not called to clean up the task correctly.
  
  A subsequent INQUIRE on this task causes message DFHXM0002
  to be issued and accompanied by a system dump.
  

Problem conclusion

• DFHSJTH has been changed to issue a DFHXMAT
  TERMINATE_TRANSACTION call.
  

Temporary fix

Comments

APAR Information

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

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

  UI45636

Modules/Macros

• DFHSJTH
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI45636

     UP17/03/23 P F703

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.