2.2.8.1.2.7 TXUSER_SETTXTIMEOUT_MTAG_SETTXTIMEOUT
The TXUSER_SETTXTIMEOUT_MTAG_SETTXTIMEOUT message modifies the transaction time-out when it is used in CONNTYPE_TXUSER_BEGIN2 (section 2.2.8.1.2) connection type and CONNTYPE_TXUSER_SETTXTIMEOUT (section 2.2.8.3.3) connection type, or queries if the transaction manager and supports the capability to do so when used in CONNTYPE_TXUSER_SETTXTIMEOUT2 (section 2.2.8.3.4).
This message is also used for CONNTYPE_TXUSER_SETTXTIMEOUT (section 2.2.8.3.3) connections and CONNTYPE_TXUSER_SETTXTIMEOUT2 (section 2.2.8.3.4) connections.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
MsgHeader (24 bytes) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
guidTx (16 bytes) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
dwTxTimeout |
|||||||||||||||||||||||||||||||
MsgHeader (24 bytes): This field MUST contain a MESSAGE_PACKET structure:
The dwUserMsgType field MUST be 0x0000107B.
The dwcbVarLenData field MUST be 20.
guidTx (16 bytes): This field MUST contain a GUID that specifies the transaction identifier. When this message is sent on a CONNTYPE_TXUSER_SETTXTIMEOUT2 connection to query the capability of the transaction manager, this value SHOULD be set to a NULL GUID and MUST be ignored on receipt.
dwTxTimeout (4 bytes): A 32-bit unsigned integer that contains the new time-out value, in milliseconds, for the transaction. When used with a CONNTYPE_TXUSER_BEGIN2 connection, a transaction MUST NOT abort due to time-out before the number of milliseconds that is specified by the value has expired. The value zero MUST be interpreted as an infinite time-out. When used with a CONNTYPE_TXUSER_SETTXTIMEOUT2 connection, this value SHOULD be set to zero and MUST be ignored on receipt.