IV47335: NUMBERFORMATEXCEPTION THROWN WHEN CONSUMING A JMS MESSAGE WITH ANON-INTEGER VALUE IN THE SEQ FIELD OF THE RFH2 JMS FOLDER

WebSphere MQ V7.5 Fix Pack 7.5.0.3
WebSphere MQ V7.0 Fix Pack 7.0.1.12
Fix Pack 7.1.0.5 for WebSphere MQ V7.1
8.5.5.5: WebSphere Application Server V8.5.5 Fix Pack 5
8.5.5.6: WebSphere Application Server V8.5.5 Fix Pack 6
8.5.5.7: WebSphere Application Server V8.5.5 Fix Pack 7
8.5.5.8: WebSphere Application Server V8.5.5 Fix Pack 8
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16
8.5.5.21: WebSphere Application Server V8.5.5.21

APAR status

• Closed as program error.

Error description

• A WebSphere MQ V7 JMS application that consumes a JMS Message
  which contains a non-integer value in the Seq JMS header field
  may encounter the following exception:
  
  for input string: "" [java.lang.NumberFormatException] at:
  java.lang.NumberFormatException.forInputString
  (NumberFormatException.java:48)
  java.lang.Integer.parseInt(Integer.java:468)
  java.lang.Integer.valueOf(Integer.java:555)
  com.ibm.msg.client.wmq.common.internal.messages.WMQMessageUtils.
  deformatTypedElement
  (WMQMessageUtils.java:297)
  com.ibm.msg.client.wmq.common.internal.messages.WMQMessageBase._
  parseJmsFolder(WMQMessageBase.java:1428)
  com.ibm.msg.client.wmq.common.internal.messages.WMQReceiveMarsha
  l.constructProviderMessageFromRFH2(WMQReceiveMarshal.java:398)
  com.ibm.msg.client.wmq.common.internal.messages.WMQReceiveMarsha
  l.constructProviderMessageFromProperties
  (WMQReceiveMarshal.java:186)
  com.ibm.msg.client.wmq.common.internal.messages.WMQReceiveMarsha
  l.createProviderMessage
  (WMQReceiveMarshal.java:479)
  com.ibm.msg.client.wmq.common.internal.messages.WMQReceiveMarsha
  l.exportProviderMessage
  (WMQReceiveMarshal.java:635)
  

Local fix

• Populate the empty string fields with integers when creating the
  messages.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of the WebSphere MQ classes for JMS,
  who are using a JMS Application to consume JMS messages whose
  RFH2 folder have been constructed by a third party application
  to contain a non-integer value for the Seq property
  
  This includes users of:
  
  - The WebSphere MQ V7.0.1, V7.1, V7.5 classes for JMS.
  - The WebSphere MQ V7.0.1, V7.1, V7.5 Resource Adapter.
  - The WebSphere Application Server V7 and V8 WebSphere MQ
  messaging provider.
  
  Platforms affected:
  All Distributed (iSeries, all Unix and Windows) +Java +Java zOS
  ****************************************************************
  PROBLEM SUMMARY:
  A JMS Message being transported by WebSphere MQ can contain
  an MQRFH2 header which carries JMS-specific data
  associated with the message.
  
  One of the folders present in an MQRFH2 header is the jms
  folder, which contains JMS header fields, and JMSX properties
  that either:
  
  i) Cannot be expressed in the MQMD header of the WebSphere
  MQ Message, or
  ii) Are duplicated from a corresponding MQMD header field
  
  When attempting to consume a message, a NumberFormatException
  was thrown if the jms folder of the MQRFH2 header associated
  with the message contained a non-integer value for the Seq
  property. This exception is thrown to the consuming application.
  

Problem conclusion

• The WebSphere MQ classes for JMS have been updated to prevent a
  NumberFormatException being returned to an application
  attempting to consume a message when the Seq property of the jms
  folder, in the MQRFH2 header of the message, contains a
  non-integer value. In this scenario, the following error is now
  returned:
  
  "JMSCMQ1050: The MQRFH2 header has an incorrect format"
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.0       7.0.1.12
  v7.1       7.1.0.5
  v7.5       7.5.0.3
  
  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 HP V7

• Fixed component ID

  5724H7222

Applicable component levels

• R701 PSY

     UP