IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IT01374

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-04-29

  • Closed date

    2014-08-20

  • Last modified date

    2014-08-29

  • 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

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1"}]

Document Information

Modified date:
25 September 2021