Network Deployment (Distributed operating systems), v8.0 > Reference > Commands (wsadmin scripting)
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.
We can create a new WS-Notification permanent topic namespace by using wsadmin as described in this topic, or by using the admin console as described in Create a new WS-Notification permanent topic namespace.
We 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.
Command-line help is provided for service integration bus commands:
- For a list of the available WS-Notification commands, plus a brief description of each command, run at the wsadmin prompt:
print AdminTask.help('WSNotificationCommands')
- For overview help on a given command, run at the wsadmin prompt:
print AdminTask.help('command_name')
After using the command, save changes to the master configuration; for example, by using the following command:
AdminConfig.save()
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.
We 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.
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 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
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 by using wsadmin".
Create a WS-Notification topic namespace on the WS-Notification service newService:
### Jython
newTopicNamespace = AdminTask.createWSNTopicNamespace(newService, ["-namespace", "http://example.org/topicNamespace/example1", "-busTopicSpace", "mySIBTopicspace"] )### Jacl
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:
### Jython
newTopicNamespace = AdminTask.createWSNTopicNamespace(newService, ["-namespace", "http://example.org/topicNamespace/example1", "-busTopicSpace", "mySIBTopicspace", "-reliability", "EXPRESS_NONPERSISTENT"] )### Jacl
set newTopicNamespace [ $AdminTask createWSNTopicNamespace $newService { -namespace http://example.org/topicNamespace/example1 -busTopicSpace mySIBTopicspace -reliability EXPRESS_NONPERSISTENT} ]
WS-Notification
Options for associating a permanent topic namespace with a bus topic space
Use WS-Notification for publish and subscribe messaging for web services
Secure WS-Notification
Create a new WS-Notification permanent topic namespace
Related
WS-Notification troubleshooting tips
Permanent topic namespace [Settings]