Updating an active workload definition

This example describes how to use the Web User Interface (WUI) to update an active workload definition and then reinstall it in the active workload.

In the example Routing particular transactions from a given user to a specific target region, you created the transaction group TRGPAY02 and named it in the workload definition WLDPAY02. In this example, you'll see how to remove TRGPAY02 and replace it with a new transaction group, TRGPAY04, which has already been created.
  1. Display active workload definitions:
    • From the main menu, click Active workloads (WLM) > Definitions. This opens the Active workload definitions tabular view.

      If the current context is not PLXPROD1, specify PLXPROD1 in the Context field and click Refresh.

    • In the Active workload definitions view, type WLSPAY01 and click Refresh. The active workload definitions associated with workload specification WLSPAY01 are listed.

    Make a note of the value in the System ID of workload owner field for WLDPAY02 (CM1B, in this example).

  2. Update workload definition WLDPAY02.
    • From the main menu, click Administration > Workload manager administration > Definitions to open the WLM definition tabular view.
    • Select the entry for WLDPAY02 and click the Update... button. The WLM definitions create view is displayed.
    • In the WLM definitions create view, change the Transaction group name to TRGPAY04 and change the Description text to Separate TRGPAY04 to CICSPA03
    • Click Yes. The WLM definitions tabular view is redisplayed.
  3. Install the updated workload definition in WLSPAY01:

    In the WLM definitions tabular view, select the entry for WLDPAY02 and click the Install... view. The Install view is displayed. In the Workload name field, type WLSPAY01. In the Workload owner field, type the 4-character ID of the workload owner that you made a note of in step 1. Click Yes. The updated workload definition is installed in workload WLSPAY01.

  4. Check that the updated workload definition has been installed:
    • From the main menu, click Active workloads (WLM) > Definitions. This opens the Active workload definitions tabular view showing the updated definition. Check that TRGPAY02 has been replaced by TRGPAY04.
  5. Check that transaction group TRGPAY02 is inactive and that transaction group TRGPAY04 is now active:
    • From the main menu, click Active workloads (WLM) > Transaction groups to view the status of the two transaction groups.
Note:
Updating the User ID, Terminal LU name, BTS process type, or Scope name of set of target systems fields in a workload definition prevents the workload definition from being reinstalled dynamically. To reinstall the workload definition into an active workload, you must:
  • From the Active workload definitions tabular view, click the Discard... button to discard the active workload definition
  • From the workload management Definitions view, click the Install... button to install the workload definition into the workload.

Alternatively, to reinstall workload definitions with changed attributes, use a batch API program to disable access to the affected application, discard the Active workload definitions view, install the WLM definitions view, and re-enable the affected application.