Sun Java System Messaging Server 6.3 管理指南

22.3.5.2 特定通知郵件的專屬特性

表 22–4 說明特定通知郵件帶有的特性。

每封郵件包含下表所示的特性之子集。如需與每封郵件相關的特性清單,請參閱表 22–5

表 22–4 特定通知郵件的專屬特性

特性 

資料類型 

說明 

client

ConstMQString 

與郵件相關的郵件佇列用戶端之 IP 位址。 

diskquota

MQInt32 

與郵件相關的使用者之磁碟空間配額 (以 KB 為單位)。此值設定為 -1 表示沒有配額。 

diskquotaused

MQInt32 

與郵件相關的使用者所用的磁碟空間量 (以 KB 為單位)。 

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 

在電子信箱中依各種郵件類型指定且標示為已讀取且已刪除的郵件總數。如果配置了郵件類型,numSeenDeleted nn 特性會帶有各種郵件類型 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 

與郵件相關的使用者 ID。 


備註 –

訂閱者解析郵件參照時,應允許未加以說明的特性。這可在未來新增特性時允許相容。


newflags 和 oldflags 特性的語法

newflagsoldflags 特性是 5 個字元的字串。此字串必須有以下值: