4.1.1 Beginning a Management Client

This packet sequence is initiated by starting a connection on a transport session between a Management Client and a Management Server.

CONNTYPE_TXUSER_DTCUIC: The packet sequence starts when a Management Client initiates a connection using CONNTYPE_TXUSER_DTCUIC.

Field

Value

Value description

MsgTag

0x00000005

MTAG_CONNECTION_REQ

fIsMaster

0x00000001

1

dwConnectionId

0x00000001

1

dwUserMsgType

0x00000000

CONNTYPE_TXUSER_DTCUIC

dwcbVarLenData

0x00000000

0

dwReserved1

0xCD64CD64

Reserved

The Management Client then sends an MTAG_HELLO user message to the OleTx Management Server.

Field

Value

Value description

MsgTag

0x00000FFF

MTAG_USER_MESSAGE

fIsMaster

0x00000001

1

dwConnectionId

0x00000001

1

dwUserMsgType

0x00003006

MTAG_HELLO

dwcbVarLenData

0x00000000

0

dwReserved1

0xCD64CD64

Reserved

When the Management Server receives the connection request from the underlying OleTx Multiplexing Protocol [MS-CMP] layer, the Management Server adds the connection to its Management Connection List.

When the Management Server's Update Timer expires, the Management Server sends a MSG_DTCUIC_STATS user message to the Management Client. In this message, the Management Server reports that two transactions are open, seventeen transactions have been committed, and as many as eight transactions were open at the same time since the transaction manager was started up on 6/14/2007.

Field

Value

Value description

MsgTag

0x00000FFF

MTAG_USER_MESSAGE

fIsMaster

0x00000001

1

dwConnectionId

0x00000001

1

dwUserMsgType

0x00003001

MSG_DTCUIC_STATS

dwcbVarLenData

0x00000058

88

dwReserved1

0xCD64CD64

Reserved

cOpen

0x00000002

2

cCommitted

0x00000011

11

cAborted

0x00000000

0

cInDoubt

0x00000000

0

cHeuristic

0x00000000

0

cOpenMax

0x00000008

8

cCommittedMax

0x00000011

17

cAbortedMax

0x00000000

0

cInDoubtMax

0x00000000

0

cHeuristicMax

0x00000000

0

cForcedCommit

0x00000000

0

cForcedAbort

0x00000000

0

cAvgResponseTime

0x00002364

9060

cMinResponseTime

0x00001F4F

8015

cMaxResponseTime

0x0000B508

46344

timeTransactionsUp

0x46709338

1181782840

systemTimeTransactionsUp

0x07D70006

6/14/2007 1:00:40.640 AM (UTC)

0x0004000E

0x00010000

0x00280280

dwTimestamp

0x00000000

0

cSinglePhaseInDoubt

0x00000001

1

The Management Server then sends an MSG_DTCUIC_TRANLIST user message to the Management Client if there are any open transactions older than specified by the Show Limit value. In this message, the Management Server reports the Transaction Id, the Isolation Level, the description, the status and Parent name for two (2) open transactions. If there are no open transactions older than specified by the Show Limit value, then this message is not sent.

Field

Value

Value description

MsgTag

0x00000FFF

MTAG_USER_MESSAGE

fIsMaster

0x00000001

1

dwConnectionId

0x00000001

1

dwUserMsgType

0x00003002

MSG_DTCUIC_TRANLIST

dwcbVarLenData

0x000000A4

164

dwReserved1

0xCD64CD64

Reserved

dwNumElements

0x00000002

2

guidTx

0xB30F0859

b30f0859-f3cf-4866-8db1-287e81cc69f2

0x4866F3CF

0x7E28B18D

0xF269CC81

ulIsol

0x00100000

ISOLATIONLEVEL_SERIALIZABLE

szDesc

0x6E617254

"Transaction #1"

0x74636173

0x206E6F69

0x00003123

0x00000000

0x00000000

0x00000000

0x00000000

0x00000000

0x00000000

dwStatus

0x00000C01

XACTSTAT_ONLY_FAILED_COMMITTED_REMAIN

szParent

0x6863614D

"Machine2"

0x32656E69

0x00000000

0x00000000

guidTx

0x2489B646

2489b646-94f0-41c6-a470-2b618d9f1ef2

0x41C694F0

0x612B70A4

0xF21E9F8D

ulIsol

0x00100000

ISOLATIONLEVEL_SERIALIZABLE

szDesc

0x6E617254

"Transaction #2"

0x74636173

0x206E6F69

0x00003223

0x00000000

0x00000000

0x00000000

0x00000000

0x00000000

0x00000000

dwStatus

0x00020000

XACTSTAT_INDOUBT

szParent[16]

0x6863614D

"Machine2"

0x32656E69

0x00000000

0x00000000

The Management Server continues to send these messages until the Management Client closes the connection by initiating the disconnect sequence.