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.

[IBM i][IBM i]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}