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.

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.

  1. If the current context isn’t PLXPROD1, issue the command CON PLXPROD1 from the current view.
  2. Create an evaluation definition.

    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.

    Note:
    This example does not make use of the second Create Evaluation Definition panel. For a complete description of the EVALDEF view and the panels you use to create one, see EVALDEF (Evaluation definitions).
  3. Create an analysis definition.

    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.
    Note:
    For a complete description of the RTADEF view, see RTADEF (Analysis definitions).
  4. Create an action definition.

    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.
    Note:
    For a complete description of the ACTNDEF view, see ACTNDEF (Action definitions).
  5. Explicitly install the analysis definition.

    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.

[[ Contents Previous Page | Next Page Index ]]