Share via


Installing MSMQ Using MSMQADM.EXE

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Make sure your device has a unique name on the network before installing MSMQ.

To install MSMQ manually

  • Open the command prompt and do the following steps.

    msmqadm register
    msmqadm start
    

To install MSMQ in your application

  1. Run MSMQADM as part of your own installation program.

  2. Your installation program must verify that MSMQ installation exists on the computer by checking for the existence of the HKEY_LOCAL_MACHINE\Software\Microsoft\MSMQ key.

    If the key exists, MSMQ is installed.

  3. Run MSMQADM to configure MSMQ service for the second shell of MSMQADM.

    msmqadm -f \temp\msmqadm.txt register
    

    The command -f instructs MSMQADM to redirect output to the file whose name follows the switch. In this case it is \temp\msmqadm.txt.

    If registration is successful, there is no output, which means the file is empty.

    In case of an error, the file contains an error message in plain ASCII text.

    You can also supply standard registry parameters to supply the GUID, the MSMQ store directory, the name of the out-FRS server, and other parameters.

    Some registration parameters can only be changed using the following command.

    msmqadm -f \temp\msmqadm.txt change ...
    

    For information about the syntax of this command, see Using the MSMQAdm Utility.

  4. When MSMQ is installed and configured, your installation program should start the MSMQ service using the following command.

    msmqadm start
    

    - or -

    Your installation program can force the device to reboot so the MSMQ device driver can be loaded. MSMQ starts after rebooting.

  5. Use the following command to stop the service.

    msmqadm stop
    

    Be careful when stopping the MSMQ service. Other applications might be using it, which causes unexpected results.

See Also

Concepts

MSMQ Application Development
Application Installation of MSMQ
Installation Options
Installing MSMQ Using Visadm
Installing MSMQ Using the Registry
Debugging MSMQ Installations