WebSphere topic destination settings for application clients

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

To view this Application Client Resource Configuration Tool (ACRCT) page, click File > Open. After you browse for an EAR file, click Open. Expand the selected JAR file > JMS Providers > JMS provider instance. Right-click WAS Topic Destinations and click New. The following fields appear on the General tab.

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 internal WebSphere JMS provider has the following properties.

Name

The name by which the topic is known for administrative purposes.

Data type	String
Units	En_US ASCII characters
Default	Null
Range	1 through 30 ASCII characters

Description

A description of the topic, for administrative purposes

Data type	String
Units	En_US ASCII characters
Default	Null
Range	1 through 30 ASCII characters

JNDI Name

The application client run-time uses this field to retreive configuration information. The name must match the value of the Name field on the General tab in the Application Client Resource Reference section of the Application Assembly Tool.

Topic Name

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

Data type	String
Units	ASCII characters
Default	Null
Range	1 to 30 ASCII characters

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 JMS queue 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. 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

Custom Properties

Specifies name-value pairs for setting additional properties on the object that is created at runtime for this resource.

You must enter a name that is a public property on the object and a value that can be converted from a string to the type required by the set method of the property. The accectable properties and values depend on the object that is created. Refer to the object documentation for a list of valid properties and values.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.