Updating an active workload definition

Start of changeThis example describes how to use the end user interface (EUI) End of changeto 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. If the current context isn’t PLXPROD1, issue the command CON PLXPROD1.
  2. Display active workload definitions.

    From the current view, issue the command WLMAWDEF WLSPAY01. The WLMAWDEF view, showing all active definitions associated with workload specification WLSPAY01, is displayed. WLDPAY02 appears in this list:

     27FEB2005  22:10:58 ----------- INFORMATION DISPLAY ---------------------------
     COMMAND  ===>                                                 SCROLL ===> PAGE
     CURR WIN ===> 1        ALT WIN ===>
     >W1 =WLMAWDEF==========PLXPROD1=PLXPROD1=27FEB2005==22:10:58=CPSM==========3===
     CMD Name     Workload Ownr Trangrp  Luname            Userid   Process Target
     --- -------- -------- ---- -------- ----------------- -------- Type--- Scope---
         WLDPAY01 WLSPAY01 CM1B TRGPAY01 *                 *        *       CICSPA02
         WLDPAY02 WLSPAY01 CM1B TRGPAY02 *                 USRPAY03 *       CICSPA03
         WLDPAY03 WLSPAY01 CM1B TRGPAY03 *                 *        *       CSGTGTS1
     

    Make a note of the value in the Ownr field for WLDPAY02 (CM1B, in this example).

  3. Update workload definition WLDPAY02.

    From the current view, issue the command WLMDEF WLDPAY02. The WLMDEF view, containing the entry for WLDPAY02, is displayed:

     27FEB2005  22:02:37 ----------- INFORMATION DISPLAY ---------------------------  
     COMMAND  ===>                                                 SCROLL ===> PAGE
     CURR WIN ===> 1        ALT WIN ===>
     >W1 =WLMDEF============PLXPROD1=PLXPROD1=27FEB2005==22:02:37=CPSM==========1===  
     CMD Def      Trangrp  Luname            Userid   Process Target   Description
     --- Name---- Name---- ----------------- -------- Type--- Scope--- -------------- 
         WLDPAY02 TRGPAY02 *                 USRPAY03 *       CICSPA03 Separate TRGPA 
     
     

    Tab to the entry for WLDPAY02. Overtype TRGPAY02 with TRGPAY04 and overtype the Description text with the string "Separate TRGPAY04 to CICSPA03". Press Enter. The WLMDEF view is redisplayed. (Depending on your CICSPlex® SM configuration, you might also have to type SET in the line-command field before pressing Enter.)

    Note:
    For a complete description of the WLMDEF view, see WLMDEF (Workload definitions).
  4. Install the updated workload definition in WLSPAY01.

    In the WLMDEF view, move the cursor to the entry for WLDPAY02 again, and issue INS from the line-command field. The Install WLMDEF panel is displayed. In the Workload field, type WLSPAY01. In the Owner field, type the 4-character ID of the workload owner that you made a note of in step 2. Press Enter. The updated workload definition is installed in workload WLSPAY01.

  5. Check that the updated workload definition has been installed.

    Issue the command WLMAWDEF WLSPAY01. The WLMAWDEF view is displayed, showing the updated definition.

     27FEB2005  22:10:58 ----------- INFORMATION DISPLAY ---------------------------
     COMMAND  ===>                                                 SCROLL ===> PAGE
     CURR WIN ===> 1        ALT WIN ===>
     >W1 =WLMAWDEF==========PLXPROD1=PLXPROD1=27FEB2005==22:10:58=CPSM==========3===
     CMD Name     Workload Ownr Trangrp  Luname            Userid   Process Target
     --- -------- -------- ---- -------- ----------------- -------- Type--- Scope---
         WLDPAY01 WLSPAY01 CM1B TRGPAY01 *                 *        *       CICSPA02
         WLDPAY02 WLSPAY01 CM1B TRGPAY04 *                 USRPAY03 *       CICSPA03
         WLDPAY03 WLSPAY01 CM1B TRGPAY03 *                 *        *       CSGTGTS1
     
  6. You can check that transaction group TRGPAY02 is inactive, and that transaction group TRGPAY04 is now active, by looking at the WLMATGRP view. To do this, issue the command WLMATGRP WLSPAY01 from the current view.
Note:
Start of change

Updating the User ID, Terminal Luname, Process Type, or Target Scope attributes in a workload definition prevents the workload definition from being reinstalled dynamically. To reinstall the workload definition into an active workload, you must:

  1. Use WLMAWDEF DSC line command to discard the active workload definition
  2. Use WLMDEF INS line command 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 WLMAWDEF, install the WLMDEF view, and re-enable the affected application.

End of change

Related concepts
Workload management and dynamic routing
Workload requirements
Establishing a workload
Balancing the work in a workload
Separating the work in a workload
Taking affinity relations into consideration
Related tasks
Balancing a workload
Adding a region to an existing target region scope
Removing a region from a target region scope
Adding a routing region to an active workload
Quiescing a target region in an active workload
Routing a specific transaction to a specific target region
Routing particular transactions from a given user to a specific target region
Honoring a pseudoconversational transaction
Deactivating a workload definition
Discarding an active transaction from a workload
Updating a workload specification
Using real-time analysis to select a target region for workload balancing
Related reference
WLMDEF (Workload definitions)
WLMAWDEF (Active workload definitions)
WLMATGRP (Transaction groups associated with an active workload)
[[ Contents Previous Page | Next Page Index ]]