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.