2.2.8.1.3.1 TXUSER_BEGINNER_MTAG_PROMOTE

The TXUSER_BEGINNER_MTAG_PROMOTE message is used to request the creation of a transaction that specifies a predetermined transaction identifier.

0	1	2	3	4	5	6	7	8	9	1 0	1	2	3	4	5	6	7	8	9	2 0	1	2	3	4	5	6	7	8	9	3 0	1
MsgHeader (24 bytes)
...
...
isoLevel
dwTimeout
szDesc (40 bytes)
...
...
isoFlags
guidTx (16 bytes)
...
...

MsgHeader (24 bytes): This field MUST contain a MESSAGE_PACKET structure:

• The dwUserMsgType field MUST be 0x00001010.

• The dwcbVarLenData field MUST be 68.

isoLevel (4 bytes): The isolation level of the transaction. The value MUST be one as specified in the OLETX_ISOLATION_LEVEL (section 2.2.6.9) enumeration.

dwTimeout (4 bytes): A 32-bit unsigned integer that MUST contain the time-out value, in milliseconds, for the transaction. The value zero MUST be interpreted as an infinite time-out. A transaction SHOULD NOT abort due to time-out before the time-out that is specified by this value has expired.

szDesc (40 bytes): The description of the transaction, as a fixed-size array of 40 bytes that contains a null-terminated Latin-1 ANSI string, as specified in [ISO/IEC-8859-1]. See section 2.2.5.4 for details.

isoFlags (4 bytes): The isolation flags for the transaction. The value MUST be a legal combination of values from the OLETX_ISOLATION_FLAGS (section 2.2.6.8) enumeration.

guidTx (16 bytes): This field MUST contain a GUID that specifies the transaction identifier.