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.

To run the command, use the AdminTask object of the wsadmin scripting client.

[IBM i][IBM i]The wsadmin scripting client is run from Qshell.

Command-line help is provided for commands of the service integration bus:
  • 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 specific command, enter the following command at the wsadmin prompt:

    print AdminTask.help('command_name')

After you use the command, save your changes to the master configuration 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 the topic about 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.