2.2.3.2.5 XATMUSER_MTAG_RMOPEN

  • Article

The XATMUSER_MTAG_RMOPEN message requests the registration of an XA Resource Manager.


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)

...

...

lenDSN

lenXaDll

Recover

DSN (variable)

...

XaDllFileName (variable)

...

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

  • The dwUserMsgType field MUST be 0x20000001.

  • The dwcbVarLenData field MUST be at least 12.

lenDSN (4 bytes): A 32-bit unsigned integer that MUST contain the count of bytes in the DSN string that follows this message. It MUST be less than 3072, but it MAY be required to be less than 256.<1>

lenXaDll (4 bytes): A 32-bit unsigned integer that MUST contain the count of bytes in the XaDllFileName string that follows this message. It MUST be less than 256.

Recover (4 bytes): This value MUST be one of the following values.

Value

Meaning

0x00000000

The transaction manager SHOULD NOT perform recovery.

0x00000001

The transaction manager SHOULD perform recovery.

DSN (variable): A Latin-1 ANSI string that indicates the Data Source Name for the XA Resource Manager. It is not necessarily NULL-terminated. It MUST contain a number of bytes equal to the lenDSN field of the message.

XaDllFileName (variable): A Latin-1 ANSI string indicating the location of the XA DLL that SHOULD be loaded for the Resource Manager. It is not necessarily NULL-terminated. It MUST contain a number of bytes equal to the lenXaDll field of the message.