Routing a specific transaction to a specific target region

Start of change

The example tasks described so far in this chapter have all been concerned with workload balancing. This example describes how to use the Web User Interface (WUI) to define some workload separation requirements to CICSPlex® SM. Specifically, you want CICSPlex SM always to route the transaction PAY1 to the target region CICSPA02, which belongs to CICS system group CSGTGTS1. Note that you are still working in CICSplex PLXPROD1, and that workload balancing, from a single CICSPT01 among target regions in the group CSGTGTS1, is in effect.

  1. If the transaction to be routed is to be started with EXEC CICS START, it should be defined as ROUTABLE.
  2. Create a transaction group.
    1. From the main menu, click Administration views-->Workload manager administration views-->Transaction groups. This opens the Transaction group definition view.

      If the current context is not PLXPROD1, specify PLXPROD1 in the Context field and click Refresh.

    2. Click the Create button and provide the following information:
      Transaction group name
      TRGPAY01
      Description
      Send PAY1 to CICSPA02
      Affinity relation and lifetime checking status
      ACTIVE
      Primary search criterion
      USERID
      You can leave the remaining fields or accept the defaults.

    Click Yes.Enter. The Transaction group definition view is redisplayed, now showing the name of the transaction group TRGPAY01.

  3. Add transaction PAY1 to transaction group TRGPAY01.
    1. In the Transaction group definition view, select the entry for TRGPAY01, and click the Add transaction button.
    2. Type the name PAY1 in the Transaction name field, and click Yes to confirm. The Transaction group definition is redisplayed.
  4. Create a workload definition.
    1. From the main menu, click , Administration views-->Workload manager administration views-->Workload definitions. This open the Workload management definition view, listing any workload definitions already created in PLXPROD1.
    2. Click the Create button and provide the following information:
      Workload management definition name
      WLDPAY01
      Description
      Separate TRGPAY01 to CICSPA02
      Transaction group name
      TRGPAY01
      Scope name of set of target systems
      CICSPA02
    3. Click Yes to confirm.
  5. Create a workload group.

    (A workload group is essential if you want a workload definition to be installed automatically when the routing region that’s routing the transactions is started.)

    1. From the main menu, click , Administration views-->Workload manager administration views-->Workload groups. This open the Workload management group view, listing any workload groups already created in PLXPROD1.
    2. Click the Create action button and type in the following:
      Workload management group name
      WLGPAY01
      Description
      Workload group for WLDPAY01
    3. Click Yes to confirm. The Workload management group screen is redisplayed.
  6. Add the workload group WLGPAY01 to the existing workload specification WLSPAY01.
    1. In the Workload management group screen, select the entry for WLGPAY01, and click Add to WLM specification
    2. In the Specification name field, enter the name of the existing workload specification, WLSPAY01 and click Yes. The Workload management group screen is redisplayed.
  7. Add the workload definition to the workload group.
    1. From the main menu, click , Administration views-->Workload manager administration views-->Workload definitions to open the Workload management definition view.
    2. Select the entry for WLDPAY01, and click Add to WLM group
    3. In the Resource group name field, type WLGPAY01 and click Yes. The Workload management definition view is redisplayed.
  8. Install the workload group into the active workload.

    Because the workload WLSPAY01 is already active, you have to install the new workload group WLGPAY01 explicitly. If you did not install WLGPAY01, it would not take effect until the routing region CICSPT01 and the target regions in CICS system group CSGTGTS1, were next started.

    1. From the main menu, click , Administration views-->Workload manager administration views-->Workload groups to open the Workload management group view.
    2. Select the entry for WLGPAY01 and click the Install action button.
    3. In the Workload name field type WLSPAY01, and In the Workload owner field type in the SYSID of the system on which the workload specification WLSPAY01 was created.

      Click Yes to confirm

    The Owner value is the SYSID of the system on which the workload specification WLSPAY01 was created.

Because you are reusing a workload specification that is already active in CICSplex PLXPROD1, and have installed the workload group the workload separation you have defined in this example takes immediate effect.

You can check that the new workload definition WLDPAY01 is active by opening the Workload management definition view. This should include an entry for WLDPAY01 in workload WLSPAY01. When transaction PAY1 is next started, by any user and from any terminal, CICSPlex SM will route it to target region CICSPA02.

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 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
Using real-time analysis to select a target region for workload balancing
Related reference
WLMGROUP (Workload groups)
WLMDEF (Workload definitions)
End of change [[ Contents Previous Page | Next Page Index ]]