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.
Analysis of PAY8’s response times is not a permanent requirement, but is necessary only until the problem is solved. Because of this, the analysis definition is installed manually in TOR CICSPT02 on request.
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 ===> RTEPAY09 Description ===> PAY8 response times check Sample Interval ===> 300 Interval between samples in seconds TableName ===> MREMTRAN Resource Table Name or * Instance Pattern ===> PAY8 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 ===> CURAVGRESP 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 1.5 3 4 View ===> MREMTRAN 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 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.
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 ===> RTDPAY09 Description ===> PAY8 response times high Perform Ops ===> NO Perform EVALDEF operations changes (YES, NO) Sample Interval ===> 300 Interval between samples in seconds (1-86400) Action Name ===> RTAPAY09 Action definition name or generic VLS LS LW HW HS VHS Entry Intervals ===> 0001 0001 0001 0001 0001 0001 Exit Intervals ===> 0001 0001 0001 0001 0001 0001 Evaluation expression: ===> RTEPAY09 ===> ===> ===> ===> ===> ===> Press Enter to create the Analysis Definition. Type END or CANCEL to cancel without creating.
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 ===> RTAPAY09 Description ===> PAY8 response times high Event ===> YES Generate Event (Yes/No) Event View ===> MREMTRAN View for Event Priority ===> 255 Event Priority (1 to 255) Event Text ===> PAY8 response times too high External Msg ===> YES Generate External Message (Yes/No) Enter Msg ===> PAY8 response times climbing Exit Msg ===> PAY8 response times falling 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. In the RTADEF view, tab to the entry for RTDPAY09, and issue INS from the line-command field. The Install RTADEF panel is displayed. In the Scope field of the Install RTADEF panel type CICST02 and press Enter. The RTADEF view is redisplayed.