Microsoft KB Archive/887220

= Description of TMQTools utilities for Microsoft Message Queuing =

Article ID: 887220

Article Last Modified on 2/9/2006

-

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 &quot;DsGetSiteName&quot; 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:

&quot;Failed to find site name value MachineCache\SiteName&quot;

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.

