Dynamic routing of an inbound client DPL request

This example describes how to use the Web User Interface (WUI) to set up dynamic routing capability for a DPL request from a CICS client, and to use the GOAL algorithm to select the target region.

Before you begin

You should check the system requirements before trying to dynamically route inbound client DPL requests. See CICSPlex SM workload requirements.

About this task

In this example, a request is received to run transaction PAY1 to invoke client program PAYPROG1. PAYPROG1 issues an EXEC CICS LINK command to server program PAYPROG2. You require transaction PAY1 to have a 2-second response time.

This example uses the environment that was used for Dynamic routing with EXEC CICS START TERMID.

As you want 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 the transaction. For example, you could specify:
  • A Service Class of Fast with a average response time of 2 seconds.
  • A classification rule that associates Classification subsystem CICS with transaction ID PAY1 and Service Class Fast.

For more information about Service Classes, see the information about the goal algorithm in Management of the work in a workload.

Perform the following procedure in CICSPlex® SM.

Procedure

  1. Set the dynamic routing status value for program PAYPROG1.
    1. From the main menu, click Administration views > Basic CICS resource administration views > Resource definitions > Program definitions > . This opens the Program definitions tabular view.
    2. If the current context is not PLXPROD1, specify PLXPROD1 in the Context field and click Refresh.
    3. Click the Record check box beside the entry for PAYPROG1 and click the Update button. From the drop-down box, set the Dynamic routing status field to NO.
    4. Click Yes to confirm.
  2. Install program definitions.
    1. From the Program definitions tabular view, click the Record check box beside the entry for PAYPROG1 and click the Install button.
    2. Type CICSPA01 in the Target scope value field.
    3. Click Yes to confirm.

    Repeat this step to install PAYPROG1 in target scopes CICSPA02 and CICSPA03.

    For details of defining and installing program definitions, see Creating resources with BAS: PROGRAM resource definitions.

  3. Install the transaction definition.
    1. From the main menu, click Administration views > Basic CICS resource administration views > Resource definitions > Transaction definitions. This opens the Transaction definitions tabular view.
    2. If the current context is not PLXPROD1, specify PLXPROD1 in the Context field and click Refresh.
    3. From the Transaction definitions view, click the Record check box beside the entry for PAY1 and click the Install button.
    4. Type CICSPA01 in the Target scope value field.
    5. Click Yes to confirm.

    Repeat this step to install PAY1 in target scopes CICSPA02 and CICSPA03.

    The transaction definition should point to the mirror program DFHMIRS. For details of defining and installing transaction definitions, see Creating resources with BAS: Transaction resource definitions.



eyuaad6.html | Timestamp icon Last updated: Sunday, 4 June 2017