Filter and modification expressions in evaluation definitions

Stabilized feature: CICSPlex® SM Real-Time Analysis (RTA) is stabilized. Consider moving to Policy system rules or to a dedicated monitoring product such as IBM OMEGAMON for z/OS. See also Stabilization notices and discontinued functions.

The Evaluation definitions (EVALDEF) views display information about the resources in CICS® systems that are to be sampled and evaluated.

Filter expressions

A filter expression can be made up of one or more attribute expressions in the form:

logic_expr

attr_expr

where:

attr

Is the name of an attribute in the resource table. You can name the same attribute more than once in a filter expression.

oper

Is one of the following comparison operators:

<: Less than
<=: Less than or equal to
=: Equal to
>=: Greater than or equal to
>: Greater than
¬=: Not equal to

value

Is the value for which the attribute is being tested. The value must be a valid one for the attribute. The value must be a valid output value if the attribute is a CVDA datatype.

If the attribute accepts character data, this value can be a generic. Generic values can contain:

An asterisk (*), to represent any number of characters, including zero. The asterisk must be the last or only character in the specified value. For example:
```
  TRANID=PAY*
```
A plus sign (+), to represent a single character. A + can appear in one or more positions in the specified value. For example:
```
  TRANID=PAY++96
```

If the value contains imbedded blanks or special characters (such as periods, commas, or equal signs), the entire value string must be enclosed in single quotes. For example:

  TERMID='Z AB'

To include a single quote or apostrophe in a value, you must repeat the character, like this:

  DESCRIPTION='October''s Payroll'

AND/OR

Combines attribute expressions into compound logic expressions using the logical operators AND and OR, like this:

  attr_expr AND attr_expr.

Filter expressions are evaluated from the left to the right. You can use parentheses to vary the meaning of a filter expression. For example, this expression:

  attr_expr AND (attr_expr OR attr_expr).

has a different meaning than this one:

  (attr_expr AND attr_expr) OR attr_expr.

NOT

Negates one or more attribute expressions.

You can negate a single attribute expression, like this:

  NOT attr_expr

You can also negate multiple attribute expressions or even a whole filter expression, like this:

  NOT (attr_expr OR attr_expr).

Note that you must place parentheses around the attribute expressions (or the filter expression) to be negated.

Modification expressions

A modification expression can be made up of one or more attribute expressions in the form:

where:

attr

Is the name of a modifiable attribute in the resource table.

value

Is the value to which you want the attribute set. The following restrictions apply:

The value must be a valid one for the attribute.
If the value contains imbedded blanks or special characters (such as periods, commas, or equal signs), the entire value string must be enclosed in single quotes, like this:
```
  DESCRIPTION='Payroll.OCT'
```
To include a single quote or apostrophe in a value, you must repeat the character, like this:
```
  DESCRIPTION='October''s Payroll'
```
The value must be a valid output value if the attribute is a CVDA datatype.