How To MSMQ: Get Extended Trace Information from MSMQ Triggers When You Use Trigmon (255553)



The information in this article applies to:

  • Microsoft Message Queue Server (MSMQ) 1.0
  • Microsoft Message Queuing 2.0

This article was previously published under Q255553
IMPORTANT: This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry

SUMMARY

The Trigmon application included with the installation of the Microsoft Message Queue (MSMQ) Triggers package monitors the operation of the triggers service during run time. The Triggers service logging mechanism is activate when you use the Triggers Microsoft Management Console (MMC) snap-in. When activated, this makes any log entries from the Triggers service available to the Trigmon application. Extended tracing information, that includes information about the Triggers service thread pool and the firing of the actual triggers, can be obtained when you modify the registry.

MORE INFORMATION

WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

When logging or tracing is turned on in the MSMQ Triggers service, tracing messages are created as MSMQ Messages. These tracing messages are sent to the private "Msmqtriggerslog" queue, and then the messages are monitored by the Trigmon application (or any other application that chooses to monitor this queue). If there is a large amount of activity in the Triggers service, and the tracing messages are not being removed from the queue, then tracing messages accumulate in the queue and take up space.

You activate the Triggers service logging mechanism when you use the MSMQ Triggers MMC Snap-in, as demonstrated in the following examples:

Windows 2000

  1. Right-click My Computer.
  2. Select Manage. The Computer Management console is displayed.
  3. Select Services and Applications in the left pane.
  4. Select Message Queuing in the left pane.
  5. Right-click MQMQ Triggers.
  6. Select Properties.
  7. Select the Write To Log Queue check box.
  8. Click Apply.
  9. Click OK.

Windows NT 4.0

  1. Run the Mmc.exe file from the Start menu.
  2. Select Add/Remove Snap-in from the Console menu.
  3. Click Add... in the Add/Remove Snap-in dialog box. The Add Stand Along Snap-in dialog box is displayed.
  4. Select MQMQ Triggers in the Add Stand Along Snap-in dialog box, and then click Add.
  5. Click the Finish in the MSMQ Triggers dialog box.
  6. Click Close in the Add Stand Alone Snap-in dialog box.
  7. Click OK in the Add/Remove Snap-in dialog box.
  8. Right-click MQMQ Triggers.
  9. Select Properties.
  10. Select the Write To Log Queue check box.
  11. Click Apply.
  12. Click OK.
The extended tracing information is activated through the following registry value:

HKEY_LOCAL_MACHINE\Software\MSMQ\Triggers\ProduceTraceInfo

The following demonstrates how to activate or disable the tracing in the registry key:
  1. Run the Registry Editor (Regedit.exe).
  2. Open the following registry key:

    HKEY_LOCAL_MACHINE\Software\MSMQ\Microsoft\Triggers

  3. Double-click the ProduceTraceInfo value to edit the registry key.
  4. To enable extended tracing, give this key a value of 1. To disable tracing, give this key a value of 0.
  5. Close the Registry Editor (Regedit.exe).
  6. Restart the MSMQ Triggers Service by performing the following:

    Using the Services Control Panel

    1. Click Start, click Settings, and then click Control Panel.
    2. Click Services.
    3. Scroll down the list of Service names, and then select the entry for MSMQ Triggers.
    4. Click Stop to stop the service.
    5. Once the service has stopped, click Start to restart the service.
    6. Close Services, and then close Control Panel.

    From a Command Prompt

    1. Start a command window.
    2. At the prompt, type the following command:
      net stop msmqtriggers
      								
      and then select the ENTER key to stop the service.
    3. At the prompt, type the command:
      net start msmqtriggers
      							
      and then select the ENTER key to start the service.
You can use the Trigmon application to view the tracing information from the MSMQ Triggers.

REFERENCES

For more information about MSMQ Triggers, please see the help files at the following Web site:
http://www.microsoft.com/msmq

Modification Type:MinorLast Reviewed:7/2/2004
Keywords:kbhowto KB255553