Monitoring multiple resource types in a CICS system group (1)
This example shows how to monitor both the CDSA and the UDSA free sizes for two CICS® systems, CICSPA01 and CICSPA02, which have already been defined as the only members of CICS system group CSGAORS1.
When either the CDSA or UDSA free size falls below a specified value, an external message and an event notification are to be issued. The severity of the event notification will increase as the DSA free size reduces.
- Create the first 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 RTEPAY05 Description Check CDSA free size Sample interval 60 Resource table CICSDSA Instance identifier of evaluated resource CDSA Result set action No Field being evaluated STGFSIZE Upper bound of range for VLS 70000 Upper bound of range for LS 85000 Upper bound of range for LW 95000 - Click Yes to create the definition.
The evaluation threshold values are based on a CDSA cushion size of 64KB. Increasingly severe conditions will be flagged as the free storage drops closer to the cushion value. (An alternative approach would have been to use percentage measurements (PCTFREE) rather than absolute measures (STGFSIZE).) The resource will be sampled once every 60 seconds.
When you click Yes, the Evaluation definitions tabular view is redisplayed, showing an entry for RTEPAY05.
Note: For a complete description of the Evaluation definition view, see Evaluation definitions. - Create the second evaluation definition:
- On theEvaluation definitions tabular view (EVALDEF object), click the Record check box beside the entry for RTEPAY05.
- Click the Create... button. The Evaluation definitions create view is displayed showing the values entered for RTEPAY05.
- Overtype the Name, Description, Instance identifier
of evaluated resource and the evaluation threshold fields, as
follows:
Leave the other fields with the values used for RTEPA05.Name RTAPAY06 Description Check USDA free size Instance identifier of evaluated resource CDSA Upper bound of range for VLS 70000 Upper bound of range for LS 80000 Upper bound of range for LW 90000 - Click Yes to create the definition.
As for the CDSA evaluation definition, the evaluation threshold values are based on a cushion size of 64KB.
- 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 RTAPAY05 Description DSA free size low below 16MB Generate event Yes Name of view that might provide useful information CICSDSA Action priority 255 Message to send when event occurs Free DSA below 16MB dropping Generate external message Yes External message sent when event occurs Free DSA below 16MB dropping External message sent when event is cleared Free DSA below 16MB climbing 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. - 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 RTDPAY05 Description DSA free below 16MB Analysis interval 300 Evaluation expression RTEPAY05|RTEPAY06 Execute evaluation modification string No Action definition name RTAPAY05 Count of true evaluations before VLS raised 2 Count of false evaluations before VLS resolved 2 Count of true evaluations before LS raised 2 Count of false evaluations before LS resolved 2 Count of true evaluations before LW raised 2 Count of false evaluations before LW resolved 2 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.
The counts of true and false evaluations are used to smooth out fluctuations in the values being seen. For example, an LW condition is not flagged until a severity of at least LW has been seen for two consecutive samples. Each condition is cleared after two, less severe samples have been seen in succession.
The evaluation expression value tells CICSPlex® SM that either of the two evaluation definitions can identify a condition that is to be flagged. The action is the same for both evaluation definitions, and is defined in RTAPAY05.
You would install the analysis definition RTDPAY05 in the CICS system group CSGAORS1 by specifying CSGAORS1 as the scope of the analysis specification.