IBM Support

PI62770: DFHMQ0101 CANNOT OPEN THE QUEUE. MQCC=2 MQRC=2195 , IS ISSUED RESTARTING A MQ CONNECTION.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Reopen APAR PI36985 for R4.2
    .
    This is the sequence of events :
    --------------------------------
    1) CEMT SET MQCONN NOTCONNECTED  / stop
       and CKTI is correctly terminated
    2) CEMT S MQCONN CONNECT / start
       XL6SE1G0 Cannot open the initiation queue. MQCC=2 MQRC=2195
    .
    Problem happens only if there is long running task running in
    the system at the time of the stop of the MQ connection.
    .
    Additional Symptom(s) Search Keyword(s): KIXREVxxx
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHMQ0480 with MQCC=2 and MQRC=2195     *
    *                      received on all requests to WMQ after   *
    *                      disconnecting then reconnecting to WMQ. *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    CICS is connected to WebSphere MQ and a task that performs
    WMQ work executes to completion on an L8 TCB. This TCB is
    subsequently reused by a non-WMQ related long running task.
    
    CICS is disconnected from the WMQ queue manager, then
    reconnected. However, the disconnection process never fully
    completed as the long running task on the L8 TCB prevents
    CICS from disassociating WMQ from the L8 TCB. As a consequence
    all WMQ requests result in a DFHMQ0480 message with MQCC=2
    and MQRC=2195.
    
    In an alternative scenario where CICS and WMQ are not
    reconnected, but instead the WMQ queue manager is quiesced,
    the queue manager will not complete shutdown until the long
    running task in CICS has completed.
    
    Additional keywords: msgDFHMQ0480 MQ0480 MQRC_UNEXPECTED_ERROR
    

Problem conclusion

  • DFHMQDSC has been changed to issue an END CONTEXT for all MQ
    threads when shutting down the CICS MQ attachment.
    
    The fix from PI60847 has also been included.
    
    DFHMQTRI has been changed to include two new trace entries
    to trace when the END CONTEXT is driven.
    
    The CICS Transaction Server for z/OS V5.1 Trace Entries
    manual (SC34-2873-00) will have additional trace entries
    added to the CICS WebSphere MQ trace points section in Table 92
    following AP A029:
    
    AP A02A  DFHMQDSC  RA 2  About to issue MQ END CONTEXT
                                                  1 Subsystem name
    AP A02B  DFHMQDSC  RA 2  Return from MQ END CONTEXT
                                                  1  FRB
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI62770

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-05-19

  • Closed date

    2016-06-14

  • Last modified date

    2016-07-04

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

    PI59872

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

    UI38763

Modules/Macros

  • DFHEIQMQ DFHMQAEX DFHMQBAS DFHMQBR9 DFHMQCOD DFHMQCON DFHMQCTL
    DFHMQDIS DFHMQDSC DFHMQDSL DFHMQIG  DFHMQIN1 DFHMQMON DFHMQPOP
    DFHMQPRM DFHMQPUL DFHMQQCN DFHMQRET DFHMQRP  DFHMQRS  DFHMQSSQ
    DFHMQTM  DFHMQTRC DFHMQTRD DFHMQTRI DFHMQTRQ DFHMQTRU DFHMQTSK
    

Publications Referenced
SC34287300    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R800 PSY UI38763

       UP16/06/24 P F606

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":"5.1","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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
04 July 2016