Using the conversion utility to add IMAP summary attributes to messages
The IMAP service uses special IMAP summary attributes ($Content_Type
, IMAP_BodyStruct
,
and IMAP_RFC822Size
) in messages to facilitate the
process of sending message headers in response to client requests.
After you convert a mail file for IMAP use, for users who receive
messages in MIME format, the Router automatically adds these items
to new messages it delivers.
About this task
However, these items might not be added to all messages in a mail file. Messages delivered in Notes® rich text format do not contain the items. And Domino® does not automatically add these items to messages delivered before conversion occurred.
Although
an IMAP client can read messages that do not contain IMAP summary
attributes, the client must first download each message in its entirety
before it can display headers. To enable faster header fetching, run
the mail conversion utility with the -h
switch to
add IMAP summary attributes to messages that don't have them.
Updating IMAP attributes following mail file changes
About this task
Changing a message that contains the IMAP_RFC822Size
attribute,
might affect a user's ability to access the message. When the size
value of the IMAP attribute no longer matches the actual message size,
IMAP clients might have difficulty downloading the message. If the
actual message size is larger than the size indicated by the attribute,
the IMAP client might not download the entire message. If the actual
size is smaller than the size indicated by the attribute, the IMAP
client can hang as it attempts to download the remaining expected
message data.
Message size might change inadvertently as a consequence of an agent running after a message is delivered or of changes to certain server configuration options, such as the settings governing outbound MIME conversion options. Although the outbound MIME conversion options apply primarily to messages sent outbound over SMTP, they also affect any message exported from the server, including messages retrieved by the IMAP service for sending to a client. For example, if you change the setting for adding RFC 822 phrases to users' Internet return addresses, this changes message size, because the Internet return address in each message an IMAP client retrieves is altered to comply with the new setting.
To prevent changes to the server configuration from contributing to download errors, update IMAP attributes to reflect the new settings. To update IMAP message attributes and refresh the mail file's MIME directory, you must remove the existing attributes and then add them again. Because IMAP clients cache header information, users must also recreate their IMAP accounts to download messages successfully.