Sun Java System Messaging Server 6.3 管理指南

22.3.5.2 特定于特定通知邮件的属性

表 22–4 描述了特定通知邮件包含的属性。

每个邮件包含下表中属性的一个子集。有关与每个邮件相关的属性列表,请参见表 22–5

表 22–4 特定于特定通知邮件的属性

属性 

数据类型 

说明 

client

ConstMQString 

与邮件相关的 Message Queue 客户端 IP 地址。 

diskquota

MQInt32 

与邮件相关的用户磁盘空间配额,以千字节为单位。值设置为 -1 表示没有配额。 

diskquotaused

MQInt32 

与邮件相关的用户磁盘空间使用量,以千字节为单位。 

hdrLen

MQInt32 

邮件标题大小。请注意,这可能不是邮件正文中标题的大小,因为此标题可能已经被截断。 

imapUid

MQInt32 

与邮件相关的 IMAP uid 属性。 

lastUid

MQInt32 

邮箱中使用的最后一个 IMAP uid 值。 

mailboxName

ConstMQstring 

与事件相关的消息存储邮箱名称。mailboxName 可以使用以下几种格式之一(其中 uid 是用户的唯一标识符):

uid — 标识默认(主)域中用户的收件箱。

uid@domain — 标识托管域中用户的收件箱。

uid/mailboxname — 标识默认域中用户的顶层邮箱。

uid@domain/mailboxname — 标识托管域中用户的顶层邮箱。

uid/foldername/mailboxname — 标识默认域中用户文件夹中的邮箱。

uid@domain/foldername/mailboxname — 标识托管域中用户文件夹中的邮箱。

msgquota

MQInt32 

用户的最大邮件数配额。值设置为 -1 表示没有配额。 

newflags

ConstMQString 

用户的邮箱邮件被当前操作改变后设置的标志。在生成 MsgFlags 通知邮件时,此属性总是与 oldflags 一起出现。

有关 newflags 的语法和值,请参见此表下面的newflags 和 oldflags 属性的语法

numDeleted

MQInt32 

邮箱中标记为已删除的邮件数量。 

此数值统计被邮箱所有者删除的邮件。如果其他用户访问此邮箱,他们在邮箱中的操作不包括在此计数内。(但是,其他用户的操作能够触发通知,如 DeleteMsg )。

numDeletednn

MQInt32 

邮箱中为每种邮件类型指定的标记为已删除的邮件总数。如果配置了邮件类型, 

numDeletednn 属性将包含每种邮件类型 nn 的计数。

始终发送 numDeleted 属性;它统计所有标记为已删除的邮件的总数,包括所有类型。

例如,如果 20 个邮件被标记为已删除,其中 10 个是类型 3,7 个是类型 16,而其余的不属于任何已识别的类型,则通知中包含以下属性和计数: 

numDeleted=20

numDeleted3=10

numDeleted16=7

numMsgs

MQInt32 

邮箱中当前邮件总数。 

numMsgsnn

MQInt32 

邮箱中为每种邮件类型指定的当前邮件总数。如果配置了邮件类型, 

numMsgsnn 属性将包含每种邮件类型 nn 的计数。

始终发送 numMsgs 属性,它统计邮箱中所有邮件的总数,包括所有类型。

例如,如果邮箱中当前有 20 个邮件,其中 10 个是类型 3,7 个是类型 16,而其余的不属于任何已识别类型,则通知中包含以下属性和计数: 

numMsgs=20

numMsgs3=10

numMsgs16=7

numSeen

MQInt32 

邮箱中标记为已读(已阅读)的邮件数。 

此数值统计已被邮箱所有者阅读的邮件。如果其他用户访问此邮箱,他们在邮箱中的操作不包括在此计数内。(但是,其他用户的操作能够触发通知,如 ReadMsg)。

numSeennn

MQInt32 

邮箱中为每种邮件类型指定的标记为已读(已阅读)的邮件总数。如果配置了邮件类型,numSeen nn 属性将包含每种邮件类型 nn 的计数。

始终发送 numSeen 属性;它统计邮箱中所有标记为已读的邮件的总数,包括所有类型。

例如,如果邮箱中有 20 个标记为已读的邮件,其中 10 个是类型 3,7 个是类型 16,而其余的不属于任何已识别类型,则通知中包含以下属性和计数: 

numSeen=20

numSeen3=10

numSeen16=7

numSeenDeleted

MQInt32 

邮箱中标记为已读(已阅读)和已删除的邮件数。  

此数值统计已被邮箱所有者标记为已阅读和已删除的邮件。如果其他用户访问此邮箱,他们在邮箱中的操作不包括在此计数内。(但是,其他用户的操作能够触发通知,如 ReadMsgDeleteMsg)。

numSeenDeletednn

MQInt32 

邮箱中为每种邮件类型指定的标记为已读(已阅读)和已删除的邮件总数。如果配置了邮件类型,numSeenDeletednn 属性将包含每种邮件类型 nn 的计数。

始终发送 numSeenDeleted 属性;它统计邮箱中所有标记为已读和已删除的邮件的总数,包括所有类型。

例如,如果邮箱中有 20 个标记为已读和已删除的邮件,其中 10 个是类型 3,7 个是类型 16,而其余的不属于任何已识别类型,则通知中包含以下属性和计数: 

numSeenDeleted=20

numSeenDeleted3=10

numSeenDeleted16=7

oldflags

ConstMQString 

用户的邮箱邮件被当前操作改变前设置的标志。在生成 MsgFlags 通知邮件时,此属性总是与 newflags 一起出现。

有关 oldflags 的语法和值,请参见此表下面的newflags 和 oldflags 属性的语法

quotaRoot

ConstMQString 

此属性可以是用户名、文件名或邮件类型。 

size

MQInt32 

邮件大小。请注意,此属性可能不是邮件正文的大小,因为正文通常是邮件被截断的版本。 

uidValidity

MQInt32 

IMAP uid 有效性属性。 

userid

ConstMQString 

与邮件相关的 userid。 


注 –

在解析邮件引用时,订户应该允许没有记录的属性。这考虑未来添加新属性时的兼容性。


newflags 和 oldflags 属性的语法

newflagsoldflags 属性是 5–字符字符串。此字符串必须有以下值: