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:
Read syntax diagramSkip visual syntax diagram
>>-| logic_expr |--.-------------------------------------------><

logic_expr

   .-AND/OR----------------------------.   
   V                                   |   
|----+-----+--+-| attr_expr |--------+-+------------------------|
     '-NOT-'  '-(--| logic_expr |--)-'     

attr_expr

|--attr--oper--value--------------------------------------------|

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 left to 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 in evaluation definitions

A modification expression can be made up of one or more attribute expressions in the form:
Read syntax diagramSkip visual syntax diagram
   .-,--------------.      
   V                |      
>>---attr--=--value-+--.---------------------------------------><

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.

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.


eyuabbm.html | Timestamp icon Last updated: Sunday, 4 June 2017