smc_create_filter creates a filter on a data item. Filters limit the number of rows of performance data returned by a view. A filter can be applied to any data item specified in a view. A view can contain one filter per data item. If you include more than one filter in a view, Monitor Client Library uses ANDs to include those filters.
The types of filters available are:
returns only values equal to one of the specified values (logical OR of each Equal comparison)
Not Equal to
returns only values equal to none of the specified value (logical AND of each Not-Equal comparison)
Greater than or equal to
returns values greater than or equal to the specified value
Less than or equal to
returns values less than or equal to the specified value
Range: bottom is less than or equal to value which is less than or equal to top
returns values between the top and bottom values, inclusive
returns the N highest values
A view may contain more than one filter, but any particular data item may only have one filter bound to it. When a view contains more than one filter, the filters are combined with an AND.
You can add or drop filters at any time. The change in filtering takes effect as of the next refresh.
See the code sample on page 24.