IBM Support

PH03168: IBM INTEGRATION BUS ( IIB ) RECEIVES MQCC=2 MQRC=2494 WHEN QUEUE IS CHANGED TO GET(ENABLED)

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • IBM Integration Bus ( IIB ), when queue is
    changed to GET(ENABLED), BIP2680E is displayed
    with the message text of MQRC=2494, and also
    BIP2628W with message text of 'EXCEPTION
    condition'.
    .
    It was determined that when using an async
    consumer with MQ on z/OS,
    if the queue is get disabled and then reenabled
    again, the callback function is invoked for
    an event call.
    In the event call, the CompCode is 2
    (MQCC_FAILED) and the Reason is 2494
    (MQRC_GET_ENABLED).
    .
    When running the same test with a distributed
    qmgr, the CompCode is 1 (MQCC_WARNING), which
    matches what is described in the documentation.
    
    
    
    
    Additional Symptom(s) Search Keyword(s):
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 1 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: An application using Asynchronous       *
    *                      consumption, may receive an incorrect   *
    *                      MQCC (MQCC=2) with a MQRC=2494          *
    *                      (MQRC_GET_ENABLED) return code.         *
    *                                                              *
    *                      This may also result in IBM Integration *
    *                      Bus producing message BIP2628W with     *
    *                      text of 'EXCEPTION CONDITION', when a   *
    *                      node uses async consume.                *
    ****************************************************************
    While an application is using async consume to process messages,
    if the queue definition of the queue being used is changed to
    GET(ENABLED), an event is sent to the consuming application with
    MQRC_GET_ENABLED. However in this case, it incorrectly has
    MQCC_ERROR, rather than the expected MQCC_WARNING value.
    
    As this is unexpected, this can result in IBM Integration Bus
    displaying messages BIP2680E and BIP2628W unexpectedly in the
    MQRC_GET_ENABLED event case.
    

Problem conclusion

  • Asynchronous consumer processing has been corrected to return
    MQCC_WARNING (MQCC=1) when MQRC_GET_ENABLED (MQRC=2494) is
    produced in this scenario.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH03168

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-09-24

  • Closed date

    2019-01-30

  • Last modified date

    2019-03-01

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

    PI81607

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

    UI61008

Modules/Macros

  • CSQMGETM
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R100 PSY UI61008

       UP19/02/28 P F902

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.



Document information

More support for: IBM MQ

Software version: 100

Reference #: PH03168

Modified date: 01 March 2019