IBM Support

IC83604: WEBSPHERE MQ CLASSES FOR JMS NULLPOINTEREXCEPTION THROWN AFTER MESSAGE PROPERTY 'JMS_IBM_CHARACTER_SET' IS SET TO NULL

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An application environment was upgraded from WebSphere MQ
    classes for JMS v6 to v7.  The WebSphere message property
    'JMS_IBM_CHARACTER_SET' is defined on a message with a 'null'
    value.  When an attempt it made to send the message to a
    Destination, a NullPointerException is thrown, with a stack
    trace of the form:
    
    java.lang.NullPointerException
    at java.util.Hashtable.get(Hashtable.java:513)
    at com.ibm.mq.jmqi.system.JmqiCodepage.getJmqiCodePageInternal(
    JmqiCodepage.java:133)
    at com.ibm.mq.jmqi.system.JmqiCodepage.getJmqiCodepage(JmqiCode
    page.java:115)
    at com.ibm.msg.client.wmq.common.internal.messages.WMQMarshalUt
    ils.calculateMessageBodyCcsid(WMQMarshalUtils.java:682)
    at com.ibm.msg.client.wmq.common.internal.messages.WMQSendMarsh
    al.constructMessageBuffers(WMQSendMarshal.java:138)
    at com.ibm.msg.client.wmq.common.internal.messages.WMQSendMarsh
    al.exportMQMDAndMessageBuffers(WMQSendMarshal.java:496)
    at com.ibm.msg.client.wmq.common.internal.messages.WMQSendMarsh
    al.exportMQMD(WMQSendMarshal.java:555)
    at com.ibm.msg.client.wmq.internal.WMQMessageProducer$ProducerS
    hadow.send(WMQMessageProducer.java:524)
    at com.ibm.msg.client.wmq.internal.WMQMessageProducer.send(WMQM
    essageProducer.java:1223)
    at com.ibm.msg.client.jms.internal.JmsMessageProducerImpl.sendM
    essage(JmsMessageProducerImpl.java:912)
    at com.ibm.msg.client.jms.internal.JmsMessageProducerImpl.send_
    (JmsMessageProducerImpl.java:767)
    at com.ibm.msg.client.jms.internal.JmsMessageProducerImpl.send(
    JmsMessageProducerImpl.java:398)
    at com.ibm.mq.jms.MQMessageProducer.send(MQMessageProducer.java
    :333)
    
    This exception was not seen with the WebSphere MQ classes for
    JMS v6, where the message was successfully sent to the
    Destination.
    

Local fix

  • Local Fix￘
    No.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of:
    
    - the WebSphere MQ V7.0 and V7.1 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 or V7.1
    installation.
    - the WebSphere MQ V7 Resource Adapter.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows) +Java +Java zOS
    ****************************************************************
    PROBLEM SUMMARY:
    The WebSphere MQ JMS message property 'JMS_IBM_CHARACTER_SET'
    is used to record the coded character set identifier (CCSID) of
    the data within the body of a message.
    
    The property is an optional field that can be set on a
    WebSphere MQ classes for JMS message object.  When using the
    WebSphere MQ v7.0 or v7.1 classes for JMS, when an attempt was
    made to send the message to a Destination, a
    NullPointerException was thrown if this property,
    'JMS_IBM_CHARACTER_SET', was defined on the message but
    contains a null value.
    
    The same scenario when using the WebSphere MQ V6.0
    classes for JMS client results in the Destination's CCSID being
    used, which is also the case in both v6 and v7 where the
    'JMS_IBM_CHARACTER_SET' property has not been defined on the
    message object.
    

Problem conclusion

  • The WebSphere MQ V7.0 and V7.1 classes for JMS has been modified
    such that where the 'JMS_IBM_CHARACTER_SET' property is defined
    on the message with a null value, the Destination's CCSID value
    is used to configure the encoding of the message data, which
    matches the behaviour of the WebSphere MQ V6 classes for JMS.
    
    ---------------------------------------------------------------
    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.2
    --------           --------------------
    Windows            U200351
    AIX                U853019
    HP-UX (Itanium)    U853052
    Solaris (SPARC)    U853048
    Solaris (x86-64)   U853054
    iSeries            7.1.0.2
    Linux (x86)        U853049
    Linux (x86-64)     U853053
    Linux (zSeries)    U853050
    Linux (Power)      U853051
    zOS                7.1.0.2
    
    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 number

    IC83604

  • 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

    2012-05-20

  • Closed date

    2012-05-29

  • Last modified date

    2013-03-25

  • 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:
19 September 2021