Using real-time analysis to select a target region for workload balancing

Start of changeThis end user interface (EUI) example End of changedescribes how to use CICSPlex® SM’s real-time analysis functions to produce data that will help in the selection of a target region during workload balancing. In particular, the number of items on the temporary storage queue will be monitored for each target region to which work can be routed. When the number of items goes above 50, a real-time analysis event notification (severity HS) and an external message will be issued. When an event notification is issued, CICSPlex SM’s workload-balancing function is notified and uses the information, in addition to the standard queue algorithm criteria, in selecting the best target region.

Note:
For a complete description of the real-time analysis views used in this example, see CICSPlex SM Managing Resource Usage.

A CICS system group CSGTGTS3 has already been created and contains four target regions (CICSPA01, CICSPA02, CICSPA03, and CICSPA04). The target regions are currently running. Work is currently being balanced among these target regions by the routing region CICSPT03.

  1. If the current context isn’t PLXPROD1, issue the command CON PLXPROD1 from the current view.
  2. Create a real-time analysis 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                  ===> RTEPAY15
     Description           ===> TSQ NUMITEMS > 50
     
     Sample Interval       ===> 300           Interval between samples in seconds
     TableName             ===> MTSQGBL       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     ===> PUTQAUX       Column name to evaluate or *
         either Operator   ===> GT            (EQ,NE,LT,GT,LE,GE)
                Value      ===> 50
                Severity   ===> HS            (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                  ===> MTSQGBL       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.
  3. Create a real-time analysis 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   ===> RTAPAY15
      Description  ===> NUMITEMS IN TSQ > 50
     
      Event        ===> YES          Generate Event (Yes/No)
       Event View  ===> TSQ          View for Event
       Priority    ===> 255          Event Priority (1 to 255)
       Event Text  ===> AUX TSQUEUE PUTQ ITEMS > 50
     
      External Msg ===> YES          Generate External Message (Yes/No)
       Enter Msg   ===> AUX TSQUEUE PUTQ ITEMS > 50
       Exit Msg    ===> AUX TSQUEUE PUTQ ITEMS < 50
     
      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.
  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             ===> RTDPAY15
      Description      ===> TSQ NUMITEMS FOR WLM / RTA
      Perform Ops      ===> NO        Perform EVALDEF operations changes (YES, NO)
      Sample Interval  ===> 300       Interval between samples in seconds (1-86400)
      Action Name      ===> RTAPAY15  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:
     ===> RTEPAY15
     ===>
     ===>
     ===>
     ===>
     ===>
     ===>
     
     Press Enter to create the Analysis Definition.
     Type END or CANCEL to cancel without creating.
  5. Create an analysis group.

    From the current view, issue the command RTAGROUP. From the RTAGROUP view, issue the command CRE. Complete the Create Analysis Group panel as shown here, and press Enter.

     ------------------------- Create Analysis Group for PLXPROD1-----------
     COMMAND  ===>
     
      Group Name          ===>  RTGPAY09
      Description         ===>  RTA/WLM Group
     
     
     
     
     
    Press Enter to create Analysis Group.
    Type END or CANCEL to cancel without creating.

    The RTAGROUP view is redisplayed.

  6. Add the analysis definition to the analysis group.

    From the current view, issue the command RTADEF. In the RTADEF view, tab to the entry for RTDPAY15 and issue ADD in the line-command field. The Add RTADEF to Analysis Group panel is displayed. Complete the panel as shown here, and press Enter.

     ------------------ Add RTADEF to Analysis Group for PLXPROD1 -----------------
     COMMAND  ===>
     
      Name                      RTDPAY15
      Description               TSQ NUMITEMS FOR WLM/RTA
     
      Analysis Group       ===> RTGPAY09      Analysis Group or Generic
      Active Period        ===>               Period Name or Generic
     
    Press Enter to add RTADEF to Analysis Group.
    Type END or CANCEL to cancel without adding.

    The RTADEF view is redisplayed.

  7. Create an analysis specification.

    From the current view, issue the command RTASPEC. From the RTASPEC view, issue the command CRE. Complete the Create Analysis Specification panel as shown here, and press Enter.

     ----------------------- Create Analysis Specification for PLXPROD1 ------------
     COMMAND  ===>
     
      RTA Spec Name     ===> RTSPAY09
      Description       ===> Workload balancing with RTA
     
      System availability management:
     
                     Action or Generic    Severity
      SAM                 =>           =>
      SOS                 =>           =>
      SYSDUMP             =>           =>
      TRANDUMP            =>           =>
      MAXTASK             =>           =>
      STALL               =>           =>
     
    Press Enter to create the RTA Specification.
    Type END or CANCEL to cancel without creating.

    You can ignore the System availability management fields.

  8. Add the analysis group to the analysis specification.

    From the current view, issue the command RTAGROUP. In the RTAGROUP view, tab to the entry for RTGPAY09 and issue ADD from the line-command field. Complete the panel as shown here and press Enter.

    -------------Add Analysis Group to Analysis Specification for EYUPLX01 ---------
     COMMAND  ===>
     
      Analysis Group            RTGPAY09
      Description               RTA/WLM Group
     
      Specification Name  ===>  RTSPAY09   Specification Name or Generic
     
     
    Press Enter to add RTA Group to RTA Specification.
    Type END or CANCEL to cancel without adding.
  9. Set the scope of the analysis specification.

    Tab to the entry for RTSPAY09 in the RTASPEC view and issue the command ADD from the line-command field. In the Scope field of the Add Scope for Specification panel, type CSGTGTS3. In the Option field, type FORCE. Press Enter. The RTASPEC view is redisplayed.

  10. Activate real-time analysis in the target regions in CSGTGTS3.

    From the current view, issue the command CICSSYS. In the CICSSYS view, tab to the entry for CICS® system CICSPA01 and issue UPD from the line-command field. Page forward to the Update system - Analysis Attributes panel. Complete the panel as shown here, and press Enter:

    --------------- Update System - Analysis Attributes - for PLXPROD1-------------
    COMMAND ===>
     
     System Name      CICSPA01
     Description      Target region 1 on System A
     
     Analysis active         ===> YES     Activate at RTA startup
     Analysis specification               Current RTASPEC
     Specification source                 Type of link to RTASPEC
     System group name                    System group if implicit source
     
     System availability management:
                       Action or   Action      Severity        Severity
                        Generic    Inherit                     Inherit
      SAM         ===>              ===> NO    ===>           ===> NO
      SOS         ===>              ===> NO    ===>           ===> NO
      SYSDUMP     ===>              ===> NO    ===>           ===> NO
      TRANDUMP    ===>              ===> NO    ===>           ===> NO
      MAXTASK     ===>              ===> NO    ===>           ===> NO
      STALL       ===>              ===> NO    ===>           ===> NO
     
     
    Type DOWN or UP to view other System Screens.
    Press ENTER to Update the System.
    Type END or CANCEL to cancel without updating.

    When you press Enter, the CICS system definition is updated and the change, which is permanent, takes immediate effect. You do not have to restart CICS system CICSPA01. Repeat this step for the target regions CICSPA02, CICSPA03, and CICSPA04.

  11. Update the workload specification.

    The workload specification WLSPAY02 is already being used for workload balancing among the target regions in CSGTGTS3. You have to update the specification to add the real-time analysis data to the standard target region-selection criteria.

    Issue the command WLMSPEC from the current view. On the WLMSPEC view, tab to the entry for WLMPAY02. From the WLMSPEC view, issue the command UPD. Complete the Update WLM Specification panel as shown here, and press Enter:

     -------------------- Update WLM Specification for PLXPROD1 --------------------
     COMMAND  ===>
     
      WLM Spec Name       ===> WLSPAY02
      Description         ===> Workload using RTA for target region selection
      Affinity Relation   ===>              Default Affinity Relation
                                     (USERID, LUNAME, GLOBAL, BAPPL)
     
      Affinity Lifetime   ===>              Default Affinity Lifetime
                                     (SIGNON, LOGON, SYSTEM, PERMANENT, PCONV, DELIM
                                      ACTIVITY, PROCESS)
      Match Key           ===> USERID       Default Primary search criterion
                                     (USERID,LUNAME)
      Create Affinity     ===>              Create Auto Affinity (YES, NO, N/A)
      Target Scope        ===> CSGTGTS3     Default CICS System,Group or Generic
     
      Event Name          ===> RTDPAY15     RTADEF, STATDEF, or Generic
     
      Abend Health        ===> 0            Target ABEND Health Factor (0 - 99)
      Abend Load          ===> 0            Target ABEND Load Factor (0 - 99)
      Algorithm Type      ===> QUEUE        Algorithm Type (GOAL, QUEUE)
     
     
    Press Enter to update WLM Specification.
    Type END or CANCEL to cancel without updating.

    Notice that the Event Name value is the name of the analysis definition you created in step 4.

    Note:
    For a complete description of the WLMSPEC view, see WLMSPEC (Workload specifications).

When the routing region CICSPT03 and the target regions in CICS system group CSGTGTS3 are next started, the routing region routes transactions among the target regions using both the standard queue algorithm criteria and the analysis definition RTDPAY15 to select a target region.

Related concepts
Workload management and dynamic routing
Workload requirements
Establishing a workload
Balancing the work in a workload
Separating the work in a workload
Taking affinity relations into consideration
Related tasks
Balancing a workload
Adding a region to an existing target region scope
Removing a region from a target region scope
Adding a routing region to an active workload
Quiescing a target region in an active workload
Routing a specific transaction to a specific target region
Routing particular transactions from a given user to a specific target region
Honoring a pseudoconversational transaction
Deactivating a workload definition
Updating an active workload definition
Discarding an active transaction from a workload
Updating a workload specification
Balancing an enterprise bean workload
Related reference
WLMSPEC (Workload specifications)
CICSPlex SM Managing Resource Usage
[[ Contents Previous Page | Next Page Index ]]