Message.UseTracing Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value that indicates whether to trace a message as it moves toward its destination queue.
public:
property bool UseTracing { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MsgUseTracing")]
public bool UseTracing { get; set; }
[<System.Messaging.MessagingDescription("MsgUseTracing")>]
member this.UseTracing : bool with get, set
Public Property UseTracing As Boolean
Property Value
true
if each intermediate step made by the original message en route to the destination queue generates a report to be sent to the system's report queue; otherwise, false
. The default is false
.
- Attributes
Exceptions
The message queue is filtered to ignore the UseTracing property.
Examples
The following code example gets and sets the value of a message's UseTracing property.
Remarks
The UseTracing property specifies whether to track the route of a message as it moves toward its destination queue. If true
, a report message (generated by Message Queuing) is sent to a report queue each time the message passes through a Message Queuing routing server. The report queue is specified by the source Queue Manager. Report queues are not limited to report messages generated by Message Queuing; your application-generated messages can also be sent to report queues.
Using tracing involves setting up Active Directory and specifying a report queue for the Message Queuing enterprise. The administrator configures these settings.