Evaluations - EVALDEF

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

Supplied views

To access from the main menu, click:

Administration views > RTA analysis point monitoring > Evaluations

Table 1. Views in the supplied Evaluation definitions (EVALDEF) view set
View Notes
Evaluation definitions

EYUSTARTEVALDEF.CREATE

Create an evaluation definition and add it to the data repository.
Evaluation definitions

EYUSTARTEVALDEF.DETAILED

Detailed information about a selected evaluation definition
Evaluation definitions

EYUSTARTEVALDEF.REMOVE

Remove an evaluation definition from the data repository.
Evaluation definitions

EYUSTARTEVALDEF.TABULAR

Tabular information about all evaluation definitions for the CICSplex identified as the context.

Actions

Table 2. Actions available for EVALDEF views
Action Description
CREATE Create an evaluation definition and add it to the data repository.
REMOVE Remove an evaluation definition from the data repository.
UPDATE Update a selected evaluation definition in the data repository.

Fields

Table 3. Fields in EVALDEF views
Field Attribute name Description
Application name APPLICATION (Optional) For the evaluation of private resources, this identifies the application component of the application context to be applied to the evaluation query. If a value is specified for this parameter, then values must also be specified for PLATFORM, APPLMAJORVER, APPLMINORVER and APPLMICROVER.
Application major version APPLMAJORVER (Optional) For the evaluation of private resources, this identifies the application major version component of the application context to be applied to the evaluation query. If a value is specified for this parameter, then values must also be specified for PLATFORM, APPLICATION, APPLMINORVER and APPLMICROVER.
Application micro version APPLMICROVER (Optional) For the evaluation of private resources, this identifies the application micro version component of the application context to be applied to the evaluation query. If a value is specified for this parameter, then values must also be specified for PLATFORM, APPLICATION, APPLMAJORVER and APPLMINORVER.
Application minor version APPLMINORVER (Optional) For the evaluation of private resources, this identifies the application minor version component of the application context to be applied to the evaluation query. If a value is specified for this parameter, then values must also be specified for PLATFORM, APPLICATION, APPLMAJORVER and APPLMICROVER.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
Last modification CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification.
Time created CREATETIME The local time when the definition was created.
Description DESC A 1- to 58-character description of the evaluation definition.
Description code page DESCCODEPAGE The code page of the description field.
Field being evaluated EVALCOL The name of a column within the CICSPlex SM resource table that is to be evaluated.

After identifying the column to be evaluated, you must determine the type of evaluation to be performed. You can specify either an evaluation value and its associated operator and severity, or evaluation threshold values. Note, however, that these two types of evaluation are mutually exclusive.

Evaluation data value EVALDATA (Evaluation Type: VALUE) A value or keyword to be used in determining if the contents of the Field being evaluated (EVALCOL) meet the evaluation criteria.
Evaluation logical operator EVALOPER (Evaluation Type: VALUE) The logical operator to be used in determining if the contents of the Field being evaluated (EVALCOL) meet the evaluation criteria. The valid operators are:
  • EQ
    • Equal to
  • NE
    • Not equal to
  • LT
    • Less than
  • GT
    • Greater than
  • LE
    • Less than or equal to
  • GE
    • Greater than or equal to
Evaluation type EVALTYPE The type of evaluation to be performed. Valid values are:
  • VALUE
    • Whether the field being evaluated meets a specific value. The associated values are:
      • Evaluation logical operator (EVALOPER)
      • Evaluation data value (EVALDATA)
      • Severity assigned when result meets criteria (SEVERITY)
  • THRESHOLD
    • A range of threshold values which the field being evaluated must meet. The associated values are:
      • Upper bound of range for VLS (VLSDATA)
      • Upper bound of range for LS (LSDATA)
      • Upper bound of range for LW (LWDATA)
      • Lower bound of range for HW (HWDATA)
      • Lower bound of range for HS (HSDATA)
      • Lower bound of range for VHS (VHSDATA)
Filter string FILTER (Optional) Identifies attributes in the specified resource table that are to be used to qualify the condition described in the evaluation fields.

A filter expression can be made up of one or more attribute expressions in the form 'attribute operator value'. Valid operators are <, <=, =, =>, > and ¬=. Attribute expressions can be combined using AND or OR operators, parentheses to group expressions and NOT to negate an expression.

