CONFIGURING


Convert utility options

The convert utility provides several options for the Convert task useful for IMAP mail databases. The convert -d option can be used to convert non-mail databases.

Table 1. Convert utility options
OptionUse
-eEnables mail files for IMAP use.
-hTo enable clients to download message headers more efficiently, the Convert task processes all messages in the mail file in the order in which they are listed in the mail file's All Documents view and adds the special IMAP attributes ($Content_Type, IMAP_BodyStruct, and IMAP_RFC822Size) to messages that don't have them.

Because the Convert task is single-threaded, and this option requires the Convert task to process every message in the mail file, it is resource-intensive and can take a long time, especially for mail files where messages must also be converted from Notes® rich text to MIME format.

You cannot use this option in combination with the -e switch.

-mEnables or disables folder references needed for IMAP.
-oRemoves from messages the IMAP items used to provide more efficient header retrieval. You may use this option in combination with the -h option, but not with the -e option.
-e-Disables IMAP access to mail files (note the minus symbol in the command).

How the conversion utility handles unread marks

In previous releases of Notes and Domino®, mail files maintained separate sets of unread marks for IMAP clients and Notes clients, with IMAP-enabled mail files relying on special template views to indicate that a message was read. With the introduction of native IMAP, a mail file enabled for IMAP displays a consistent set of unread marks to the IMAP and Notes clients opening the file.

Related concepts
The IMAP service

Related tasks
Using load convert to convert non-mail databases
Upgrading mail files with the mail conversion utility