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:
- In the navigation pane, click Resources > JMS->Topics to display existing topic destinations.
- Select the name of the topic destination to work with.
- Optional: To create a new topic destination, click New.
- 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 the WebSphere MQ topic.
- Custom properties to display or change the custom properties of the WebSphere MQ topic.
Under Related items, we can click JAAS - J2C authentication data to configure authentication information for use with the topic.
We 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.
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 specified must match the values that specified when configuring WebSphere MQ for JMS resources. For more information about configuring WebSphere MQ JMS resources, see the Use Java and MQ System Administration sections of the WebSphere MQ information center.
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. For more information see Disable WebSphere MQ functionality in WebSphere Application Server.
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 defined at more general scopes.
The scope displayed is for information only, and cannot be changed on this panel. 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 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. For more information about the Topic name, see WebSphere MQ product information:
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.
Broker publication queue manager
The queue manager that hosts the topic.
Information Value Data type String
Subtopics
- WebSphere MQ messaging provider queue and topic advanced properties settings
Use this panel to view or change the advanced properties for the selected queue or topic destination for use with the WebSphere MQ messaging provider. These advanced properties control the behavior of connections made to WebSphere MQ messaging provider destinations.
Related concepts
JMS interfaces - explicit polling for messages
Related tasks
Manage Java 2 Connector Architecture authentication data entries for JAAS Secure messaging Disable WebSphere MQ functionality in WebSphere Application Server
WebSphere MQ resource custom properties settings Mapping of administrative console panel names to command names and WebSphere MQ names
WebSphere MQ libraryWebSphere MQ messaging provider queue and topic advanced properties settings Reference topic