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

Obtain the fix for this APAR.

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'.
  .
  +BIP2628W (Msg 1/2) MBssid MBEG101 72
      EXCEPTION CONDITION DETECTED ON
      INPUT NODE
      '<name of IIB input node>'.
  +BIP2680E (Msg 2/2) MBssid MBEG101 73 FAILED TO
      SETUP A MQ CONTROL CALL  BACK FOR
      COMPONENT
      '<name of IIB input node>'
      TO QUEUE    '<MQ queue name>'
      ON QUEUE MANAGER 'SSID': MQCC=2; MQRC=2494.
  .
  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 0 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 is sysrouted FROM one or more of the following:

  PI79674

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

  UI47505 PH03168

Modules/Macros

• CSQMGETM
  

Fix information

• Fixed component name

  MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R000 PSY UI47505

     UP17/08/10 P F708

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.