Unread marks synchronization is inconsistent between BlackBerry smartphone and IBM Lotus Notes

Article ID: KB05253

Type: Support Content

Last Modified: 10-31-2014


Product(s) Affected:

  • BlackBerry Enterprise Server for IBM Domino
  • BlackBerry Enterprise Server 4.0 to 5.0 SP4
  • IBM Domino 6.0, 6.5, 7.0, 8.0, and 8.5
  • DT 44719
  • DT 50187
  • DT 65372

The synchronization of read or unread marks is inconsistent between the BlackBerry smartphone and IBM Notes.


The following may cause this issue:

Cause 1

The BlackBerry Enterprise Server and the BlackBerry smartphone user do not have Manager and Editor rights to the mail databases.

Cause 2

Unread marks replication of the mail databases is not configured.

Cause 3

After performing a fail-over between the clustered replicas of the mail databases, the unread marks in the unread table are not synchronized. When the BlackBerry smartphone user clicks the mail database icon in IBM Notes, the email client accesses the replica in the secondary messaging and collaboration server. The BlackBerry smartphone user then notices differences in the read and unread messages on the BlackBerry smartphone.

Cause 4

Unread marks between the BlackBerry smartphone and the mail file became inconsistent while the IBM Notes email application was not running or not connected to the IBM Domino Server.

Cause 5

If the BlackBerry smartphone user's mail file version is prior to IBM Domino 6.0, the BlackBerry Messaging Agent does not synchronize read or unread marks to the associated BlackBerry smartphone.

Cause 6

The canonical name does not match the first item in the User Name field in the Person document.


Resolution for Cause 1

Complete the following steps in the IBM Domino Administration client:

  1. Go to File > Database > Access Control.
  2. In the access control list (ACL), make sure that either LocalDomainServers or the BlackBerry Enterprise Server is listed. If LocalDomainServers is listed, make sure the BlackBerry Server is a member of this group.
  3. Make sure that the User Type is Server and the Access is Manager and the Delete Documents option is checked.
  4. Also select Advanced Tab and set Maximum Internet name and password to Editor.

Resolution for Cause 2

Configure the replication of the unread marks. To do this, check the Database properties on the mail database replicas. Then, on the Advanced tab, select All servers under Replicate unread marks.

Resolution for Cause 3

To synchronize the unread table, perform a manual replication between the clustered mail database replicas in IBM Notes.

Note: Once the manual replication is complete, click View > Show Unread. The number of unread messages should match the number that appears on the Database icon in the mail database replicas (including the local desktop replica copy).

Resolution for Cause 4

On both the BlackBerry Enterprise Server and the IBM Domino Server, update to IBM Domino 6.0.4 or 6.5.4.

Resolution for Cause 5

To verify this, perform the following steps in the IBM Domino administration client:

  1. Go to File > Database > Properties.
  2. Select the i tab and check the On-Disk Structure (ODS) version (in IBM Domino 6.0, the ODS version is 43).

Note: If the mail file version is prior to IBM Domino 6.0, see the Workaround for Cause 5 steps in the Workaround section.

Resolution for Cause 6

If the canonical name shown in the BlackBerry smartphone user's Notes Client under File > Security > User Security > Name does not match the first item in the User Name field in their Person document in the Domino Directory, unread marks are not synchronized. For example:

  • User Name in Person Document = Andrew Paterson/Enterprise/Fleet
  • Name shown in User Security = Andrew Paterson/NCC-1701/Server

The BlackBerry Messaging Agent (MAGT) log will show that read/unread marks were successful saved in the Unread Marks table with changes FROM the BlackBerry smartphone. No changes will be detected going to the BlackBerry smartphone except during message pre-population after an Enterprise Activation. This happens because the BlackBerry Messaging Agent is looking at the unread table for Andrew Paterson/Enterprise/Fleet. In comparison, the IBM Domino server is using the unread table for Andrew Paterson/NCC-1701/Server.

Resolve the name inconsistency between the IBM Notes ID and their Person Document. The affected BlackBerry smartphone user will need his account recreated on the BlackBerry Enterprise Server in order to create a new BlackBerry State Database for them that references the correct unread mark table. Please refer to KB26797 for information about the consequences of removing a BlackBerry smartphone user's state database.


Workaround for Cause 5

In BlackBerry Enterprise Server 4.0 SP3, modify a registry key to enable and disable the BlackBerry Messaging Agent to check read or unread marks. The registry key controls whether or not the BlackBerry Enterprise Server will check the ODS version. If the functionality is enabled, wireless reconciliation of read or unread marks will occur regardless of the ODS version.

Warning: The following procedure involves modifying the computer registry. This can cause substantial damage to the Windows operating system. Document and back up the registry entries prior to implementing any changes.

Complete the following steps:

  1. In the registry, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents
  2. Create a new DWORD value named CheckMailTemplateVersionForOTAFM.
  3. Assign one of the following values:

    • 0 - where the BlackBerry Enterprise Server will check for read/unread marks
    • 1 - where the BlackBerry Enterprise Server will not check for read/unread marks

Important: Performing this workaround in IBM Domino prior to 6.0.4 or 6.5.4 may result in inconsistent reconciliation problems and is not recommended.


By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.

Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.