Creating a new WS-Notification permanent topic namespace

Create a new permanent topic namespace. A topic namespace is a grouping of topics that allows information to be shared between applications. You use a permanent topic namespace to statically define the association between a WS-Notification topic namespace URI and a service integration bus topic space destination.

Before you begin

Decide which method to use to configure these resources. You can create a new WS-Notification permanent topic namespace by using the administrative console as described in this task, or by using the createWSNTopicNamespace command.

You can create many to many relationships between the set of permanent topic namespaces defined in a cell (that is for all WS-Notification services defined in that cell) and the service integration bus topic spaces with which they are associated. These relationships can become quite complex depending upon the topologies required by the applications that connect to the WS-Notification service. For guidance on when certain configurations might or might not be appropriate, see Options for associating a permanent topic namespace with a bus topic space.

About this task

A permanent topic namespace has the following characteristics:
  • You can use it to expose an existing service integration bus topic space for use by WS-Notification clients, thus permitting interoperation between the WS-Notification applications and existing publish and subscribe applications connected to the bus such as JMS.
  • You can use it to restrict the structure and content of the topic namespace by applying one or more topic namespace documents that describe the required structure.
  • You can use it as part of a topic space mapping configured on a service integration bus link (between two service integration buses) or a topic mapping as part of a publish and subscribe bridge between a service integration bus and a WebSphere® MQ network.

When you create a new WS-Notification permanent topic namespace, you specify the namespace and associate it with one of the service integration bus topic spaces configured on the bus on which the parent WS-Notification service is defined. You cannot modify a permanent topic namespace after it has been created, other than to apply or remove topic namespace documents.

You can also set a configuration attribute of a permanent topic namespace to control the reliability setting (persistence or non persistence) that is applied to any messages that use a given topic namespace.

To create a new WS-Notification permanent topic namespace, use the administrative console to complete the following steps:

Procedure

  1. In the navigation pane, click Service integration -> WS-Notification -> Services -> service_name -> Permanent topic namespaces or Service integration -> Buses -> bus_name -> [Services] WS-Notification services -> service_name -> Permanent topic namespaces.
    The permanent topic namespace collection is displayed.
  2. In the content pane, click New.
  3. Specify the following properties for this permanent WS-Notification topic namespace:
    1. Enter a name for the permanent topic namespace.
      The URI string by which this topic namespace is known. That is, the namespace URI by which WS-Notification applications refer to topics hosted by this namespace. For example http://widgetproducer.com/prices.
    2. Associate this new permanent topic namespace with the service integration bus topic space that you want to use to publish and receive messages.
      From the service integration bus topic space drop-down list, complete one of the following actions:
      • Select the name of an existing bus topic space.
      • Select the offered default name of this_service_nameTopicSpace for a new bus topic space.
      • Select the option to Create a new topic space, then enter a name for the new topic space.
    3. Select from the drop-down list the service integration bus reliability (quality of service) that is assigned to messages published through this topic namespace.
      You can choose one of five values. Each value represents one of the service integration bus message reliability levels. The default value is reliable persistent, which is the value used by default for JMS Persistent messages.
  4. Click OK.
    If the processing completes successfully, the list of permanent WS-Notification topic namespaces is updated to include the new topic namespace. Otherwise, an error message is displayed.
  5. Save your changes to the master configuration.

What to do next

To view the configuration of the associated service integration bus topic space, see Showing the properties of a permanent WS-Notification topic namespace. To apply a topic namespace document, see Applying a WS-Notification topic namespace document