IT42882: MQ INPUT NODE DOES NOT CORRECTLY HANDLE MQRC_RECONNECT_FAILED REASON CODE

APAR status

• Closed as program error.

Error description

• An MQ input node is consuming messages from a remote queue
  manager using MQEndpoint policy configured on the node. The
  MQEndpoint policy is configured to allow reconnect.
  
  When 'Allow Reconnect' is enabled a new return code is possible
  MQRC_RECONNECT_FAILED, but this return code is not listed in the
  set of return codes which require the connection to be re-made
  so ACE does not disconnect and re-connect so no more messages
  are delivered to the input node.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  <span style="background-color:rgb(255, 255, 255)">All users of
  the IBM App Connect Enterprise v11 and V12 using MQInput
  Node</span>
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  MQ input node can be configured to consume messages from a
  remote queue manager using MQEndpoint policy configured on the
  node.
  
  When 'Allow Reconnect' option is enabled in  MQEndpoint  policy,
  a new return code MQRC_RECONNECT_FAILED is possible, however,
  this return code is not listed in the set of return codes which
  require the connection to be re-established. So when the
  connection errors out with MQRC_RECONNECT_FAILED,  the message
  flow does not attempt re-connection to the remote queue manager,
  and therefore no further messages are delivered to the input
  node.   Following error is typically observed in the logs:
  
  BIP2628W: Exception condition detected on input node
  'xxxxxxxxx'.
  BIP2680E: Failed to setup a MQ control callback for component
  'yyyyyyyyy' to queue 'AAAAAA' on queue manager 'ZZZZ': MQCC=2;
  MQRC=2548.
  

Problem conclusion

• Product now handles MQRC_RECONNECT_FAILED return code and allows
  connection to be re-established with the queue manager.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v11.0      11.0.0.21
  v12.0      12.0.8.0
  
  The latest available maintenance can be obtained from:
  http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041
  
  If the maintenance level is not yet available,information on
  its planned availability can be found on:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
  ---------------------------------------------------------------
  

Temporary fix

Comments

APAR Information

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

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

Fix information

• Fixed component name

  APP CONNECT ENT

• Fixed component ID

  5724J0560

Applicable component levels