Lotus Domino Administrator 8.5 Help - Setting advanced outbound MIME options

MAIL

Setting advanced outbound MIME options
Outbound MIME settings apply to messages sent over SMTP to another host. They do not apply to messages delivered to local mail files on the server or messages transferred over IBM® Lotus® Notes® routing.

Use the advanced outbound MIME options to specify how servers determine the following message items:

Encoding for attachments sent from Macintosh clients
Use of phrases specifying the sender's user name in the sender's Reply address
Sending of Notes mail items that do not have standard MIME equivalents
Removal of Notes fields from message headers
Character set to use when converting multilingual messages
Character set alias to use in place of one that is typically mislabeled in outgoing messages

To set advanced outbound MIME options

1. From the Domino Administrator, click the Configuration tab and expand the Messaging section.

2. Click Configurations.

3. Select the Configuration Settings document for the mail server or servers you want to administer, and click Edit Configuration.

4. Click the MIME - Advanced - Advanced Outbound Message Options tab.

5. Complete the following fields, and then click Save & Close:

Field Enter

Macintosh attachment conversion The format for Macintosh attachments. Choose one:

AppleDouble [base64 only] - (default) Provides standard MIME encoding for sending Macintosh files to recipients using newer Macintosh and PC mail programs. AppleDouble splits the data fork and the resource fork of the file and encodes the resulting data in Base 64 for transport. PC clients receiving the attachment discard the resource fork and use the data fork only.
The AppleDouble header is effectively the resource fork and includes the original Mac file name of the file. If the AppleDouble data part has a recognizable MIME type, Domino uses it to label the MIME part of the converted message; for example, the data part of a Microsoft Word attachment is described as application/msword. If the MIME type cannot be determined, Domino labels the MIME part as application/octet-stream.

BinHex4.0 - Sends Macintosh attachments with the MIME type application/mac-binhex40. Use this method for sending Macintosh files to other Macintosh users who do not use MIME-compliant mail programs. Because few Microsoft® Windows® mail programs can decode BinHex, this method should not be used when sending files to recipients who use Windows.

RFC822 phrase handling Specifies how the server handles phrases in an address header. Choose one:

Do not add phrase (default) - Outbound mail displays the sending user's RFC 821 address. The Router permits user-defined phrases in recipient addresses.
Use DN as phrase (Use domain name for the phrase) - The Router constructs an RFC 822-style address using a phrase part derived from the person's hierarchical, distinguished name; for example, "John Jones/Sales/ACME" <JJones@acme.com>. The Router permits user-defined phrases in recipient addresses.
Use alt. name if available - otherwise DN (Use the alternative name or domain name) - If an Alternate name is specified in the user's Person document, constructs an RFC 822-style address using it as the phrase part; otherwise uses the hierarchical, distinguished name; for example, "John Jones/Sales/ACME" <JJones@acme.com>. The Router permits user-defined phrases in recipient addresses.
Remove phrase - Only RFC 821-style addresses allowed. The Router strips user-defined phrases in recipient addresses.
Use CN as phrase - Constructs an RFC 822-style address using a phrase part derived from the person's common name; for example, "John Jones" <JJones@acme.com>. The Router permits user-defined phrases in recipient addresses.

Internet mail server sends Notes private items in messages Notes private items are header items present in a Notes rich-text message that do not map to any of the standard header fields for SMTP messages, as defined in RFC 2822. When adding private items to the headers of an SMTP message, Domino adds the prefix "x-notes-item" to the field name to indicate that it is a nonstandard field.
Choose one:

Enabled - When converting Notes rich-text messages for SMTP transport or download by a POP3 or IMAP client, Domino converts all Notes private items in the message to custom "x-notes-item" headers. The resulting "x-notes-item" is a structured header with parameters that reflect the attributes of the original notes item, for example, data type, value, summary flags, item name, and so on. Because Notes private items are not generally used in Internet mail, do not select this option unless you have a specific reason for sending private items.
Note Items specified in the field "Notes items to be removed from headers" are excluded from the headers of the converted message.

Disabled - (default) When converting Notes rich-text messages for SMTP transport, Domino removes nonstandard Notes header items.

Always send the following Notes items in headers List the Notes header items to always include as RFC 2822 headers in outbound SMTP messages, mapping each specified Notes item to a valid nonstandard RFC 2822 header item. For example, the Notes item, header-1 would be mapped to the RFC 2822 header, x-header-1. The header body is the first 255 bytes of the item value, converted to text if necessary.
Domino sends the items specified in this field even if sending of Notes private items is disabled. Use this field to send specific items only, while preventing export of all unspecified Notes private items.
Note If an item listed in this field is also listed in the field "Notes items to be removed from headers," the item is not included.

Notes items to be removed from headers List the Notes header items to exclude from x-headers in outbound SMTP messages.

When converting a multilingual message to MIME Specifies the character set Domino uses when converting a Notes rich-text message with text content that cannot be represented by a single character set group -- for example, a message in which part of the content is in French (Western character set group) and part in Arabic. Choose one:

Send it in Unicode [UTF8] - (default) Domino converts all the text to an 8-bit encoding of the Unicode character set. To read the resulting message, recipients' mail programs must support Unicode.
Send it in most representable character set - Domino selects the character set that best matches the majority of characters in the message. If the message is sent as plain text, any character that cannot be represented by the selected character set is replaced by a fallback character -- typically a question mark. If the message is sent as HTML, a Unicode-enabled mail program is required to decode the message because such a mail program can replace unrepresentable characters with their Unicode numeric values.

