IT01374: WMQ V7 JAVA: A MESSAGE MAY NOT BE CONVERTED TO UNICODE WHEN SHARECNV=0 IS SET ON A CLIENT CHANNEL.

Fix Pack 8.0.0.1 for WebSphere MQ V8.0
Fix Pack 7.1.0.6 for WebSphere MQ V7.1
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.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

• If a WebSphere MQ classes for Java application issues a
  MQQueue.get() call with the following properties set
   * characterSet=1208
   * MQGMO_CONVERT
  and if the size of message is greater than 4KB, then the message
  may not be converted.
  
  A WebSphere MQ server trace shows the MQGET call ends with
  MQRC=2190 (MQRC_CONVERTED_STRING_TOO_BIG).
  
  This behaviour occurs only when the SHARECNV channel property is
  set to 0.
  

Local fix

• Add following option when starting a WebSphere MQ Java client
  application:
  
    -Dcom.ibm.mq.jmqi.defaultMaxMsgSize=[x]
  
  where [x] is larger than the size of the largest expected
  message represented in the desired codepage, in order to set
  the initial buffer size to a value large enough to hold the
  converted message
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This APAR affects all users of the version 7 and 8 WebSphere MQ
  classes for Java programming interface who attempt to get a
  message using the MQGMO_CONVERT option across a client channel
  where v6 migration mode is in use.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  If a WebSphere MQ classes for Java client application uses the
  MQGMO_CONVERT option and the
  size of message returned from the queue manager is greater than
  4KB, then the message may not be converted when calling
  MQQueue.get().
  
  The MQQueue.get() call ends with MQRC=2190
  (MQRC_CONVERTED_STRING_TOO_BIG) warning, which is not returned
  to the calling application.
  
  The WebSphere MQ classes for Java converts the message and then
  returns this to the calling application. However the Coded
  Character Set Identifier (CCSID) field in the MQMD structure was
  not updated to reflect the CCSID of the converted message.
  
  This behaviour occurs only when v6 migration mode is in use -
  either when the client is connected to a version 6 queue
  manager, or the SVRCONN channel used to connect to a version 7
  or higher queue manager has the SHARECNV property set to "0".
  

Problem conclusion

• The WebSphere MQ classes for Java have been modified to use a
  larger buffer when handling messages that need to be converted
  and return the CCSID of the converted message.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.0       7.0.1.13
  v7.1       7.1.0.7
  v7.5       7.5.0.5
  v8.0       8.0.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 WINDOWS V7

• Fixed component ID

  5724H7220

Applicable component levels

• R701 PSY

     UP