listWSNTopicNamespaces command

Use the listWSNTopicNamespaces command to list the WS-Notification topic namespaces in the configuration of the target WS-Notification service that match the specified input parameters. A topic namespace is a grouping of topics that allows information to be shared between applications. You use a permanent topic namespace to statically define the association between a WS-Notification topic namespace URI and a service integration bus topic space destination.

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 scripts using wsadmin scripting .

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

Purpose

This command lists all the WS-Notification topic namespaces in the configuration of the target WS-Notification service that match the specified input parameters. This command can be used to obtain a reference to one or more WS-Notification topic namespaces that have already been created in the configuration in order to work with the topic namespace further, for example to add a new topic namespace document definition.

Target Object

WSNService

Required parameters

None.

Conditional parameters

None.

Optional parameters

-namespace
The namespace URI of the WS-Notification topic namespace by which the list should be filtered. Omitting this parameter results in the listing of all WS-Notification topic namespaces for the target WS-Notification service.

Example

Obtain a reference to the first WS-Notification topic namespace defined against the wsnService object:
  • Using Jython:
    AdminTask.listWSNTopicNamespaces(wsnService)
    wsnNamespace = wsnNamespaceList.split("\n")[0].rstrip()
  • Using Jacl:
    set wsnNamespaceList [$AdminTask listWSNTopicNamespaces $wsnService]
    set wsnNamespace [ lindex $wsnNamespaceList 0 ]
Obtain a reference to the WS-Notification topic namespace defined against the wsnService object with a given namespace:
  • Using Jython:
    wsnNamespaceList = AdminTask.listWSNTopicNamespaces(wsnService, 
    ["-namespace", "http://example.org/topicNamespace/example1"] )
    wsnNamespace = wsnNamespaceList.split("\n")[0].rstrip()
    
  • Using Jacl:
    set wsnNamespaceList [$AdminTask listWSNTopicNamespaces $wsnService 
    {-namespace http://example.org/topicNamespace/example1}]
    set wsnNamespace [ lindex $wsnNamespaceList 0 ]
    



Related concepts
WS-Notification
Related tasks
Using WS-Notification for publish and subscribe messaging for web services
Securing WS-Notification
Related reference
WS-Notification troubleshooting tips
Related information
Permanent topic namespaces [Collection]
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Feb 6, 2014 8:11:25 PM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-mp&topic=rjwsn_cli_wsntns_list
File name: rjwsn_cli_wsntns_list.html