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.

We can apply a WS-Notification topic namespace document to an existing topic namespace using wsadmin.sh, or 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.

(iSeries) (iSeries) The wsadmin scripting client is run from Qshell. (iSeries) See Configure Qshell to run WebSphere 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 at the wsadmin prompt:

  print AdminTask.help('WSNotificationCommands')

• For overview help on a given command, enter at the wsadmin prompt:

  print AdminTask.help('command_name')

After using the command, save the changes to the master configuration using the following command:

AdminConfig.save()

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 the topic about creating a new permanent WS-Notification topic namespace :

• Use Jython:

  newTopicDoc = AdminTask.createWSNTopicDocument(newTopicNamespace, 
  ["-url", "http://www.example.org/instance_doc1.xml"] )
  

• Use Jacl:

  set newTopicDoc [ $AdminTask createWSNTopicDocument $newTopicNamespace 
  { -url http://www.example.org/instance_doc1.xml } ]
  

Note that change the url parameter to point to a valid topic namespace document as defined in the WS-Topics Version 1.3 OASIS Standard.