2.2.4.2.4 XAUSER_CONTROL_MTAG_RECOVER

The XAUSER_CONTROL_MTAG_RECOVER message discovers which XA transactions need recovery.


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)

...

...

RequestFlags

totalUOWsRequested

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

  • The dwUserMsgType field MUST be 0x00004003.

  • The dwcbVarLenData field MUST be 8.

RequestFlags (4 bytes): Flags that control the scan performed by the Transaction Manager for XA transactions in need of recovery. It MUST be a bitwise OR operator of one or more the following flags.

Value

Meaning

XARECOVER_START_SCAN

0x00000001

The Transaction Manager MUST begin a new session to scan for transactions in need of recovery.

XARECOVER_END_SCAN

0x00000002

The Transaction Manager MUST end the current session being used to scan for transactions in need of recovery.

XARECOVER_CONTINUE_SCAN

0x00000004

The Transaction Manager MUST continue the current session being used to scan for transactions in need of recovery. This flag is assumed to be set if no other flag is set.

totalUOWsRequested (4 bytes): A 32-bit unsigned integer that MUST contain the requested number of XA transactions that need recovery. This value SHOULD be less than or equal to 5.<3>