Monitoring a resource type in a single CICS system

In this example, you’ll see how to get CICSPlex® SM to monitor the LU 6.2 connections in CICS® system CICSPT02, which has recently been experiencing LU 6.2 problems. Both an external message and an event notification are to be issued whenever any connection is found to be in RELEASED status. The monitoring will not be limited to specific hours of the day, but will be continuous.

The task is fundamentally the same as the one shown in the example Monitoring resources permanently. The interesting differences arise in the creation of the evaluation definition, the action definition, and the analysis definition. Those steps are shown here:

  1. Create an evaluation definition.

    From the current view, issue the EVALDEF command. From the EVALDEF view, issue the CRE command. Complete the first Create Evaluation Definition panel as shown here:

     ------------------- Create Evaluation Definition for PLXPROD1------------------
     COMMAND  ===>
     
     Name                  ===> RTEPAY03
     Description           ===> Connections in CICSPT02
     
     Sample Interval       ===> 30            Interval between samples in seconds
     TableName             ===> CONNECT       Resource Table Name or *
     Instance Pattern      ===> *             Specific or generic pattern
     Result Set Action     ===> ANY           Operation(ALL,ANY,SUM,MIN,MAX,AVG,CNT)
     Separate Task         ===> NO            Run as a separate task (YES, NO)
     
     Evaluation Column     ===> CONNSTATUS    Column name to evaluate or *
         either Operator   ===> EQ            (EQ,NE,LT,GT,LE,GE)
                Value      ===> RELEASED
                Severity   ===> VHS           (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
     
     
     View                  ===> CONNECT       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.

    In this example:

    Issue the DOWN command and complete the second Create Evaluation Definition panel as shown here:

     ------------------- Create Evaluation Definition for EYUPLX01------------------
     COMMAND  ===>
     
     Name                  ===> EYURTE01
     
     Filter string expression:  (Type FILTER to list columns)
     ===> TYPE=LU62.
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     
     Modification string expression:  (Type MODIFY to list modifiable columns)
     ===>
     ===>
     ===>
     ===>
     
     Type DOWN or UP to view other Evaluation Definition screens.
     Press Enter to create Evaluation Definition.
     Type END or CANCEL to cancel without creating.

    In this example, the filter string limits the checking to LU 6.2 connections.

    Note:
    For a complete description of the EVALDEF view, see EVALDEF (Evaluation definitions).
  2. 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   ===> RTAPAY03
      Description  ===> Connections lost in CICSPT02
     
      Event        ===> YES          Generate Event (Yes/No)
       Event View  ===> CONNECT      View for Event
       Priority    ===> 255          Event Priority (1 to 255)
       Event Text  ===> Connections lost in CICSPT02
     
      External Msg ===> YES          Generate External Message (Yes/No)
       Enter Msg   ===> Connections lost in CICSPT02
       Exit Msg    ===> CICSPT02 connections now OK
     
      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.

    This action definition tells CICSPlex SM that you want both an event notification and an external message to be issued.

    Note:
    For a complete description of the ACTNDEF view, see ACTNDEF (Action definitions).
  3. Create an analysis definition.

    Issue the command RTADEF from the current view. 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             ===> RTDPAY03
      Description      ===> Connections in CICSPT02
      Perform Ops      ===> NO        Perform EVALDEF operations changes (YES, NO)
      Sample Interval  ===> 30        Interval between samples in seconds (1-86400)
      Action Name      ===> RTAPAY03  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:
     ===> RTEPAY03
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     
     Press Enter to create the Analysis Definition.
     Type END or CANCEL to cancel without creating.

    (You can allow the Entry Intervals and the Exit Intervals to default to 0001.) CICSPlex SM will evaluate the results of the evaluation definition (defined in RTEPAY03) every 30 seconds.

    You would install the analysis definition in the CICS system CICSPT02 by specifying CICSPT02 as the scope of the analysis specification.

    Note:
    For a complete description of the RTADEF view, see RTADEF (Analysis definitions).
[[ Contents Previous Page | Next Page Index ]]