Extended parameters of the module *EMAIL

Select the *EMAIL module by entering option number 8 into the corresponding choice box. In the dialog program "Change i-effect Module Data", parameters can now be modified.

The following options for the *EMAIL module can be set:

SSL Determine if SSL (Secure Socket Layer) will be used to establish a connection to the email server.

*YES YES, SSL is used.

*NO NO, a standard connection is to be established.

SSL Connection Certificate If *YES is set in the parameter "SSL", the name of the certificate in the keystore, which will be used for authentication of the email server, can be entered here. In SSL connections, the email server identifies to the client by transmitting its X509 certificate to the client when the connection is established. The client decides whether the certificate is known and valid, and therefore, whether the email server can be trusted. The certificate defined here is compared to the certificate sent by the email server. Of course, the email server's certificate must be imported into the i-effect^® keystore before establishing a connection.

Use Client Authentication ? This parameter no longer applies.

Import Untrustworthy Certificates ? Enter the value *YES into this parameter to automatically import email server certificates. The email server identifies to the client by transmitting its X509 certificate itself when the connection is established. If the certificate does not exist in the i-effect^® keystore, it will be imported automatically.
If the value *NO is entered into this parameter and the certificate of the remote server does not exist in the i-effect^® keystore, the connection will automatically be closed

*YES YES, server certificates are automatically imported.

*NO NO, server certificates are not imported.

Use TLS ? This parameter is dropped.

Email Client Connection Timeout

Define the time in seconds that the client waits for connection establishment. If the time has expired, a timeout notification will be sent.

CODE

Possible values: 5-36000

Maximum Email Client Threads Enter the maximum number of simultaneous email-client-connections.

SMTP Host/IP

Define the SMTP email server that will be used to send emails. It may be either a DNS name or a TCP/IP address in the form of xxx.xxx.xxx.xxx.

All email servers working according to SMTP protocols, e.g. Lotus Notes or Microsoft Exchange, can be used.

SMTP Port Define the TCP/IP port that will be used for SMTP communication. The default port for SMTP is 25.

SMTP User ID Enter the user ID of the user authorized to access the SMTP server.

SMTP Password Enter the password of the user being authorized to access the SMTP server.

SMTP Sender Enter the sender of outbound emails sent via SMTP.

SMTP Reply-to

Enter an address to which a reply to the email should be sent.
Possible special value:

*SENDER

The Reply-to email address is identical to the sender's address.

SMTP Error-to

Enter an address to which an error notification should be sent
Possible special value:

*SENDER

The Error-to email address is identical to the sender's address.

SMTP Text Format

This parameter defines which format is to be used for the message text.
The following values are possible:

*PLAIN	Simple Text The entered text, or text imported from an external file, will be sent as email with content type „text/plain".
*HTML	HTML Text The entered text, or text imported from an external file, will be sent as email with content type „text/html". The text will be put into a standard HTML structure and needs not to be available as HTML file. If the external file is a HTML file (file extension .htm or .html), the content will not be put into a standard HTML structure but will be sent as it is. Therefore, it is possible to send arbitrary HTML contents as email.
*BOTH	Text and HTML The entered text, or text imported from an external file, shall be sent as email with content type „ multipart/alternative ". („text/plain" and „text/html"). The text will be put into a standard HTML structure. The email client on the remote side decides which of the two parts will be displayed (depending on the preferences of the particular email-client-program).

SMTP Encryption

This parameter defines the character set that is to be used for the message text. Data will be converted into the code page defined in this setting before sending.
The following values are possible:

*UNICODE	Universal character set
*ISO-8859-1	ISO-8859-1 (Latin1) covers most of the Western European languages, e.g. French (fr), Spanish (es), Catalan (ca), Basque (eu), Portuguese (pt), Italian (it), Albanian (sq), Rhaeto-Romanic (rm), Dutch (nl), German (de), Danish (da), Swedish (sv), Norwegian (no), Finnish (fi), Faeroese (fo), Icelandic (is), Irish (ga), Scottish (gd) and English (en), partly Afrikaans (af) and Swahili (sw). Therefore, it covers the entire American continent, Australia, parts of Asia and a big part of Africa.
*ISO-8859-2	SO-8859-2 (Latin2) covers the languages of Central and EasternEurope: Czech (cs), Hungarian (hu), Polish (pl), Romanian (ro), Croatian (hr), Slovak (sk), Slovenian (sl), Sorbian.
*ISO-8859-3	SO-8859-3 (Latin3) is to be used for Esperanto (eo) and Maltese (mt), and covered Turkish before the introduction of Latin5 in 1988.
*ISO-8859-4	ISO-8859-4 (Latin4) contains letters for Estonian (et), the Baltic languages, Latvian (lv) and Lithuanian (lt), Greenlandic (kl) and Sami languages.
*ISO-8859-5	These Cyrillic letters cover Bulgarian (bg), Belorussian (be), Macedonian (mk), Russian (ru), Serbian (sr) and before 1990 Ukrainian (uk).
*ISO-8859-6	Dies ist das Arabische Alphabet, leider nur das einfache Alphabet für die Arabische (ar) Sprache ohne die vier Persischen (fa) und acht Pakistanischen (Urdu, ur) Extrabuchstaben.This is the Arabic alphabet, but regrettably just the simple one for Arabian (ar) without the four Persian (fa) and eight Pakistani (Urdu, ur) extra letters.
*ISO-8859-7	This is the (modern monotonic) Greek (el) alphabet.
*ISO-8859-8	Dies ist die Hebräische Schrift benutzt in Hebräisch (iw) und Jiddisch (ji).This is the Hebrew script, used for Hebrew (iw) and Yiddish (ji).
*ISO-8859-9	ISO-8859-9 (Latin 5) replaces the rarely used Icelandic specific characters with Turkish letters.
*ISO-2022-JP	The Japanese Katakana DBCS character set.
*ISO-2022-KR	The Korean DBCS character set.
*ISO-2022-CN	The Chinese DBCS character set.

