WebSphere WebSphere Application Server Version 6.1.x Feature Pack for Web Services Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

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.

For i5/OS platforms 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.

Examples

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} ]
Related tasks
WS-Notification - publish and subscribe messaging for Web services
Learning about WS-Notification
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

Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 27 November 2008
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.wsfep.multiplatform.doc/ref/rjwsn_cli_wsntns_new.html

Copyright IBM Corporation 2004, 2008. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)