This example shows how to disable a single transaction throughout a scope.
From the current view, issue the command LOCTRAN PAY1. The LOCTRAN view, listing all local transactions called PAY1 in the current scope, is displayed:
26MAR1999 15:15:58 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> >W1 =LOCTRAN===========PLXPROD1=PLXPROD1=26MAR1999==15:15:57====CPSM==========3 CMD Tran CICS Enabled Use Program Pri TranCls Purge Dmp Rout --- ID-- System-- Status-- Count Name---- --- -------- ------------ --- ---- PAY1 CICSPA01 ENABLED 0 PRGPAYR1 1 0 NOTPURGEABLE YES DYNA PAY1 CICSPA02 ENABLED 0 PRGPAYR1 1 0 NOTPURGEABLE YES DYNA PAY1 CICSPA03 ENABLED 0 PRGPAYR1 1 0 NOTPURGEABLE YES DYNA
For a more complete description of the LOCTRAN view, see LOCTRAN - Local transactions.
As you can see from the LOCTRAN view, PAY1 is installed in three CICS® systems in CICSplex PLXPROD1. You could disable those instances of PAY1 individually, but that approach can be inefficient, particularly when you have many more occurrences of a resource than are shown here. The alternative is to summarize the resources, and then to apply any disabling action to the summary line.
To summarize the three occurrences of PAY1, type SUM in the COMMAND field, then move the cursor to any of the PAY1 entries in the Tran ID column and press Enter. The LOCTRANS view is displayed:
26MAR1999 15:15:02 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> >W1 =LOCTRAN==LOCTRANS=PLXPROD1=PLXPROD1=26MAR1999==15:15:02====CPSM==========1 CMD Tran CICS Count Enabled Use Program Pri TranCls Purge Dm --- ID-- System-- ----- Status-- Count Name---- --- -------- ------------ -- PAY1 CICSPA0* 3 ENABLED 0 PRGPAYR1 1 0 NOTPURGEABLE YE
For a more complete description of the LOCTRANS view, see LOCTRANS - Local transactions summary.
The count field shows the number of occurrences of transaction PAY1 in the current scope.
To disable every occurrence of transaction PAY1 represented in this summary line, issue DIS from the line-command field for transaction PAY1. When you press Enter, the Status value changes from ENABLED to DISABLED:
26MAR1999 15:15:02 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> >W1 =LOCTRAN==LOCTRANS=PLXPROD1=PLXPROD1=26MAR1999==15:15:02====CPSM==========1 CMD Tran CICS Count Enabled Use Program Pri TranCls Purge Dm --- ID-- System-- ----- Status-- Count Name---- --- -------- ------------ -- PAY1 CICSPA0* 3 DISABLED 0 PRGPAYR1 1 0 NOTPURGEABLE YE
The LOCTRANS view confirms that transaction PAY1 is now disabled throughout the current scope.