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 by as described in this topic, or using the administrative console as described in Apply 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 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 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 the changes to the master configuration 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 ":

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

• 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

Use WS-Notification for publish and subscribe messaging for web services

Secure WS-Notification

Apply a WS-Notification topic namespace document

WS-Notification troubleshooting tips

Related information:

Topic namespace document [Settings] Reference topic