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.

Because you are monitoring two resources in this example (UDSA and CDSA), two evaluation definitions are required. Here are the relevant steps:

  1. Create the first 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                  ===> 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.

    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).
  2. Create the second evaluation definition.

    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.

  3. 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   ===> 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.
    Note:
    For a complete description of the ACTNDEF view, see ACTNDEF (Action definitions).
  4. 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             ===> 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.

Note:
For a complete description of the RTADEF view, see RTADEF (Analysis definitions).

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 ]]