Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 JMS Channels : Using JMS Header Properties in Incoming and Outgoing Messages

Using JMS Header Properties in Incoming and Outgoing Messages
Information in this section assumes you are familiar with JMS and its header properties. Consult your JMS provider documentation for information. This section explains only how TIBCO BusinessEvents supports use of these properties.
Setting Certain Header Properties in Destinations
In the JMS destination Configuration section, you configure the following three header properties:
DeliveryMode (JMSDeliveryMode)
Priority (JMSPriority)
TTL (JMSExpiration)
Setting Header Properties Using Header Properties from Incoming JMS Messages
You can configure events created from incoming JMS messages to have properties that match the JMS header properties. You can then use those event properties to set JMS header properties in outgoing messages.
These event properties must match the JMS header fields. You must use the names as shown in Table 15, JMS Header Field Names. You only have to configure event properties for those fields that you want to use. Incoming JMS message header properties will then populate the corresponding TIBCO BusinessEvents event properties.
Setting JMS Header Properties in Outgoing JMS Messages Using Event Properties
Similarly outgoing JMS message header properties will be populated by the corresponding TIBCO BusinessEvents event properties.
Note that the JMSMessageID and JMSTimeStamp properties are generated when the message is sent. You cannot set these properties manually.
See How TIBCO BusinessEvents Sets the JMSReplyTo Header in Outgoing Messages for special handling of the JMSReplyTo header.
JMS header properties defined in events take precedence over properties defined in destinations.
See Table 15, JMS Header Field Names for details on all properties.
How TIBCO BusinessEvents Sets the JMSReplyTo Header in Outgoing Messages
If an event has a string type property named JMSReplyTo (case sensitive), TIBCO BusinessEvents reads this event property value as a JMS queue or topic name, according to the event's default destination type. TIBCO BusinessEvents looks up the javax.jms.Destination on the connected JMS server using this queue or topic name. If TIBCO BusinessEvents cannot find one, it creates a new javax.jms.Destination using the given queue or topic name. TIBCO BusinessEvents then sets the JMSReplyTo header property of the outgoing JMS message using this destination
If you use the catalog function Event.replyEvent(requestEvent, replyEvent) during the RTC in which the requestevent is received, then the replyevent is sent to the destination in the JMSReplyTo header property of the JMS message associated with the requestevent.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved