Modifying the state of a resource

In this example you’ll see how to use an evaluation definition and an analysis definition to modify a CICS® resource when it is not in the desired state. This example is an extension of the example in Reusing analysis specifications and analysis groups, in which you saw how to monitor files in the CICS system group called CGSAORS1. You will be using the Time Period Def (PDFCHECK) and the Action Def (RTAPAY12) from that example.

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

     ------------------- Create Evaluation Definition for PLXPROD1------------------
     COMMAND  ===>
     
     Name                  ===> RTEPAY12
     Description           ===> REMFILE PAYFILA* enabling
     
     Sample Interval       ===> 60            Interval between samples in seconds
     TableName             ===> REMFILE       Resource Table Name or *
     Instance Pattern      ===> PAYFILA*      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     ===> ENABLESTATUS  Column name to evaluate or *
         either Operator   ===> NE            (EQ,NE,LT,GT,LE,GE)
                Value      ===> ENABLED
                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                  ===> REMFILE       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.

    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)
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     
     Modification string expression:  (Type MODIFY to list modifiable columns)
     ===> ENABLESTATUS=ENABLED, OPENSTATUS=OPEN.
     ===>
     ===>
     ===>
     
     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 modification string expression modifies the ENABLESTATUS and OPENSTATUS attributes to make the specified files available.

  2. Create the 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             ===> RTDPAY14
      Description      ===> Appl file check and modify
      Perform Ops      ===> YES       Perform EVALDEF operations changes (YES, NO)
      Sample Interval  ===> 60        Interval between samples in seconds (1-86400)
      Action Name      ===> RTAPAY12  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:
     ===> RTEPAY12
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     
     Press Enter to create the Analysis Definition.
     Type END or CANCEL to cancel without creating.

    The Perform Ops field indicates that the resource modification defined in the evaluation definition should be performed when the evaluation condition is true.

    Note:
    For a complete description of the RTADEF view, see RTADEF (Analysis definitions).
  3. Associate the new analysis definition with the existing analysis group.

    In the RTADEF view, tab to the entry for RTDPAY14, and issue ADD from the line-command field. The Add RTADEF to Analysis Group panel is displayed.

    In the Analysis Group field, specify RTGPAY02. In the Active Period field, specify PDFCHECK.

The Analysis Group RTGPAY02 already exists and it has already been associated with the analysis specification RTSPAY02. Therefore, analysis definition RTDPAY14 is installed automatically in the CICS systems in group CSGAORS1 when those systems are next started, for the period of time defined in PDFCHECK.

[[ Contents Previous Page | Next Page Index ]]