Managing a Link3270 bridge workload

Start of changeThese examples describe how to use the end user interface (EUI) to manage a Link3270 bridge workloadEnd of change

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

Balancing a Link3270 bridge workload

In this example CICSPT01 is the router region and the target regions are CICSPA01, CICSPA02 and CICSPA03.

  1. If the current context isn’t PLXPROD1, issue the command CON PLXPROD1 from the current view.
  2. Set the DTRPGM system initialization parameter to EYU9XLOP in all regions. (See the CICS System Definition Guide.)
  3. Use the CICSSYS view to update the definitions of the regions (CICSPT01, CICSPA01, CICSPA02 and CICSPA03). Set the Routing Support Active attribute to YES in all four regions. Set the Target Routing at Startup attribute to YES in the regions that are to act as target regions. (See CICSPlex System Manager Administration for a description of the CICSSYS view.)
  4. Use the CICSGRP view to create a CICS system group (CSGTGTS1in this example) which is to contain the regions that are to act as targets. (See CICSPlex System Manager Administration for a description of the CICSGRP view.)
  5. Add the target regions to CSGTGTS1.
  6. Create a workload specification. Issue the CRE command from the WLMSPEC view and complete the Create WLM specification panel as shown:
    ------------------- 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).

  7. Associate the workload specification with the routing region scope using the Add Scope for Specification panel of the specification that you have just created (BRSPEC01 in this example).

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.

Separating a Link3270 bridge workload

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.

  1. If the current context isn’t PLXPROD1, issue the command CON PLXPROD1 from the current view.
  2. Create a transaction group.
    1. From the current view, issue the command TRANGRP. The TRANGRP view is displayed, listing any transaction groups already defined in PLXPROD1.
    2. From the TRANGRP view, issue the command CRE. The Create Trangroup panel is displayed. Complete the panel as shown here:
     ---------------------- 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).

  3. Identify the transactions in group TRGBRI01.

    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.
  4. Repeat the previous two steps for any further transactions that you wish to be routed to different regions.
  5. Create a workload definition.
    1. From the command line of the current view, issue the command WLMDEF. The WLMDEF view is displayed.
    2. From the WLMDEF view, issue the command CRE. The Create Workload Definition panel is displayed. Complete the panel as shown here:
     ----------------------- 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).

  6. Repeat the previous step for any further transaction groups you have created for transactions that are to be routed to different regions.
  7. 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.)

    1. Issue the command WLMGROUP from the current view. The WLMGROUP view is displayed, listing any workload groups already created in PLXPROD1.
    2. From the WLMGROUP view, issue the command CRE. The Create WLM Group panel is displayed. Complete the panel as shown here:

     --------------------- 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).

  8. Add the workload definition WLDBRI01 and any other workload definitions you have created to WLGBRI01:
    1. From the WLMDEF view issue the ADD command against the entry for WLDBRI01.
    2. Complete the panel as shown:
       ------------------- 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.
    3. Repeat for any additional workload definitions that you created in step 5.
  9. Add workload group WLGBRI01 to workload specification BRSPEC01.
    1. From the WLMGROUP view issue the ADD command against WLGBRI01. This causes the Add WLM group to Workload Specification Panel to be displayed.
    2. Enter the name of the workload specification BRSPEC01 in the Specification Name field.
  10. In the WLMDEF view issue INS against workload definition WLDBRI01 to install it into the active workload. This ensures that the workload separation definitions you have just created take effect immediately. You can issue the WLMWADEF command to check that the workload definition is active.

Note:
If you wish to separate by luname you must enter LUNAME in the MATCHKEY field of the TRANGRP Create panel and the luname in the Terminal Luname field of the WLMDEF Create panel. Refer to Separating Link3270 bridge workloads for a description of the restrictions on the use of luname when separating Link3270 bridge workloads.
[[ Contents Previous Page | Next Page Index ]]