Adding a region to an existing target region scope

This example describes how to use the Web User Interface (WUI) to increase the number of regions in an existing target scope without disrupting an existing workload.

Assume that you have implemented workload routing in CICS®plex PLXPROD1, via workload specification WLSPAY01, and that work requests are being routed among target regions CICSPA01, CICSPA02, and CICSPA03. These target regions all belong to CICS system group CSGTGTS1. Now you want to add a fourth region CICSPA04 to group CSGTGTS1. Region CICSPA04 has been defined to CICSplex PLXPROD1 and is running and is linked to the routing region CICSPT01

  1. Add target region CICSPA04 to CICS system group CSGTGTS1:
    1. From the Web User Interface main menu click Administration > Topology administration > System definitions to open the CICS system definitions tabular view.

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

    2. Select the entry for CICSPA04, and click the Add to CICS system group button. The Add to CICS system group view is displayed.
    3. In the Group which member will join field, enter the name CSGTGTS1 and click Yes.
  2. Update the CICSPlex® SM definition of target region CICSPA04:
    1. From the CICS system definitions tabular view, select the entry for CICSPA04 and click Update.
    2. Change the Workload manager status field to YES from the menu. Click Yes to confirm the update.

    This change takes effect when the target region CICSPA04 is next started.

When the target region CICSPA04 has been started, you can check that the workload is active by clicking Active workloads (WLM) > Active workload target distribution factors. This opens the Active workload target distribution factors view showing all target regions (including CICSPA04) to which work requests in this workload can be routed.