Description of TMQTools utilities for Microsoft Message Queuing (887220)


The information in this article applies to:

  • Microsoft Message Queuing 2.0
  • Microsoft Message Queuing 3.0

Introduction

The article describes the TMQ State, TMQ Store and TMQ Site utilities that are contained in the TMQTools utilities.

You can use the TMQ State utility to obtain information about the basic configuration of the environment under which Microsoft Message Queuing is running. You can also use the TMQ State utility to obtain information about the current resource usage of Message Queuing.

You can use the TMQ Store utility to verify whether the Message Queuing storage structures in the Message Queuing storage directory are consistent and intact. You can use the TMQ Store utility to resolve inconsistencies that are found in the storage directory.

You can use the TMQ Site utilitiy to diagnose inconsistancies betweeen MSMQ Active Directory objects and the corresponding MSMQ registry information.

MORE INFORMATION

The TMQTools utilities are extendible. The function of the TMQTools utilities is determined by the resource DLL that is included at the command line when you run the TMQ command.

TMQ State

The TMQ State command displays the following information:
  • General environment data
  • File versioning
  • Storage directory statistics
  • Local disk usage summary
  • Memory usage
  • Recent system error events
  • Recent Message Queuing events
  • Recent application error events
  • Current system state
To run the TMQ State command, follow these steps:
  1. Click Start, click Run, type cmd, and then click OK.
  2. Change the directory to the folder that you installed the TMQTools utilities in.
  3. At the command prompt, type TMQ State -v -d, and then press ENTER.

Note When you run the TMQ State command, the information appears on the screen. At the same time, TMQ State also creates a file that is named Tmqstate.log with the same information.

TMQ Store

The TMQ Store command performs the following functions:
  • Examines the status of all storage directory structures to make sure that all storage files are intact and consistent
  • Examines the storage directory size and displays how the space is used in the storage directory
  • Examines the local disk usage
  • Synchronizes files by using the -f switch if a problem is found
To run the TMQ Store command, follow these steps:
  1. Click Start, click Run, type cmd, and then click OK.
  2. Change the directory to the folder that you installed the TMQTools utilities in.
  3. At the command prompt, type TMQ Store -v -d, and then press ENTER.
Note To repair damaged storage files, you can use the TMQ Store -f command. Use this switch or command option only when it is required. Synchronization of transactional logging files can cause messages that have already been sent to be redelivered since the last existing checkpoint.

Note When you run the TMQ Store command, the information appears on the screen. At the same time, TMQ Store also creates a file that is named Tmqstore.log with the same information.

TMQ Site

The TMQ Site command displays the following information:
  • Site name from Active Directory
  • Current role of this computer
  • Site name from the Windows Registry
  • Site ID from the Windows Registry
  • Netbios name of the local machine
  • Confirmation of the presence of critical MSMQ objects in Active Directory
To run the TMQ Site command, follow these steps:
  1. Click Start, click Run, type cmd, and then click OK.
  2. Change the directory to the folder that you installed the TMQTools utilities in.
  3. At the command prompt, type TMQ Site -v -d, and then press ENTER.
Note If the site membership in the registry does not match the value returned by "DsGetSiteName" you can use theTMQ Site -f command this will configure the registry to match the actual site membership of the computer. However if site membership under the properties of the Computer's MSMQ object in AD Users and Computers is incorrect it must be changed manually.

Note When you run the TMQ Site command, the information appears on the screen. At the same time, TMQ Site also creates a file that is named Tmqsite.log with the same information.

Note TMQ Site when run on Message Queuing 3.0 may report the following message:

"Failed to find site name value MachineCache\SiteName"

This is expected behavior. This value may not be populated.

TMQTools utilities

For additional information about how to download the TMQTools utilities, visit the following Microsoft Web site:

http://www.microsoft.com/downloads/details.aspx?FamilyId=5D1A9FA3-0964-4998-A306-D95280CEF8BB&displaylang=en

File information

The English version of this file has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time tool in Control Panel.
   Date         Time   Version            Size    File name
   --------------------------------------------------------------
   03-Oct-2004  13: 17 6.0.4093.0          6,144  Tmq.exe          
   03-Oct-2004  13: 17 6.0.4093.0         93,184  Tmqsite.dll     
   03-Oct-2004  13:17  6.0.4093.0         37,376  Tmqstore.dll  
   03-Oct-2004  14: 21 6.0.4093.0         93,184  Tmqstate.dll
Note Microsoft Product Support Services does not support the installation or usage of the TMQ State and TMQ Store Utilities for MSMQ.

REFERENCES

For additional information about Message Queuing, visit the following Microsoft Web site:

http://www.microsoft.com/windowsserver2003/technologies/msmq/default.mspx

Modification Type:MajorLast Reviewed:2/9/2006
Keywords:kbinfo kbhowto KB887220 kbAudDeveloper kbAudITPRO
©2004 Microsoft Corporation. All rights reserved.