showWSNAdministeredSubscriber command
Use the showWSNAdministeredSubscriber command to show the properties of an administered subscriber. 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.
The wsadmin scripting client is run from Qshell.
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 shows the properties of a WS-Notification administered subscriber object in a
human-readable form. There are two patterns for use of this command:
- The required administered subscriber is determined by the target WSNAdministeredSubscriber object.
- The required administered subscriber is determined by a combination of the target WS-Notification service point, and the endpoint, topic, topicNamespace and dialect provided as parameters.
Target object
There are two choices for the target type of this command:
- WSNAdministeredSubscriber (explicitly nominates the administered subscriber to be shown).
- WSNServicePoint (determines the required WS-Notification service point; must be used in combination with the conditional parameters).
Required parameters
None.
Conditional 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
. This parameter must be specified if the target type is WSNServicePoint, and must not be specified if a WSNAdministeredSubscriber target is supplied. - -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. This parameter must be specified if the target type is WSNServicePoint, and must not be specified if a WSNAdministeredSubscriber target is supplied. - -topicNamespace
- The namespace URI by which the list is filtered. This parameter must be specified if the target type is WSNServicePoint, and must not be specified if a WSNAdministeredSubscriber target is supplied.
- -dialect
- The dialect in which the topic is expressed. That is, the name of the chosen topic dialect as defined by the WS-Topics standard, by which the list is filtered. Values of this parameter are SIMPLE, CONCRETE, FULL. For more information, see WS-Topics. This parameter must be specified if the target type is WSNServicePoint, and must not be specified if a WSNAdministeredSubscriber target is supplied.
Optional parameters
None.
Examples
Show the properties of the administered subscriber
newAdminSub
created in the example
from the topic about creating a new WS-Notification administered subscriber by using the wsadmin
tool.- Using Jython:
AdminTask.showWSNAdministeredSubscriber(newAdminSub)
- Using
Jacl:
$AdminTask showWSNAdministeredSubscriber $newAdminSub
Show the properties of the administered subscriber
newAdminSub
, created in the example
from topic Creating a new WS-Notification administered subscriber by using the wsadmin tool, by using the WSNServicePoint target pattern.
- Using
Jython:
AdminTask.showWSNAdministeredSubscriber(newServicePoint, [
-topic
,stock
]) - Using
Jacl:
$AdminTask showWSNAdministeredSubscriber $newServicePoint {-topic stock}