wiki:Documentation/Configuration

Version 2 (modified by damato, 2 years ago) (diff)

--

Configuration

YAM has a huge number of options, which can be set up in the configuration window. The program options are divided into sheets which can be selected by clicking on the corresponding word in the left part of the configuration window. There are also three menu items available.

First Steps

This sheet contains some essential information needed for YAM to work.

Minimal configuration

Full Name

Your real name and surname.  Please take care that this field is filled in correctly.  DO NOT use quotation marks in your name.

Example: John Doe

E-mail address

This is your e-mail address, consisting of your <username>@<domainname>.

Example: jdoe@…

Mail server

The Internet address (hostname or IP) of your system's mail server. This server, which normally is a computer of your ISP (Internet Service Provider), must be capable of working with the POP3/SMTP protocol.

Example: mail.example.com

User name

The user name for logging into the mail server of your ISP.

Example: jdoe

Password

The password which is asked from you by your mail server. This password is possibly but not necessarily identical to the password you use to log in on your ISP, and is usually case sensitive.

Example: nguz56

Time zone

Timezone

The time and date displayed by YAM in the message list is always converted to your local time. This guarantees correct sorting of messages from all over the world sent out from different time zones. The time zone is part of the message's date and specifies the difference between local time and Greenwich Mean Time (GMT).

Examples: GMT+01:00 (for Central Europe), GMT 00:00 (for the U.K.), GMT-05:00 (for U.S. EST e.g. New York City)

Normally YAM will get the time zone from your Locale settings, thus this selector will be ghosted.

Add adjustment for daylight saving time

This option is to be activated during daylight saving time. By doing so, one hour will be added to the time zone value. YAM automatically changes to/from daylight saving time if the operating system support DST switching (e.g. AmigaOS4) or if a AutoDST tool like SetDST, FACTS or SummertimeGuard is installed. This is indicated by ghosting this checkbox.

Example: John Doe

TCP/IP

Here you can enter the information needed to actually send email, as well as define additional POP3 accounts.

Send mail (SMTP)

Apart from the primary SMTP server already defined in the First steps section, you can set up an unlimited number of SMTP servers here; the names appear in the list on the left and clicking on a name brings up the relevant details on the right. Note that these accounts can be for the same user on a different server, or a different user on the same server. Either way, you can check for new mail with a single mouse click. Click on [New] to insert the data required for a new e-mail account. With [Delete] you can delete accounts.

Server

The Internet address of the system you're sending your mail to. This server, which usually is a computer of your ISP (Internet Service Provider), must be capable of processing the SMTP protocol.

Example: mail.example.com

Port

The port number of the SMTP service. The standard port is 25 for plain SMTP. In case of using SSL/TLS connections this port may also be 576 or 456.

Example: 25

SMTP server allows 8bit

Originally only the US-ASCII character set was allowed for use in e-mail, which meant that users were forced to use vowels (e.g., they had to use 'ae' instead of 'ä'). The reason for that was that many servers only processed the first 7 bits and simply cut off the 8th bit, crippling the e-mail while doing so. This problem was solved by introducing the MIME quoted-printable standard, which converts all 'unauthorized' characters to 7 bit before transfer and reconverts them to the original characters on delivery. Modern mail servers don't have problems with non-US-ASCII characters any more, so messages do not necessarily have to be converted. If you are absolutely sure that your server supports 8 bit transfers, you can switch this option on and save a few bits when transferring e-mails. The best way to find out if your mail server supports this is to write a message to yourself containing modified vowels and see what happens.

Example: Yes

Use SMTP AUTH

Enable this if you want to use SMTP Authentication, whereby YAM will request your mail server to use an extra authentication layer as documented in RFC 2554. You will need to fill in another couple of UserID/Password fields in this case. If your SMTP server does not support SMTP AUTH, you will receive an error message when trying to send email. Ask your ISP if in doubt.

Example: No

Use SMTP TLSv1/SSLv3

Enable this if your SMTP server supports TLSv1/SSLv3 secure connections. If enabled, YAM will connect via the AmiSSL library with the SMTP server and encrypts every transfer.

Example: No