3.3.5 Moving a transaction

When a UAP commits a transaction in a process different from the process in which the UAP accessed HiRDB, the commitment processing is called moving the transaction.

The UAP referenced is a UAP that connects itself to HiRDB via the HiRDB XA library.

When the transaction-move function is used, 1 must be specified in the PDXAMODE operand of the client environment definition. For details about the PDXAMODE operand, see 6.6.4 Environment definition information.

Organization of this subsection
(1) Scope of LOCK TABLE UNTIL DISCONNECT when the PDXAMODE operand is specified

(1) Scope of LOCK TABLE UNTIL DISCONNECT when the PDXAMODE operand is specified

The specification of the PDXAMODE operand affects the scope of the LOCK TABLE UNTIL DISCONNECT specification, as explained as follows:

(a) PDXAMODE=0
  1. Resource Manager opened by means of AP coding
    The LOCK TABLE UNTIL DISCONNECT specification remains in effect until the Resource Manager is closed.
  2. Resource Manager opened separately for each transaction
    The LOCK TABLE UNTIL DISCONNECT specification remains in effect throughout the global transaction.
(b) PDXAMODE=1
  1. Resource Manager opened by means of AP coding
    • Transaction is not moved
      The LOCK TABLE UNTIL DISCONNECT specification remains in effect until the Resource Manager is closed.
    • Transaction is moved
      The LOCK TABLE UNTIL DISCONNECT specification remains in effect throughout the global transaction.
  2. Resource Manager opened separately for each transaction
    The LOCK TABLE UNTIL DISCONNECT specification remains in effect throughout the global transaction.

Table 3-7 shows the scope of the LOCK TABLE UNTIL DISCONNECT specification when OpenTP1 is used.

Table 3-7 Scope of the LOCK TABLE UNTIL DISCONNECT specification when OpenTP1 is used

PDXAMODE specificationOpenTP1 specificationScope of LOCK TABLE UNTIL DISCONNECT
0trn_rm_open_close_scope=processEffective until Resource Manager is closed.
trn_rm_open_close_scope=transactionEffective within a global transaction.
1trn_rm_open_close_scope=process-d option specified in trnstring operandEffective until the Resource Manager is closed.
-d option not specified in trnstring operandA single AP comprises a global transaction in the OpenTP1 system.
Multiple APs comprise a global transaction in the OpenTP1 system.A single AP links to the HiRDB XA library.
Multiple APs link to the HiRDB XA library.Effective within the global transaction.
trn_rm_open_close_scope=transaction
Note
The -d option can be specified when the TP1/Server Base version is 03-03 or later and the HiRDB version is for UNIX systems.