This topic contains sections marked as revised for this release

WebSphere Message Brokers
File: ab00120_
Writer: Terry Cowling

Reference topic

This build: July 31, 2007 21:16:14

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.

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, the workbench tries to make the connection before it opens the editor. If you click Cancel during this attempt, 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, the edit window 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 the values that are displayed in any of the entry fields in the upper part of the edit window. You can use wildcard characters in the entry fields to display a specified range of subscriptions. The wildcard characters are:
  • A percent character '%' for zero or more characters. For example, 'B%EAD' would match character strings where zero or more characters follow B and precede the string EAD, like BREAD, BEAD, or BROWNBREAD.
  • An underscore character '_' for a single character. For example, '_ATCH' would match five-character strings where any single character precedes the string ATCH, like BATCH, HATCH, or LATCH.

The entry fields are:

  • Topics

    If you don't want to display subscriptions for all topics, you can put a topic name here. You can use the wildcard characters 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 characters to display the subscriptions for a range of broker names.

  • Users

    If you 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 characters to display the subscriptions for a range of user names.

  • Subscription points

    If you 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 characters to display the subscriptions for a range of subscription points.

You can also specify that you want to display subscriptions that were registered between two dates.

Result of a query

The result of a query is displayed 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
  • 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
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:16:14

ab00120_ This topic's URL is: