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

Option

Use

-e

Enables mail files for IMAP use.

-h

To 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.

This option may also cause a significant temporary increase in database size. Running compact -c on a mail file after using the -h option is recommended.

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

-m

Enables or disables folder references needed for IMAP.

-o

Removes 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.