This example describes how to use the end user interface (EUI)
to ensure that multiple transactions, among which there is an affinity, are
routed to the same target region. As before, you are working in CICSplex PLXPROD1
and are routing transactions from CICSPT01 to the target regions in CICS system
group CSGTGTS1.
---------------------- Create Trangroup for PLXPROD1 -------------------------- COMMAND ===> Trangroup name ===> TRGPAY03 Description ===> Pseudoconversational transaction Status ===> ACTIVE Transaction Group Status (ACTIVE,DORMANT) Match Key ===> USERID Primary WLMDEF search criterion (USERID,LUNAME) Affinity Relation ===> USERID Optional affinity relation may be: (USERID,LUNAME,GLOBAL, BAPPL) Affinity Lifetime ===> PCONV 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 pseudoconversational transaction (PCONV), and that this affinity lasts while those transactions are coming from the same user ID (USERID). If one of them is initiated from a different user ID, 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 TRGPAY03.
From the TRANGRP view, move the cursor to the entry for TRGPAY03, 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 PCONV Mode Error ===> PAY2 ===> START ===> PAY3 ===> ===> PAY4 ===> ===> PAY5 ===> END ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> Press Enter to add Transaction to Trangroup. Type END or CANCEL to cancel without adding.
As you can see from this panel, there are four transactions in this group (PAY2, PAY3, PAY4, and PAY5). PAY2 starts the pseudoconversation, and PAY5 ends it. Press Enter. The TRANGRP view is redisplayed.
----------------------- Create Workload Definition for PLXPROD1 --------------- COMMAND ===> Definition Name ===> WLDPAY03 Description ===> TRGPAY03 to the same target region Trangroup Name ===> TRGPAY03 Specific Trangroup, Generic, or Blank Terminal Luname ===> * Specific or pattern Luname User Id ===> * Specific or pattern Userid Process Type ===> * 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 TRGPAY03, initiated by any user and from any terminal, 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.
In the WLMDEF view, move the cursor to the entry for WLDPAY03, 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 WLGPAY01 and press Enter. The WLMDEF view is redisplayed.
Because group WLGPAY01 is already associated with the active workload WLSPAY01, changes you make to that group will not take effect until the routing region CICSPT01, and the target regions in CICS system group CSGTGTS1, are next started. To make the new workload definition take effect immediately, you must install it explicitly in WLSPAY01.
In the WLMDEF view, tab to the entry for WLDPAY03 again and issue INS from the line-command field. The Install WLMDEF panel is displayed. Complete the panel as shown here, and press Enter.
---------------------------- Install WLMDEF for PLXPROD1 ---------------------- COMMAND ===> Name WLDPAY03 Description TRGPAY03 to the same target region Type WLMDEF Workload ===> WLSPAY01 Active Workload in which to install the WLMDEF Or Generic Owner ===> * Owner of the Workload in which to install the WLMDEF Or Generic Press Enter to install Workload Definition. Type END or CANCEL to cancel without installing.
The Owner value is the SYSID of the system on which the workload specification WLSPAY01 was created. If you enter a generic value in this field, CICSPlex SM presents a list from which you can select the correct value.
Because you have explicitly installed the workload definition WLDPAY03 in the active workload WLSPAY01, CICSPlex SM is able to honor this pseudoconversational transaction immediately. Be aware that you are able to use the single workload specification WLSPAY01 for both workload balancing and workload separation because you did not specify default Affinity Relation and Affinity Lifetime values in WLSPAY01. Had you done so, you would have had to create different workload specifications for workload balancing and workload separation.