Separating CICS BTS activities

Start of changeThis example describes how to use the end user interface (EUI) to separate a CICS BTS-related workload.End of change

In this example, BTS activity BTSACT1 has an affinity of LIFETIME and runs under transaction id BTS1 and process type SALES. This example uses the configuration that has been used for the example in Balancing CICS BTS activities. Similarly, the SIT parameter DSRTPGM must be set to EYU9XLOP.

Note:
You should check the system requirements before trying to dynamically route CICS BTS activities. See CICS system connectivity and CICS release requirements for dynamic routing.
  1. If the current context isn’t PLXPROD1, issue the command CON PLXPROD1 from the current view.
  2. Create a transaction group.
    1. From the current view, issue the command TRANGRP. The TRANGRP view is displayed, listing any transaction groups already defined in PLXPROD1.
    2. From the TRANGRP view, issue the command CRE. The Create Trangroup panel is displayed. Complete the panel as shown here:
     ---------------------- Create Trangroup for PLXPROD1 -----------------------
     COMMAND  ===>
     
      Trangroup name    ===> TRGCBTS1
      Description       ===> CICS BTS transaction group
     
      Status            ===> ACTIVE        Transaction Group Status
                                       (ACTIVE,DORMANT)
      Match Key         ===> USERID        Primary WLMDEF search criterion
                                       (USERID,LUNAME)
      Affinity Relation ===> BAPPL        Optional affinity relation may be:
                                       (USERID,LUNAME,GLOBAL, BAPPL)
      Affinity Lifetime ===> ACTIVITY     Optional affinity lifetime  may be:
                                       (SIGNON,LOGON,PCONV,DELIMIT,SYSTEM, PERMANENT
                                        ACTIVITY, PROCESS)
      Create Affinity   ===>              Create Auto Affinity (YES, NO, N/A)
      Event Name        ===>              RTADEF/STATDEF, or generic
     
      Abend Health      ===> 0            Target ABEND Health Factor (0 - 99)
      Abend Load        ===> 0            Target ABEND Load Factor (0 - 99)
     
    Press Enter to create Trangroup.
    Type END or CANCEL to cancel without creating.

    Notice that the Affinity Relation and Affinity Lifetime fields must be completed. These values tell CICSPlex® SM that the transactions in this group constitute a BTS affinity, and that this affinity lasts while those transactions are coming from the same BTS application. If one of them is initiated from a different BTS application, CICSPlex SM can select a different target region. Of course, the same type of affinity will then come into play in that second target region. You can ignore any fields that have been left blank. Press Enter. The TRANGRP view is redisplayed, now showing the name of the transaction group TRGCBTS1.

    Note:
    For a complete description of the TRANGRP view, see TRANGRP (Transaction groups).
  3. Identify the transactions in group TRGCBTS1.

    From the TRANGRP view, move the cursor to the entry for TRGCBTS1, and issue ADD from the line-command field. The Add Transaction to Trangroup panel is displayed. Complete the panel as shown here:

     ------------------- Add Transaction to Trangroup for PLXPROD1 ----------------
     COMMAND  ===>
     
      Trangroup               TRGPAY03
     
          Transaction     ACTIVTY Mode        Error
     ===> BTS1            ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     
     
    Press Enter to add Transaction to Trangroup.
    Type END or CANCEL to cancel without adding.

    Press Enter. The TRANGRP view is redisplayed.

  4. Create a workload definition.
    1. From the command line of the current view, issue the command WLMDEF. The WLMDEF view is displayed.
    2. From the WLMDEF view, issue the command CRE. The Create Workload Definition panel is displayed. Complete the panel as shown here:
     ----------------------- Create Workload Definition for PLXPROD1 ---------------
     COMMAND  ===>
     
      Definition Name      ===> WLDCBTS3
      Description          ===> Separate CICS BTS activities
     
      Trangroup Name       ===> TRGCBTS1       Specific Trangroup, Generic, or Blank
      Terminal Luname      ===> *              Specific or pattern Luname
      User Id              ===> *              Specific or pattern Userid
      Process Type         ===> SALES          Specific or pattern Process Type
      Target Scope         ===> CSGTGTS1       CICS System, Group, or Generic
     
     
    Press Enter to create definition.
    Type END or CANCEL to cancel without creating.
    These values tell CICSPlex SM that transactions in group TRGCBTS1,and of process type SALES, must go to a target region in group CSGTGTS1. CICSPlex SM can select the most appropriate target region at the time the transaction is initiated.

    Press Enter. The WLMDEF view is redisplayed.

    Note:
    For a complete description of the WLMDEF view, see WLMDEF (Workload definitions).
  5. Add the workload definition to the workload group.

    In the WLMDEF view, move the cursor to the entry for WLDCBTS1, and issue ADD from the line-command field. The Add WLM Definition to Workload Group panel is displayed. In the Workload Group Name field, type WLGCBTS1 and press Enter. The WLMDEF view is redisplayed.

  6. Add the workload group to the a workload specification.

    In the WLMGROUP view, tab to the entry for WLDCBTS1, and issue ADD from the line-command field. In the Specification Name field, type WLGCBTS1 and press Enter.

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 CICS BTS activities
Related reference
WLMDEF (Workload definitions)
CICS release requirements for dynamic routing
CICS® Business Transaction Services
[[ Contents Previous Page | Next Page Index ]]