Enable Route Tracking and Test Messages

Applies To: Windows Server 2008

Use this procedure to enable Message Queuing route tracking and test messages.

You can use this procedure to enable Message Queuing route tracking and test messages.

A test message is a message that is generated by the Message Queuing service on a specified source computer and sent to a target queue on a specified destination computer. The source computer can be any independent client or Message Queuing server, and the specified destination computer hosting the target queue can be any other independent client or Message Queuing server within the same forest. The target queue must be a test queue; that is, a nontransactional public queue with a queue type ID set equal to {55EE8F33-CCE9-11CF-B108-0020AFD61CE9}. For more information about tracking messages, see Tracking Messages.

Test messages are sent to verify that messages can be sent from a given source computer and delivered to public queues on a given destination computer and, if message route tracking is enable, to track the route taken by messages sent from the source computer to public queues on the destination computer. For more information about tracking the routes taken by messages, see Tracking Messages.

You can either create a new test queue or transform an existing public queue into a test queue. Most existing public queues can be made to function as a test queue by changing the type ID to that of a test queue. However, it is useless to change the type ID of a transactional queue or a queue requiring message authentication to convert it into a test queue, because test messages, which are nontransactional and are not authenticated, will not be delivered to a transactional queue or to a queue requiring message authentication (unless the queue is located on the source computer)

Membership in the local Administrators group, or equivalent, is the minimum required to complete this procedure.

To enable Message Queuing route tracking and test messages

  1. Click Start, click Run, type regedit, and then click OK.

  2. Click to expand Computer, click to expand HKEY_LOCAL_MACHINE, click to expand SOFTWARE, and then click to expand Microsoft.

  3. Click to expand MSMQ, click to expand Parameters, and then click Security.

  4. Right-click the details pane, point to New, and then click DWORD Value.

  5. Type EnableReportMessages as the name of the new value, and then press ENTER.

  6. Double-click the new EnableReportMessages value to change the value data. To enable the sending of test messages, enter a Decimal value of 1 in Value data. To disable the sending of test messages, enter a Decimal value of 0 in Value data. This is the default value.

  7. Click OK to save the value. After setting the registry, restart the Message Queuing service for the changes to take effect.

Warning

Incorrectly editing the registry may severely damage your system. It is recommended that you back up any valuable data on the computer before making changes to the registry.

Additional considerations

  • For instructions on sending test messages after the feature is enabled, see Additional references.

  • By enabling this feature, you also enable the message route tracking feature. For more details, see Additional references.

Additional references