Managing filters for automatic sets

We can add, edit, copy and delete filters to configure automatic queue manager sets.


Before you begin

Before you add, edit, copy or delete filters:
  1. Enable set visibility as described in: Displaying queue manager sets.
  2. Define a set for the queue managers to be added to or removed from as described in: Defining automatic sets.


To manage filters:


Procedure

  1. Right-click the set you want to manage filters for in the Navigator view, click Edit Set... to open the Edit Set window.
  2. Click Manage Filters to open the Manage Filters window.


What to do next

The following options are available:


Add a new filter

About this task

We can create filters to define which queue managers are grouped in your set.

The following instructions use an example for creating a filter for queue managers.

To create a new filter:

Procedure

  1. Open the Manage Filters dialog, as described previously in Managing filters for automatic sets.
  2. In the Manage Filters dialog, click Add... The Add Filter dialog opens.
  3. In the Add Filter dialog, in the Filter Name field, type a name for the filter; for example, Queues containing more than 50 messages
  4. In the Includes queue managers where fields, we can enter the criteria to add to the new filter. For example, enter the following information:
    1. The first row of fields allows you to filter on the name of the queue manager. By default, the third field contains an asterisk (*) so that all queue managers, regardless of their names, are included in the filter. For example, to include only the queues that start with jupiter, type jupiter*
    2. Optional: We can enter another criteria to the filter based on the value of an attribute of the objects. Select the check box labeled - AND- so that we can edit the fields. For example, to include only queue manager that have a Description field of Payroll, select the attribute Payroll; in the second field, select equal to; in the third field, type Payroll.
  5. Optional: To automatically apply an existing column scheme when the filter is applied, select the check box labeled Automatically apply a Column Scheme when this filter is applied, then select the column scheme from the list.
  6. Click OK. The Add Filter dialog closes. The new filter is displayed in the Manage Filters dialog with any other available filters.
  7. In the Manage Filters dialog, click OK. The Manage Filters dialog closes.

Results

Your new filter will be added to the existing list of available filters.


Edit a filter

About this task

We can edit filters to define which queue managers are grouped in your set.

The following instructions use an example for editing a filter for queue managers.

To edit a filter:

Procedure

  1. Open the Manage Filters dialog, as described previously in Managing filters for automatic sets.
  2. In the Manage Filters dialog, click Edit... The Edit Filter dialog opens.
  3. In the Edit Filter dialog, add, remove, or change the criteria that are set for the filter, then click OK. For more information about the fields in the dialog, see Add a new filter.
  4. Click OK to close the Manage Filters dialog.

Results

The changes to the filter are automatically applied to any tables that are using that filter. MQ Explorer might take several seconds to apply the filters to the queue managers.


Copy a filter

About this task

If you want to create a filter that is similar to an existing one, we can copy the existing filter and then edit it as required. We can copy any filter that we have created previously and we can also copy the filters that are supplied with IBM MQ Explorer; for example, the Command level = 500 filter.

To copy an existing filter:

Procedure

  1. Open the Manage Filters dialog, as described previously in Managing filters for automatic sets.
  2. In the Manage Filters dialog, select the filter you want to copy, then click Copy As... The Edit Filter dialog opens.
  3. In the Copy Filter dialog, type a name for the new filter, then click OK. The copied filter name cannot be the same as an existing filter.
  4. In the Manage Filters dialog, click Edit... The Edit Filter dialog opens.
  5. In the Edit Filter dialog, add, remove, or change the criteria that are set for the filter, then click OK. For more information about the fields in the dialog, see Add a new filter.
  6. Click OK to close the Manage Filters dialog.

Results

The new filter is available to apply.


Remove an existing filter

About this task

To delete and existing filter:

Procedure

  1. Open the Manage Filters dialog, as described previously in Managing filters for automatic sets.
  2. In the Manage Filters dialog, select the filter you want to delete, then click Remove... The Remove Filter confirmation dialog opens.
  3. Click Yes to remove the filter and close the confirmation dialog.
  4. Click OK to close the Manage Filters dialog.

Results

The filter you deleted will be removed from the list of filters for the selected queue manager set. Any queue managers added to the set by the filter will no longer be a member of the set in the Navigator view.