Using data gathered by the resource monitoring function
This example shows you how the real-time analysis functions of CICSPlex® SM can interpret data from another CICSPlex SM function—resource monitoring—and issue appropriate notifications when problems occur.
Assume that a key transaction (PAY8) is experiencing poor response times, and that the cause is unclear. Transaction PAY8 is initiated from TOR CICSPT02 in CICSplex PLXPROD1. Appropriate monitoring definitions have been created to monitor the response time of transaction PAY8 at 5-minute intervals. (An example of how to do this is provided in Monitoring transaction response times.) CICSPlex SM's real-time analysis function will examine the data gathered by the resource monitoring function, and will issue an event notification and an external message when the response time is poor. The severity of the event notification will increase in line with the degradation in response times.
- If the current context isn't PLXPROD1, change the Context field on the main menu and click Set.
- Create an evaluation definition:
- From the main menu, click to display the Evaluation definitions tabular view (EVALDEF object).
- Click the Create... button. The Evaluation definitions create view is displayed.
- Complete the fields as follows:
Name RTEPAY09 Description PAY8 response times check Sample interval 300 Resource table MREMTRAN Instance identifier of evaluated resource PAY8 Result set action MAX Field being evaluated CURAVGRESP Upper bound of range for HW 1.5 Upper bound of range for HS 3 Upper bound of range for VHS 4 - Click Yes to create the definition.
The evaluation threshold values are response times in seconds. Thus, an average response time of 4 in any one sampling, for example, will be flagged as VHS. (Note that, although a Result Set Action value has been specified, it has no particular effect in this example. It is most useful when multiple resources are being evaluated, rather than one. For example, if you had specified an instance pattern of PAY* and a Result Set Action value of MAX, the maximum average response time of transactions PAY* would be used by CICSPlex SM in determining whether to flag a condition.
Note: This example does not make use of the second Create Evaluation Definition panel. For a complete description of the Evaluation definitions view and the panels you use to create one, see Evaluation definitions. - Create an analysis definition:
- From the main menu, click to display the RTA definitions tabular view (RTA object).
- Click the Create... button. The RTA definitions create view is displayed.
- Complete the fields as follows:
Name RTDPAY09 Description PAY8 response times high Analysis interval 300 Evaluation expression RTEPAY09 Execute evaluation modification string No Action definition name RTAPAY09 Count of true evaluations before VLS raised 1 Count of false evaluations before VLS resolved 1 Count of true evaluations before LS raised 2 Count of false evaluations before LS resolved 1 Count of true evaluations before LW raised 1 Count of false evaluations before LW resolved 1 Count of true evaluations before HW raised 1 Count of false evaluations before HW resolved 1 Count of true evaluations before HS raised 1 Count of false evaluations before HS resolved 1 Count of true evaluations before VHS raised 1 Count of false evaluations before VHS resolved 1 - Click Yes to create the definition.
Note: For a complete description of the RTA definitions view, see RTA definitions. - Create an action definition:
- From the main menu, click to display the Action definitions tabular view (ACTION object).
- Click the Create... button. The Action definitions create view is displayed.
- Complete the fields as follows:
Name RTAPAY09 Description PAY8 response times high Generate event Yes Name of view that might provide useful information MREMTRAN Action priority 255 Message to send when event occurs Free DSA below 16MB dropping Generate external message Yes External message sent when event occurs PAY8 response times climbing External message sent when event is cleared PAY8 response times dropping Generate SNA generic alert No MVS automatic restart No - Click Yes to create the definition.
Note: For a complete description of the Action definitions view, see Action definitions. - Explicitly install the analysis definition:
- From the main menu, click to display the RTA definitions tabular view.
- Click the Record check box beside the entry for RTDPAY09 and click the Install... button. The Install view is displayed.
- Type CICST02 into the Scope value field and click Yes to install the analysis definition.
The RTA definitions tabular view is redisplayed.