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:
| 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
| 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
| 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.
|
| 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:
|
| Evaluation type | EVALTYPE | The type of evaluation to be performed. Valid values are:
|
| 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:
|
| 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:
|
| 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:
|
| 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. |