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.

(iSeries) (iSeries) The wsadmin scripting client is run from Qshell. (iSeries) 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 at the wsadmin prompt:

  print AdminTask.help('WSNotificationCommands')

• For overview help on a given command, enter at the wsadmin prompt:

  print AdminTask.help('command_name')

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 we 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. 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 using the wsadmin tool":

• Use Jython:

  AdminTask.showWSNAdministeredSubscriber(newAdminSub)
  

• Use 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 using the wsadmin tool", using the WSNServicePoint target pattern:

• Use Jython:

  AdminTask.showWSNAdministeredSubscriber(newServicePoint, ["-topic", "stock"])
  

• Use Jacl:

  $AdminTask showWSNAdministeredSubscriber $newServicePoint {-topic stock}