Adapter for JMS 6.1 SP1 | webMethods Adapter for JMS Documentation | webMethods Adapter for JMS Installation and User’s Documentation | Adapter Services | Configuring MessageConsumer Services | Using MessageConsumer Services
 
Using MessageConsumer Services
To enable the MessageConsumer service to retrieve a JMS Message from a Queue or Topic, provide values for the parameters listed below in the service's input signature when configuring the adapter service within a flow service in Designer. You can either map in values from the pipeline, or you can set constant values using the pipeline editor.
Parameter
Description/Action
JMSDestination
The JMS Destination object or the JMS Destination JNDI Name (String).
If the adapter connection is configured for a queue, the JMS destination must be a queue.
If the adapter connection is configured for a topic, the JMS Destination must be a topic.
JMSMessageSelector
(Optional) A String contain a SQL92 conditional expression.
Only messages with JMS Properties or JMS Headers that match the expression will be delivered.
A value of null or an empty string indicates that there is no message selector for the service.
JMSTimeout
The maximum length of time the service waits on the JMS Destination if a message does not arrive.
Topic.isDurableSubscriber
(Optional) This parameter is for use with topics only.
Set this parameter to true if the subscriber to the topic is a durable subscriber. Otherwise, set the field to false. Default: false
Topic.JMSSubscriptionName
(Optional) This parameter is for use with topics only.
If the subscriber to the topic is a durable subscriber, set the field to the subscription name to use.
Note:
Do not change this field after you have saved the service because doing so could potentially cause orphaned durable subscriptions on the JMS destination.
The MessageConsumer service contains the following output signature:
Parameter
Description/Action
JMSMessage
The JMS message object that is retrieved from the JMS Destination.
Convert the document to a JMS message object using one of the following Adapter for JMS services:
*TextMessageToDocument
*ObjectMessageToDocument
*MapMessageToDocument
*BytesMessageToDocument
*StreamMessageToDocument
JMSMessageClass
A String containing the name of the Java class for the JMS message. You can use the value from this parameter to determine which message-to-document service to use to convert the JMS message to a document.