WebSphere MQ messaging provider topic settings

Use this panel to view or change the configuration properties of the selected JMS topic destination for publish/subscribe messaging with WebSphere® MQ as a messaging provider.

A WebSphere MQ topic destination is used to configure the properties of a topic for the WebSphere MQ messaging provider. Connections to the topic are created using an associated WebSphere MQ topic connection factory or connection factory.

To view WebSphere MQ topic settings, use the administrative console to complete the following steps:
  1. In the navigation pane, click Resources > JMS->Topics to display existing topic destinations.
  2. Select the name of the topic destination that you want to work with.
  3. Optional: To create a new topic destination, click New.
  4. Optional: To view or change the topic destination settings, select its name in the list displayed.
Under General Properties there are two groups of properties:
  • Administration
  • WebSphere MQ topic
Make any required changes to the Administration and WebSphere MQ topic groups of properties, and then click Apply to save the configuration before, in the content pane under Additional Properties, you click either of the following links:
  • Advanced properties to display or change the advanced properties of your WebSphere MQ topic.
  • Custom properties to display or change the custom properties of your WebSphere MQ topic.

Under Related items, you can click JAAS - J2C authentication data to configure authentication information for use with the topic.

You can specify the following additional properties by using WebSphere MQ administrative commands:
  • wildcardFormat
  • brokerVersion

For more information about these properties, refer to the createWMQTopic command.

Note: When specifying WebSphere MQ properties, the following restrictions apply:
  • Names can have a maximum of 48 characters, with the exception of channels, which have a maximum of 20 characters.
  • The property values that you specify must match the values that you specified when configuring WebSphere MQ for JMS resources. For more information about configuring WebSphere MQ JMS resources, see the Using Java™ and MQ System Administration sections of the WebSphere MQ documentation.

If WebSphere MQ functionality has been disabled at a scope that affects this WebSphere MQ messaging provider resource, then an informational message indicating that WebSphere MQ has been disabled appears. In a single server environment this informational message is only displayed when the server is restarted after WebSphere MQ functionality has been disabled. In a network deployment environment the informational message is displayed immediately.

Scope

The scope assigned to the topic when it is created. The scope specifies the level to which this topic definition is visible to applications.

Resources such as messaging providers, namespace bindings, or shared libraries can be defined at multiple scopes, with resources defined at more specific scopes overriding duplicates that are defined at more general scopes.

The scope displayed is for information only, and cannot be changed on this panel. If you want to browse or change this resource at a different scope, change the scope on the WebSphere MQ topic destination collection panel, then click Apply, before clicking the link for the type of resource.

Information Value
Data type String

Provider

The JMS provider assigned when the topic is created.

For all topics created using this panel, the provider is the WebSphere MQ messaging provider.

The provider is displayed for information only.

Information Value
Data type String

Name

The name by which the topic is known for administrative purposes within WebSphere Application Server.

Information Value
Data type String

JNDI name

The name that is used to bind the topic into the JNDI namespace.

As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource.

Information Value
Data type String

Description

A description of the topic for administrative purposes within WebSphere Application Server.

Information Value
Data type String

Topic name

The WebSphere MQ name for the topic.

Information Value
Data type String

Broker durable subscriber queue

The queue to use for durable subscribers.

If this property is blank then the default WebSphere MQ value SYSTEM.JMS.D.SUBSCRIBER.QUEUE is used.

Information Value
Data type String

Broker durable subscription connection consumer queue

The queue to use for durable subscribers that use a connection consumer.

If this property is blank then the default WebSphere MQ value SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE is used.

Information Value
Data type String

Broker publication queue

The queue to use for publishing messages.

Information Value
Data type Drop-down list
Default As connection
Range
As connection
The connection factory values are used.
Override connection
Enter the name of a queue in the associated text box.