IBM Support

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

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PK82414

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-03-12

  • Closed date

    2009-07-16

  • Last modified date

    2010-03-24

  • 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
    

Publications Referenced
GC34556108SX33610806   

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.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
24 March 2010