WebSphere Message Brokers
File: aq03530_
Writer: Terry Cowling

Task topic

This build: July 31, 2007 21:35:17

Adding a new topic

You can define a new topic explicitly by using either the Message Brokers Toolkit or the Configuration Manager Proxy Java API. This topic describes how to use the Message Brokers Toolkit.

For information about how to use the Configuration Manager Proxy (CMP), see Developing applications using the CMP and Class com.ibm.broker.config.proxy.TopicProxy.

You can define a new topic implicitly by sending to the message broker a Publish command that specifies the new topic.

However, to define a new topic explicitly, do the following:

  1. Switch to the Broker Administration perspective.
  2. In the Domains view, expand the appropriate broker domain.
  3. Double-click on the Topics item to open the Topics Hierarchy editor.
  4. Right-click Topics in the topics hierarchy that is displayed by the Topics Hierarchy Editor.
  5. From the menu shown, click Create Topic; a topic window opens that shows the topic hierarchy.
  6. In the topic hierarchy, select the topic that you want to be the parent topic of the topic that you are creating. In the lower pane of the topic window, type the name of your new topic.
  7. Click Next; the next wizard page opens. The pane on the left of this window shows all the principals (groups and users) that are defined.
  8. Select the groups and users that you want to relate to your new topic and click the> icon between the two panes of the window; the pane on the right of the window is updated with the groups and users that you have chosen.
  9. For each principal selected in the right-hand pane, you can set Publish, Subscribe, and Persistent attributes by choosing a value from the corresponding list.

    By selecting more than one principal, you can choose values for a set of principals.

  10. Click Finish to insert the topic into the topic hierarchy and update the access control list (ACL) for the topic. The ACL is in a table with four columns that are entitled Principal, Publish, Subscribe, and Persistent. The rows of the table show the properties of each principal that is relevant to the topic.

    The topic is created locally, but the change is not effective until you have saved or closed the editor.

    When saving or closing the editor, you might be prompted to deploy the new topics hierarchy or the deployment might be automatic, depending on the Perform topics deploy after change preference.

Related concepts
Topics
Publish/Subscribe
Publications
Subscriptions
Topic-based security
Related tasks
Deleting a topic
Deploying a publish/subscribe topics hierarchy
Related reference
Publish message
Broker Administration perspective
Topics Hierarchy editor
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:35:17

aq03530_ This topic's URL is: