How To Determine if MSMQ 2.0 Is Installed in Workgroup or Domain Mode (248500)


The information in this article applies to:

  • Microsoft Windows 2000 Server
This article was previously published under Q248500

SUMMARY

There are two main ways to set up Microsoft Message Queue Server (MSMQ) 2.0 on a Windows 2000 computer - Workgroup or Directory mode. This is determined when configuring MSMQ for the first time. To determine whether your MSMQ 2.0 is configured in Workgroup or Directory mode, check the following registry key: 
HKLM\SOFTWARE\Microsoft\MSMQ\Parameter
A value named 'Workgroup' with a value of 1 (0x1) indicates MSMQ 2.0 was installed in Workgroup mode.

MORE INFORMATION

When MSMQ is being installed you may find a dialog box which displays as follows:
Setup did not locate a server running Message Queuing that provides directory services. Choose if Message Queuing will use a directory service:
(O) Message Queuing will access a directory service
....
(O) Message Queuing will not access a directory service
Message Queuing on this computer will only support creation of private queues and direct connections with other computers running Message Queuing.
If the second option ("Message Queuing will not access a directory service") was selected, then MSMQ is configured in "Workgroup Mode", and the registry key earlier displays "0x1" as the value.

Also, when in workgroup mode, if you attempt to browse the public queues, you get the following error message:
Message Queuing Service
Unable to display all public queues. Only public queues cached locally can be displayed.
Error: The operation is not supported for a WORKGROUP installation computer
You can also use the MSMQ 2.0 Administration objects to determine this programmatically. The IsDSEnabled property of the MSMQApplication object returns a nonzero value if MSMQ is installed in Directory mode, as shown in the following code: 
If MSMQApplication.IsDSEnabled Then MsgBox "I am in Directory mode"

REFERENCES

For detailed information on MSMQ 2.0 configuration and development see the following:

http://msdn.microsoft.com/library/en-us/msmq/msmq_overview_4ilh.asp


Modification Type:MinorLast Reviewed:7/15/2004
Keywords:kbComPlusQC kbhowto KB248500
©2004 Microsoft Corporation. All rights reserved.