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.

The wsadmin scripting client is run from Qshell. For more information, see Configuring Qshell to run WebSphere® Application Server scripts .

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.
Reference topic    

Terms of Use | Feedback

Last updated: Oct 20, 2010 11:50:58 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-base-iseries&topic=rjwsn_cli_wsntnsdoc_new
File name: rjwsn_cli_wsntnsdoc_new.html