Description of TMQTools utilities for Microsoft Message Queuing

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.

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 the TMQ 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:

TMQTools utilities

For additional information about how to download the TMQTools utilities, contact Microsoft support.

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.

Note Microsoft Product Support Services does not support the installation or usage of the TMQ State and TMQ Store Utilities for MSMQ.

For additional information about Message Queuing, visit Installing Message Queuing (MSMQ).