Use of the Registry by EMWAC Internet Mail Services
The various services comprising the IMS read their configuration information
from the Windows NT Registry. Two keys are used by each service: one key for
information which is common to more than one service, and one key containing
information specific to the service in question.
Common
Common configuration information is stored under the following key:
HKEY_LOCAL_MACHINE\SOFTWARE\EMWAC\IMS
The following values may be stored in the Registry under this key:
- MailInBoxDir (REG_SZ)
- Template defining the location of each local user's incoming mailbox.
Default: %HOME%\INETMAIL\INBOX.
- AutoCreateInboxDir (REG_DWORD)
- If this entry is non-zero, POP3S or SMTPDS will try to create a user's mail
inbox directory when (a) the user access the POP3 server, or (b) a message addressed
to the user is processed by the SMTP Delivery Agent. Default: 1.
- LocalFailuresToPostmaster (REG_DWORD)
- If this entry is non-zero, delivery failure notifications for messages addressed to
local users will be copied to the postmaster. Default: 0.
- MailSpoolDir (REG_SZ)
- Location of main directory for storing mail in transit.
Default: %SystemRoot%\EMWAC\MAIL.
- GatewayName (REG_SZ)
- IP address or domain name of host to which all non-local mail is sent.
No default.
- DomainNamesAreLocal (REG_MULTI_SZ)
- Domain names which are treated as "local" - ie mail to users at these
domains will be delivered to registered users on this Windows NT machine.
No default.
- Postmaster (REG_SZ)
- Name of local user who is acting as postmaster.
Default: administrator.
Lists (key)
This key contains one subkey for each mailing list under the following key:
HKEY_LOCAL_MACHINE\SOFTWARE\EMWAC\IMS\LISTS
Each mailing list subkey contains the following:
- Members (key)
- Contains one subkey for each email address belonging to the mailing list.
- BouncesTo (REG_SZ)
- Contains the mail address of the person to whom any non-delivery messages
for addresses on the mailing list should be sent.
If empty (the default), non-delivery messages will not be generated. If this is
the special value $SENDER, then non-delivery messages will be sent to the
person who sent the message to the mailing list.
- Moderator (REG_SZ)
- Contains the mail address of the moderator of this mailing list.
If empty (the default), the mailing list is not moderated.
- ModeratorControlJoin (REG_DWORD)
- If a list is moderated and this entry is non-zero, any JOIN message to this
mailing list will be forwarded to the moderator. Default: 0.
- ModeratorControlLeave (REG_DWORD)
- If a list is moderated and this entry is non-zero, any LEAVE message to this
mailing list will be forwarded to the moderator. Default: 0.
- WhoCanSend (REG_DWORD)
- This entry controls who can send messages to the mailing list.
If it is 2, anyone can send to the list. If it is 1, only list members
may send messages to the list. If it is 3, only the moderator can send
messages to the list. Default: 1.
Aliases (key)
This key is under the following key:
HKEY_LOCAL_MACHINE\SOFTWARE\EMWAC\IMS\ALIASES
This key contains one value for each host for which aliases are defined.
Currently, only aliases for users at local hosts are supported, and this
key therefore contains only one value: $local$.
Each value is a REG_MULTI_SZ which contains multiple pairs of strings. In each pair,
the first is the user name which is matched against incoming recipient names.
The second is the mapped-to address.
SMTP Receiver
SMTPRS-specific configuration information is stored under the following key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SMTPRS\Parameters
The following values may be stored in the Registry under this key:
- CheckLocalRecipient (REG_DWORD)
- Non-zero means that names of local recipients of a mail message are
checked when SMTPRS receives the message. If a name does not exist, then
that recipient is rejected immediately. If zero, then all local names are
assumed valid - the SMTP Delivery Agent will check whether the name is actually
correct. Default: 0.
- MailInlogEnabled (REG_DWORD)
- Non-zero if logging is enabled. Default: 0.
- ProhibitMailRelay (REG_DWORD)
- Zero if mail addressed to sites other than the local machine is
to be accepted. Default: 0.
- PortNo (REG_DWORD)
- Port number on which SMTPRS listens for incoming connections.
It would be extremely unusual to change this value. Default: 25.
- MailQueueDir (REG_SZ)
- The subdirectory of the mail MailSpoolDirectory into which SMTPRS writes
incoming messages. This does not affect SMTPDS, which always uses incoming,
so IMS will stop working if you set this value. Default: incoming.
SMTP Delivery Agent
SMTPDS-specific configuration information is stored under the following key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SMTPDS\Parameters
The following values may be stored in the Registry under this key:
- MailOutlogEnabled (REG_DWORD)
- Non-zero if logging is enabled. Default: 0.
- Timeout (REG_DWORD)
- SMTPDS regularly checks the domain subdirectories to see if it is time
to resend any message in any domain in terms of a resend schedule.
This parameter is the interval in seconds between
checks. Default: 120.
The resend schedule is hard-coded into SMTPDS:
- {10,10,10,2*60,10,10,8*60,10,10,24*60,10,10,36*60,10,10,36*60,0}
where SMTPDS waits for a number of minutes between each retry. The
intervals are in minutes. When it gets to the end, it generates a
non-delivery report.
POP3 Server
POP3-specific configuration information is stored under the following key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\POP3S\Parameters
The following values may be stored in the Registry under this key:
- MessageExtension (REG_SZ)
- Extension used for message files. Default: MSG.
- PortNo (REG_DWORD)
- The TCP/IP port number on which the POP3 Server listens for incoming
POP3 connections. It would be most unusual to change this number. Default: 110.
- Timeout (REG_DWORD)
- This parameter is an inactivity autologout timeout in seconds.
Default: 600.
- Pop3LogEnabled (REG_DWORD)
- Non-zero if logging is enabled. Default: 0.
