WebSphere WebSphere Application Server Network Deployment, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

JMS topic settings

A JMS topic is used as a destination for publish/subscribe messaging. Use topic destination administrative objects to manage JMS topics for the default messaging provider.

In the administrative console page, to view this page click JMS providers > Default messaging provider > JMS topics > [Content Pane] topic_name.

Related concepts
JMS topic resources and service integration
Related tasks
Configuring a JMS topic for the default messaging provider
Related reference
Creating a new JMS topic using the wsadmin tool
Modifying an existing JMS topic using the wsadmin tool

Configuration tab

Configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.

General properties

Scope

The level to which this resource definition is visible; for example, the cell, node, cluster, or server level.

The scope displayed is for information only, and cannot be changed on this panel. If you want to browse or change this resource (or other resources) at a different scope, change the scope on the messaging provider settings panel, then click Apply, before clicking the link for the type of resource.

Required Yes
Data type Text

Name

The name by which this resource is known for administrative purposes.

Required Yes
Data type Text

JNDI name

The JNDI name for the resource.

As a convention, use a JNDI name of the form jms/Name, where Name is the logical name of the resource. For more information about the use of JNDI and its syntax, see JNDI support in WebSphere Application Server.

Required Yes
Data type Text

Description

An optional description for the resource.

Required No
Data type Text area

Topic name

The name of the topic that this JMS topic is assigned to, in the topic space defined by the Topic space property.

To specify a multi-level topic name, separate each level by a forward slash character (/); for example:
schools/eton/subjects/maths
Required No
Data type Text

Topic space

The name of the topic space that contains the topic, on the service integration bus defined by the Bus name property

Type the name of a topic space that has been created on the service integration bus.
Required No
Data type Custom

JMS delivery mode

The delivery mode for messages sent to this destination. This controls the persistence of messages on this destination.

Required No
Data type Selection list
Range
Application
The persistence of messages on this topic is defined by the producing application.

Nonpersistent
All messages sent to this topic are treated as nonpersistent.

Persistent
All messages sent to this topic are treated as persistent.

Time to live

The default length of time in milliseconds from its dispatch time that a message sent to this destination should be kept by the system.

Messages are deleted after the specified time. If a value is not specified for this property, the time limit set by the producing application is used.
Required No
Data type Long
Range 0 through 574476389546486783

A value of 0 (zero) means that messages are kept indefinitely. The default for this property is null, which allows the application to determine the time to keep messages.

Message priority

The relative priority for messages sent to this destination, in the range 0 to 9, with 0 as the lowest priority and 9 as the highest priority.

If a value is not specified for this property, the message priority set by the producing application is used.
Required No
Data type Integer
Range 0 through 9

The message priority range is from 0 (lowest) through 9 (highest).

Read ahead

Read ahead is an optimization that preemptively assigns messages to consumers. This improves the time taken to satisfy consumer requests.

Messages that are assigned to a consumer are locked on the server and cannot be consumed by any other consumers for that destination. Messages that are assigned to a consumer, but not consumed before that consumer is closed, are subsequently unlocked on the server and then available for receipt by other consumers.

This property overrides the value set by the Read ahead property on the JMS connection factory.

Required No
Data type Selection list
Range
Enabled
The messaging provider preemptively assigns messages to consumers. This improves the time taken to satisfy consumer requests for this destination.

Disabled
The messaging provider does not preemptively assign messages to consumers for this destination.

As connection factory
Read ahead optimization is defined on the connection.


Reference topic

Terms of Use | Feedback

Last updated: 15 Mar 2007
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.pmc.nd.doc\sibjmsresources\SIBJMSTopic_DetailForm.html

© Copyright IBM Corporation 2004, 2007. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)