If a value contains embedded blanks or special characters (including periods, commas or equal signs) the entire value must be enclosed in single quotes. If a single quote is included in a value it should be converted to two single quotes.

The filter expression must be terminated with a period.

Get parameters GETPARMS (Optional) Identifies parameters to be used during the execution of this evaluation definition. These must be valid user specifiable GET parameters for the resource table that is associated with this evaluation definition. Multiple parameters can be specified, and must be separated by a space. The total string can be from 1 to 42 characters in length and must be terminated by a period.
Lower bound of range for HS HSDATA (Evaluation Type: THRESHOLD) Lower threshold boundary for the range of values which will be assigned a severity of high severe (HS) when the evaluation criteria is met.

The upper boundary is set by the value for very high severe (VHSDATA).

High warning values can be set for either bidirectional thresholds, evaluating both high and low conditions by specifying the VLSDATA, LSDATA, LWDATA, HWDATA, HSDATA and VHSDATA threshold values, or for unidirectional thresholds which evaluate only on low conditions for HWDATA, HSDATA and VHSDATA.
Lower bound of range for HW HWDATA (Evaluation Type: THRESHOLD) Lower threshold boundary for the range of values which will be assigned a severity of high warning (HW) when the evaluation criteria is met.

The upper boundary is set by the value for high severe (HSDATA).

High warning values can be set for either bidirectional thresholds, evaluating both high and low conditions by specifying the VLSDATA, LSDATA, LWDATA, HWDATA, HSDATA and VHSDATA threshold values, or for unidirectional thresholds which evaluate only on low conditions for VLSDATA, LSDATA and LWDATA.
Instance identifier of evaluated resource INSTANCE Enter a specific resource name or a pattern for the resource occurrences you want to evaluate. A pattern can include the characters + (plus sign), * (asterisk), or both.

This field only applies to the primary key of the resource. For resources with multiple keys, use it in combination with FILTER to provide greater accuracy.

Upper bound of range for LS LSDATA (Evaluation Type: THRESHOLD) Upper threshold boundary for the range of values which will be assigned a severity of low severe (LS) when the evaluation criteria is met.

The lower boundary is set by the value for very low severe (VLSDATA).

Low severe values can be set for either bidirectional thresholds, evaluating both high and low conditions by specifying the VLSDATA, LSDATA, LWDATA, HWDATA, HSDATA and VHSDATA threshold values, or for unidirectional thresholds which evaluate only on low conditions for VLSDATA, LSDATA and LWDATA.
Upper bound of range for LW LWDATA (Evaluation Type: THRESHOLD) Upper threshold boundary for the range of values which will be assigned a severity of low warning (LW) when the evaluation criteria is met.

The lower boundary is set by the value for low severe (LSDATA).

Low warning values can be set for either bidirectional thresholds, evaluating both high and low conditions by specifying the VLSDATA, LSDATA, LWDATA, HWDATA, HSDATA and VHSDATA threshold values, or for unidirectional thresholds which evaluate only on low conditions for VLSDATA, LSDATA and LWDATA.
Name NAME The 1- to 8-character name for the evaluation definition. The name can contain alphabetic, numeric, or national characters. However, the first character must be alphabetic.
Modification string OPRSTRING (Optional) Identifies attributes in the specified resource table that are to be modified if the condition described by this evaluation definition becomes true.

The modification string attempts to change the current value of a modifiable resource attribute by using the SET command. The string, that defines which attribute changes are to be made, can be made up of one or more attribute expressions separated by commas and terminated with a period.

The modification will be attempted only if the RTA definition (RTADEF) Execute evaluation modification string (EXEC_OPS) attribute requests it.
Platform name PLATFORM (Optional) For the evaluation of private resources, this identifies the platform component of the application context to be applied to the evaluation query. If a value is specified for this parameter, then values must also be specified for APPLICATION, APPLMAJORVER, APPLMINORVER and APPLMICROVER.
Qualifier data value QUALDATA An alphanumeric value or keyword to be used in determining if the contents of the evaluation column meet the evaluation criteria. This value must be a valid attribute value for the resource table column being evaluated. The value must be a valid output value if the attribute is a CVDA datatype.
Qualifier logical operator QUALOPER The logical operator to be used in determining if the contents of the evaluation column meet the evaluation criteria. The valid operators are:
  • LT
    • Less than
  • LE
    • Less than or equal to
  • EQ
    • Equal to
  • GE
    • Greater than or equal to
  • GT
    • Greater than
  • NE
    • Not equal to
