Resolution:
Description:
============

JMS Queue Receiver throwsa  Null Pointer Exception while receiving a message containing a String application property whose value is NULL.

Environment:
===========

 TIBCO BusinessWorks 5.10 Hotfix-03 (and above)

Symptoms:
========

The following error/stack trace is seen in the TIBCO BusinessWorks log:

<?xml version = "1.0" encoding = "UTF-8"?>
<ns0:ErrorReport xmlns:ns0 = "http://www.tibco.com/pe/EngineTypes">
            <StackTrace>Job-20000 Error in [Process Definition (1).process/JMS Topic Subscriber]
There was an error while parsing a message.
            at com.tibco.plugin.jms.service.JMSEventContextProcessor.postProcess(Unknown Source)
            at com.tibco.plugin.share.jms.impl.JMSEventContext.postProcess(Unknown Source)
            at com.tibco.pe.core.ProcessGroup.eval(Unknown Source)
            at com.tibco.pe.plugin.Activity.eval(Unknown Source)
            at com.tibco.pe.core.TaskImpl.eval(Unknown Source)
            at com.tibco.pe.core.Job.a(Unknown Source)
            at com.tibco.pe.core.Job.k(Unknown Source)
            at com.tibco.pe.core.JobDispatcher$JobCourier.a(Unknown Source)
            at com.tibco.pe.core.JobDispatcher$JobCourier.run(Unknown Source)
caused by: com.tibco.plugin.share.jms.impl.JMSExceptionWrapper: java.lang.NullPointerException
            at com.tibco.plugin.share.jms.impl.JMSPluginException.<init>(Unknown Source)
            at com.tibco.plugin.share.jms.impl.JMSReceiveException.<init>(Unknown Source)
            at com.tibco.plugin.jms.service.JMSEventContextProcessor.postProcess(Unknown Source)
            at com.tibco.plugin.share.jms.impl.JMSEventContext.postProcess(Unknown Source)
            at com.tibco.pe.core.ProcessGroup.eval(Unknown Source)
            at com.tibco.pe.plugin.Activity.eval(Unknown Source)
            at com.tibco.pe.core.TaskImpl.eval(Unknown Source)
            at com.tibco.pe.core.Job.a(Unknown Source)
            at com.tibco.pe.core.Job.k(Unknown Source)
            at com.tibco.pe.core.JobDispatcher$JobCourier.a(Unknown Source)
            at com.tibco.pe.core.JobDispatcher$JobCourier.run(Unknown Source)
Caused by: java.lang.NullPointerException
            at com.tibco.plugin.share.jms.service.DynamicPropertiesUtils.appendDynamicProperties(Unknown Source)
            at com.tibco.plugin.share.jms.service.JMSMessageDeserializer.messageToXiNode(Unknown Source)
            ... 9 more
            </StackTrace>
            <Msg>There was an error while parsing a message.</Msg>
            <FullClass>com.tibco.plugin.share.jms.impl.JMSReceiveException</FullClass>
            <Class>JMSReceiveException</Class>
            <ProcessStack>Process Definition (1).process/JMS Topic Subscriber</ProcessStack>
            <MsgCode>BW-JMS-100043</MsgCode>
            <Data>
                        <ns1:JMSReceiveException xmlns:ns1 = "http://schemas.tibco.com/bw/plugins/jms/5.0/jmsExceptions">
                                    <msg>There was an error while parsing a message.</msg>
                                    <msgCode>BW-JMS-100043</msgCode>
                        </ns1:JMSReceiveException>

Cause:
=====

This is due the following defect:

********************************
BW-15809
JMS Queue Receiver throws Null Pointer Exception when it tries to receive a message, which has a String application property and its value is set to Null.
********************************

Resolution:
==========

 Due to the string application property having a null value. There are two workarounds available:

1). Make sure that Sender application is not setting a null value for string property.

2). Create an application property in BW and use it with the JMS Queue receiver.