Creating a new permanent WS-Notification topic namespace using the wsadmin tool

Use a command script to create a new WS-Notification 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.

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.

To run the command, use the AdminTask object of the wsadmin scripting client.

[iSeries] The wsadmin scripting client is run from Qshell. For more information, see the topic "Configure Qshell to run WebSphere® Application Server scripts".

This command is only valid when used with WebSphere Application Server Version 6.1 and later application servers. Do not use it with earlier versions.

Command-line help is provided for service integration bus commands:

Purpose

This command creates the following resources:
  • It creates a new WS-Notification topic namespace on a WS-Notification service and associates it with the specified service integration bus topic space.
  • It creates the specified service integration bus topic space if it does not already exist.
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.
Command name
createWSNTopicNamespace
Target
WSNService
Result
A WS-Notification topic namespace is created.

Required parameters

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.
busTopicSpace
The service integration bus topic space with which this namespace is associated. That is, the bus topic space that is used by this topic namespace.

Conditional parameters

None.

Optional parameters

reliability
The service integration bus reliability to apply to messages published to this topic namespace. Valid values for this property are as follows:
  • ASSURED_PERSISTENT
  • RELIABLE_PERSISTENT
  • RELIABLE_NONPERSISTENT
  • EXPRESS_NONPERSISTENT
  • BEST_EFFORT_NONPERSISTENT
Each value represents one of the service integration bus message reliability levels.

Example

In the following examples, the WS-Notification topic namespace uses the WS-Notification service "newService" created in the example from topic "Creating a new WS-Notification service using the wsadmin tool".

Create a WS-Notification topic namespace on the WS-Notification service "newService":

set newTopicNamespace [ $AdminTask createWSNTopicNamespace $newService 
{ -namespace http://example.org/topicNamespace/example1 
-busTopicSpace mySIBTopicspace } ]

Create a WS-Notification topic namespace on the WS-Notification service "newService" with a specific reliability:

set newTopicNamespace [ $AdminTask createWSNTopicNamespace $newService 
{ -namespace http://example.org/topicNamespace/example1 
-busTopicSpace mySIBTopicspace -reliability EXPRESS_NONPERSISTENT} ]



Subtopics
Deleting a WS-Notification permanent topic namespace using the wsadmin tool
Listing WS-Notification topic namespaces using the wsadmin tool
Showing the properties of a WS-Notification topic namespace using the wsadmin tool
Related concepts
Learning about WS-Notification
Related tasks
WS-Notification - publish and subscribe messaging for Web services
Securing WS-Notification
Related reference
Creating a new WS-Notification service using the wsadmin tool
Creating a new WS-Notification service point using the wsadmin tool
Creating a new WS-Notification administered subscriber using the wsadmin tool
Applying a WS-Notification topic namespace document using the wsadmin tool
Retrieving a reference to an inbound service using the wsadmin tool
Retrieving a reference to an inbound port using the wsadmin tool
WS-Notification troubleshooting tips
Configuring WS-Notification resources using the wsadmin tool
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 4:28:44 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-mp&topic=rjwsn_cli_wsntns_new
File name: rjwsn_cli_wsntns_new.html