|This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.|
Configuration information must be present for MSMQ to start at boot time. If the registry key is not configured, MSMQ starts in a suspended state. After configuration is complete, you can start MSMQ using the MSMQADM utility.
Note You must configure MSMQ after you set the computer name and current time. Current time is used for the generation of the GUID. If the time is not set properly, more than one machine can end up with the same GUID. For this reason, configuration does not proceed automatically during the first cold boot but is instead left to the user to accomplish.
MSMQ can be configured either by setting registry information as detailed below or by running the MSMQADM utility. This section describes registry values and installation/configuration options.
The entire persistent state of MSMQ is a combination of information in the MSMQ registry key and the MSMQ base directory. The base registry key is HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSMQ\SimpleClient. The following table provides the named values for the base-registry MSMQ configuration parameters.
|BaseDir : REG_SZ||The directory used for queue information and message storage.|
|CEStartAtBoot : REG_DWORD||The Windows CE–specific entry. If this value is a 0 DWORD entry, MSMQ will not start at boot time but can be started using the MSMQ administration utility.|
|CETrackNetwork : REG_SZ||Yes or No. If Yes, MSMQ will attempt to resend immediately after the network has reconnected instead of following the standard resend schedule.|
|DebugQueue : REG_SZ||The queue used for routing debugging.|
|DebugOutputChannels : REG_DWORD||The mask of MSMQ debug output channels.|
|DebugOutputMask : REG_DWORD||The mask of enabled debug zones.|
|DefaultQuota : REG_DWORD||The queue quota for message storage by a remote queue, and the maximum default queue size and size of output queues, in kilobytes. If this value does not exist, outgoing queues are unrestricted.|
|FSMaxTimeout : REG_DWORD||Time-out in seconds for an installable file system. If the MSMQ base directory is not found on startup, MSMQ will wait for this amount of time, rechecking every second before failing.|
|LanRetrySchedule : REG_DWORD||If there are no network interfaces, the next attempt to connect is shifted by this value (in seconds) instead of next leg of the connection schedule. If 0, existence of network interfaces is not checked and the connection schedule is followed.|
|LogSize : REG_DWORD||The size of MSMQ log file.|
|QueueManagerGUID : REG_BINARY||The globally unique identifier (GUID) of the Windows CE queue manager, used for session protocols between Windows CE and Windows NT implementations.|
|OrderAckScale : REG_DWORD||A multiplier for transactional acknowledgement periods and time-outs. By default it is 5.|
|OrderAckWindow : REG_DWORD||How many packets are sent per transactional queue until transactional receipt arrives. Changing this may have severe repercussions.|
|OutFRSQueue : REG_SZ||The outgoing FRS queue format name. This name must be DIRECT. If any other name is used, it will not be possible to configure the outgoing FRS queue.|
|PingPort : REG_DWORD||The machine UDP port that the MQ Ping service is monitoring. This ping port is always set to 3,527 by the registration utility. Do not change the ping port setting.|
|PingTimeout : REG_DWORD||The time-out for response to MQ Ping. If it is set to 0, it disables pinging so connections are attempted immediately.|
|Port : REG_DWORD||The machine TCP/IP port that MSMQ is monitoring. This port is always set to 1,801 by the registration utility. Do not change the port setting.|
|HostName : REG_SZ||The host name to override the machine's host name. If this is not set, information is queried dynamically from the network.|
|MessageID : DWORD||The current message identifier, accurate to within 1,000 messages. This identifier is set and used by the MSMQ client and should not be changed by a user. It is used for backup and restore purposes.|
|RetrySchedule : REG_BINARY||An array of little-endian shorts, each containing the next leg of connection schedule. See the "Connectivity" section for complete description.|
The base registry key for NETREG is HKEY_LOCAL_MACHINE\Software\Microsoft\MSMQ. The following table provides the named values for the base-registry NETREG configuration parameters.
|Cycle : REG_DWORD||In seconds, the period for repeating the name registration.|
|TrackNetwork : REG_DWORD||Set to 1 to enable registration on network interface up.|
|EmulateNB : REG_DWORD||Set to 1 to provide NetBIOS services.|
|UseRedirector : REG_DWORD||Set to 1 to use redirector for NetBIOS services (must be selected if redirector is present).|