SET DB2TRAN

Description

A DB2TRAN is identified by the name it was defined with in CEDA. Alternatively, if a transid is specified on a DB2ENTRY when the DB2ENTRY is installed, CICS® installs a DB2TRAN named DFHxxxx, where xxxx is the transid.

Options

DB2ENTRY

specifies the name of the DB2ENTRY to which this DB2TRAN refers; that is, the DB2ENTRY with which this additional transid should be associated.

TRANSID

specifies the transaction id to be associated with the entry. You cannot have more than one installed DB2TRAN for the same transaction id. If you specify a transaction id that matches a transaction id specified in an existing installed DB2TRAN, the command will fail. The transaction id can include wildcard characters (see Wildcard characters for transaction IDs for information about use of wildcard characters). If you change TRANSID for a DB2TRAN while the attachment is active, all transactions with a thread continue to use the thread from that entry until it is released for reuse. When that transaction issues the next SQL statement, the thread is acquired from the entry or pool based upon the new definition.

DB2TRAN parameters may be set at any time.

Conditions

NOTAUTH

The user associated with the issuing task is not authorized to use this command, or is not authorized to access this resource.

RESP2 values:

100

Command authorization failure

101

Resource authorization failure

102

Surrogate authorization failure

103

Authtype authorization failure

NOTFND

RESP2 values:

1

There is no DB2TRAN currently installed with the specified name.

INVREQ

RESP2 values:

2

Bad characters in TRANSID name

3

Transid already exists in another installed DB2TRAN

4

Bad characters in DB2ENTRY name