Message::UseTracing Property
Gets or sets a value that indicates whether to trace a message as it moves toward its destination queue.
Assembly: System.Messaging (in System.Messaging.dll)
public: [MessagingDescriptionAttribute("MsgUseTracing")] property bool UseTracing { bool get(); void set(bool value); }
Property Value
Type: System::Booleantrue 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.
| Exception | Condition |
|---|---|
| InvalidOperationException | The message queue is filtered to ignore the UseTracing property. |
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.
The following code example gets and sets the value of a message's UseTracing property.
Available since 1.1