WebSphere topic settings

Use this panel to view or change the configuration properties of the selected topic destination for use with the embedded WebSphere JMS provider.

A topic destination is used to configure the properties of a JMS topic for the associated JMS provider. Connections to the topic are created by the associated topic connection factory. A topic for use with the embedded WebSphere JMS provider has the following properties.

To view this administrative console page, click Resources-> WebSphere JMS Provider-> (In content pane, under Additional Properties) WebSphere Topic destinations-> destination_name

Name

The name by which the topic is known for administrative purposes within IBM WebSphere Application Server.

Data type

String

JNDI name

The JNDI name that is used to bind the topic into the application server's name space.

As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource.

This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform.

Data type

String

Description

A description of the topic, for administrative purposes within IBM WebSphere Application Server.

Data type	String
Default	Null

Category

A category used to classify or group this topic, for your IBM WebSphere Application Server administrative records.

Data type

String

Topic

The name of the topic as defined to the JMS provider.

Data type	String
Default	Null
Range	Depends on the broker used. For details, see the documentation for your broker; for example the WebSphere MQ Event Broker library at    http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/wsmqebv21.html .

Persistence

Whether all messages sent to the destination are persistent, non-persistent, or have their persistence defined by the application

Data type	Enum
Units	Not applicable
Default	APPLICATION_DEFINED
Range	Application defined Messages on the destination have their persistence defined by the application that put them onto the queue. Queue defined [WebSphere MQ destination only] Messages on the destination have their persistence defined by the WebSphere MQ queue definition properties. Persistent Messages on the destination are persistent. Non persistent Messages on the destination are not persistent.

Priority

Whether the message priority for this destination is defined by the application or the Specified priority property

Data type	Enum
Units	Not applicable
Default	APPLICATION_DEFINED
Range	Application defined The priority of messages on this destination is defined by the application that put them onto the destination. Queue defined [WebSphere MQ destination only] Messages on the destination have their persistence defined by the WebSphere MQ queue definition properties. Specified The priority of messages on this destination is defined by the Specified priority property.If you select this option, define a priority on the Specified priority property.

Specified priority

If the Priority property is set to Specified, type here the message priority for this queue, in the range 0 (lowest) through 9 (highest)

If the Priority property is set to Specified, messages sent to this queue have the priority value specified by this property.

Data type	Integer
Units	Message priority level
Default	Null
Range	0 (lowest priority) through 9 (highest priority)

Expiry

Whether the expiry timeout for this queue is defined by the application or the Specified expiry property, or messages on the queue never expire (have an unlimited expiry timeout)

Data type	Enum
Units	Not applicable
Default	APPLICATION_DEFINED
Range	Application defined The expiry timeout for messages on this queue is defined by the application that put them onto the queue. Specified The expiry timeout for messages on this queue is defined by the Specified expiry property.If you select this option, define a timeout on the Specified expiry property. Unlimited Messages on this queue have no expiry timeout, so those messages never expire.

Specified expiry

If the Expiry timeout property is set to Specified, type here the number of milliseconds (greater than 0) after which messages on this queue expire

Data type	Integer
Units	Milliseconds
Default	Null
Range	Greater than or equal to 0 0 indicates that messages never timeout Other values are an integer number of milliseconds

Connection pool

Specifies an optional set of connection pool settings.

Connection pool properties are common to all J2C connectors.

The application server pools connections and sessions with the JMS provider to improve performance. This is independent from any WebSphere MQ connection pooling. You need to configure the connection and session pool properties appropriately for your applications, otherwise you may not get the connection and session behavior that you want.

Change the size of the connection pool if concurrent server-side access to the JMS resource exceeds the default value.The size of the connection pool is set on a per queue or topic basis. See the following table for details.