IT24438: MQGET NODE FAILS WITH MQRC 2046 (MQRC_OPTIONS_ERROR)

APAR status

• Closed as program error.

Error description

• An MQGet node in a message flow may fail if the user has used
  the LocalEnvironment to override some of the MQGET message
  options but not the 'Options' specific field. For example, if
  the user has just overridden the WaitInterval in a compute node
  preceding the MQGET node with:
  
  SET OutputLocalEnvironment.MQ.GET.MQGMO.WaitInterval = 0;
  
  The MQGet node fails with the following errors:
  
  BIP4633E: An error occurred whilst performing an MQGet node
  operation.
  BIP4630E: An MQGET operation was unsuccessful. Completion Code
  2; Reason Code 2046.
  

Local fix

• Explictly set the 'Options' field in the LocalEnvironment to
  the desired value, or the default value of MQGMO_NO_WAIT:
  
  
  
  SET OutputLocalEnvironment.MQ.GET.MQGMO.Options =
  MQGMO_NO_WAIT; -- default 0
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM Integration Bus V10.0 and IBM App Connect
  Enterprise V11.0 using the MQGet node.
  
  
  Platforms affected:
  z/OS, MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  An MQGet node in a message flow may fail if the user has used
  the LocalEnvironment to override the MQGET WaitInterval message
  option but not the 'Options' specific field. For example, if the
  user has just overridden the WaitInterval in a compute node
  preceding the MQGET node with:
  
  SET OutputLocalEnvironment.MQ.GET.MQGMO.WaitInterval = 0;
  
  The MQGet node fails with the following errors:
  
  BIP4633E: An error occurred whilst performing an MQGet node
  operation.
  BIP4630E: An MQGET operation was unsuccessful. Completion Code
  2; Reason Code 2046.
  

Problem conclusion

• The product now correctly sets the MQGET message options when
  LocalEnvironment overrides are used.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v10.0      10.0.0.13
  v11.0      11.0.0.1
  
  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

  INTEGRATION BUS

• Fixed component ID

  5724J0540

Applicable component levels