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
- In
the navigation pane, click or . 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 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.
- 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.
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