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.
Because you are monitoring two resources in this example (UDSA and CDSA), two evaluation definitions are required. Here are the relevant steps:
From the current view, issue the command EVALDEF. From the EVALDEF view, issue the command CRE. Complete the first Create Evaluation Definition panel as shown here, and press Enter:
------------------- Create Evaluation Definition for PLXPROD1------------------ COMMAND ===> Name ===> RTEPAY05 Description ===> Check CDSA free size Sample Interval ===> 60 Interval between samples in seconds TableName ===> CICSDSA Resource Table Name or * Instance Pattern ===> CDSA Specific or generic pattern Result Set Action ===> MAX Operation(ALL,ANY,SUM,MIN,MAX,AVG,CNT) Separate Task ===> NO Run as a separate task (YES, NO) Evaluation Column ===> STGFSIZE Column name to evaluate or * either Operator ===> (EQ,NE,LT,GT,LE,GE) Value ===> Severity ===> (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 70000 85000 95000 View ===> CICSDSA 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.
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 press Enter, the EVALDEF view is redisplayed, showing an entry for RTEPAY05.
From the EVALDEF view, tab to the entry for RTEPAY05, and issue CRE from the line-command field. The Create Evaluation Definition panel is displayed, showing the values you entered when you created RTEPA05. Overtype the Name, Description, Instance Pattern, and Evaluation Threshold values as shown here, and press Enter:
------------------- Create Evaluation Definition for PLXPROD1------------------ COMMAND ===> Name ===> RTEPAY06 Description ===> Check UDSA free size Sample Interval ===> 60 Interval between samples in seconds TableName ===> CICSDSA Resource Table Name or * Instance Pattern ===> UDSA Specific or generic pattern Result Set Action ===> MAX Operation(ALL,ANY,SUM,MIN,MAX,AVG,CNT) Separate Task ===> NO Run as a separate task (YES, NO) Evaluation Column ===> STGFSIZE Column name to evaluate or * either Operator ===> (EQ,NE,LT,GT,LE,GE) Value ===> Severity ===> (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 70000 80000 90000 View ===> CICSDSA 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.
As for the CDSA evaluation definition, the Evaluation Threshold values are based on a cushion size of 64KB.
From the current view, issue the command ACTNDEF. From the ACTNDEF view, issue the command CRE. Complete the Create Action Definition panel as shown here, and press Enter:
-------------------- Create Action Definition for PLXPROD1 -------------------- COMMAND ===> Action Name ===> RTAPAY05 Description ===> DSA free size low below 16MB Event ===> YES Generate Event (Yes/No) Event View ===> CICSDSA View for Event Priority ===> 255 Event Priority (1 to 255) Event Text ===> Free DSA below 16MB dropping External Msg ===> YES Generate External Message (Yes/No) Enter Msg ===> Free DSA below 16MB dropping Exit Msg ===> Free DSA below 16MB climbing Alert ===> NO Generate Alert (Yes/No) CMAS Name ===> CMAS to Issue Alert Enter Text ===> Exit Text ===> Restart ===> NO Cancel for ARM Restart (Yes/No) Press Enter to create the Action Definition. Type END or CANCEL to cancel without creating.
From the current view, issue the command RTADEF. From the RTADEF view, issue the command CRE. Complete the Create Analysis Definition panel as shown here, and press Enter:
------------------------ Create Analysis Definition for PLXPROD1 -------------- COMMAND ==> Name ===> RTDPAY05 Description ===> DSA free below 16MB Perform Ops ===> NO Perform EVALDEF operations changes (YES, NO) Sample Interval ===> 300 Interval between samples in seconds (1-86400) Action Name ===> RTAPAY05 Action definition name or generic VLS LS LW HW HS VHS Entry Intervals ===> 0002 0002 0002 0001 0001 0001 Exit Intervals ===> 0002 0002 0002 0001 0001 0001 Evaluation expression: ===> RTEPAY05|RTEPAY06 ===> ===> ===> ===> ===> ===> Press Enter to create the Analysis Definition. Type END or CANCEL to cancel without creating.
The Entry and Exit intervals 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.
[[ Contents Previous Page | Next Page Index ]]