INQUIRE DB2TRAN

Returns attributes of a particular DB2TRAN which associates a transaction or group of transactions with a DB2ENTRY.

Read syntax diagramSkip visual syntax diagramINQUIRE DB2TRAN
 
>>-INQUIRE DB2TRAN--+--------------+--+---------------------+--->
                    '-(data-value)-'  '-DB2ENTRY(data-area)-'
 
>--+-----------------+--+-------------------------+------------->
   '-PLAN(data-area)-'  '-PLANEXITNAME(data-area)-'
 
>--+--------------------+--------------------------------------><
   '-TRANSID(data-area)-'
 

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

This command is threadsafe.

Description

The DB2TRAN is identified by the name it was defined with in CEDA. For RCTs migrated to the CSD, the name is the same as the transaction for which the DB2TRAN is being created.

If a TRANSID is specified on a DB2ENTRY when the DB2ENTRY is installed, CICS installs a DB2TRAN named DFHtttt, where tttt is the TRANSID.

Browsing

You can also browse through all of the DB2TRANs installed in your system by using the browse options (START, NEXT, and END) on INQUIRE DB2TRAN commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

DB2ENTRY
returns the name of the DB2ENTRY to which this DB2TRAN refers; that is, the DB2ENTRY with which this additional transaction is associated.
PLAN
returns the name of the plan retrieved from the associated DB2ENTRY if it exists. If there is no associated DB2ENTRY, or the DB2ENTRY is disabled with DISABLEDACT(POOL), then the pool plan name is returned if it exists. If PLAN is returned, PLANEXITNAME is blank.
PLANEXITNAME
returns the name of the dynamic plan exit to be used (if any) from the associated DB2ENTRY if it exists. If there is no associated DB2ENTRY, or the DB2ENTRY is disabled with DISABLEDACT(POOL), then the pool plan exit name is returned if it exists. If PLANEXITNAME is returned, PLAN is blank.
TRANSID
specifies the transaction id to be associated with the entry. The transaction id can include wildcard characters (see the CICS® Resource Definition Guide for information about use of wildcard characters).

Conditions

NOTFND
RESP2 values:
1
The DB2TRAN cannot be found.
NOTAUTH
RESP2 values:
100
Command authorization failure
101
Resource authorization failure
[[ Contents Previous Page | Next Page Index ]]