Routing a specific transaction to a specific target region

Use the Web User Interface (WUI) to define some workload separation requirements to CICSPlex® SM.

This example describes how to use the Web User Interface (WUI) to always route the transaction PAY1 to the target region CICSPA02, which belongs to CICS system group CSGTGTS1. You are still working in CICSplex PLXPROD1, and workload routing, 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:
    • From the main menu, click Administration views > Workload manager administration views > Transaction group definitions. This opens the Transaction group definitions view.

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

    • Click the Create... button, and provide the following information:

      You can leave the remaining fields blank or accept the defaults.

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

  3. Add transaction PAY1 to transaction group TRGPAY01:
    • In the Transaction group definitions view, select the entry for TRGPAY01, and click the Add transaction... button.
    • In the Transaction name field, type the name PAY1 and click Yes to confirm. The Transaction group definitions view is redisplayed.
  4. Create a workload definition:
    • From the main menu, click Administration views > Workload manager administration views > Definitions. This opens the WLM definitions view, listing any workload definitions already created in PLXPROD1.
    • Click the Create... button, and provide the following information:
    • 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.)
    • From the main menu, click Administration views > Workload manager administration views > Groups. This open the WLM groups view, listing any workload groups already created in PLXPROD1.
    • Click the Create... button, and type in the following:
    • Click Yes to confirm. The WLM groups view is redisplayed.
  6. Add the workload group WLGPAY01 to the existing workload specification WLSPAY01:
    • In the WLM groups view, select the entry for WLGPAY01, and click the Add to WLM specification... button.
    • In the Specification name field, enter the name of the existing workload specification, WLSPAY01 and click Yes. The WLM groups view is redisplayed.
  7. Add the workload definition to the workload group:
    • From the main menu, click Administration views > Workload manager administration views > Definitions to open the WLM definitions view.
    • Select the entry for WLDPAY01, and click the Add to WLM group... button.
    • In the Resource group name field, type WLGPAY01 and click Yes. The WLM 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.

    • From the main menu, click , Administration views > Workload manager administration views > Groups to open the WLM groups tabular view.
    • Select the entry for WLGPAY01 and click the Install... button.
    • 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

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 WLM definitions 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.



eyuaadu.html | Timestamp icon Last updated: Sunday, 4 June 2017