The EMAILX configuration file is designed to contain those parameters which are most likely to be user-definable yet constant for a given site or application. The file is normally called EMAILX.CFG, although you specify the name (and location; there is no search path) yourself in the EMAILX statement. The file is a typical text configuration file, and it uses this syntax:
<parameter name> = <value> ; <optional comment>
Note that the config file paramters are case INsensitive.
Parameters
|
Parameter |
Description |
|
SMTP authentication. | |
|
DOMAIN |
DOMAIN is a strictly optional parameter which specifies the domain to be added to any unqualified address, thus allowing you to abbreviate the addresses, say, for your local company by dropping the @ and everything after it. For example, if DOMAIN=microsabio.com, then if you specify the address "admin" in the to or from fields, it will automatically be expanded to "admin@microsabio.com". |
|
HOST |
HOST fulfills the same purpose here as it does in the XCALL parameter list, and is used only if HOST is blank or not specified in the XCALL. This is typically your domain name, and is used to identify your computer or domain to the SMTP server when making the initial connection. Theoretically, the SMTP server may decide to accept or reject you based on whether it recognizes or can resolve this domain name. |
|
Log file name | |
|
Log level | |
|
Password. | |
|
REPLYTO |
REPLYTO is an important parameter often confused with the return address. This is where mail will be sent if the reader clicks the "Reply" button in their email client. It may or may not be the same as the address of the person (or cyber-entity) that actually sent the message. If specified, it inserts a line in the message header reading "Reply-To: " followed by the specified address. |
|
RTNADDR |
Return address |
|
Enable/Disable secure EHLO message | |
|
Type of secure connection. | |
|
SMTP server name | |
|
Signature file | |
|
USERNAME |
USERNAME fulfills the same purpose here as it does in the XCALL parameter list, and is used only if the AUTH parameter is specified, and the USERNAME is blank or not specified in the XCALL. |
|
Maximum wait for SMTP response |
Sample
;EMAILX.SBX configuration file
WAIT = 10 ; max wait (secs) for SMTP response
SERVER = localhost ; SMTP server
SECURE = STARTTLS ; use STARTTLS protocol
AUTH = * ; SMTP auth mode (LOGIN or PLAIN)
USERNAME = yo@micasa.com ; SMTP login username
PASSWORD = secret ; SMTP login password
HOST = microsabio.com ; HELO (sending domain)
DOMAIN = microsabio.com ; default domain to add to unqualified addrs
RTNADDR = ashell@microsabio.com ; return address (default FROM address)
REPLYTO = replyto@microsabio.com ; default Reply-To address
SIGNATURE = EMAILX.SIG ; signature file (text, amos or native spec)
LOGFILE = EMAILX.LOG ; log file name (amos or native)
LOGLVL = 3 ;