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 Application Server product Java Messaging Service (JMS) provider.
To view this 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 used with the internal JMS provider has the following properties.
Name The name by which the topic is known for administrative purposes.
Data type String
Description A description of the topic, for administrative purposes within IBM WAS.
Data type String Default Null
JNDI Name The application client run-time environment uses this field to retrieve 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
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, specify 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 time out
- 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 run time 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 acceptable properties and values depend on the object that is created. Refer to the object documentation for a list of valid properties and values.