Navigation:  Programs > Windows GUI Applications >

EMSETUP

Previous pageReturn to chapter overviewNext page

E-Mail Configuration and Testing

EMSETUP [updatecfg]


The EMSETUP program displays data to assist in the configuration of CopiaFacts e-mail transmissions. It must be run on the same node (each node) that is used for e-mail operations, to configure transmissions on that node.

The top box in the EMSETUP window displays the DNS settings of the node which will be used by F7EMAIL.DLL. If no items, or incorrect items, are shown, then you need to use Windows network settings dialogs to fix this:

The second box displays the IP address determined by visiting www.copia.com/ip.  This shows the detected IP address from your IP headers. Check the box if you have only one node sending e-mail and if you want to copy the value into the configuration file:

The third box contains a form to specify that e-mails are to be sent via a local mailserver (such as that provided by your ISP) instead of CopiaFacts contacting directly the recipient's mailserver. This feature should not be used if you are sending large volumes of e-mail, such as e-mail broadcasts.  It causes e-mails to take longer to arrive and removes the ability to detect delivery failures.

Enter the normal SMTP server, login and password information that you would normally enter in a mail client.  The authentication box should be checked to force an authenticated login.

If you leave the e-mail domains box blank, all e-mail will be sent via the ISP. The entries in this box must otherwise be the MX record names for the domain(s) you wish to handle in this way.  For example if you want to add mail to yahoo.com, first obtain the MX records for yahoo.com:

All you need to enter in the e-mail domains box is a common and unique substring which will identify mail to one of these MX domains:

Mail directed to any MX record name which has "mx.mail.yahoo.com" as a substring will then be sent instead via the nominated ISP.

The local ISP specified is also used as the mailserver when an e-mail retry operation $retry_delays entry has a prefix of 'I'.  Note that if this is only use you will make of the via-ISP feature, you must enter a string in the e-mail domains box which cannot be a substring of any domain name. This is because leaving the box empty causes all e-mail to be sent via the specified ISP.  A suitable substring is "@" since this is not a valid character in a domain name:

The above entry in conjunction with an ISP login will set up for sending e-mail via the ISP, but will not automatically send e-mail by this means. The $retry_delays 'I' prefix will only send e-mail via the ISP for the specific retry operation.

The command-line parameter "updatecfg" will cause EMSETUP to get the external IP address, update the $email_localname in the CFG file (for all lines), and terminate without displaying the normal EMSETUP dialog. This allows you to arrange for the localname to be set on system or CopiaFacts startup to allow for systems using a dynamic IP address. The use of a static IP address for all CopiaFacts e-mail operations remains strongly recommended, and this feature should be limited to test systems only.


Topic url: http://www.copia.com/support/refmanual/index.html?emsetup.htm