load convert [arguments]
and press ENTER.
The mail conversion utility command uses arguments to specify options. It has the form:
load convert -? /? -a -c -d -e -f -g -h -i -l -m -n -o -proxy -r -s -u
-w -x mailfilepath existingtemplatename newtemplatefilename
Mailfilepath specifies which mail file or files to upgrade.
Existingtemplatename specifies a certain mail file design to upgrade (for example, only mail files using Notes 8 design). This property is found in the Template Name field on the Database Properties - Design tab.
Newtemplatefilename specifies the template with which to upgrade the mail files.
Options | Description |
-a Admin Name | Enables sending mail to the administrator when the convert tool completes. |
-c | Converts categories to folders. |
-d | Do not convert categories to folders. |
-e or -e- | Enables or disables NSF support for IMAP. Converts the file or files for IMAP use in Notes 8.5. |
-f <file name> | Reads the list of databases to process from a text file. |
-g"Language Name" | Replaces the mail file design with user's preferred language. |
-h | Adds the IMAP specific items to optimize fetches. |
-i | Converts categories to folders, even if there are more than 200 categories. |
-l <file name> | Generates a list of mail files by reading people's mail files from the Domino Directory. Writes the list to a text file. |
-m | Enables or disables folder references which are needed for IMAP. Converts the file or files for IMAP use in Notes 8.5. |
-n | Shows the databases that match the file name and template name criteria, without actually updating anything. |
-o | Removes IMAP-specific items. |
-proxy | Enables a display status and error messages in a console window. |
-r | Enables recursive search of databases. Converts mail files in subdirectories of the specified directory. |
-s | Ignores the preserve flag for folders when replacing the design but always preserve them. |
-u | Enables the upgrade of folders to the same design as the $inbox design. |
-w <dir path> | Enables fix up of names in Notes in all mail files on the server to allow for Microsoft Exchange Mail Migration. |
-x | Enables exclusive design element keys: <NAME><CLASS><LANGUAGE> |
-? /? | Displays help information. Displays command line help. |
Task | Description |
Upgrading a single mail database | This example finds the mail database USER.NSF in the \MAIL subdirectory of the Notes data directory. The mail conversion utility replaces the current mail template -- regardless of which template the mail file uses -- with MAIL85.NTF, the Notes 8.5 mail template.
load convert mail\user.nsf * mail85.ntf |
Upgrading all mail databases in a directory | This example finds all databases located in the \MAIL subdirectory of the Notes data directory that use StdR6Mail, the Notes 6 mail template, and replaces their design template with MAIL85.NTF, the Notes 8.5 mail template.
load convert mail\*.nsf StdR6Mail mail85.ntf |
Upgrading all mail databases in a directory and in its subdirectories | This example finds all databases located in the \MAIL subdirectory of the Notes data directory and all subdirectories of the \MAIL directory (for example, C:\NOTES\DATA\MAIL\GROUP1, C:\NOTES\DATA\MAIL\GROUP2, and C:\NOTES\DATA\MAIL\GROUP3) and upgrades them to the Notes 8.5 mail template, MAIL85.NTF.
load convert -r mail\*.nsf * mail85.ntf |
Upgrading all mail databases listed in a text file | You can create a text file listing databases you want to upgrade and use it with the mail conversion utility to upgrade only those databases. For example, you can create the text file MAILLIST.TXT to list all the mail databases you want to upgrade and save it in the directory C:\TEMP. This example finds all databases listed in MAILLIST.TXT, determines whether the databases use a design template name that matches Mail*, (mail8.ntf for example), and replaces the designs of the matching databases with MAIL85.NTF), the Notes 8.5 mail template.
load convert -f c:\temp\maillist.txt mail*.ntf mail85.ntf |
Creating a text file that lists all mail databases in a directory | You can use the mail conversion utility to create a text file that lists all primary mail databases on the server (it does not list replica mail databases). This example creates a text file, MAILLIST.TXT, in the C:\TEMP directory. MAILLIST.TXT contains a list of primary mail databases on the server but excludes replica mail databases. After you create the text file using this option, you can use the file to upgrade the mail databases listed in it. See "Upgrading all mail databases listed in a text file" in this table.
load convert -l c:\temp\maillist.txt |
Converting mail files for use with IMAP in Notes 5 | If you use a Notes 5 mail file with IMAP, run the mail conversion utility to enable IMAP-specific features in the mail file. This example readies the mail database USER.NSF in the \MAIL subdirectory of the Notes data directory for use with IMAP.
load convert -m mail\user.nsf |
Converting mail files for use with IMAP in Notes 8 | If you use a Notes 8 mail file with IMAP, run the mail conversion utility to enable IMAP-specific features in the mail file. This example readies the mail database USER.NSF in the \MAIL subdirectory of the Notes data directory for use with IMAP.
load convert -e mail\user.nsf |
Upgrading custom folder design | You can use the mail conversion utility to upgrade custom folder design to the Inbox design. This example upgrades the custom folder design of all mail databases in the \Mail subdirectory of the Notes data directory to the Inbox design.
load convert -u mail\* |
Upgrading folder design of folders without the Preserve bit | The -s argument ignores any folder or view with the Preserve bit deselected. This bit corresponds to the "Do not allow refresh/replace to modify" option in the design properties. System folders and other design elements from the original template used to create the mail file do not have this bit set, even if the database is set to inherit from design. System folders, such as the Inbox, are not updated if you run the mail conversion utility with the -s argument. This affects mail files being upgraded to Lotus Notes 6 because required script libraries have been removed and action buttons have been upgraded.
load convert -s mail\* |
Changing the English mail design to a German mail design | load convert -g"German" TestMail.nsf * mail85_en_de.ntf |
Upgrade all previous users' mail designs listed in the file maillist.txt to Notes 8.5 mail design | load convert -u -f maillisttxt * mail85.ntf |
Performs address fixup for all Microsoft Exchange migrated mail databases in <dir path> and its subdirectories | load convert -w <db path> |
Performs address fixup on the given Exchange migrated mail database. | load convert -w <mail db path> |
Generates a text list containing all Exchange migrated mail databases from the primary mail directory, excluding replicas. This feature is of lesser-importance than address fixup but it is necessary in the event that the subsequent option is required. | load convert -w -l <text list path> |
Performs address fix-up on all Exchange-migrated mail databases listed in the given text list file. Provides flexibility in allowing the administrator to manage the databases that need address fix-up. | load convert -w -f <text list file> |