How to assign a BlackBerry smartphone user to a static mailbox agent on a BlackBerry Enterprise Server

Article ID: KB12766

Type: Support Content

Last Modified: 04-02-2014


Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server 4.1 to 5.0 for Microsoft Exchange

This article describes how to set a BlackBerry smartphone user to a static mailbox agent ID.

A static mailbox agent is a BlackBerry Messaging Agent process that administrators can create manually. Administrators can manage which users are assigned to static mailbox agents.

To assign a BlackBerry smartphone user to a static mailbox agent on BlackBerry Enterprise Server 4.1, complete the following steps:

  1. Open BlackBerry Manager.
  2. Select the All Users tab and right-click the BlackBerry smartphone user's account and select Edit Properties.
  3. In the Properties window, select the Advanced tab.
  4. Change Enable Static Mailbox Agent to True.
  5. Set Mailbox Agent ID to a value between 200 to 399.
  6. Click the Apply button to save the changes before closing the window.

To assign a BlackBerry smartphone user to a static mailbox agent ID in BlackBerry Enterprise Server 5.0, complete the following steps:

  1. Log into the BlackBerry Administration Service web console.
  2. Expand User under the BlackBerry Solution Management.
  3. Click Manage Users.
  4. Search for the specific BlackBerry smartphone user and click the user's display name.
  5. Click Component information in the user view.
  6. Click Edit user.
  7. Set Turn on static mailbox agent to Yes.
  8. Enter a number between 200 and 399 in the Mailbox agent ID field.
  9. Click Save all.
CollapseAdditional Information

Some of the potential uses of static mailbox agents are as follows:

  • Prevent BlackBerry smartphone users experiencing temporary problems in the BlackBerry messaging agent from affecting other users.
  • Proactively or reactively separate important users from other users in the event a messaging agent issue (such as busy working or no response threads) impacts users on another BlackBerry messaging agent.
  • Assign dedicated BlackBerry Enterprise Server resources and separate connections to Exchange for one or more BlackBerry smartphone users while another messaging agent is busy performing other activities. For example, mailbox rescans occur after restarting the BlackBerry Controller or BlackBerry Dispatcher services and a user assigned to a static mailbox agent would not have to wait for the mailbox rescans in other agents to complete.
  • Isolate one or more users with mailboxes that contain a large number of items to reduce the performance impact on other users.
  • Generate a separate log file for one or more users to make it easier to troubleshoot those users.

For example, this procedure might be useful as a temporary solution when BlackBerry smartphone user accounts are on a remote Microsoft Exchange Server and there is high network latency between the BlackBerry Enterprise Server and the Exchange server. Assigning those BlackBerry smartphone users to a static agent can help reduce the impact of network latency on BlackBerry smartphone user accounts on local Microsoft Exchange servers until a long-term solution can be implemented.

To remove a user from a static mailbox agent, see KB19297.

Note: If assigning multiple static agents, each one will initiate a new BlackBerryAgent.exe process and a new CalHelper.exe process on the BlackBerry Enterprise Server. Each of these processes will use resources on the BlackBerry Enterprise Server, including memory and processing power. The more BlackBerry messaging agents are running, the greater the potential performance impact on the BlackBerry Enterprise Server.


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

   (a) that the terms of use for the documents found at 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