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
- In the navigation pane, click service_name or bus_nameservice_name.
The Permanent topic namespaces [Collection] form
is displayed.
- In the content pane, click New.
- Specify the following properties for this permanent WS-Notification
topic namespace:
- 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.
- 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.
- 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.
- 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.
- Save your changes to the master configuration.