IBM Support

PI21447: rc61444 and Gateway object closed after Java client application sends XA_ROLLBACK.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A client application flowed an XA_ROLLBACK to terminate an
    in-flight request. The transaction was terminated with the
    expected abendAITJ and the following message was written by
    CICS:
    DFHIS0998  A transaction processing a request using IP
    Interconnectivity has abended with code AITJ.
    The above was expected, but the Java client application received
    return code 61444 and the Gateway object in the J2E server was
    closed.
    A subsequent transaction might also receive an unexpected
    ECI_ERR_SYSTEM_ERROR return code.
    
    Additional search words: msgDFHIS0998 abendAITJ 61444
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of CICS TG with IPIC connected     *
    *                 CICS servers.                                *
    ****************************************************************
    * PROBLEM DESCRIPTION: rc61444 returned to the client          *
    *                      application and the Gateway object      *
    *                      closed.                                 *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When the Gateway daemon received an XA_ROLLBACK request for an
    in-flight transaction, it sent an XA_ROLLBACK to the CICS
    server. At this point CICS TG was in receive state and the
    CICS server was in send state, so the CICS server was not
    expecting to receive the XA_ROLLBACK. The transaction was
    correctly abended in the CICS server, but CICS TG incorrectly
    sent an rc61444 to the client application causing the Gateway
    object to be closed. CICS TG should have sent a PURGE instead
    of the XA_ROLLBACK.
    After cleaning-up from this error, a worker thread is left
    waiting for a response to the XA_ROLLBACK. It might incorrectly
    interpret a response for another request as the XA_ROLLBACK
    response and return ECI_ERR_SYSTEM_ERROR to the client
    application.
    

Problem conclusion

  • CICS TG has been changed so that a PURGE rather than an
    XA_ROLLBACK will be sent to CICS over an IPIC connection
    when CICS TG is in receive state.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI21447

  • Reported component name

    CTG V9 FOR Z/OS

  • Reported component ID

    5655Y2000

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2014-07-07

  • Closed date

    2014-07-11

  • Last modified date

    2014-08-04

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

    PI18420

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

    UI19557

Modules/Macros

  • CTG00201 CTG00204
    

Fix information

  • Fixed component name

    CTG V9 FOR Z/OS

  • Fixed component ID

    5655Y2000

Applicable component levels

  • R900 PSY UI19557

       UP14/07/22 P F407

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMJ2","label":"CICS Transaction Gateway"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
15 August 2024