These examples describe how to use the end user interface (EUI)
to manage a Link3270 bridge workload
In the case of Link3270 bridge requests, the client application in the requester region calls the Link3270 bridge using EXEC CICS LINK, EXCI or ECI, and passes a communication area to the bridge router program, DFHL3270, which runs in the router region. The transaction ID that is used for Link3270 bridge workload balancing is the name that is passed to DFHL3270 in the communication area and is not necessarily the same as the transaction name entered at the terminal or workstation. The target regions contain the bridge environment in which the target transaction runs. The target regions must be at CICS® Transaction Server for z/OS®, Version 2 Release 2 or later because earlier releases do not contain the correct Link3270 bridge environment.
When CICSPlex® SM is in use and the CICSPlex SM routing exit, EYU9XLOP is specified as the SIT DTRPGM parameter, DFHL3270 uses CICS distributed program linking to pass control to EYU9XLOP. The mirror program, DFHMIRS, passes the following information to EYU9XLOP in the DFHDYPDS communication area:
For more information about the Link3270 bridge see the CICS External Interfaces Guide.
CICS distributed program linking is described in detail in the CICS Intercommunication Guide
In this example CICSPT01 is the router region and the target regions are CICSPA01, CICSPA02 and CICSPA03.
------------------- Create WLM Specification for PLXPROD1 --------------------- COMMAND ===> WLM Spec Name BRSPEC01 Description ===> Link3270 Bridge Workload 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 criteria (USERID, LUNAME) Create Affinity ===> N/A Create auto affinity (YES, NO, N/A) Target Scope ===> BRITGTS1 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 ===> QUEUE Algorithm Type (GOAL, QUEUE) Press ENTER to create the WLM Specification. Type END or CANCEL to cancel without creating.
You must supply:
A complete description of the WLMSPEC view is given in WLMSPEC (Workload specifications).
When the regions are next restarted the workload will be balanced across the target regions. You can use the command WLMAWORK BRSPEC01 to check that the workload specification is active. You can use the command WLMAWAOR BRSPEC01 to see which target regions are being routed to.
This example uses the same configuration as that described in Creating workload management definitions using the end user interface.
You can separate Link3270 bridge workloads by user ID, or transaction group. You can also separate by LU name, but only if you are overriding the NETNAME which the bridge generates automatically. See Separating Link3270 bridge workloads for details of how to do this. You should also know that in the case of Link3270 bridge workloads the LU name is the eight-character NETNAME of the terminal running the client transaction that started the Link3270 bridge, rather than the NETNAME of the bridge facility itself. To separate by bridge facility NETNAME you must modify the EYU9WRAM module. See Separating Link3270 bridge workloads for more information. CICS will route all transactions running under the same bridge facility to the same target region. You cannot force them to go to different regions.
The following example describes how to separate a bridge workload by userid and transaction group. Add the following definitions to those that you created in Creating workload management definitions using the end user interface.
---------------------- Create Trangroup for PLXPROD1 ------------------------- COMMAND ===> Trangroup name ===> TRGBRI01 Description ===> Link3270 bridge transaction group Status ===> ACTIVE Transaction Group Status (ACTIVE,DORMANT) Match Key ===> USERID Primary WLMDEF search criterion (USERID,LUNAME) Affinity Relation ===> Optional affinity relation may be: (USERID,LUNAME,GLOBAL, BAPPL) Affinity Lifetime ===> Optional affinity lifetime may be: (SIGNON,LOGON,PCONV,DELIMIT,SYSTEM, PERMANENT ACTIVITY, PROCESS) Create Affinity ===> N/A 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.The Affinity Relation and Affinity Lifetime fields must be left blank and the Create Affinity field set to N/A because CICSPlex SM does not handle affinities between Link3270 bridge transactions.
A complete description of the TRANGRP view is given in TRANGRP (Transaction groups).
From the TRANGRP view, move the cursor to the entry for TRGBRI01, and issue ADD from the line-command field. The Add Transaction to Trangroup panel is displayed. Add the names of transactions that you wish to include in TRGBRI01:
------------------- Add Transaction to Trangroup for PLXPROD1 ----------------- COMMAND ===> Trangroup TRGPAY03 Transaction ACTIVTY Mode Error ===> BRI1 ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> Press Enter to add Transaction to Trangroup. Type END or CANCEL to cancel without adding.
----------------------- Create Workload Definition for PLXPROD1 --------------- COMMAND ===> Definition Name ===> WLDBRI01 Description ===> Separate Link3270 bridge activities Trangroup Name ===> TRGBRI01 Specific Trangroup, Generic, or Blank Terminal Luname ===> * Specific or pattern Luname User Id ===> BRIUSER1 Specific or pattern Userid Process Type ===> * Specific or pattern Process Type Target Scope ===> CICSPA01 CICS System, Group, or Generic Press Enter to create definition. Type END or CANCEL to cancel without creating.These values indicate that transactions in group TRGBRI01 entered by BRIUSER1 are to be routed to CICSPA01.
A complete description of the WLMDEF view is given in WLMDEF (Workload definitions).
(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.)
--------------------- Create WLM Group for PLXPROD1 ------------------- COMMAND ===> Group Name ===> WLGBRI01 Description ===> Workload Group for WLDBRI01 Press Enter to create Workload Group. Type END or CANCEL to cancel without creating.
A complete description of the WLMGROUP view is given in WLMGROUP (Workload groups).
------------------- Add WLM Definition to Workload Group for PLXPROD1 -------- COMMAND ===> Workload Definition WLDBRI01 Description Link3270 bridge workload definition Workload Group ===> WLGBRI01 Group Name or Generic Press Enter to add WLM Definition to Workload Group. Type END or CANCEL to cancel without adding.