Help Center

Local Navigation

BlackBerry Mail Store Service

The BlackBerry Mail Store Service connects to the messaging servers in your organization's environment and retrieves the contact information that the BlackBerry Administration Service requires to search for user accounts on the messaging servers.

The BlackBerry Mail Store Service performs the following actions:
  • synchronizes your organization's contact list to the BlackBerry Configuration Database
  • updates the contact list in the BlackBerry Configuration Database every 24 hours automatically
  • permits the BlackBerry Administration Service to access user account information that is stored in the mailbox or mail file on the messaging servers
  • exposes an API that the BlackBerry Administration Service can use to connect to the BlackBerry Mail Store Service
  • searches for contact information on behalf of the BlackBerry Administration Service

You install a BlackBerry Mail Store Service when you install a BlackBerry Enterprise Server. The BlackBerry Mail Store Service connects to the messaging server using the same connection information that the BlackBerry Enterprise Server uses. The BlackBerry Administration Service is designed to communicate with the BlackBerry Mail Store Service using RPC.

Database tables in the BlackBerry Configuration Database that store contact information

The BlackBerry® Mail Store Service synchronizes contact information to two database tables in the BlackBerry Configuration Database.

Table name

Description

MsDomains

This table contains a list of domains and messaging servers that are located in your organization's environment.

MsAddresses

This table contains a list of the email addresses that are included in your organization's contact list.

Contact information that the BlackBerry Mail Store Service stores in the BlackBerry Configuration Database

The BlackBerry® Mail Store Service synchronizes contact information that is stored in the messaging environment to the BlackBerry Configuration Database. To compare the contact information changes that occurred between synchronization processes, the BlackBerry Mail Store Service maintains two copies of the contact information.

The BlackBerry Mail Store Service synchronizes contact information that is stored in the messaging environment to the BlackBerry Configuration Database. The contact information is stored in database properties in the BlackBerry Configuration Database.

Contact information

Database property name

Database property name in BlackBerry Configuration Database version 4.1

Description

address type

Type

This property specifies whether this is the address for a user or distribution list.

display name

DisplayName

UserConfig.DisplayName

This property specifies the display name for the user account.

email address

MailboxSMTP

UserConfig.MailboxSMTPAddr

This property specifies the email address for the user account.

mailbox path

MailboxKey

UserConfig.MailboxDN

This property specifies the unique mailbox path.

messaging server path

ServerName

UserConfig.ServerDN

This property specifies the path to the messaging server.

How the BlackBerry Mail Store Service accesses contact information that is stored on the messaging server

Configuring the BlackBerry Mail Store Service instance that updates the contact list

The BlackBerry® Configuration Database contains your organization's contact list and a list of BlackBerry® Enterprise Server instances. By default, the BlackBerry Mail Store Service instance that you installed with the first BlackBerry Enterprise Server instance that appears in the list updates the contact list. If you prevent the BlackBerry Mail Store Service that you installed with the first BlackBerry Enterprise Server instance from updating the contact list, the next available BlackBerry Mail Store Service instance in the list updates the contact list.

By default, if you install multiple BlackBerry Mail Store Service instances, each instance can update the contact list in the BlackBerry Configuration Database. The first BlackBerry Mail Store Service instance that updates the contact list prevents the other instances from also updating the contact list. Each BlackBerry Mail Store Service instance searches for time stamp information in the BlackBerry Configuration Database to determine if another BlackBerry Mail Store Service instance is updating the contact list already before it starts to update the contact list.

You must verify that at least one BlackBerry Mail Store Service instance can update the contact list in the BlackBerry Configuration Database so that the BlackBerry Administration Service can access the latest contact list information when you create and manage user accounts. If you prevent all of the BlackBerry Mail Store Service instances from updating the contact list, the BlackBerry Configuration Database might not contain the contact information for all user accounts on your organization's messaging server.

If the BlackBerry Configuration Database does not contain contact information for a user account, you cannot create the user account by searching for the contact information in the BlackBerry Administration Service. You can only create the user account if you use the Add from company directory option in the BlackBerry Administration Service. The Add from company directory option permits the BlackBerry Mail Store Service to search the contact information that is stored in the messaging environment so that you can create the user account even if the BlackBerry Configuration Database does not contain the contact information for the user account.


Was this information helpful? Send us your comments.