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.