Routing a specific transaction to a specific target region
Use the Web User Interface (WUI) to define some workload separation requirements to CICSPlex® SM.
- If the transaction to be routed is to be started with EXEC CICS START, it should be defined as ROUTABLE.
- 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:
Name TRGPAY01 Description Send PAY1 to CICSPA02 Affinity relation and lifetime checking status ACTIVE Primary search criterion USERID 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.
- From the main menu, click Administration views > Workload manager
administration views > Transaction group definitions. This opens
the Transaction group definitions view.
- 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.
- 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:
Workload management definition WLDPAY01 Description Separate TRGPAY01 to CICSPA02 Transaction group name TRGPAY01 Scope name of set of target systems CICSPA02 - Click Yes to confirm.
- 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:
Workload management group WLGPAY01 Description Workload group for WLDPAY01 - Click Yes to confirm. The WLM groups view is redisplayed.
- 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.
- 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.
- 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.