Internet Exchange Documents
White Papers
Internet Exchange for cc:Mail Version 2 - Format of the IMA.INI File
The file ima.ini is
the Internet Exchange configuration file, and is used to store all gateway
configuration information. This file is installed in the Windows directory. It is created
by the installation procedure, and updated whenever any changes are made to the gateway
configuration via the system manager (admin.exe). Most initialization file settings
are loaded into memory at the start of program execution. Since CCIN, CCOUT,
and SMTPC are not long running tasks, they pick up any changes by the next time
they run. The settings ADMIN references are loaded each time it needs to test them,
so changes are reflected instantly. SMTPD must be shutdown and restarted to pickup
changes.
The configuration parameters
in the ima.ini file are broken down into several functional categories. They are:
Each section
of the ima.ini file is identified by the section name enclosed between brackets.
For example, the PostOffice section will be identified by the marker [PostOffice]
in the configuration file. Section and variable names are not case sensitive. If a value
contains embedded spaces, you may enclose it with double quotation marks, however
it is not required. To include comments in the IMA.INI file, begin each comment
line with a semicolon (;). Each configurable parameter within a given section will be of
the form:
OptionName=OptionValue
[PostOffice]
PoName
This is the name of the local
cc:Mail Post Office database which will be used to store messages. This name is the same
name the cc:Mail administrator supplies on the cc:Mail (not Internet Exchange) ADMIN
utility command line when doing user ID additions, deletions, etc. to the cc:Mail
directory. The default value is main-po.
example: PoName=Main Post Office
PoPath
This is the full DOS path to
the local cc:Mail post office database referenced by the PoName setting above. The
default value is m:\ccdata.
example: PoPath=m:\ccdata
PoPassword
This is set to the encrypted
password of the cc:Mail Post Office database (i.e. the same password you use to invoke the
cc:Mail ADMIN utility). It is set by IMASETUP and the Configure Post
Office screen and is not intended to be modified by any other means.
PoAdministrator
This is the name of the local
cc:Mail administrator. Messages addressed to "postmaster" will be forwarded to
this cc:Mail user. The default value is postmaster.
example: PoAdministrator=Adam Smith
InternetPoName
This is the name which Internet
Exchange uses to log into the local cc:Mail Post Office. It is an upper case
"P" entry in the cc:Mail directory. This should be left as Internet
unless this name is already used. Note: At installations which provide cc:Mail
users with several means of delivering messages to and from the Internet, the P.O. name, "Internet"
may be too broad, in which case you might consider using a more specific name such as SMTP
or MIME. The default value is Internet.
example: InternetPoName=Internet
[Gateway]
SendMessageSize
This is the maximum size for
outgoing messages. CCOUT will return messages larger than this value to the sender.
A value of 0 indicates no limit. The default is 0.
example: SendMessageSize=0
ReceiveMessageSize
This is the maximum size for
incoming messages. CCIN will return messages larger than this value to the sender.
If a message must be returned, and it is also larger than SendMessageSize, only the
message headers will be returned. A value of 0 indicates no limit. The default is 0.
example: ReceiveMessageSize=0
LogfileSizeLimit
This is the maximum size of
logfile in bytes. The Windows notepad application cannot display files larger than about
50kb, so when the logfile exceeds this size, it is renamed and a new logfile is started.
If your logfile viewer (see [Config]Viewer) can handle larger files, then this number can
be increased. A value of 0 indicates no limit. The default is 50,000.
example: LogfileSizeLimit=50000
QueueDirectory
This is the directory Internet
Exchange uses for queuing incoming and outgoing messages. It is sometimes desirable to
change the default location of this directory if you want to move the whole queue
directory tree off to a network drive. The default value for this option is
c:\ieccmail\queue.
example: QueueDirectory=c:\ieccmail\queue
TimeZone
This is the local timezone. The
format is NNNHH:MMSSS, where NNN is the 3 digit code for normal time, HH:MM a signed value
indicating the difference in hours from Greenwich Mean Time (GMT) and SSS is the 3 digit
code for daylight saving time. This last code can be omitted if daylight saving is not
used locally. It is generally easier for the user to set this option from IMASETUP
or ADMIN's Gateway button/dialog. The default value is PST8PDT.
example: TimeZone=PST8PDT
LoggingLevel
This option defines how much
information to record in IECCMAIL.LOG. Level 1 is the lowest level, which allows
only errors to be logged. Level 2 allows queue processors to log successful delivery of
messages. Level 3 additionally logs all SMTP transactions, while level 4 includes much
diagnostic information as well. Normally, level 2 or 3 should be used, although SMTP
logging consumes a great deal of disk space. Note: See the [Debug] DetailedSMTPlog
option for additional ways to control SMTP logging. The default is 3.
example: LoggingLevel=3
GatewayMode
This option accepts the values send,
receive, configure, or send/receive. Send causes Internet
Exchange's Admin program to only execute CCOUT and SMTPC, while receive
causes it to only run SMTPD and CCIN. Send/receive allows all
programs to function normally. Configure mode will not allow any message traffic to
be processed and can be used when it is necessary to make configuration changes while
message delivery is suspended. Note: When Internet Exchange is restricted to
either send or receive mode, error reports (i.e. bounced messages) will
still be produced, but their delivery will be postponed until the gateway mode is changed
to a mode that will allow for these error reports to be delivered. The default mode is send/receive.
example: GatewayMode=send/receive
RetryPeriod
This is the number of hours
during which SMTPC will attempt to deliver a message. After this time has elapsed, the
message will be returned to sender. The default is 72.
example: RetryPeriod=72
MaxRetryPeriod
This specifies the maximum
value, in hours, for the SMTPC retry period, generated via the exponential back-off
algorithm. i.e. if this value is reached, then all further retries before RetryPeriod
will be every MaxRetryPeriod hours. e.g. if RetryPeriod=72 and MaxRetryPeriod=12,
then the retry increment each time will double until it hits 12 hours. It will then
increase by 12 hours each time until 72 hours have elapsed, at which point the message
will be bounced. The default is 60 hours.
example: MaxRetryPeriod=4
SMTPCqueueRunSize
This is the number of messages
which SMTPC will attempt to deliver in a single queue pass. SMTPC will
continue to process messages (based upon the setting of SMTPCrestartIfNotDone) as
long as there are any messages remaining in the queue after a given pass. A value of 0
allows SMTPC to process all the messages in a single queue run. The default is 5.
example: SMTPCqueueRunSize=10
SMTPCrestartIfNotDone
Controls the restarting of SMTPC
after it has processed SMTPCqueueRunSize number of messages. The default is YES.
example: SMTPCrestartIfNotDone=YES
MaxSessions
This limits the number of
simultaneous incoming SMTP connections. Some Winsock stacks cannot handle unlimited
incoming connections. Values are numeric, with the default being zero (i.e. no limit).
example: maxSessions=8
TemporaryDirectory
This points to the directory
which Internet Exchange will use for the storage of temporary files. If this can be
configured as a RAM disk or a disk with lazy write caching enabled, a considerable speedup
can be achieved. The default value is c:\ieccmail\queue\tmp.
example: TemporaryDirectory=c:\ieccmail\queue\tmp
FastAdminStartup
If there has been a network
outage or hardware failure, etc., which has caused the cc:Mail post office queue to grow
very long, you can reduce the time required for ADMIN to startup by enabling the FastAdminStartup
option. This will postpone the queue counter update until the first mouse or keyboard
action from the user, and will delay the updating of the listbox until the second mouse or
keyboard action from the user. The default is NO.
example: FastAdminStartup=NO
LoopingItemsToPostmaster
Controls whether CCIN
forwards items which appear to be caught in a routing loop to the system administrator, or
returns them to the sender (which may only perpetuate the loop). The default is NO.
example: LoopingItemsToPostmaster=NO
LocalCharSet
This value is either US-ASCII
or ISO-8859-1 up to -10. These are the standard ISO strings used for the
MIME character set parmeter. The default is US-ASCII.
example: LocalCharSet=US-ASCII
MaxTrips
This option specifies the
maximum number of Recieved lines allowed in an incoming message which include the FQDN of
the gateway machine. If this number is exceeded, the message will be bounced. This can be
used to stop message loops. The default is 5.
example: MaxTrips=5
SMTPC554DuringDATAisTemporary
RFC 821 (SMTP) is unclear
whether a "554 transaction failed" error during the SMTP DATA phase indicates a
non-retriable error. Generally 5XX errors are considered permanent, non-retriable errors,
but some SMTP implementations issue 554 for non-fatal error conditions. Internet
Exchange takes the conservative approach and treats this as retriable, unless you set
this option to NO. If set to YES, a 554 SMTP error during the data phase of
an SMTPC session is treated as temporary, and the message will be retried later, otherwise
it will be bounced. The default is YES.
example: SMTPC554DuringDATAisTemporary=YES
MAXDNSRecordNumber
DNS caching was introduced as a
performance enhancement to Internet Exchange version 1.1. This paramater is used to
control the maximum number of DNS records in the DNS-caching database. If set to 0, the
DNS caching is disabled. The default is 1000.
example: MAXDNSRecordNumber=1000
OldLogFile
The Internet Exchange
system manager, ADMIN, uses this paramater to store the name of the last logfile
which is being renamed. It is not necessary for users to configure this paramater.
[Schedules]
CcInInterval
This is the interval in minutes
for starting up the CCIN queue manager. The default is 5.
example: CcInInterval=5
CcOutInterval
This is the interval in minutes
for starting up the CCOUT queue manager. The default is 5.
example: CcOutInterval=5
SMTPCInterval
This is the interval in minutes
for starting up the SMTPC queue manager. The default is 5.
example: SMTPCInterval=5
CcInSync
If set, ccInSync will
cause CCIN to start up as soon as a message is fully received by SMTPD into
the queue\in directory. Valid values are YES and NO. The default value is NO.
example: CcInSync=YES
CcOutSync
If set, ccOutSync will
cause CCOUT to start up as soon as a message is detected in the outgoing cc:Mail
post office queue (i.e. in the cc:Mail database). Valid values are YES and NO.
The default value is NO.
example: CcOutSync=YES
SMTPCSync
If set, SMTPCSync will
cause SMTPC to start up as soon as a message is fully delivered by CCOUT to
the queue\out directory. Valid values are YES and NO. The default value is NO.
example: SMTPCSync=YES
ShutdownTime
This value, if set to a value
other than NONE, is the time at which the gateway will shut itself down. To
shutdown the gateway once per day on a regular basis, use the format hh:mm using a 24 hour
clock. The auto shutdown option can also specify a time interval from when the gateway was
started rather than an absolute time. The time can be specified in the format
"+hh:mm" or "+mm". If set to NONE, the gateway will run
continuously. The default value is NONE.
example: ShutdownTime=23:30
IMAStartTime
This value is used to store the
start time of the Internet Exchange system manager, ADMIN for calculating
the auto-shutdown time. This value is not to be user modified, and is automatically set by
the system. The time is stored in the format of time_t.
example: IMAStartTime=819626538
KeepAlive
For TCP connections that are
made over a PPP dialup connection, some stacks can be configured to timeout and
automatically disconnect after a predetermined period with no network activity. Under
these conditions, it is necessary for the gateway to keep the stack active if SMTPD is to
continue to be able to receive incoming mail. If the KeepAlive option is enabled,
SMTPD will send keepalive packets (actually a single UDP packet) to the discard port (9)
of a remote host. The gateway will first look for a DNS server, followed by a sequential
search for any host other than the gateway itself in the hosts file to send the keepalive
packets to. The keepalives are sent one packet approximately every 10 seconds. The default
value is NO.
example: KeepAlive=NO
AutoDialUp
This option allows Internet
Exchange to automatically dial a remote Internet Service Provider when using the Microsoft
PPP implimentation under Windows 95. When trying to connect, ADMIN will wait for a
successful Connected status and will keep trying to establish the connection within a
timeout of 10 minutes. If Internet Exchange is configured to automatically
shutdown, SMTPD will wait until the last connection has terminated and will
disconnect the dialup connection after one minute of inactivity when AutoDialUp is
enabled. The default value is NO.
example: AutoDialUp=NO
DialUpNetName
When AutoDialUp is
enabled, DialUpNetName specifies the name of the Dialup Networking name created
within Windows 95. There is no default value.
example: DialUpNetName=IMA CISCO 2511
[Connection]
GatewayHostName
This is the Internet name of
the gateway machine, WITHOUT the domain part. The default value is iegate.
example: GatewayHostName=iegate
GatewayDomain
This is the domain component of
the Internet name of the gateway machine. Note: Together, GatewayHostName and
GatewayDomain make up the gateway's Fully Qualified Domain Name, which is sometimes
referred to as the FQDN. The default value is anon.com.
example: GatewayDomain=anon.com
HostTable
This is the location of the TCP
HOSTS file. Your specific Winsock TCP/IP stack may dictate the location of this file. The
default value is c:\ieccmail\hosts.
example: HostTable=c:\ieccmail\hosts
AlternateNameList
This is a comma separated list
of alternate host/domain names (i.e. FQDN's) by which the gateway is known on the
Internet. There is no default value.
example: AlternateNameList=victoria.ima.com, cm.ima.com
[Routing]
DNSaddresses
This is a comma-delimited list
of Internet addresses of DNS nameservers, to be tried in succession. There should always
be at least one DNS nameserver listed if DNS is being used.
example: DNSaddresses=190.9.200.1,190.9.200.5
NameResolution
This is the order of methods
used to resolve domain names. Valid options are HostOnly, DNSonly, HostThenDNS,
DnsThenHost or MailRelayHostOnly. This can be set via ADMIN's Routing
button, aka Configure Routing dialog. Note: this is not a comma separated
list. Only a single value is allowed. The default value is DnsThenHost.
example: NameResolution=DnsThenHost
PrimaryRelayHostname
This is the name of default
host to be used if MailRelayHostOnly is enabled or if the DNS fails to resolve a
hostname. The message is forwarded to this host under the assumption that it will know how
to deliver the message to its recipients. It is highly recommended that a Mail Relay Host
be defined here in the event that mail cannot be delivered by any other method. There is
no default for this option.
example: PrimaryRelayHostname=ima.com
EnableSecondaryRelayHost
This option is used to switch
on/off the secondary mail relay host. If this option is enabled, messages will be
forwarded to the secondary mail relay host if the DNS fails to resolve a hostname and the
primary relay host is not responding. The default value is NO.
example: EnableSecondaryRelayHost=NO
SecondaryRelayHostname
This is the name of secondary
host to be used if DNS fails to resolve a hostname. The message is forwarded to this host
under the assumption that it will know how to deliver the message to its recipients. It is
highly recommended that a Mail Relay Host be defined here in the event that mail cannot be
delivered by any other method. There is no default for this option.
example: SecondaryRelayHostname=ima.net
RelayHostUsed
This option is set by
Internet Exchange, and
is not settable by the user. It is used by the gateway to indicate that it is currenly
trying to route mail via the mail relay host. There is no default for this option.
example: RelayHostUsed=NO
TimeToRetryPrimaryRelayHost
This is the waiting time (in
minutes) to retry connecting to the primary relay host when it is not responding. The
default for this option is 60 minutes.
example: TimeToRetryPrimaryRelayHost=60
TimeToTrySecondaryRelayHost
This is the waiting time (in
minutes) to try connecting to the secondary relay host (if one has been configured) when
the primary relay host is not responding. The default for this option is 5 minutes.
example: TimeToTrySecondaryRelayHost=5
TimeFirstTryPrimaryRelayHost
This paramater is
used to record the time when Internet Exchange shoud first attempt to reconnect to
the primary relay host. This value is internally generated and is not settable by the
user. The time is stored in time_t format.
example: TimeFirstTryPrimaryRelayHost=8175293
[Options]
DefaultEncoding
If a file with an extension not
configured under the [Magic] section, or a file with no extension, is exported,
then it will be encoded using this encoding method. Valid values are base64, quoted-printable
or x-uue. The latter value is for sending files to sites which cannot handle MIME
messages. Note: Text items which contain non-ASCII characters will always be
encoded using quoted-printable. The default value is base64.
example: DefaultEncoding=base64
IncludeRfc822Header
This option indicates if the
gateway should import all RFC 822 headers from incoming messages and attach them as a
separate note item. Valid values are YES and NO. The default is YES.
example: IncludeRfc822Header=YES
IncludeccMailName
This option indicates if the
gateway should include cc:Mail user names (extracted from the cc:Mail directory) in
outgoing Internet addresses. Valid values are YES and NO. The default is YES.
example: IncludeccMailName=YES
UseReplyTo
This option controls setting
the cc:Mail sender field to the value of the Internet Reply-to: header instead of the
From: header. You need to choose between the two header fields because cc:Mail is unable
to differentiate between the two. Valid values are YES and NO. The default
is NO.
example: UseReplyTo=NO
RegularScreenUpdates
This option will update the
current queue being displayed in the ADMIN screen every minute. Normally this
should be set. However, if a large backlog has accumulated in a particular queue,
displaying all the messages will drastically slow down the gateway. In this case the
option should be turned off until the queue size has gone down. Valid values are YES
and NO. The default is YES.
example: RegularScreenUpdates=YES
CloseSMTPD
This option indicates whether
SMTPD should shutdown when the Admin interface exits. Valid values are YES
and NO. If set to NO, SMTPD will continue to accept messages, even if
Admin is not running. The default is YES.
example: CloseSMTPD=YES
AutoRestartSMTPD
This option is used to
automatically restart the SMTP daemon if it exits for any reason. This should normally be
set to YES. Valid values are YES and NO. The default is YES.
example: AutoRestartSMTPD=YES
IncludeMimeHeader
This variable controls the
importation of MIME headers for a given message. If set, an extra text item will be
created for each incoming MIME bodypart in each message. This will result in a large
number of attachments in the resulting cc:Mail message, which may push it over the cc:Mail
limit of 20 attachments. It is recommended that this variable be set for debugging
purposes only. Valid values are YES and NO. The default value is NO.
example: IncludeMimeHeader=NO
Separator
This variable holds the
addressing delimiter used to perform default address mapping. Currently Internet
Exchange is limited to use just the dot and underscore characters. Valid values are dot
and underscore. The default value is underscore.
example: Separator=underscore
BounceToPostmaster
This is used to send a copy of
all bounced messages to the local postmaster as well as the original sender of the
message. This can be useful for debugging delivery problems. Valid values are YES
and NO. The default value is NO.
example: BounceToPostmaster=NO
BounceSender
This option specifies an
Internet ID to be used as the sender of bounced messages. The FQDN of the gateway is
appended onto the end of this parmeter, forcing the address of the sender to appear to be
local to the gateway. This value can point to a nonexistent ID, such as nobody, so
that remote users cannot reply to these error reports! The default is postmaster.
example: BounceSender=postmaster
UseHostname
This indicates whether to
include the local Internet hostname in outgoing addresses. Some sites prefer to use just
the domain name, with no host component at all. Valid values are YES and NO.
If set to NO, the gateway domain must be added to the alternate host name domain
list. The default value is YES.
example: UseHostname=YES
DeleteMIMEheaders
This indicates whether to
discard outgoing MIME header text items, which are created when importing MIME
messages into cc:Mail. It is recommended that this variable be set to YES to
discard such headers as these attachments typically cause confusion and do not convey any
useful information when re-exported. Valid values are YES and NO. The
default value is NO.
example: DeleteMIMEheaders=YES
RrqHeader
This contains the name of the
header field used to contain return receipt information. The default value is return-receipt-to.
example: RrqHeader=return-receipt-to
UseRemotePoName
If set to YES, default
addresses include the cc:Mail post office name of the sender and are of the form:
Bill_Smith_at_Sales@a.b.c
If set to NO they do not
include the cc:Mail post office name and take the form:
Bill_Smith@a.b.c
The later form is usually
desirable when the post office Internet Exchange sends messages to knows how to
route messages to all possible recipients, i.e. when running ADE. The default is YES.
example: UseRemotePoName=YES
RejectUnqualifiedAddresses
If this option is set to YES,
SMTPD rejects all unqualified addresses. This forces use of fully qualified
addresses at all times. The default is NO.
example: RejectUnqualifiedAddresses=NO
RejectRemoteRecipients
If set to YES, SMTPD
will reject remote recipients for incoming mail. This is to prevent remote sites spoofing
messages which get re-routed through the gateway. The default is YES.
example: RejectRemoteRecipients=YES
SmtpcPort
This specifies the TCP port
number to use for SMTP. The default is 25.
example: SmtpcPort=25
SmtpdPort
This specifies the TCP port
number to use for SMTPD. The default is 25.
example: SmtpdPort=25
WarnIfEmptyMsgSentOut
This option, when set to YES,
causes outbound empty messages to trigger a warning from postmaster. This is designed to
alert users who sometimes put their reply text in imported header text items, which gets
deleted on the way out (if DeleteMIMEHeaders is set to YES), resulting in an
empty message going out. The default is YES.
example: WarnIfEmptyMsgSentOut=YES
TryReverseSeparator
This option, if set to YES
causes both address separators to be compared with incoming addresses during default
address translation. The default is NO.
example: TryReverseSeparator=NO
KillSMTPDzombie
When this option is set to YES,
SMTPD checks for [config] SMTPDmainSocket on startup. If this is not set to NONE,
this socket number indicates the main socket used by SMTPD when it shutdown
prematurely last time around. An attempt to close this socket is performed, so that SMTPD
does not get an "address already in use" error the next time around. The default
is YES.
example: KillSMTPDzombie=YES
MimePreambleFile
MIME messages contain an empty
or null section, also known as the MIME preamble area, where either no information is
stored, or a short message useful to non-MIME gateways and UA's can be stored. This
section resides after the RFC 822 headers and the first MIME body part. If this option is
set to point to an existing file, the contents of this file is used as the MIME preamble
in outgoing messages. If set to a nonexistent file, no preamble is used. If not set, the
default preamble, which is built into Internet Exchange is used. The default is internal.
example: MimePreambleFile=c:\ieccmail\pre.txt
TabSize
The cc:Mail clilents typically
do not perform any TAB character expansion with incoming mail messages. To get around this
problem, Internet Exchange can be configured to perform automatic TAB expansion for
incoming messages. The TabSize paramater is used to set the tab size which appears
in the cc:Mail client program. This option is used to set the equivalent number of spaces
that are generated for each TAB character received. The default value is 8, which means
that a single TAB will be replaced by 8 spaces. If set to 0, TAB expansion conversion is
disabled.
example: TabSize=8
RFC822HeaderPlacement
The RFC822 header is treated as
an attachment in the cc:Mail client program. The location of this attachment can be
configured to be placed at either the top or the bottom of the attachment list. Valid
values for this option are top and bottom. The default is bottom.
example: RFC822HeaderPlacement=bottom
UseResentFrom
When enabled, Internet
Exchange will try to determine the existance of a Resent-From: header in
incoming messages. If this option is set to YES, the address found in the received Resent-From:
header will be mapped to the cc:Mail From address if no RFC822 From: field is
detected and if no Reply-To: field is detected and UseReplyTo is enabled.
The default is YES.
example: UseResentFrom=YES
ForceNative
By enabling this
option, inbound Macintosh attachments (in BinHex, MacMIME or uuencoded Applesingle format)
are stripped of their file header and (if present) the resource fork before being attached
to messages in the cc:Mail Post Office. If this is not done, some applications (Excel 4
for Windows as an example) may refuse to open the resulting file. The default is NO.
example: ForceNative=NO
ForceApple
By enabling this option,
inbound non-Macintosh file attachments are automatically given a dummy header and
converted into AppleSingle cc:Mail attachments. The default is NO.
example: ForceApple=NO
ScanOutboundMAChqx
Macintosh files can sometimes
be encoded by the user manually using BinHex encoding and then locally stored. Such
encoded files typically carry a ".hqx" extension identifying them as Macintosh
BinHex encoded files. If the ScanOutboundMAChqx option is enabled, files attached
to cc:Mail messages with a ".hqx" extension will not be re-encoded, and attached
to the message in their original BinHex encoded format. The default is YES.
example: ScanOutboundMAChqx=YES
DefaultSendPermission
The ability for local cc:Mail
users to send Internet mail is determined by the send property for the user in the Alias
mapping and directory databases. If a user does not have a specific mapping in one of
these databases, the system default send permission, defined by this option, is used. The
default for this option is YES.
example: DefaultSendPermission=YES
DefaultReceivePermission
The ability for local cc:Mail
users to receive Internet mail is determined by the receive property for the user in the
Alias mapping and directory databases. If a user does not have a specific mapping in one
of these databases, the system default receive permission, defined by this option, is
used. The default for this option is YES.
example: DefaultReceivePermission=YES
SendOldLogFile
At the time a logfile is
renamed, it is also possible to send a copy of this file to the postmaster. The default
for this option is NO.
example: SendOldLogFile=NO
KeepOldLogFile
Over time, as logfiles are
renamed, if not manually maintained, they can start to consume significant amounts of disk
space. If the KeepOldLogFile option is set to NO, the old logfiles are
automatically removed instead of being renamed. The default is YES.
example: KeepOldLogFile=YES
RejectUnqualifiedAddresses
This option is used by SMTPD
durring the MAIL FROM portion of the SMTP protocol. If this option is enabled and SMTPD
receives an originator address that is not fully qualified, it will be rejected. If RejectUnqualifiedAddresses
is not enabled and a non-fully qualified address is received, Internet Exchange
will add the remote machine's host name to the address to obtain a fully qualified
address. The default is NO.
example: RejectUnqualifiedAddresses=NO
[DelayedMail]
Each line in the [DelayedMail]
section identifies options related to the way Internet Exchange handles mail that
experiences delivery delays
EnableNotification
This option enables the
generation of delayed mail notification to message originators. If EnableNotification
is enabled, users will be notified by return mail when a message is delayed for a period
of time longer than SendNotificationAfter. The default is NO.
example: EnableNotification=NO
SendNotificationAfter
This is the period of time (in
hours) a message is held in an Internet Exchange message queue without being
delivered for delayed notification purposes. If EnableNotification is enabled,
messages in the queue for a period of time longer than this option will have delayed
notification messages generated. The default is 4.
example: SendNotificationAfter=4
DelayMessageFile
When Internet Exchange
generates a delayed notification message, it normally uses a builtin message text
template. The DelayMessageFile allows the administrator to specify an alternate
text file to use instead of the builtin text. The default message path is c:\ieccmail\delay.txt.
If no file exists in this location, the default message text is used.
example: DelayMessageFile=c:\ieccmail\delay.txt
WarnOnlyOnce
Messages that have been delayed
for an extended period can generate many delayed notification messages. If this is not the
desired result, by setting WarnOnlyOnce, the message originator will only receive a
single warning message for each delayed message. The default is YES.
example: WarnOnlyOnce=YES
EnableSuccessNotification
This option enables the
generation of successful mail notification to message originators for messages that have
previously been delayed in transit. If EnableSuccessNotification is enabled, users
will be notified by return mail when a message that has been previously delayed has
been finally delivered. The default is NO.
example: EnableSuccessNotification=NO
SuccessDeliveryMessageFile
For messages that have been
delayed, and eventually delivered to their final recipient, a message indicating eventual
sucessful delivery can be sent back to the originator. When Internet Exchange
generates a positive notification message, it normally uses a builtin message text
template. The SuccessDeliveryMessageFile allows the administrator to specify an
alternate text file to use instead of the builtin text. The default message path is c:\ieccmail\success.txt.
If no file exists in this location, the default message text is used.
example: SuccessDeliveryMessageFile=c:\ieccmail\delay.txt
[Confirm]
The values in the [confirm]
section are boolean values that take on the values of either YES or NO. They
determine whether to ask the user for confirmation before performing the action desired.
They are just a convenience for experienced users and do not yet have an ADMIN interface.
Quit
This value is used to confirm
exit of ADMIN. The default is YES.
example: Quit=YES
DeleteMsg
This value is used to confirm
deletion of messages. The default is YES.
example: DeleteMsg=YES
MessageDeleted
This value is used to control
display of a message deleted confirmation dialog. The default is YES.
example: MessageDeleted=YES
ClearLog
This value is used to confirm
clearing of the logfile. The default is YES.
example: ClearLog=YES
[Config]
The [config] section
stores configuration information used by the gateway.
Version
The current version of the
gateway software. This value should not be changed.
Viewer
The program used to view the
logfile. Defaults to write.exe if unspecified.
example: Viewer=c:\windows\write.exe
Addressfile
The name and location of
address file. This value should not be changed.
example: Addressfile=c:\ieccmail\smtp.adr
Domainfile
The name and location of domain
file. This value should not be changed.
example: Domainfile=c:\ieccmail\smtp.pod
InstallDirectory
This entry is created by the
install script and used by other programs. This value should not be changed.
example: InstallDirectory=c:\ieccmail
HelpFile
This is the location of the
Internet Exchange help file. This value should not be changed.
example: HelpFile=c:\ieccmail\ieccmail.hlp
SetupHelpFile
This is the location of the
Internet Exchange setup help file. This value should not be changed.
example: SetupHelpFile=c:\ieccmail\imasetup.hlp
UpSince
This records the time and date
when Internet Exchange was last started. It is useful in tracking how long the
gateway has been in continuous operation. There is no default value.
[Tuning]
The options in the [tuning]
section contain configurable tuning parameters used in SMTP.
SMTPDtimeout
This variable indicates the
timeout value (in minutes) used in SMTPD. It should not need to be changed, but if unusual
delays are experienced, this can be adjusted to stop SMTPD from timing out.
example: SMTPDtimeout=5
SMTPCInitialTimeout
Defines the period (in minutes)
SMTPC is to wait for the initial contact of a remote host to complete. The default
value is 5 minutes.
example: SMTPCInitialTimeout=5
SMTPCHeloTimeout
Defines the period (in minutes)
SMTPC is to wait for the remote system to respond to HELO. The default is 5 minutes
example: SMTPCHeloTimeout=5
SMTPCQuitTimeout
Defines the period (in minutes)
SMTPC is to wait for the remote system to respond to QUIT. The default is 5
minutes.
example: SMTPCQuitTimeout=5
SMTPCMailTimeout
Defines the period (in minutes)
SMTPC is to wait for the remote system to respond to MAIL FROM. The default is 5
minutes.
example: SMTPCMailTimeout=5
SMTPCRcptTimeout
Defines the period (in minutes)
SMTPC is to wait for the remote system to respond to RCPT TO. The default is 5
minutes.
example: SMTPCRcptTimeout=5
SMTPCDataTimeout
Defines the period (in minutes)
SMTPC is to wait for the remote system to respond to DATA. The default is 5
minutes.
example: SMTPCDataTimeout=5
SMTPCDataBlockTimeout
This variable defines the
period (in minutes) SMTPC is to wait for the remote system to acknowledge an
individual buffer transmission of the message data. Another way of looking at this is the
period which SMTPC is willing to wait between writes to the Winsock stack before it
considers the remote system "dead". The default is 5 minutes.
example: SMTPCDataBlockTimeout=5
SMTPCDataEndTimeout
Defines the period (in minutes)
SMTPC is to wait for the remote system to respond to DATA phase wrap up. The
default is 5 minutes.
example: SMTPCDataEndTimeout=5
DataBufferSize
This is a numeric value that
sets the file read buffer size (in bytes) used by SMTPC. The maximum value that can be
configured is 32K. If you are utilizing disk caching software, set this value to the size
of its caching-unit (a.k.a. read-ahead) size. The default value is 4096 (4K).
example: DataBufferSize=4096
DNStimeout
If set, this option specifies
the number of seconds before a DNS timeout is registered. The default is 5.
example: DNStimeout=5
DNSretries
If set, this option specifies
the number of times a DNS query is retried after a timeout. Note: DNS retries
utilize an exponential-backoff timer to vary the period between retries. The default is 4.
example: DNSretries=4
[Debug]
These options in the [debug]
section are not normally needed, and are only used for tracking problems.
LogFileIO
This value, if set, will log
all file I/O functions. Valid values are TRUE and FALSE. Note: This
will produce a huge amount of output.
example: LogFileIO=TRUE
DetailedSMTPlog
If this option is set to YES,
and logging is in diagnostic mode, detailed SMTPC and SMTPD Winsock activity
will be logged. The default is NO.
example: DetailedSMTPlog=NO
[License]
The values in the [License]
section store Internet Exchange licensing information
SerialNumber
This is the numeric value that
corresponds to the Internet Exchange serial number. This will be different for each
installation and should not be changed.
example: SerialNumber=46
License Key
This is the numeric value of
the IMA license key. This is supplied by IMA when enabling the gateway license. This
value, consisting of 16 hexadecimal digits, must be entered exactly as supplied by your
licensing agent, except that upper and lower case of the hex digits A-F are not important.
example: LicenseKey=38c74bc0f239d5be
IEccMailInstallDate
This is the date that Internet
Exchange was installed. This value should not be changed.
example: IEccMailInstallDate=Thu Aug 03 11:11:01 1995
ExpirationDate
For sites that are running with
Interim or evaluation license keys, this paramater stores the date in which the Internet
Exchange license will expire. This field is not used by the gateway, but is present to
aid IMA Technical Support in cases where the analysis of a customer configuration file is
necessary.
[Addressing]
The [Addressing]
section effects how default Internet to cc:Mail user address mappings are performed.
PrimaryATWord
When this option is set, this
is the value of the main word used by cc:Mail to separate the user name from the post
office name. The default is the character string "AT".
example: PrimaryATWord=AT
ATWordList
When this option is set, it
corresponds to the list of possible local AT words used by various international
versions of cc:mail locally. The default is NONE.
example: ATWordList=NONE
[Rules-based Addressing]
The [Rules-based
Addressing] section stores the rules that are generated by the Rules Editor
within Internet Exchange. These rules are stored one per line within this section.
It is highly recommended that these values not be hand modified, but only updated
via the Rules Editor.
example: Rule1=FA_L1SR
Rule2=F1M2L3S
[Charset Map]
The [Charset Map]
section stores the character set mapping used in the address translation process. This
information is generated by the Character Set Mapping Editor inside Internet
Exchange. The character set mapping is used to map the extended ASCII code (i.e. the
character codes which are outside the range of 0 - 127) to ASCII characters. It is
recommended that these mapping only be modified using the Character Set Mapping Editor.
example: 129=a
220=ea
[Dynamic Conversion]
The [Dynamic Conversion]
section is used by the Internet Exchange conversion programs when converting
between the internal database file formats and the older (pre-1.1) flat file databases
(SMTP.ADR, SMTP.POD, etc).
AutoCheckAddressFile
This option is used to enable
to automatic conversion of SMTP.ADR files to the Internet Exchange Alias database.
When the gateway detects a modification of the SMTP.ADR file, and with AutoCheckAddressFile
set to YES, the gateway database file will automatically be updated. The default is
NO.
example: AutoCheckAddressFile=NO
AutoCheckDomainFile
This option is used to enable
to automatic conversion of SMTP.POD files to the Internet Exchange Domain database.
When the gateway detects a modification of the SMTP.POD file, and with AutoCheckAddressFile
set to YES, the gateway database file will automatically be updated. The default is
NO.
example: AutoCheckDomainFile=NO
UseNewAddressFileFormat
Send permission, receive
permission, and comment fields were added to the SMTP.ADR file format with Internet
Exchange Version 1.1. When the routine checking of the SMTP.ADR file is
enabled, the SMTP.ADR file will be updated if the database is modified inside the Config
Users dialog box. If this option is disabled, the new three fields will not be updated
to the SMTP.ADR file. The default is NO.
example: UseNewAddressFileFormat=NO
SMTPADR
This specifies the location of
the SMTP.ADR text file. The default path is c:\ieccmail\smtp.adr.
example: SMTPADR=c:\ieccmail\smtp.adr
SMTPPOD
This specifies the location of
the SMTP.POD text file. The default path is c:\ieccmail\smtp.pod.
example: SMTPPOD=c:\ieccmail\smtp.pod
Published: February 1996
|