Disabling a transaction globally

This example shows how to disable a single transaction throughout a scope.

  1. If the current context isn’t PLXPROD1, issue the command CON PLXPROD1 from the current view.
  2. List all instances of the transaction.

    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.

  3. Summarize the list of transaction instances.

    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.

  4. Disable the transaction globally.

    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.

[[ Contents Previous Page | Next Page Index ]]