+

Search Tips   |   Advanced Search

Listing 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 we 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 console to complete the following steps:

  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 containing 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 containing 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.

    This topic references one or more of the application server log files. As a recommended alternative, we can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files on distributed and IBM i systems. We can also use HPEL in conjunction with the native z/OS logging facilities. If we are using HPEL, we can access all of the log and trace information using the LogViewer command-line tool from the server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.

    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 associated with the WS-Notification subscription. This is a link to the service integration bus durable subscription detail panel for the subscriptions containing 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. For more information, 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. For more information, see Administer durable subscriptions.

    Topics

    The list of topics 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.


Related concepts

  • WS-Notification


    Related tasks

  • Listing or deleting active WS-Notification publisher registrations
  • Listing or deleting active WS-Notification pull points
  • Listing active WS-Notification administered subscribers
  • Use High Performance Extensible Logging to troubleshoot applications
  • Use WS-Notification for publish and subscribe messaging for web services
  • Secure WS-Notification

  • WS-Notification troubleshooting tips


    Related information:

  • Subscriptions [Collection]