pub.jms:createConsumer

connectionAliasName

String Name of the JMS connection alias that you want the message consumer to receive messages.

The JMS connection alias indicates how Integration Server connects to the JMS provider. A JMS connection alias can specify that Integration Server use a JNDI provider to look up administered objects (connection factories and destinations) and then use the connection factory to create a connection. Alternatively, a JMS connection alias can specify that Integration Server uses the native webMethods API to create the connection directly on the webMethods Broker.

destinationName

String Name or lookup name of the Destination from which you want the message consumer to receive messages. Specify the lookup name of the Destination object when the JMS connection alias uses JNDI to retrieve administered objects. Specify the provider-specific name of the Destination when the JMS connection alias uses the native webMethods API to connect directly to the webMethods Broker.

destinationType

String Optional. Type of destination from which the message consumer receives messages. Specify one of the following:

QUEUE to receive messages sent to a particular queue. This is the default.

TOPIC to receive messages sent to a particular topic.

Note:

You need to specify a destinationType only if you specified a connectionAliasName that uses the native webMethods API.

acknowledgmentMode

String Optional. Specifies the acknowledgment mode. Specify one of the following:

AUTO_ACKNOWLEDGE to automatically acknowledge the message when it is received by the message consumer. The message consumer will acknowledge the message before the message processing completes. The JMS provider cannot redeliver the message if Integration Server becomes unavailable before message processing completes. This is the default.

CLIENT_ACKNOWLEDGE to acknowledge the receipt of a message when the JMS client (Integration Server) invokes pub.jms:acknowledge service.

DUPS_OK_ACKNOWLEDGE to automatically, lazily acknowledge the receipt of messages, which reduces system overhead but may result in duplicate messages being sent.

messageSelector

String Optional Specifies a filter used to receive a subset of messages from the specified destination. A message selector allows a client to filter the messages it wants to receive by use of a SQL92 string expression in the message header. That expression is applied to properties in the message header (not to the message body content) containing the value to be filtered.

If the SQL expression evaluates to true, the JMS provider sends the message to the message consumer; if the SQL expression evaluates to false, the JMS provider does not send the message.

durableSubscriberName

String Optional. Name of the durable subscriber that you want this service to create on the JMS provider. A durable subscriber creates a durable subscription on the JMS provider. If a durable subscriber of this name already exists on the JMS provider, this service resumes the previously established subscription.

Note:

This parameter only applies when the destinationType is set to TOPIC. If you select TOPIC, but do not specify a durableSubscriberName, this service creates a nondurable subscriber. If destinationType is set to QUEUE, this parameter is ignored.

noLocal

java.lang.Boolean Optional. Flag indicating whether the message consumer can receive locally published messages. Integration Server considers a message to be local if the message was:

Sent by the same Integration Server, and

Sent using the same JMS connection alias.

Specify one of the following values:

True to indicate that the consumer will not receive locally published messages.

False to indicate that the consumer can receive locally published messages. This is the default.

Note:

This parameter only applies when the destinationType is set to TOPIC.