createWSNTopicDocument command

A topic namespace can optionally have topic namespace documents applied to it that define the structure of the topics that are permitted within the namespace. Use the createWSNTopicDocument command to apply a topic namespace document to an existing topic namespace.

You can apply a WS-Notification topic namespace document to an existing topic namespace by using the wsadmin tool as described in this topic, or by using the administrative console as described in Applying a WS-Notification topic namespace document.

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, 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')

After using the command, save your changes to the master configuration; for example, by using the following command:


AdminConfig.save()

Purpose

This command adds a new WS-Notification topic namespace document to an existing WS-Notification topic namespace.

Target object

WSNTopicNamespace

Required parameters

-url
The URL of the topic namespace document that should be loaded. This URL must address a valid topic namespace document as defined in the WS-Topics Version 1.3 OASIS Standard

Conditional parameters

None.

Optional parameters

-description
An optional description of the topic namespace document.

Example

Create a new topic namespace document on the WS-Notification topic namespace newTopicNamespace created in the example from topic "Creating a new permanent WS-Notification topic namespace by using the wsadmin tool" :
  • Using Jython:
    newTopicDoc = AdminTask.createWSNTopicDocument(newTopicNamespace, 
    ["-url", "http://www.example.org/instance_doc1.xml"] )
  • Using Jacl:
    set newTopicDoc [ $AdminTask createWSNTopicDocument $newTopicNamespace 
    { -url http://www.example.org/instance_doc1.xml } ]
Note that you must change the url parameter to point to a valid topic namespace document as defined in the WS-Topics Version 1.3 OASIS Standard.



Related concepts
WS-Notification
Related tasks
Using WS-Notification for publish and subscribe messaging for web services
Securing WS-Notification
Applying a WS-Notification topic namespace document
Related reference
WS-Notification troubleshooting tips
Related information
Topic namespace document [Settings]
Reference topic Reference topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 6:15:55 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-express-dist&topic=rjwsn_cli_wsntnsdoc_new
File name: rjwsn_cli_wsntnsdoc_new.html