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.
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 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 topic "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}