JMS Message Builder

JMS Message Builder

In this topic ...

Specifying Inputs
Related Topics ...

JMS Session builder
Sun Microsystems' Java Messaging System (JMS) page
JMS specification

The JMS Message builder allows you to create and send messages to the Java Message Service (JMS) Topic or Queue specified by a JMS Session builder call. We can use the JMS Message builder to send data from your Web application to a JMS client application. The JMS client could be a logging application, a notification system, or an entry point to a backend system.
The JMS Message builder creates a JMS Message based on the inputs you provide in the Builder Call Editor. We can send the message by calling the invoke method on the LJO that the JMS Message builder adds to the model.
Before you get started using the JMS builders, we need to have a JNDI service provider running somewhere on your network.

Specifying Inputs

The JMS Message builder takes the inputs described in the table below. For help on inputs common to many or all builders such as those in the Properties and HTML Attributes input groups, see "Using the Builder Call Editor."

Input name Description
Name Enter a name for this builder call. The designer tool displays this name in the builder call list.
Associated JMS Session Builder Name Choose the name of the JMS Session builder call to which to associate the message. The message will get sent to the Topic or Queue specified in the JMS Session builder call.
Message Type Specify whether the message is text or of type Object.
Message Body Enter text directly for a simple String message or use the Reference Chooser to specify an indirect reference to a method call or variable that returns/contains the message you want to send. For example, to send the XML returned by a method, you could use an indirect reference similar to the following:
${MethodCall/myMethod}
Advanced
Message Properties Allows you to specify one or more properties for the message. Enter the name, type, and value for each property you want to associate with the message.
JMSType If your application defines specific message types, we can use this input to declare the message as being of one of those types.
See the JMS specification and documentation for more details.
JMSCorrelationID Application specific String to use for associating messages with one another. See the JMS specification for more details.
Delivery Mode Specify a delivery mode for this particular message. The Delivery Mode for a message overrides the Delivery Mode set in the JMS Session builder call.

Persistent -- Provides for message recovery in the event that the JMS provider fails.
Non-persistent -- Does not provide for any JMS failover functionality.

Message Priority Specify a priority for this message. This setting overrides the Message Priority value defined in the JMS Session builder call.
Message Expiration Specify an interval (in milliseconds) after which this message expires, where 0 = no expiration.
This setting overrides the Message Expiration value defined in the JMS Session builder call.

Input name	Description
Name	Enter a name for this builder call. The designer tool displays this name in the builder call list.
Associated JMS Session Builder Name	Choose the name of the JMS Session builder call to which to associate the message. The message will get sent to the Topic or Queue specified in the JMS Session builder call.
Message Type	Specify whether the message is text or of type Object.
Message Body	Enter text directly for a simple String message or use the Reference Chooser to specify an indirect reference to a method call or variable that returns/contains the message you want to send. For example, to send the XML returned by a method, you could use an indirect reference similar to the following: ${MethodCall/myMethod}
Advanced
Message Properties	Allows you to specify one or more properties for the message. Enter the name, type, and value for each property you want to associate with the message.
JMSType	If your application defines specific message types, we can use this input to declare the message as being of one of those types. See the JMS specification and documentation for more details.
JMSCorrelationID	Application specific String to use for associating messages with one another. See the JMS specification for more details.
Delivery Mode	Specify a delivery mode for this particular message. The Delivery Mode for a message overrides the Delivery Mode set in the JMS Session builder call. Persistent -- Provides for message recovery in the event that the JMS provider fails. Non-persistent -- Does not provide for any JMS failover functionality.
Message Priority	Specify a priority for this message. This setting overrides the Message Priority value defined in the JMS Session builder call.
Message Expiration	Specify an interval (in milliseconds) after which this message expires, where 0 = no expiration. This setting overrides the Message Expiration value defined in the JMS Session builder call.