2.2.8.2.1.1.1 TXUSER_ASSOCIATE_MTAG_ASSOCIATE

The TXUSER_ASSOCIATE_MTAG_ASSOCIATE message requests that the transaction manager perform pull propagation of an existing transaction. This is also known as an associate request. 


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)

...

...

guidTx (16 bytes)

...

...

isoLevel

isoFlags

cbSourceTmAddr

szDesc (40 bytes)

...

...

SourceTmAddr (variable)

...

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

  • The dwUserMsgType field MUST be 0x00002031.

  • The dwcbVarLenData field MUST be equal to the value of cbSourceTMAddr plus 68.

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

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.

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.

cbSourceTmAddr (4 bytes): A 4-byte integer value that MUST contain the length, in bytes, of the SourceTmAddr field. The length MUST include the padding bytes used in the SourceTmAddr field.

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.

SourceTmAddr (variable): This field is used for identifying the address of the superior transaction manager against which the pull propagation operation is requested. This field MUST contain either a NAMEOBJECTBLOB (section 2.2.5.3) structure or an OLETX_TM_ADDR (section 2.2.4.2) structure in a version-specific manner as specified in Version-Specific Aspects of Connection Types Relevant to an Application (section 2.2.1.1.1). The SourceTmAddr field MUST be aligned on a 4-byte boundary by padding with arbitrary values.