Character set name aliases Specifies the name of a nonstandard character set alias to be used when converting Notes rich-text messages for outbound SMTP transfer. For example, you can send messages sent in ISO-8859-1 with the tag "My-Character-Set." It is not recommended that you provide aliases here because outbound messages will be understood only by similarly configured mail clients.

Note These settings apply to messages sent outbound over SMTP to another host, or exported to the IMAP or POP3 service. They are not applied to messages delivered locally or messages transferred over Notes routing.

6. The change takes effect after the next Router configuration update. To put the new setting into effect immediately, reload the routing configuration.

Related topics

Setting advanced inbound MIME options

Setting inbound and outbound MIME and character set options

Configuring outbound Internet mail to use RFC 822 address format (phrase parts)

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary

Field	Enter
Macintosh attachment conversion	The format for Macintosh attachments. Choose one: AppleDouble [base64 only] - (default) Provides standard MIME encoding for sending Macintosh files to recipients using newer Macintosh and PC mail programs. AppleDouble splits the data fork and the resource fork of the file and encodes the resulting data in Base 64 for transport. PC clients receiving the attachment discard the resource fork and use the data fork only. The AppleDouble header is effectively the resource fork and includes the original Mac file name of the file. If the AppleDouble data part has a recognizable MIME type, Domino uses it to label the MIME part of the converted message; for example, the data part of a Microsoft Word attachment is described as application/msword. If the MIME type cannot be determined, Domino labels the MIME part as application/octet-stream. BinHex4.0 - Sends Macintosh attachments with the MIME type application/mac-binhex40. Use this method for sending Macintosh files to other Macintosh users who do not use MIME-compliant mail programs. Because few Microsoft® Windows® mail programs can decode BinHex, this method should not be used when sending files to recipients who use Windows.
RFC822 phrase handling	Specifies how the server handles phrases in an address header. Choose one: Do not add phrase (default) - Outbound mail displays the sending user's RFC 821 address. The Router permits user-defined phrases in recipient addresses. Use DN as phrase (Use domain name for the phrase) - The Router constructs an RFC 822-style address using a phrase part derived from the person's hierarchical, distinguished name; for example, "John Jones/Sales/ACME" <JJones@acme.com>. The Router permits user-defined phrases in recipient addresses. Use alt. name if available - otherwise DN (Use the alternative name or domain name) - If an Alternate name is specified in the user's Person document, constructs an RFC 822-style address using it as the phrase part; otherwise uses the hierarchical, distinguished name; for example, "John Jones/Sales/ACME" <JJones@acme.com>. The Router permits user-defined phrases in recipient addresses. Remove phrase - Only RFC 821-style addresses allowed. The Router strips user-defined phrases in recipient addresses. Use CN as phrase - Constructs an RFC 822-style address using a phrase part derived from the person's common name; for example, "John Jones" <JJones@acme.com>. The Router permits user-defined phrases in recipient addresses.
Internet mail server sends Notes private items in messages	Notes private items are header items present in a Notes rich-text message that do not map to any of the standard header fields for SMTP messages, as defined in RFC 2822. When adding private items to the headers of an SMTP message, Domino adds the prefix "x-notes-item" to the field name to indicate that it is a nonstandard field. Choose one: Enabled - When converting Notes rich-text messages for SMTP transport or download by a POP3 or IMAP client, Domino converts all Notes private items in the message to custom "x-notes-item" headers. The resulting "x-notes-item" is a structured header with parameters that reflect the attributes of the original notes item, for example, data type, value, summary flags, item name, and so on. Because Notes private items are not generally used in Internet mail, do not select this option unless you have a specific reason for sending private items. Note Items specified in the field "Notes items to be removed from headers" are excluded from the headers of the converted message. Disabled - (default) When converting Notes rich-text messages for SMTP transport, Domino removes nonstandard Notes header items.
Always send the following Notes items in headers	List the Notes header items to always include as RFC 2822 headers in outbound SMTP messages, mapping each specified Notes item to a valid nonstandard RFC 2822 header item. For example, the Notes item, header-1 would be mapped to the RFC 2822 header, x-header-1. The header body is the first 255 bytes of the item value, converted to text if necessary. Domino sends the items specified in this field even if sending of Notes private items is disabled. Use this field to send specific items only, while preventing export of all unspecified Notes private items. Note If an item listed in this field is also listed in the field "Notes items to be removed from headers," the item is not included.
Notes items to be removed from headers	List the Notes header items to exclude from x-headers in outbound SMTP messages.
When converting a multilingual message to MIME	Specifies the character set Domino uses when converting a Notes rich-text message with text content that cannot be represented by a single character set group -- for example, a message in which part of the content is in French (Western character set group) and part in Arabic. Choose one: Send it in Unicode [UTF8] - (default) Domino converts all the text to an 8-bit encoding of the Unicode character set. To read the resulting message, recipients' mail programs must support Unicode. Send it in most representable character set - Domino selects the character set that best matches the majority of characters in the message. If the message is sent as plain text, any character that cannot be represented by the selected character set is replaced by a fallback character -- typically a question mark. If the message is sent as HTML, a Unicode-enabled mail program is required to decode the message because such a mail program can replace unrepresentable characters with their Unicode numeric values.
Character set name aliases	Specifies the name of a nonstandard character set alias to be used when converting Notes rich-text messages for outbound SMTP transfer. For example, you can send messages sent in ISO-8859-1 with the tag "My-Character-Set." It is not recommended that you provide aliases here because outbound messages will be understood only by similarly configured mail clients.