Microsoft Windows CE 3.0  

Configuring MSMQ

Important:
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.

Value Description
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.

Value Description
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).