LOCTRAN - Local transactions

The LOCTRAN view shows general information about currently installed local transactions. Information about dynamic transactions that are running locally is also included in the view. Examples of how to use this view can be found in:

Availability

The LOCTRAN view is available for all managed CICS® systems.

Access

Issue command:
LOCTRAN [tran [ENABLED|DISABLED]]

tran
is the specific or generic name of a currently installed local transaction, or * for all local transactions.

ENABLED|DISABLED
Limits the view to local transactions that are either enabled or disabled. If you omit this parameter, local transactions are included in the view regardless of their status.

If you do not specify parameters, the view includes information about all local transactions within the current scope.

Note:
Some transaction names might contain lower case characters. You cannot inquire on these in the EUI using a filter because TSO converts lower case characters to upper case. For example ab* will be converted to AB* and as a result no data will be retrieved.
Select:
TRANS from the OPERATE menu, and LOCTRAN from the TRANS submenu.

Figure 142 is an example of the LOCTRAN view.

Figure 142. The LOCTRAN view
 27FEB2005  08:24:49 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
 >W1 =LOCTRAN===========EYUPLX01=EYUPLX01=27FEB2005==08:24:48====CPSM========220
 CMD Tran CICS     Enabled  Use      Program  Pri TranCls  Purge        Dmp Rout
 --- ID-- System-- Status-- Count    Name---- --- -------- ------------ --- ----
     BUSY EYUMAS1A ENABLED         0 EYU9BUSY   1        0 NOTPURGEABLE YES STAT
     BUSY EYUMAS1B ENABLED         0 EYU9BUSY   1        0 NOTPURGEABLE YES STAT
     CATA EYUMAS1A ENABLED         0 DFHZATA  255        0 PURGEABLE    YES STAT
     CATA EYUMAS1B ENABLED         0 DFHZATA  255        0 PURGEABLE    YES STAT
     CATD EYUMAS1A ENABLED         0 DFHZATD  255        0 PURGEABLE    YES STAT
     CATD EYUMAS1B ENABLED         0 DFHZATD  255        0 PURGEABLE    YES STAT
     CATR EYUMAS1A ENABLED         0 DFHZATR  255        0 NOTPURGEABLE YES STAT
     CATR EYUMAS1B ENABLED         0 DFHZATR  255        0 NOTPURGEABLE YES STAT
     CBRC EYUMAS1A ENABLED         0 DFHBRCP    1        0 NOTPURGEABLE YES STAT
     CBRC EYUMAS1B ENABLED         0 DFHBRCP    1        0 NOTPURGEABLE YES STAT
     CCR  EYUMAS1A ENABLED         0 CCR        1        0 NOTPURGEABLE NO  STAT
     CCR  EYUMAS1B ENABLED         0 CCR        1        0 NOTPURGEABLE NO  STAT
     Examples needed for dynamic routing.
 

Action commands

Table 279 shows the action commands you can issue from the LOCTRAN view. The overtype fields are shown in Table 280. The action commands and overtype fields for the LOCTRAN view are available in all managed CICS systems for which LOCTRAN is valid, except as noted in Table 279 and Table 280.

Table 279. LOCTRAN view action commands
Primary command Line command Description
DISable
tran sysname
DIS Disables a transaction.
DiSCard
tran sysname
DSC Discards a transaction from the CICS system where it is installed.
Note:
Transactions that have names beginning with C are supplied by CICS and cannot be disabled or discarded.

DiSCard is available for CICS Transaction Server for OS/390, Version 1 Release 3 and later systems.

ENAble
tran sysname
ENA Enables a transaction.
n/a SET Sets a transaction attribute according to the new value you specify in an overtype field (see Table 280).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
Where:
tran
Is the specific or generic name of a local transaction.
sysname
Is the specific or generic name of a CICS system.

Table 280. LOCTRAN view overtype fields
Field name Values
Enabled Status ENABLED | DISABLED
Pri 1-255
TranCls 8-character name

Modifiable for CICS Transaction Server for OS/390, Version 1 Release 3 and later systems.

Purge PURGEABLE | NOTPURGEABLE
Dmp YES | NO

Hyperlinks

Table 281 shows the hyperlink fields on the LOCTRAN view.

Table 281. LOCTRAN view hyperlink fields
Hyperlink field View displayed Description
Tran ID LOCTRAND Detailed view of the specified local transaction.
Program Name PROGRAMD Detailed view of the program associated with the local transaction.
Note:
You can also display the LOCTRANS view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]