Subscriptions Query editor

The Subscriptions Query editor is the default editor that is provided by the Broker Administration perspective for managing subscriptions. Use this editor to view and delete subscriptions in your publish/subscribe system. The editor allows you to set query parameters, submit subscription queries, and delete subscriptions.

You can use wildcard characters in subscription names so that you can manage a specified range of subscriptions.

The Subscriptions Query editor is launched in the editor area of the Broker Administration perspective when you double-click Subscriptions in the Domains view.

If you are not connected to a domain, an attempt to do so is made before opening the editor. During this attempt, if you click Cancel, the connection that is in progress stops and the domain returns to its initial unconnected state.

Subscription Query editor view

The Subscription Query editor view is divided into two parts.

In the upper part of the edit window, you can define your query. When you click Query, the current subscriptions are displayed in the lower part of the edit window. Unless you make any changes to the default query, this displays all subscriptions that are registered with all of the brokers that are set up for publish/subscribe.

Subscription query

You can change the default query by changing any of the following values that are displayed in the upper part of the edit window:

  • Topics

    If you don't want to display subscriptions for all topics, you can put a topic name here. You can use the wildcard character '%' to display subscriptions for a range of topics.

  • Brokers

    If you want to display only those subscriptions that are valid for a specific broker, you can put the name of the broker here. You can use the wildcard character '%' to display the subscriptions that are valid for a range of broker names.

  • Users

    If want to display only those subscriptions that are valid for a specific user, you can put the user name here. You can use the wildcard character '%' to display the subscriptions that are valid for a range of user names.

  • Subscription points

    If want to display only those subscriptions that are valid for a specific subscription point, you can put the name of the subscription point here. You can use the wildcard character '%' to display the subscriptions that are valid for a range of subscription points.

You can also specify that you only want to know about subscriptions that were registered on certain dates.

Results of a query

The results of a query is presented in a table in the lower part of the edit window. Each row of the table describes a registered subscription request.

The table has columns that contain the following information:

  • The name of the topic (this might include wildcard characters '#' or '+').
  • The name of the user that registered the subscription.
  • The name of the broker where the subscription was registered.
  • The subscription point (if any) that is associated with the subscription.
  • The date when the subscription was registered.