Creating a new WS-Notification administered subscriber using the wsadmin tool

Use a command script to create a new 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.

You should not define an administered subscriber for any of the endpoints exposed by the WS-Notification service on which it is being defined, because this would result in infinite looping of messages through the notification broker.

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 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 adds a new WS-Notification administered subscriber to the target WS-Notification service point.

Command name
createWSNAdministeredSubscriber
Target
WSNServicePoint
Result
An administered subscriber is created.

Required parameters

endpoint
The URL of the external Web service to which the service should subscribe. That is, the endpoint reference (Web address) of a notification producer or notification broker application. For example http://remoteproducer.com.
topic
The topic on which the service should subscribe. 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.
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. Values of this parameter are SIMPLE, CONCRETE, FULL. For more information, see WS-Topics.

Conditional parameters

None.

Optional parameters

topicNamespace
The URI that describes the topic namespace in which the specified topic is defined. Omitting this field indicates that the topic is contained in the ad-hoc topic namespace.
remoteSubscriptionTimeout
The length of time in hours after which the remote subscription will expire if not renewed by the server. This timeout minimizes the potential for orphaned subscriptions in the remote Web service if the local server is uninstalled. Note that this field does not indicate the actual time at which the remote subscription is due to expire. Set the timeout length to something larger than the maximum length of time that the server is expected to remain offline, otherwise the stream of messages from the remote Web service might be interrupted. While the server is running it occasionally renews the remote subscription termination time (with the specified timeout) to prevent it from expiring during normal operation. If not specified, this timeout defaults to 24 (hours).

Example

Create an administered subscriber on the WS-Notification service point "newServicePoint" created in the example from topic "Creating a new WS-Notification service point using the wsadmin tool":

set newAdminSub [ $AdminTask createWSNAdministeredSubscriber $newServicePoint 
{ -endpoint http://myremotehost:9080/producerEP -dialect SIMPLE -topic stock 
-topicNamespace http://example.org/mynamespace -remoteSubscriptionTimeout 48 } ]



Subtopics
Deleting a WS-Notification administered subscriber using the wsadmin tool
Listing WS-Notification administered subscribers using the wsadmin tool
Showing the properties of a WS-Notification administered subscriber using the wsadmin tool
Related concepts
Learning about WS-Notification
Related tasks
WS-Notification - publish and subscribe messaging for Web services
Securing WS-Notification
Related reference
Creating a new WS-Notification service using the wsadmin tool
Creating a new WS-Notification service point using the wsadmin tool
Creating a new permanent WS-Notification topic namespace using the wsadmin tool
Applying a WS-Notification topic namespace document using the wsadmin tool
Retrieving a reference to an inbound service using the wsadmin tool
Retrieving a reference to an inbound port using the wsadmin tool
http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-os.pdf
WS-Notification troubleshooting tips
Configuring WS-Notification resources using the wsadmin tool
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 8:21:57 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-express-iseries&topic=rjwsn_cli_wsnadminsub_new
File name: rjwsn_cli_wsnadminsub_new.html