WebSphere WebSphere Application Server Version 6.1.x Feature Pack for Web Services Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

Listing WS-Notification administered subscribers using the wsadmin tool

Use a command script to list the WS-Notification administered subscribers in the configuration of the target WS-Notification service point that match the specified input parameters. An administered subscriber provides a mechanism for the WS-Notification service point to subscribe to an external notification producer at server startup time.

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

For i5/OS platforms The wsadmin scripting client is run from Qshell. For more information, see the topic "Configure Qshell to run WebSphere Application Server scripts".

This command is only valid when used with WebSphere Application Server Version 6.1 and later application servers. Do not use it with earlier versions.

Command-line help is provided for service integration bus commands:

Purpose

This command lists all the administered subscribers in the configuration of the target WS-Notification service point that match the specified input parameters. This command can be used to obtain a reference to one or more administered subscribers that have already been created in the configuration in order to work with the administered subscriber further, for example to delete the definition.

Command name
listWSNAdministeredSubscribers
Target
WSNServicePoint
Result
A List of the administered subscribers that match the requested pattern.

Required parameters

None.

Conditional parameters

None.

Optional parameters

endpoint
The remote Web service endpoint by which the list is filtered. That is, the endpoint reference (Web address) of a notification producer or notification broker application. For example http://remoteproducer.com.
topic
Topic expression describing the class of notification messages by which the list is filtered. This describes the class of notification messages that are delivered to the WS-Notification service point. For example stock/IBM. This property can include wildcards if they are supported by the topic dialect that you select.
topicNamespace
The namespace URI by which the list is filtered.
dialect
The dialect in which the topic is expressed. That is, the name of the chosen topic dialect as defined by the WS-Topics specification, by which the list is filtered. Values of this parameter are SIMPLE, CONCRETE, FULL. For more information, see WS-Topics.

Examples

Obtain a reference to the first administered subscriber defined against the "newServicePoint" object:

set wsnSubscriberList [$AdminTask listWSNAdministeredSubscribers $newServicePoint]
set wsnSubscriber [ lindex $wsnSubscriberList 0 ]

Obtain a reference to the first administered subscriber defined against the "newServicePoint" object with a given topic:

set wsnSubscriberList [$AdminTask listWSNAdministeredSubscribers $newServicePoint {-topic stock/IBM}]
set wsnSubscriber [ lindex $wsnSubscriberList 0 ]
Related tasks
WS-Notification - publish and subscribe messaging for Web services
Learning about WS-Notification
Securing WS-Notification
Related reference
Deleting a WS-Notification administered subscriber using the wsadmin tool
Showing the properties of a WS-Notification administered subscriber using the wsadmin tool
WS-Topics Version 1.3 OASIS Standard
WS-Notification troubleshooting tips

Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 27 November 2008
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.wsfep.multiplatform.doc/ref/rjwsn_cli_wsnadminsub_list.html

Copyright IBM Corporation 2004, 2008. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)