PK82414: DFHXM0002 SEVERE ERROR CODE 100A OCCURRED IN MODULE DFHXMIQ. INQUIRE_TERMINAL_FACILITY WITH TFIQ_TERMINAL_TOKEN = ZEROS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS Transaction server for VSE/ESA R1.1.1 and
  receive the following error message:
  DFHXM0002 A severe error (code X'100A') has occurred in module
            DFHXMIQ.
  Here is the exception trace from the dump:
  XM 100A XMIQ  *EXC*
         Unexpected_return_code_from_TFIQ_INQUIRE_TERMINAL_request
         INQUIRE_TRANSACTION
  Transaction CSNC was running at the time, and is processing
  an AZI2 abend due to a prior error trying to switch to a
  system connected via MRO. Transaction dump module DFHSAXDF
  issues an Inquire_transaction, which causes DFHXMIQ to issue
  Inquire_terminal_facility.
  It is passing 00000000 for the TFIQ_TERMINAL_TOKEN, which
  it retrieves from the XM_TXN+x'18', which is causing the
  severe error 100A.
  Additional symptom(s):MSDFHXM0002 MSGDFHXM0002 AZI2
  KIXREVxxx
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHXM0002 A severe error (code          *
  *                      X'100A') has occurred in module         *
  *                      DFHXMIQ.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When an IRC connection needs to be connected (CEMT SET
  CONN(cccc) INS), the CSNC task is woken up and issues an IRP
  CONNECT request for each MRO session TCTTE associated with
  that connection.
  
  DFHCRNP sets the TXN control block facility type to TERMINAL
  and calls DFHCRR.
  
  DFHCRR issues a DFHTC WRITE LAST call, which passes control to
  DFHZARQ and DFHZIS2 to perform a DFHIRP SWITCH. This fails and
  sets a 208 (X'D0' IRERRGM8) return code. This can be seen in
  a trace entry:
  
  AP DD21 ZIS2  EVENT IRC  SWITCH SUBSEQUENT TO SYSTEM
  (xxxxxxxxxx) RETURN CODE WAS 208
  
  DFHZARQ issues an ABEND with an abend code of AZI2.
  
  During abend processing DFHSAXDF issues a request to DFHXMIQ
  to obtain information about the failing transaction. During
  the processing of this request, DFHXMIQ notices that the TXN
  control block facility type is set to TERMINAL and then calls
  DFHTFIQ to obtain the facility name using the TXN principal
  facility TCTTE address. This was not set by DFHCRNP, and a
  value of zeros is passed resulting in a bad response code.
  
  The bad response code causes DFHXMIQ to create the XM0002
  abend.
  
  Additional keywords: ABENDAZI2 ABENDXM0002 LOOP
  

Problem conclusion

• DFHCRR has been changed to issue a conditional IRC request. The
  AZI2 is intercepted and does not produce a dump. DFHCRR writes
  an AP DD3C exception trace entry, issues message DFHIR3784 that
  produces a system dump without terminating CICS, and places the
  failing connection into an out-of-service status. As no dump
  is produced for this case of the AZI2, the XM0002 abend will
  no longer occur.
  
  The CICS Transaction Server for VSE/ESA V1.1 Messages and
  Codes GC34-5561-08 will be updated to include the new message
  DFHIR3784 inserted at page 206 after message DFHIR3783
  as follows:
  
  DFHIR3784 applid A severe error (code X'code') has
            occurred in module DFHCRR.
            Connection conname (if non-blank) has
            been set out of service.
  
  Explanation:
  An error has been detected in module DFHCRR. The
  code X'code' is the exception trace point id which
  uniquely identifies what the error is and where the error
  was detected.
  
  This problem may occur as a result of the VSE System Getvis Area
  being full, in which case a return code 208 (IRERRGM8) will be
  seen in a formatted trace entry such as AP DD21 ZIS2 EVENT IRC.
  
  System action:
  An exception entry is made in the trace table (X'code' in
  the message). A system dump is taken, unless you
  have specifically suppressed dumps in the dump table.
  
  The connection conname (if any) being processed at
  the time of error is set out of service, to prevent the
  error from recurring repeatedly.
  
  CICS will continue unless you have specified in the dump table
  that CICS should terminate.
  
  User response:
  Find and fix the source of the error before setting the
  connection back in service.
  
  Review the formatted trace and look for a trace entry such as
  the one described above.
  
  This failure indicates a serious error in CICS.
  If you have not requested termination in the dump table,
  you may want to terminate CICS.
  
  Destination: Console
  
  Module:
  DFHCRR
  
  XMEOUT Parameters: applid, X'code', conname
  
  The CICS Transaction Server for VSE/ESA Trace Entries Version 1
  Release 1 SX33-6108-06 manual has been changed to add a new
  entry after 'AP DD31' as follows:-
  
  Point ID Module  Lvl Type                      Data
  
  AP DD3C  DFHCRR  Exc DFHTC WRITE LAST failure  1 Address of
                                                  session TCTTE
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK48482

Modules/Macros

•    DFHAPTPA DFHAPTRA DFHCRR   DFHMEIRC DFHMEIRE
  DFHMEIRG DFHMEIRK MFHMEIRE
  

Fix information

• Fixed component name

  CICSTS FOR VSE

• Fixed component ID

  564805400

Applicable component levels

• RB0P PSY UK48482

     UP09/07/21 P E422

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.