Creating a new permanent WS-Notification 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

You can create a new permanent WS-Notification topic namespace through the administrative console as described in this task, or you can create a new permanent WS-Notification topic namespace through the command line.

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 use patterns 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:
  • It enables you 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.
  • It allows you to restrict the structure and content of the topic namespace by applying one or more topic namespace documents that describe the required structure.
  • It allows the topic namespace to be used 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 permanent WS-Notification 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 (persistence or non persistence) setting that is applied to any messages inserted using a given topic namespace.

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

Procedure

  1. In the navigation pane, click Service integration > Web services > WS-Notification services > [Content Pane] service_name > Permanent topic namespaces or Service integration > Buses > [Content Pane] bus_name > [Services] WS-Notification services > [Content Pane] service_name > Permanent topic namespaces . The Permanent topic namespaces [Collection] form 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 using 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



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 12:02:36 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-zos&topic=tjwsn_wsntns_new
File name: tjwsn_wsntns_new.html