Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer web services - Notification (WS-Notification) > Use WS-Notification for publish and subscribe messaging for web services > Configure WS-Notification resources > Interacting at run time with WS-Notification


List or deleting active WS-Notification subscriptions

List the subscriptions that exist at run time for a particular WS-Notification service point, or for all service points for a particular WS-Notification service.

The runtime panels for WS-Notification subscriptions list the durable subscriptions that have been created by a WS-Notification service point in response to "Subscribe" requests from WS-Notification applications. We can view the subscription name (ID), topic and other information associated with the subscription, and you can view messages held on the durable subscription pending delivery. We can also delete subscriptions. For example, to tidy up after a badly-behaved application.

Both the WS-Notification subscription and publisher registration resources include the concept of scheduled termination, in which the application indicates a period of time after which the resource is destroyed. "Badly-behaved" in this case describes an application that requests an infinite lifetime for a resource and then does not explicitly delete the resource before it goes away (never to return).

A subscription created by a WS-Notification application can contain more than one topic expression, and each of these topic expressions can be in a different namespace, which can result in service integration bus subscriptions being created in multiple topic spaces.

To display a list of WS-Notification subscriptions that exist at run time, use the admin console...


Procedure

  1. Choose between information for a particular service point, or information aggregated for all service points for a particular service, by completing one of the following substeps:

    1. Optional: For runtime information for a particular service point, navigate to either Service integration -> WS-Notification -> Services -> service_name -> [Additional Properties] WS-Notification service points -> point_name or Service integration -> Buses -> bus_name -> [Services] WS-Notification services -> service_name -> [Additional Properties] WS-Notification service points -> point_name , then click the Runtime tab. A panel is displayed that contains links to runtime information about subscriptions, registrations, pull points and administered subscribers for this WS-Notification service point.

    2. Optional: For runtime information aggregated for all service points for a particular service, navigate to either Service integration -> WS-Notification -> Services -> service_name or Service integration -> Buses -> bus_name -> [Services] WS-Notification services -> service_name , then click the Runtime tab. A panel is displayed that contains links to runtime information about subscriptions, registrations and pull points for this WS-Notification service.

  2. Click Subscriptions The Subscriptions [Collection] form is displayed. This form shows all the currently active subscriptions for this WS-Notification service point or service. This collection form contains the following information about each list item:

    Subscription id

    The unique identifier of the subscription.

    Topics

    An array of topic names. Note that this will usually only contain one element.

    Delivery state

    The current runtime state of the subscription. In normal operation the subscription will show a state of OK. Other states are PAUSED, indicating that the application has paused the subscription as defined by the WS-Notification standards, or ERROR, indicating that the last attempt to deliver an event notification to the notification consumer was not successful. In the error case, more information about the cause of the failure can be found in the SystemOut log.

    With WAS v8 you can configure the server to use the HPEL log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files or native z/OS logging facilities. If you are using HPEL, you can access all of your log and trace information using $PROFILE/bin/LogViewer.sh.

    Consumer EPR

    The endpoint reference to which event notifications matching the subscription are sent. That is, the endpoint reference to which notification messages are delivered as specified on the subscribe call.

    Creation time

    The time at which the subscription was created.

    Termination time

    The time at which the subscription will be deleted.

    Pull type

    Indicates whether the subscription is being used in pull mode. That is, whether this subscription is being accessed by a pull point. If the asynchronous (push) subscription model is being used, this field displays "No". If a pull point is being used, this field displays "Yes".

    Service integration bus subscriptions

    The service integration bus durable subscription or subscriptions that are associated with the WS-Notification subscription. This is a link to the service integration bus durable subscription detail panel for the subscriptions that contain data for this object.

  3. Optional: To observe the runtime state of each of the service integration bus durable subscriptions that have been created, click the link in the SIBus subscriptions field.

    If only one durable subscription has been created, the bus durable subscription detail panel is displayed. See Administer durable subscriptions.

    If multiple durable subscriptions have been created, for example if the WS-Notification subscription is spanned across multiple service integration bus topic spaces, a runtime collection form is displayed that shows the individual bus durable subscriptions. This form shows all the currently active publisher registrations for this WS-Notification service point or service.

    SIBus subscription

    The service integration bus durable subscription ID. This links to the associated bus durable subscription detail panel. See Administer durable subscriptions.

    Topics

    The list of topics that are contained within a single service integration bus topic space (and thus durable subscription).


What to do next

To delete one or more WS-Notification subscriptions, and the associated service integration bus durable subscriptions, select the check box next to each subscription name then click Delete.
WS-Notification
Use HPEL to troubleshoot applications
Use WS-Notification for publish and subscribe messaging for web services
Secure WS-Notification


Related


WS-Notification troubleshooting tips
Subscriptions [Collection]

+

Search Tips   |   Advanced Search