This example describes how to use the end user interface (EUI)
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.
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).
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.)
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.
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
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:
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.