2.2.2.4.1.8 MSG_DTCUIC_TRACESTRING

  • Article

The MSG_DTCUIC_TRACESTRING message is sent by the Management Server to the Management Client to trace an unformatted message (see section 3.3.4.2).


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)

...

...

dwSev

dwSource

szMsg (variable)

...

MsgHeader (24 bytes): This field MUST contain a MESSAGE_PACKET structure (as specified in [MS-DTCO] section 2.2.4.1). The dwUserMsgType field MUST be 0x00003000. The dwcbVarLenData field MUST be 8 plus the length of the string present in the szMsg field (not including its null terminator).

dwSev (4 bytes): This field MUST be set to a TRACE_SEVERITY_LEVEL value.

dwSource (4 bytes): The field MUST be set to an implementation-specific unsigned integer that maps to one of the functional modules in the specific implementation. This field is set to one of the following 4-byte unsigned integer values.

Value

Trace Source

0x00000001

The MSDTC service functionality

0x00000002

The transaction manager core

0x00000003

The connection manager

szMsg (variable): This field MUST contain a null-terminated Latin-1 ANSI string, as specified in [ISO/IEC-8859-1]. The length of this string MUST be at least 1. This field is set to one of the following string values.

  • "PRIMARY: Session Bind Failed due. Primary Timed Out while waiting for the secondary to Bind"

  • "PRIMARY: Session Bind Failed. The Version Numbers did not match"

  • "PRIMARY: Session Bind Failed. Protocol Not Supported"

  • "ProcId = <PROCID> CSO: Maintain session; Received E_CM_SERVER_NOT_READY." Where <PROCID> is the string representation of the 4-byte unsigned integer value process identifier value in hexadecimal notation.

  • "ProcId = <PROCID> CSO: Maintain session; Received E_S_UNAVAILABLE. Giving up after retry." Where <PROCID> is the string representation of the 4-byte unsigned integer value process identifier value in hexadecimal notation.

  • "Session Bind Failed due. Primary Timed Out while waiting for the secondary to Bind"