Input port settings

An input port has the following configuration properties:

Scope
The scope at which the extended messaging provider is defined. The value represents the location of the configuration file.
Name
The name of the input port, used for administrative purposes. The value for this field must be a string.
JNDI Name
The Java Naming and Directory Interface (JNDI) name for the resource. The value for this field must be a string.
Description
A description of the input port, used for administrative purposes. The value for this field must be a string.

This field is optional.

Category
A category string to use when classifying or grouping the resource. The value for this field must a a string between 1 and 30 ASCII characters in length.

This field is optional.

JMS Connection Factory JNDI Name
The JNDI name for the Java Message Service (JMS) connection factory used by the input port (for example, jms/connFactory1). The value for this field must be a string.
JMS Destination JNDI Name
The JNDI name for the JMS destination used by the input port (for example, jms/destn1). The value for this field must be a string.
JMS Acknowledgement Mode
The JMS mode that is used to acknowledge messages. This property is used only for message-driven beans that use bean-managed transaction demarcation (in other words, the transaction type is set to Bean).
The valid values for this field are as follows:
  • Auto Acknowledge—The session automatically acknowledges a message in either of the following cases:
    • When the session has successfully returned from a call to receive a message
    • When the session has called a message listener to process the message and received a successful response from that listener
  • Dups OK Acknowledge—The session acknowledges only the delivery of messages. This can result in the delivery of duplicate messages if JMS fails.

The default mode is Auto Acknowledge.

Destination Type
The JMS resource type. The valid values for this field are as follows:
  • Queue—The receiver bean receives messages from a queue destination
  • Topic—The receiver bean receives messages from a topic destination

The default value is Queue.

Subscription Durability
Specifies whether a JMS topic subscription is durable. The valid values for this field are as follows:
  • Durable—A subscriber registers a durable subscription with a unique identity that is retained by JMS. Subsequent subscriber objects with the same identity resume the subscription in the state in which it was left by the previous subscriber. If there is no active subscriber for a durable subscription, JMS retains the subscription’s messages until they are received or they expire.
  • Nondurable—Nondurable subscriptions last for the lifetime of their subscriber. A client sees the messages published on a topic only while its subscriber is active. If the subscriber is inactive, the client misses the messages published on its topic.

The default value is Durable.

This field is required only if the JMS destination type is a topic.

Reply JMS Connection Factory JNDI Name
The JNDI name of the JMS connection factory that is used for replies. The value for this field must be a string.
Reply JMS Destination JNDI Name
The JNDI name of the JMS destination that is used for replies. The value for this field must be a string.

Last updated: Wed 06 Dec 2006 07:08:08

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)