使用转换实用程序向消息中添加 IMAP 摘要属性

IMAP 服务使用消息中的特殊 IMAP 摘要属性（$Content_Type、IMAP_BodyStruct 和 IMAP_RFC822Size）来实施消息头的发送过程，以响应客户机的请求。为使用 IMAP 而对邮件文件进行转换之后，对于以 MIME 格式接收消息的用户，路由器会自动向它传递的新消息中添加这些项目。

关于此任务

但是，这些项目可能不会添加到邮件文件内的所有消息中。以 Notes® 富文本格式传递的消息不包含这些项。而且 Domino® 不会向转换之前传递的消息自动添加这些项目。

虽然 IMAP 客户机可以读取不包含 IMAP 摘要属性的消息，但是该客户机必须完全下载每个消息之后才能显示消息头。要使消息头能被快速访存，请使用 -h 开关参数运行邮件转换实用程序，以便向没有 IMAP 摘要属性的消息添加 IMAP 摘要属性。

邮件文件在更改之后更新 IMAP 属性

关于此任务

对包含 IMAP_RFC822Size 属性的消息进行更改可能会影响用户访问该消息的能力。当 IMAP 属性的大小值与实际的消息大小不再匹配时，IMAP 客户机下载消息时可能遇到困难。如果实际的消息大小大于属性中表明的大小，则 IMAP 客户机可能不会下载整个消息。如果实际的大小小于属性中表明的大小，则 IMAP 客户机可能会由于试图下载预期的剩余消息数据而导致挂起。

由于消息传递之后运行的代理或者某些服务器配置选项的更改（如主管外发 MIME 转换选项的设置），消息的大小可能会不小心被更改。虽然外发 MIME 转换选项主要应用于通过 SMTP 向外发送的消息，但是也可能影响从服务器导出的任何消息，包括 IMAP 服务检索的要发送给客户机的消息。例如，如果更改了用于向用户的因特网回复地址添加 RFC 822 短语的设置，将使消息大小发生更改，这是因为 IMAP 客户机检索的每个消息中的因特网回复地址都会发生改变以符合新的设置。

要防止服务器配置的更改引起下载错误，请对 IMAP 属性进行更新以反映新的设置。要更新 IMAP 消息属性并刷新邮件文件的 MIME 目录，必须删除现有的属性，然后再进行添加。因为 IMAP 客户机会高速高速缓存标题信息，所以用户还必须重新创建他们的 IMAP 帐户才能成功下载消息。

注：对于其个人文档中将 Notes® 富文本格式指定为邮件存储首选项的 IMAP 用户会发生类似的问题。这种情况下，路由器不会向传递到邮件文件的消息添加 IMAP 属性，但是 IMAP 客户机还是会高速高速缓存大小信息。修改服务器的配置时（例如，将服务器设置为在消息转换为 MIME 时以 HTML 导出消息内容，而不是纯文本）会更改消息的大小。因为客户机希望现有消息的大小与它们高速高速缓存的大小相匹配，所以用户将不能再从 IMAP 客户机检索这些现有消息。要删除 IMAP 客户机高速高速缓存的标题信息，用户必须重新创建 IMAP 帐户。

运行邮件转换实用程序以添加或更新 IMAP 属性

过程

通过在控制台上输入下列命令，关闭包含待转换邮件文件的服务器上的路由器：
```
tell router quit
```
这可以防止 Domino® 将邮件路由到正在进行转换的邮件文件中。邮件文件升级过程中，邮件将存储在 MAIL.BOX 中。在转换完邮件文件并再次装入路由器任务后，路由器将处理并传递 MAIL.BOX 中的邮件。
输入下列命令可以装入邮件转换实用程序：
```
load convert [-h /-o] maildirectory\mailfilename
```
其中 maildirectory 表示包含该用户邮件文件的邮件子目录的路径，mailfilename 为该用户的邮件文件的文件名。maildirectory 路径描述的是相对于服务器的 Domino® 数据目录的路径。例如，要将 IMAP 属性添加到 Domino® 数据目录的 \MAIL 子目录中的邮件数据库 USER.NSF 中，请输入：
```
load convert -h mail\user.nsf
```
注：在 UNIX™ 系统上，请使用正斜杠 (/) 作为层次结构分隔符，而不要使用反斜杠 (\)。例如，输入：
```
load convert -h mail/user.nsf
```
要指定目录中的所有文件，请确保该目录只包含邮件文件，并且这些邮件文件都是要转换的邮件文件。例如，要将 IMAP 属性添加到 \MAIL 子目录中的所有邮件文件中，请输入：
```
load convert -h mail\*.nsf
```
警告：使用 -h 选项运行转换实用程序时，完成转换操作需要的时间可能较长。确切的时间取决于服务器的处理速度和内存，以及邮件文件的大小和内容。要确保能够在可用时间内完成转换，请先使用一个邮件文件运行一个测试，然后再使用通配符运行多个转换。
在此服务器上为使用 IMAP 而启用邮件文件之后，通过输入下列命令可以装入路由器：
```
load router
```