This example describes how to use the end user interface (EUI)
to set up dynamic routing capability for a transaction started by an EXEC
CICS START command, that specifies a terminal ID and a transaction id, and
to use the goal algorithm to select the target region.
In this end user interface (EUI) example, a program running in CICSPA01 issues an EXEC CICS START command, which is associated with terminal TRM1, to run transaction PAY1, for which you require a 2-second response time. Terminal TRM1 is associated with region CICSPT01. Transaction PAY1 may execute in any region connected to CICSPT01, that is, in CICSPA01-CICSPA03.
This example uses the environment that has already been created as part of earlier examples. You are working in CICSplex PLXPROD1, which comprises TOR CICSPT01 and AORs CICSPA01, CICSPA02, and CICSPA03 in CICS® system group CSGTGTS1. Transaction group TRGPAY03 has transactions PAY1, PAY2, PAY3, and PAY4 associated with it. Workload definition WLDPAY03 was defined to tell CICSPlex® SM that transactions in group TRGPAY03 must go to a target region in CICS system group CSGTGS1.
As you wish to use the goal algorithm, you need to define, in MVS™ Workload Manager, a Service Class with the required response time and allocate that Service Class to transaction PAY1. For example, you could specify:
For more information about Service Classes, see topic Service classes.
In CICSPlex SM:
Issue the command WLMSPEC from the current view. From the WLMSPEC view, issue the command CRE. Complete the Create WLM Specification panel as shown here, and press Enter:
-------------------- Create WLM Specification for PLXPROD1 -------------------- COMMAND ===> WLM Spec Name ===> WLSDYN01 Description ===> Dynamic routing START Affinity Relation ===> Default Affinity Relation (USERID, LUNAME, GLOBAL, BAPPL) Affinity Lifetime ===> Default Affinity Lifetime (SIGNON, LOGON, SYSTEM, PERMANENT, PCONV, DELIMIT ACTIVITY, PROCESS) Match Key ===> USERID Default Primary search criterion (USERID,LUNAME) Create Affinity ===> Create Auto Affinity (YES, NO, N/A) Target Scope ===> CSGTGTS1 Default CICS System, Group or Generic Event Name ===> RTADEF, STATDEF, or Generic Abend Health ===> 0 Target ABEND Health Factor (0 - 99) Abend Load ===> 0 Target ABEND Load Factor (0 - 99) Algorithm Type ===> GOAL Algorithm Type (GOAL, QUEUE) Press Enter to create WLM Specification. Type END or CANCEL to cancel without creating.
You must supply:
When you press Enter, the WLMSPEC view is redisplayed, this time showing an entry for the new workload specification, WLSDYN01.
The next step is to tell CICSPlex SM about the region that’s going to be routing the work requests to the target regions in group CSGTGTS1.
Issue the command CICSSYS from the current view. In the CICSSYS view, tab to the line-command field for the CICSPT01 entry and issue the UPD command. Page forward until you see the Update System - Workload Attributes panel. In the Routing support active field, enter YES. This change takes effect when CICSPT01 is next started.
In the CICSSYS view, tab to the line-command field for the CICSPA01 entry and issue the UPD command. Page forward until you see the Update System - Workload Attributes panel. In the Target routing at startup field, enter YES. This change takes effect when the target region CICSPA01 is next started.
Repeat this step for target regions CICSPA02, CICSPA03, and CICSPA04.
You can either update the transaction definitions to specify these attributes, or you can specify override values when you install the transaction definitions. For details, see CICSPlex SM Managing Business Applications.
In this example task, a program running in CICSPA01, the requesting region, issues an EXEC CICS START command that specifies a transaction id of PAY1 and a terminal id TRM1. The START command is function shipped to CICSPT01, the TOR that owns the specified terminal. CICSPT01 acts as the routing region and invokes the dynamic routing exit, which selects the target region. All the AORs in CICS system group CSGTGS1 are possible target regions; the actual target region is selected on the basis of the goal criterion of a response time of 2 seconds. CICSPlex SM obtains the Service Class of transaction PAY1 and the identity of the target region to which that Service Class is allocated, from a CICSPlex SM-maintained table.