IV30610: WMQ 7.0 CLASSES FOR JMS DO NOT HONOUR THE WESPHERE APPLICATION SERVER LISTENER PORT PROPERTY "MAXIMUM MESSAGES"

WebSphere MQ V7.5 Fix Pack 7.5.0.1
WebSphere MQ V7.0 Fix Pack 7.0.1.10
Fix Pack 7.1.0.3 for WebSphere MQ V7.1

APAR status

• Closed as program error.

Error description

• The WebSphere Application Server Listener Port property
  "maxMessages" allows multiple messages to be processed by the
  Listener Port in a single transaction. WebSphere MQ V7 classes
  for JMS do not honour that property in an XA environment so each
  message is processed in its own transaction and a commit occurs
  for every message.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of the WebSphere MQ classes for Java,
  which are making use of XA Transactions with Listener Ports in
  WebSphere Application Server who are attempting to process
  multiple messages in a single transaction.
  
  Platforms affected:
  All Distributed (iSeries, all Unix and Windows) +Java +Java zOS
  ****************************************************************
  PROBLEM SUMMARY:
  The WebSphere Application Server Listener Port property
  "maxMessages" is not being honored by the WebSphere MQ V7
  classes for JMS in an XA environment. This results in each
  message being processed in its own transaction despite the user
  specifying that multiple message should be processed in one
  transaction.
  

Problem conclusion

• In order to have the Listener Port property "maxMessages"
  honored by the WebSphere MQ V7 classes for JMS a new Generic JVM
  Argument has been created:
  
  com.ibm.mq.jms.tuning.enableMaxMessagesForXAListenerPorts
  
  This argument takes as an argument a boolean value which
  represents whether the MaxMessages property is enabled. For
  example to enable this property:
  
  
  -Dcom.ibm.mq.jms.tuning.enableMaxMessagesForXAListenerPorts=true
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
                     v7.0
  Platform           Fix Pack 7.0.1.10
  --------           --------------------
  Windows            U200352
  AIX                U853055
  HP-UX (PA-RISC)    U853082
  HP-UX (Itanium)    U853087
  Solaris (SPARC)    U853083
  Solaris (x86-64)   U853089
  iSeries            7.0.1.10
  Linux (x86)        U853084
  Linux (x86-64)     U853088
  Linux (zSeries)    U853085
  Linux (Power)      U853086
  zOS                7.0.1.10
  
                     v7.1
  Platform           Fix Pack 7.1.0.3
  --------           --------------------
  Windows            7.1.0.3
  AIX                7.1.0.3
  HP-UX (Itanium)    7.1.0.3
  Solaris (SPARC)    7.1.0.3
  Solaris (x86-64)   7.1.0.3
  iSeries            7.1.0.3
  Linux (x86)        7.1.0.3
  Linux (x86-64)     7.1.0.3
  Linux (zSeries)    7.1.0.3
  Linux (Power)      7.1.0.3
  zOS                7.1.0.3
  
  Platform           v7.5
  --------           --------------------
  Multiplatforms     7.5.0.1
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

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

  WMQ LIN X86 V7

• Fixed component ID

  5724H7224

Applicable component levels