Sample interval SAMPLE How long, in seconds, CICSPlex SM is to wait between the collection of sample data. The value must be between 1 and 86400.

If the Resource Table name field identifies a monitor resource table and monitoring for that resource category is active, this sample interval value is ignored. Instead, the sample interval specified for the appropriate monitor specification is used. To prevent this from occurring, specify the equivalent operations resource table in the Table name field, rather than the monitor table.

Separate task indicator SEPTASK Specify YES or NO to indicate whether the evaluation process should run as a separate system task.

The default value of NO allows the evaluation process to run under the MAS long running task (LRT). Depending on the type of evaluation and the number of resources involved, running under the LRT may prevent user tasks with the same priority (255) from running.

If you specify YES, a separate task (COIR) is attached to process this evaluation definition. The priority of the task is set according to the value of the COIRTASKPRI system parameter. If COIRTASKPRI is set to 0, a separate task is not started for any evaluation definition.

If the MAS is CICS TS Version 5.4 or later, these tasks are system tasks.

Method of evaluating results in result set SETACTION Specify how the information about the resource occurrences is to be evaluated, as:
  • ALL
    • Compare the information against the evaluation criteria. If the result shows all occurrences of the resource within the current sample are true, set a true condition.

      This action is not supported when evaluating threshold values.

  • ANY
    • Compare the information against the evaluation criteria. If the result shows any occurrence of the resource within the current sample is true, set a true condition.

      This action is not supported when evaluating threshold values.

  • AVG
    • Process the information and compare the resulting average value against the evaluation criteria. If the result for the current sample is true, set the condition true.

      This action is available for numeric data only. If you specify this action, you cannot request a modification operation in the Modification String expression field.

  • CNT
    • Compare the number of resource occurrences against the evaluation criteria. If the result for the current sample is true, set the condition true.

      If you specify this action, you cannot request a modification operation in the Modification string expression field.

      You cannot specify an evaluation column with CNT.

  • MAX
    • Process the information and compare the resulting maximum value against the evaluation criteria. If the result for the current sample is true, set the condition true.
  • MIN
    • Process the information and compare the resulting minimum value against the evaluation criteria. If the result for the current sample is true, set the condition true.
  • SUM
    • Total the information and compare the sum against the evaluation criteria. If the result for the current sample is true, set the condition true.

      This action is available for numeric data only. If you specify this action, you cannot request a modification operation in the Modification string expression field.

Severity assigned when result meets criteria SEVERITY (Evaluation Type: VALUE) The severity level to be assigned when the resource occurrence meets the evaluation criteria. The severity levels are:
  • VLS
    • Very low severe
  • LS
    • Low severe
  • LW
    • Low warning
  • HW
    • High warning
  • HS
    • High severe
  • VHS
    • Very high severe
Resource table TABLE The name of a CICSPlex SM resource table that identifies the resource category you want to evaluate.

When specifying a table name, consider where the evaluation definition and its associated analysis definition will be installed. The definitions may be installed in a variety of CICSPlex SM managed CICS systems, however, not all resource tables are supported in all CICS systems. Therefore, when the definitions are installed, CICSPlex SM determines whether the target system supports the resource table.

Lower bound of range for VHS VHSDATA (Evaluation Type: THRESHOLD) Lower threshold boundary for the range of values which will be assigned a severity of very high severe (VHS) when the evaluation criteria is met. Very high severe values can be set for either bidirectional thresholds, evaluating both high and low conditions by specifying the VLSDATA, LSDATA, LWDATA, HWDATA, HSDATA and VHSDATA threshold values, or for unidirectional thresholds which evaluate only on high RTA conditions for HWDATA, HSDATA and VHSDATA.
View that may provide extra information VIEW The name of the CICSPlex SM view that is to appear in the View field when a notifiable condition occurs. This field should identify the view associated with the resource table specified in the Table Name field.
Upper bound of range for VLS VLSDATA (Evaluation Type: THRESHOLD) Upper threshold boundary for the range of values which will be assigned a severity of very low severe (VLS) when the evaluation criteria is met. Very low severe values can be set for either bidirectional thresholds, evaluating both high and low conditions by specifying VLSDATA, LSDATA, LWDATA, HWDATA, HSDATA and VHSDATA threshold values, or for unidirectional thresholds which evaluate only on low conditions for VLSDATA, LSDATA and LWDATA.


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