Archive Outbound Emails	This parameter determines if outbound emails are to be stored in the archive directory. The email will be stored entirely including possible attachments. The following values are possible:
	*YES	YES, emails are archived after sending.
	*NO	NO, emails are archived after sending.
SMTP Archive Directory	The default IFS path where sent emails are stored.
SMTP Priority	This parameter defines the priority by which the email is sent. The following values are possible:
	*NORMAL	Normal Priority. The email is marked with normal priority.
	*LOW	Low Priority. The email is marked with low priority.
	*HIGH	High Priority. The email is marked with high priority.
MDN Request	This parameter determines if a receipt confirmation (MDN) is requested for sent emails. If the receiving system supports this function, an email (MDN) to confirm the reception of the original email will be generated automatically. The following values are possible:
	*YES	Request MDN. Reciept confirmation is requested.
	*NO	MDN is not requested. Reciept confirmation is not requested.

SMTP Proxy Host

If a proxy server is used for sending emails, enter its IP address or DNS name here.

SMTP Proxy Port

If a proxy server is used for sending emails, enter its TCP/IP port here.

SMTP Proxy User ID

Enter, if required, the user ID of the user being authorized to access the proxy server.

SMTP Proxy Password

Enter, if required, the password of the user being authorized to access the proxy server.

SMTP Signature Alias

Enter the alias of the key pair (private key) in the keystore, which is used for signature.

SMTP Signature Algorithm

This parameter determines if the outbound email has to be signed electronically. If an email is signed electronically, it allows the receiver to check it for authenticity and integrity as well as its origin by using his public key.
Possible values:

*NONE	No Signature. The email is not signed.
*MD5	MD5 Signature The signature is generated using the MD5 algorithm (Message Digest Algorithm 5). It is a widespread cryptographic hash function, generating a 128bit hash value.
*SHA1	SHA1 Signature The signature is generated using the SHA-1 algorithm (secure hash algorithm). This algorithm, designating a group of standardized cryptographic hash functions, generates a 160bit hash value.

SMTP Encryption Alias	Enter the alias of the public key (certificate) in the keystore, which is used for encryption.
SMTP Encryption Algorithm	This parameter determines if the outbound email must be encrypted before sending. If an email is encrypted using the partner's public key, it can only be decrypted by the partner with his private key. Possible values:
	*NONE	No encryption. The email is not encrypted.
	*TRIPLEDES	3DES Encryption The email is encrypted by the 3DES (Data Encryption Standard) It is a widespread symmetric encryption algorithm. Its key length of 3DES (= 168 bits) is three times as long as with DES (= 56 bits).

POP Host/IP	This parameter defines the email server that is be used to receive emails. Enter either a DNS name or a TCP/IP address in the form of xxx.xxx.xxx.xxx. Every server working according to the POP3 or IMAP protocol can be used, e.g. Lotus Notes or Microsoft Exchange. An account, which is read out with the command RCVEMAIL, must be created on the server.
POP Port	The TCP/IP port number, under which the mail server can be accessed. The standard value for a SMTP server is 25, for POP3 it is 110 and for IMAP mostly 143.
POP User ID	Usually, authentication is necessary to login to the POP3/IMAP server. The user ID defined here is used for this purpose.
POP Password	Enter the password related to the user ID.

POP Protocol

This parameter determines the protocol that will be used to receive emails.
The following values are possible:

*POP3

The POP3 protocol is used.

*IMAP

The IMAP protocol is used.

Archive Inbound Emails

Determines if inbound emails will be archived. The email will be stored entirely including possible attachments.
The following values are possible:

*YES

YES, received emails are archived.

*NO

NO, received emails are not archived.

Archive Directory

Enter the directory where received emails are to be stored.

Attachment Directory

Enter the IFS directory where attachments of incoming emails are stored.

Inline Text Directory

Enter the directory where the textual content of incoming emails is stored.

POP Proxy Host

If a proxy server is used for receiving emails, enter its IP address or DNS name here.

POP Proxy Port

If a proxy server is used for receiving emails, enter its TCP/IP port here.

POP Proxy User ID

Enter, if required, the user ID of the user authorized to access the proxy server.

POP Proxy Password

Enter, if required, the password of the user authorized to access the proxy server.

Type of Call

This parameter defines whether the calling server waits for a feedback or is immediately available for further action.

*SYNCH	Synchronous means the system will wait for an answer from the remote side, with for example RCV/SNDEMAIL, all files will be sent, before further actions can be taken.
*ASYNCH	The Power Systems server is immediately available for further actions, because processing of the remote-controlled call runs in the background.