PROPID_M_TRACE

The PROPID_M_TRACE property specifies where report messages will be sent when tracing a message.

Type Indicator

VT_UI1 (or VT_NULL)

PROPVARIANT Field

bVal

Property Values

This property can be set to one of the following values:

MQMSG_SEND_ROUTE_TO_REPORT_QUEUE: Each hop made by the original message generates a report that is recorded in a report message. The elements of the report are the source Queue Manager, message identifier, target, time, and next hop. The report message is sent to the report queue specified by the source Queue Manager.
MQMSG_TRACE_NONE: The default. No tracing for this message.

Remarks

If MQMSG_SEND_ROUTE_TO_REPORT_QUEUE is specified but the report queue is not defined by the MSMQ Administrator for the message's source Queue Manager, this property is ignored.

When passing PROPID_M_TRACE to MQReceiveMessage, the corresponding VT field in the aPropVar array can be set to VT_NULL.

For a description of report queues and messages, see Report Queues and Report Messages.

For information on machine journals, see Journal Queues.