BlackBerry Messaging Agent

This parameter indicates that the BlackBerry Messaging Agent is running or, if the BlackBerry® Enterprise Server uses multiple BlackBerry Messaging Agent instances, that all BlackBerry Messaging Agent instances are running. The BlackBerry Messaging Agent sets this parameter when it calculates the current health score of the BlackBerry Messaging Agent.

User accounts

This parameter indicates that a target percentage of user accounts are healthy (by default, the target percentage is 75%). The BlackBerry Dispatcher calculates the percentage of healthy user accounts based on the health score that the BlackBerry Messaging Agent sends to the BlackBerry Dispatcher. The BlackBerry Dispatcher compares the calculated percentage to a target percentage that is stored in the BlackBerry Configuration Database. If the BlackBerry Messaging Agent is not running, the BlackBerry Dispatcher determines that all user accounts that you assigned to the BlackBerry Messaging Agent are unhealthy.

The BlackBerry Messaging Agent sets this health parameter if it determines that all user accounts are healthy. If the BlackBerry Messaging Agent determines that some user accounts are unhealthy, the BlackBerry Messaging Agent clears the health parameter value and sends the number of unhealthy user accounts to the BlackBerry Dispatcher.

Connection to the messaging server(s)

This parameter indicates that a target percentage of messaging servers are healthy (by default, the target percentage is 75%). The BlackBerry Dispatcher calculates the percentage of healthy messaging servers based on the health score that the BlackBerry Messaging Agent sends to theBlackBerry Dispatcher. The BlackBerry Dispatcher compares the calculated percentage to a target percentage that is stored in the BlackBerry Configuration Database.

The BlackBerry Messaging Agent sets this health parameter if it can connect to all messaging servers. If the BlackBerry Messaging Agent cannot connect to a messaging server, the BlackBerry Messaging Agent clears the parameter value and sends the number of unavailable messaging servers to the BlackBerry Dispatcher. The BlackBerry Messaging Agent tests the connection to a messaging server every minute if the BlackBerry Messaging Agent is not making other calls to the messaging server.

If your organization's environment includes the BlackBerry® Enterprise Server for Microsoft® Exchange, and the BlackBerry Messaging Agent cannot connect to one or more of the messaging servers, the BlackBerry Messaging Agent sends the list of unavailable messaging servers to the BlackBerry Dispatcher.

If your organization's environment includes the BlackBerry® Enterprise Server for IBM® Lotus® Domino®, and the BlackBerry Messaging Agent cannot connect to one or more of the messaging servers directly, it tries to connect to one of the cluster mates of the messaging servers. The BlackBerry Messaging Agent considers a messaging server unhealthy if the BlackBerry Messaging Agent cannot connect to the messaging server or to one of the cluster mates of the messaging server.

At least one user account

This parameter indicates that at least one user account that you assigned to the BlackBerry Messaging Agent is healthy.

Calendar synchronization

This parameter indicates that the BlackBerry Messaging Agent can synchronize calendars. If your organization's environment includes the BlackBerry Enterprise Server for Microsoft Exchange, the BlackBerry Messaging Agent sets the health parameter if it can synchronize calendars with the messaging server. The BlackBerry Messaging Agent tests calendar synchronization periodically (by default, every 10 minutes), if it is not synchronizing calendars actively.

If your organization's environment includes the BlackBerry Enterprise Server for IBM Lotus Domino, the BlackBerry Messaging Agent synchronizes messages and the calendar using the same API. The BlackBerry Messaging Agent always sets this health parameter when it calculates the health score for the current BlackBerry Messaging Agent.

Address lookup

This parameter indicates that the BlackBerry Messaging Agent can look up addresses. The BlackBerry Messaging Agent tests whether it can look up addresses every minute if it is not actively looking up addresses.

Attachment viewing

This parameter indicates that the BlackBerry Attachment Service can process attachments.

The BlackBerry Messaging Agent sets this parameter if the BlackBerry Attachment Service can load the extension DLL and the BlackBerry Attachment Service reports that it is healthy. The BlackBerry Attachment Service reports that it is healthy by processing attachment viewing requests or when it is requested to report its health through the GetHealthScore function. The BlackBerry Messaging Agent calls the GetHealthScore function every minute if the BlackBerry Attachment Service is not processing attachments actively.

Organizer data synchronization

This parameter indicates that the PIM connector, which is a subcomponent of the BlackBerry Messaging Agent, is healthy.

The BlackBerry Messaging Agent sets this health parameter if it can deliver requests for organizer data synchronization. If the BlackBerry Messaging Agent is not synchronizing organizer data actively, the BlackBerry Messaging Agent tests the health of the PIM connector every 10 minutes by sending a configuration request to the user account that is the least busy of all the user accounts.

If your organization's environment includes the BlackBerry Enterprise Server for IBM Lotus Domino, the BlackBerry Messaging Agent must connect to the BlackBerry Configuration Database before it can set this parameter.