An evaluation definition identifies the resources in one or more CICS® systems that are to be sampled and evaluated. (For more information about these resources, see the CICSPlex SM Resource Tables Reference book.) 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.
To display information about existing evaluation definitions, issue the command:
EVALDEF [evaldef]
where evaldef is the specific or generic name of an evaluation definition. If you omit this parameter, the resulting view, illustrated in Figure 15, includes information about all evaluation definitions for the CICSplex identified as the context.
27FEB2005 18:29:18 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =EVALDEF===========EYUPLX01=EYUPLX01=27FEB2005==18:29:18=CPSM=========10=== CMD Name Table Column Name Intvl Description --- -------- -------- ------------ ----- ------------------------------ EYURTELC MAS 60 SSet - Licence EYURTE01 CONNECT CONNSTATUS 300 SSet - All connections EYURTE02 LOCFILE ENABLESTATUS 60 SSet - Local File DFHCSD EYURTE16 LOCFILE EMPTYSTATUS 300 SSet - Empty required on files EYURTE17 DBCTLSS MAXTHRDCNT 300 SSet - DBCTL maxthreads EYURTE18 CICSRGN DTRPROGRAM 300 SSet - DTR not set correctly EYURTE19 CICSRGN MONSTAT 300 SSet - MONITORING inactive EYURTE20 CICSDSA PCTFREE 300 SSet - DSA free space EYURTE21 EVENT 300 SSet - Outstanding EVENTs EYURTE22 TRANDUMP TDMPSUPP 300 SSet - Dump suppression
Table 12 summarizes the action commands you can use with the EVALDEF view.
Primary command | Line command | Description |
---|---|---|
n/a | BRO | Browse an evaluation definition in the data repository.
The format of the resulting panel is similar to that shown in Figure 16. The panel fields are not modifiable. |
CREate | CRE | Create an evaluation definition and add it to the data repository,
as described in Creating an evaluation definition.
When you use the primary command CREate, some fields in the new view may contain values supplied by CICSPlex® SM; you may change these values. When you enter the line command CRE next to the name of an evaluation definition, fields in the new view contain values to be modelled (from the existing evaluation definition). |
n/a | MAP | Display a visual map of real-time analysis definitions using the specified definition as a starting point. |
n/a | REM | Remove an evaluation definition from the data repository. |
TEMPMP cmasid | n/a | Change the temporary maintenance point CMAS to a specific CMAS or display a selection list based on a generic CMAS ID. |
n/a | UPD | Update an evaluation definition in the data repository.
The format of the resulting panel is similar to the panel shown in Figure 16. You can modify the contents of any field in the panel except Name. |
There are no hyperlink fields on the EVALDEF view.
When you use the create primary (CREate) or line (CRE) action command from the EVALDEF view, a sequence of two panels is produced. The first panel includes all of the fields that are required to create an evaluation definition. The second panel contains optional fields for qualifying the evaluation and defining modifications to be made when the specified condition becomes true.
Figure 16 shows the format of the first panel produced when you are creating an evaluation definition.
------------------- Create Evaluation Definition for EYUPLX01------------------ COMMAND ===> Name ===> EYURTE01 Description ===> Evaluate transaction status Sample Interval ===> 60 Interval between samples in seconds Table Name ===> LOCTRAN Resource Table Name or * Instance Pattern ===> * Specific or generic pattern Result Set Action ===> ANY Operation (ALL,ANY,SUM,MIN,MAX,AVG,CNT) Separate Task ===> NO Run as a separate task (YES, NO) Evaluation Column ===> STATUS Column name to evaluate or * either Operator ===> NE (EQ,NE,LT,GT,LE,GE) Value ===> ENABLED Severity ===> HS (VLS,LS,LW,HW,HS,VHS) or set Thresholds: Provide 3 low and/or 3 high values, N=Normal VLS LS LW (N) HW HS VHS View Invoked ===> LOCTRAN View invoked for this Evaluation Type DOWN or UP to view other Evaluation Definition screens. Press Enter to create Evaluation Definition. Type END or CANCEL to cancel without creating.
Provide the following information, as appropriate.
If the 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.
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.
Refer to the CICSPlex SM Resource Tables Reference book for a detailed description of each table.
This action is not supported when evaluating threshold values.
This action is not supported when evaluating threshold values.
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.
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.
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.
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 started to process this evaluation definition. The priority of the task is set according to the value of the COIRTASKPRI system parameter.
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.
Use evaluation values when your criteria involves numeric data, keywords (such as ENABLED, OPEN, or YES), or Boolean operators. To use a value as your evaluation criteria, specify the following:
In Figure 16, for example, if a local transaction (LOCTRAN) is found to have a status not equal to ENABLED, the evaluation is true and a severity of high severe (HS) is assigned.
Alternatively, you can establish a range of threshold values for the resource occurrence that, if met, result in varying severity levels. To use thresholds as your evaluation criteria, specify the following:
For severity levels to the left of normal (N), the specified threshold is the upper bound. For severity levels to the right of normal (N), the specified threshold is the lower bound.
For example, if the evaluation thresholds are:
VLS LS LW (N) HW HS VHS
1 3 5 7 9 11
then:
You may specify the values in either ascending or descending numerical order.
Also, it is possible to specify unidirectional thresholds, evaluating for only a high or low condition, but not both. To use only half of the evaluation threshold range, specify threshold values either for VLS, LS, and LW or for VHS, HS, and HW. When you specify values for only half of the threshold range, the fields in the other half must be blank.
If the evaluation definition is complete, press Enter to add it to the data repository. If you want to qualify the evaluation or define modifications to be made, issue the DOWN command.
Figure 17 shows the format of the panel produced when you issue the DOWN command.
------------------- Create Evaluation Definition for EYUPLX01------------------ COMMAND ===> Name ===> EYURTE01 Filter string expression: (Use FILTER command to list columns) ===> PROGRAM=AB* AND (USECOUNT>0 OR RESTARTCNT>0). ===> ===> ===> ===> ===> ===> ===> ===> ===> Modification string expression: (Use MODIFY command to list alterable columns) ===> STATUS=ENABLED. ===> ===> ===> Type DOWN or UP to view other Evaluation Definition screens. Press Enter to create Evaluation Definition. Type END or CANCEL to cancel without creating.
Provide the following information, as appropriate.
In Figure 17, for example, only those local transactions that have a first program name beginning with AB and either a use count greater than 0 or a restart count greater than 0 are evaluated.
A filter expression can be made up of one or more attribute expressions in the form:
Filter Expression >>-| logic_expr |--.------------------------------------------->< logic_expr: .-AND/OR----------------------------. V | |----+-----+--+-| attr_expr |--------+-+------------------------| '-NOT-' '-(--| logic_expr |--)-' attr_expr: |--attr--oper--value--------------------------------------------|
where:
If the attribute accepts character data, this value can be a generic. Generic values can contain:
TRANID=PAY*
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’
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.
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.
To see a list of the attributes in the resource table, type FILTER in the COMMAND field and press Enter. Figure 18 shows the format of the panel produced when you issue the FILTER command. For more information on these attributes, see the CICSPlex SM Resource Tables Reference book.
-------------------------- List of CICSplex Resources------------- Row 1 of 34 COMMAND ===> Scroll ==> PAGE Available columns in resource table: LOCTRAN ColumnName Type Len Description ------------ ------ ----- ------------------------------ CMDSEC CVDAS 00004 Command security DTB CVDAS 00004 Dynamic Trans Bacout Option DTIMEOUT BINARY 00004 Data Timeout DUMPING CVDAS 00004 Dumping Option INDOUBTWAIT CVDAS 00004 Transaction Indoubtwait option ISOLATEST CVDAS 00004 Isolation status LOCALCNT BINARY 00004 Times run local via DTR PRIORITY BINARY 00004 Priority PROFILE CHAR 00008 Transaction Profile PROGRAM CHAR 00008 First program name PURGEABILITY CVDAS 00004 Purgability ( SPURGE ) RUNAWAY BINARY 00004 Runaway time in milliseconds RUNAWAYTYPE CVDAS 00004 Runaway time type
A modification expression can be made up of one or more attribute expressions in the form:
Modification Expression .-,--------------. V | >>---attr--=--value-+--.---------------------------------------><
where:
DESCRIPTION=‘Payroll.OCT’
DESCRIPTION=‘October''s Payroll’
To see a list of attributes in the resource table that can be modified, type MODIFY in the COMMAND field and press Enter. Figure 19 shows the format of the panel produced when you issue the MODIFY command. For more information on these attributes, see the CICSPlex SM Resource Tables Reference book.
-------------------------- List of CICSplex Resources------------- Row 1 of 10 COMMAND ===> Scroll ==> PAGE Available columns in resource table: LOCTRAN ColumnName Type Len Description ------------ ------ ----- ------------------------------ DUMPING CVDAS 00004 Dumping Option PRIORITY BINARY 00004 Priority PURGEABILITY CVDAS 00004 Purgability ( SPURGE ) RUNAWAY BINARY 00004 Runaway time in milliseconds RUNAWAYTYPE CVDAS 00004 Runaway time type SHUTDOWN CVDAS 00004 Shutdown run status STATUS CVDAS 00004 Enabled Status TRACING CVDAS 00004 Tracing option TRANCLASS CHAR 00008 Transaction Class TRANID CHAR 00008 Name **************************** Bottom of Data *********************************