When you open a resource view, it might show many resources.
You can apply a filter to show resources with similar resource attributes,
or to locate a single resource. You can filter by one or more resource
attributes that are displayed as columns in the view.
About this task
For most CICS® resource table views, you can filter by one
or more resource attributes in the open view. You can select a value of a resource attribute in the
view, or specify a resource attribute, to filter resources by. These filters are known as
quick filters. Quick filters are retained with the view if you refresh or reopen it,
but are not saved to the view configuration. To add filters to your view configuration for reuse,
you can configure the Filters pane in the CICS View Configurations page. See
Customizing and sharing resource views with the CICS View Configuration page.
Tip: If you often use specific
filters, but with varying filter values, you can create quick filters
with empty values so they are always available when you open the view.
If
you apply multiple filters to a view, the effect is cumulative.
You
can also apply filters when you configure a view. You can filter resources
by any attribute that applies to the view, including attributes that
are not displayed. See Customizing and sharing resource views with the CICS View Configuration page.
Any quick filters are not saved in the view configuration.
If
a view is already configured to apply filters, a Filtered icon
is displayed in the column header of each attribute
that is used for filtering. The status bar in the view indicates that
the records are filtered, and you can hover the mouse over the status
bar to display a tooltip that shows details of the filters that are
applied. Any quick filters that you apply to the open view are cumulative
with the existing filters.
Procedure
- Start from the resource view that you want to filter.
- Ensure that the column for the attribute to filter resources
by is displayed in the view.
-
Specify the value of a resource attribute, or the resource attribute, to use to create the
filter. You cannot filter resources by the regions resource attribute.
- To specify an existing value of a resource attribute, locate the value to filter resources
by in the table. Right-click the value, and then click Add Quick Filter in
the menu.
If it is not already present, a filter toolbar is displayed in the view. A filter field
for the selected attribute is displayed in the filter toolbar. The filter field shows the attribute
name, the default operator for the type of attribute, and the selected value, displayed in the
correct format for the type of attribute. For example, dates, times, and certain storage values are
shown in a convenient to read format in the table, but in the format required for filtering in the
filter field.
The view changes to display only resources that match the filter criteria. A
Filtered icon
is displayed in the column header of the attribute. The status bar in the view shows how
many records are collected and indicates that the records are filtered. If you hover the mouse over
the status bar, a tooltip shows details of the filters that are applied.
- To specify a resource attribute, right-click the column header of that attribute, and then
click Add Quick Filter.
Alternatively, click the View Menu icon
in the toolbar of the view; click Quick Filters; then click the
attribute to filter resources by.
If it is not already present, a filter toolbar is displayed
in the view. A filter field for the selected attribute is displayed in the filter toolbar. The
filter field shows the attribute name, the default operator, and a value field or list, depending on
the type of attribute.
- Optional: To change the operator for the filter,
click the arrow in the operator list then select an operator from
the list.
The list shows valid operators for the type of
attribute.
Restriction: Ensure that you select an operator
that your CICS system connection
supports. For example, a CMCI connection to a CICS TS Version 4 or later system supports all
valid operators for the type of attribute, but some connections support
only the Equal to
(=) operator.
- Optional: Set or change the value to filter by.
If you selected a value of a resource attribute to create the filter, the value is already set.
Use this step if you want to change the value to filter by.
When the attribute has a predefined set of values, click the arrow in the value list then select
a value from the list.
When the attribute does not have a predefined list of values, type the value in the value field,
then press Enter. Your value must be suitable for the type of attribute. For example, if the
attribute is numeric, you can apply a numeric filter, but you cannot apply a text filter. If the
attribute is mixed case, the filter is case-sensitive. If the attribute is uppercase, any lowercase
characters you enter are converted to uppercase.
You can use wildcard characters in the value 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.
Restriction: 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.
If you enter a value that is not valid for the type of attribute, an error icon is displayed. You
can hover the mouse over the error icon to display a tooltip about the error.
The view changes to display only resources that match the filter criteria. A
Filtered icon
is displayed in the column header of the attribute. The status bar
in the view shows how many records are collected and indicates that the records are filtered. If you
hover the mouse over the status bar, a tooltip shows details of the filters that are applied.
- Optional: Repeat the procedure from Step 3 for each filter
that you want to apply to the view.
- Optional: To remove a filter
from the view, click the Remove filter icon
in the corresponding filter field in the
filter toolbar.
- Optional: To remove
all filters from the view, click the Remove all filters icon
in the filter toolbar.
- Optional:
To reset the view to its configured columns, filters and sorting, click the Reset to View Configuration button
in the toolbar
of the view.
Results
The view displays only resources that match the filter criteria. A
Filtered icon
is displayed in the column header of each attribute that is used
for filtering. The status bar in the view shows how many records are collected and indicates that
the records are filtered. If you hover the mouse over the status bar, a tooltip shows details of the
filters that are applied.
If you refresh the view, the current quick filters are retained. If you close the view, the quick
filters are displayed in the filters toolbar and applied to the view the next time that you open the
view.
Filter examples
- Example 1
-
The following example shows a
Name = DFH+T* filter that is applied to the
Programs view. The filtered result shows program resources with names that start with DFH, have any
value for the fourth character, have a T for the fifth character, and are five or more characters in
length.
- Example 2
-
The following example shows a
Name = DFH* and
Share Status =
SHARED filter that is applied to the Programs view. The filtered result shows program
resources with names that start with DFH and with a share status of SHARED.
- Example 3
-
The following example shows a
Name = DFH* and
Concurrent Use
Count > 0 filter that is applied to the Programs view. The filtered result shows program
resources with names that start with DFH and with a concurrent use count of one or more.
- Example 4
-
The following example shows a Tasks view, named Suspended Tasks, that is configured to filter for
tasks with a Run Status of SUSPENDED. An
Attach time >=
2016-04-18T00:02:43.570 and
Transaction ID = COI* quick filter
are applied to the open view. The filtered result shows task resources that are suspended, with an
attach time after the specified time and date, and with transaction IDs that start with COI.