Evaluation definitions
The Evaluation definitions views (EVALDEF objects) display information about the resources in CICS® systems that are to be sampled and evaluated.
When the result of the evaluation is true, an associated analysis definition is used to determine if a notifiable condition has occurred. Examples of how to use this view can be found in Example tasks: real-time analysis.
Filter expressions in evaluation definitions
A filter expression
can be made up of one or more attribute expressions in the form:
where:>>-| logic_expr |--.------------------------------------------->< logic_expr .-AND/OR----------------------------. V | |----+-----+--+-| attr_expr |--------+-+------------------------| '-NOT-' '-(--| logic_expr |--)-' attr_expr |--attr--oper--value--------------------------------------------|
- 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
TERMID='Z AB'To include a single quote or apostrophe in a value, you must repeat the character, like this:DESCRIPTION='October''s Payroll' - 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:
- 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 left to right. You can use parentheses to vary the meaning of a filter expression. For example, this expression:
has a different meaning than this one:attr_expr AND (attr_expr OR attr_expr).(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_exprYou can also negate multiple attribute expressions or even a whole filter expression, like this:
Note that you must place parentheses around the attribute expressions (or the filter expression) to be negated.NOT (attr_expr OR attr_expr).
Modification expressions in evaluation definitions
A modification expression
can be made up of one or more attribute expressions in the form:
where:.-,--------------. V | >>---attr--=--value-+--.---------------------------------------><
- 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.
Creating an evaluation definition
To create
an evaluation definition:
- From the main menu, click Administration views > RTA MAS resource monitoring.
- From the RTA MAS resource monitoring menu, click Evaluations.
- On the Evaluation definitions tabular view (EVALDEF object), click the Create... button. To base the new definition on an existing one, click the Record check box before clicking the Create... button. The Evaluation definitions create view is displayed.
- When you have completed the fields, click the Yes button to create the definition. Otherwise, click No to abandon the process.
