IC72897: ADD PROPERTIES TO ENABLE V7.0 WMQ JMS APPLICATIONS TO CONFIGURE MESSAGE DATA CONVERSION TO OCCUR IN THE QUEUE MANAGER OR CLIENT

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • The WebSphere MQ V7.0 classes for JMS (Java Message Service)
    applications request messages from the queue manager using the
    MQGET option:
    
    MQGMO_CONVERT
    
    This option requests that the queue manager performs message
    data conversion before sending the message to the JMS
    application.
    
    There is no mechanism which permits the client application to
    configure the use of this setting using the WebSphere MQ
    classes for JMS.
    
    The WebSphere MQ V6 classes for JMS do not use this option.
    This means that messages are retrieved from the queue in the
    form with which they were stored on the queue, and the
    WebSphere MQ classes for JMS are responsible for data
    conversion into a native form for use within the JVM and client
    application.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of:
    
    - the WebSphere MQ V7.0 classes for JMS.
    - the WebSphere Application Server V7 WebSphere MQ messaging
    provider.
    - the WebSphere Application Server V6 WebSphere MQ messaging
    provider who have configured the WebSphere Variable
    MQ_INSTALL_ROOT to point to a WebSphere MQ V7 installation.
    - the WebSphere MQ V7 Resource Adapter.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows) +Java
    ****************************************************************
    PROBLEM SUMMARY:
    The MQGMO_CONVERT option was added to the MQGET request
    associated with the WebSphere MQ V7.0 classes for JMS's receive
    request:
    
    MQMessageConsumer.receive()
    
    as a way to enable WebSphere MQ conversion exits to be run when
    requesting messages with a JMS client.
    
    This change was intended to be transparent to existing JMS
    applications.  However several problems have been reported for
    applications which have been migrated from the WebSphere MQ V6
    classes for JMS to V7.0.
    
    For more information, please see the following document:
    
    http://www.ibm.com/support/docview.wss?uid=swg21459994
    

Problem conclusion

  • Two new properties have been added to WebSphere MQ JMS
    Destination objects which permits configuration of both the
    MQGMO_CONVERT option when performing message receive requests,
    and the CCSID which the queue manager is requested to convert a
    message to when using message conversion.
    
    These properties are:
    
    RECEIVECONVERSION  Configures use of MQGMO_CONVERT.
    RECEIVECCSID       Requested CCSID to convert the message to
    when using MQGMO_CONVERT.
    
    Their use is described in detail in the technote:
    
    https://www.ibm.com/support/docview.wss?uid=swg21459994
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.1.5
    --------           --------------------
    Windows            U200324
    AIX                U839183
    HP-UX (PA-RISC)    U839621
    HP-UX (Itanium)    U839626
    Solaris (SPARC)    U839622
    Solaris (x86-64)   U839628
    iSeries            tbc_p700_0_1_5
    Linux (x86)        U839623
    Linux (x86-64)     U839627
    Linux (zSeries)    U839624
    Linux (Power)      U839625
    
    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

    IC72897

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-11-30

  • Closed date

    2011-01-28

  • Last modified date

    2011-01-28

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    PM42539

Fix information

  • Fixed component name

    WMQ WINDOWS V7

  • Fixed component ID

    5724H7220

Applicable component levels

  • R700 PSY

       UP



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere MQ
APAR / Maintenance

Software version:

7.0

Reference #:

IC72897

Modified date:

2011-01-28

Translate my page

Machine Translation

Content navigation