You can configure a notification message to be sent when an email message has changed status.
A message-flags notification is produced whenever a status flag has changed because the email message was:
Answered
Flagged
Deleted
Seen (read)
Draft
When a message-flags notification is sent, the notification carries the following properties:
The flags set for the email message before its status changed
The flags set for the email message after its status changed
This information is carried in two properties, oldflags and newflags, which are 5–character strings.
For a description of the values of these two properties, see Syntax for newflags and oldflags Properties.
To enable message-flag notifications, you must configure the following configutil parameters:
local.store.notifyplugin.MsgFlags
local.store.notifyplugin.*.MsgFlags.enable
The first MsgFlags parameter enables the IMAP server and message store to identify and track the changing values of the status flags so that this information can be delivered in notification messages.
This parameter applies to all notification plug-ins. Therefore, you must enable the parameter if any notification plug-in uses message-flag notifications. If no plug-in uses message-flag notifications, be sure that this parameter is disabled (its default value).
The second parameter, *.MsgFlags.enable, allows message-flag notifications to be sent for a particular plug-in library.
You must configure both parameters to enable notifications for message flags.