Filtering resources in specific views

When you open a resource view, it might show a large number of resources. For a small number of older-style views, you can apply a filter in the same way as in CICS Explorer® Version 5.2. You can apply a filter to show resources with similar properties, or to locate a single resource. You can filter on one or more resource attributes at the same time.

About this task

This procedure applies to the Resource Group Definitions view, Group List Definitions view, and a small number of older-style views, as listed in Changing specific resource views. To filter resources in these views, use the following procedure.

For the procedure that applies to most CICS® resource table views, see Filtering resources in a view.

To filter resources, you use one or more filter fields in the toolbar of the view. The name of the attribute to filter by is displayed next to the filter field. By default, each resource view displays one filter field for the key field of that resource, for example the resource name or resource ID. To filter on other attributes, you can add filter fields to the view.

The following example shows the Name filter field, which is the default filter field in a number of views.

Name filter field, Apply filter icon, Clear filter icon, and View Menu icon.

Procedure

  1. Start from the resource view that you want to filter.
  2. Use the following steps to add or remove the filter fields you want to use:
    1. Click the View Menu icon View Menu icon in the view toolbar, then click Choose filter attributes. The menu options show the attributes in the current view, with a check mark by each attribute that has a filter field in the view toolbar.
    2. Click an attribute to select or clear it. The menu closes and the corresponding filter field is added to, or removed from, the view.
    The filter fields that you add or remove are specific to the current view and are not displayed in any other view.
  3. Enter the details you want to match in one or more of the filter fields:
    • If the attribute has a limited list of values, click the filter field and click the required value in the list.
    • If the filter field is a text box, type the details that you want to match.

      If the field is mixed case, the filter is case-sensitive. If the field is uppercase, any lowercase characters you enter are converted to uppercase.

      You can use wildcard characters in the filter field:
      • You can use an asterisk (*) at the end of a filter to match any number of characters in a resource value, including none.
      • You can use one or more plus signs (+) anywhere in the filter, where each plus sign matches any single character in a resource value.
      • You can combine plus signs and an asterisk in a filter, but the asterisk must be the last character in the filter.
      You can use the following expressions in the filter field:
      Expression Description
      == Match the exact value
      > Greater than
      >= Greater than or equal to
      < Less than
      <= Less than or equal to
      ! Not

      You can use these expressions for alphanumeric values. The filter is case sensitive.

      If you enter an expression that is not valid, when you apply the filter, the expression is ignored and a message is displayed in the workbench status bar.

    Restriction: The following restrictions apply to filtering in this version of CICS Explorer:
    • You cannot filter on a field that contains date or time information.
    • For some fields, wildcard characters are not appropriate and do not work. You must enter the full value that you want to match in these fields.
  4. When your entries are complete, press Enter, or click the Apply filter icon Apply filter icon. The information in the view changes to display only resources that match the filter criteria.
  5. Optional: To clear the currently applied filters, click the Clear filter icon Clear filter icon.