createWSNTopicNamespace command
Use the createWSNTopicNamespace command to create a new WS-Notification 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.
You can create a new WS-Notification permanent topic namespace by using the wsadmin tool as described in this topic, or by using the administrative console as described in Creating a new WS-Notification permanent topic namespace.
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.
To run the command, use the AdminTask object of the wsadmin scripting client.
The wsadmin scripting client is run from Qshell.
For more information, see Configuring Qshell to run WebSphere scripts using wsadmin scripting.
- For a list of the available WS-Notification commands, plus a brief description of
each command, enter the following command at the wsadmin prompt:
print AdminTask.help('WSNotificationCommands')
- For overview help on a given command, enter the following command at the wsadmin
prompt:
print AdminTask.help('command_name')
AdminConfig.save()
Purpose
- 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.
Target Object
WSNService
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:
- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
Examples
In the following examples, the WS-Notification topic namespace uses the WS-Notification service newService created in the example from the topic about creating a new WS-Notification service by using the wsadmin tool.
- Using
Jython:
newTopicNamespace = AdminTask.createWSNTopicNamespace(newService, ["-namespace", "http://example.org/topicNamespace/example1", "-busTopicSpace", "mySIBTopicspace"] )
- Using
Jacl:
set newTopicNamespace [ $AdminTask createWSNTopicNamespace $newService { -namespace http://example.org/topicNamespace/example1 -busTopicSpace mySIBTopicspace } ]
- Using
Jython:
newTopicNamespace = AdminTask.createWSNTopicNamespace(newService, ["-namespace", "http://example.org/topicNamespace/example1", "-busTopicSpace", "mySIBTopicspace", "-reliability", "EXPRESS_NONPERSISTENT"] )
- Using
Jacl:
set newTopicNamespace [ $AdminTask createWSNTopicNamespace $newService { -namespace http://example.org/topicNamespace/example1 -busTopicSpace mySIBTopicspace -reliability EXPRESS_NONPERSISTENT} ]