Administration Guide

Local Navigation

Extension plug-ins for processing messages

You can add extension plug-ins to a BlackBerry® Messaging Agent. The BlackBerry Messaging Agent uses extension plug-ins to process and make changes to email messages and attachments that the BlackBerry Messaging Agent sends to and receives from BlackBerry devices. For example, you can add an extension plug-in to modify the signature in email messages.

Before you add an extension plug-in to the BlackBerry Administration Service, you must install the extension plug-in application on the computer the hosts the BlackBerry® Enterprise Server Express. By default, each BlackBerry Messaging Agent in your organization's BlackBerry Domain includes the extension plug-in BBAttachBESExtension, which connects the BlackBerry Messaging Agent to the BlackBerry Attachment Service so that the BlackBerry Attachment Service can process email message attachments. If you add multiple extension plug-ins to a BlackBerry Messaging Agent, you can define the order that the BlackBerry Messaging Agent uses the extension plug-ins to process email messages in.

Install an extension plug-in application

To add an extension plug-in to the BlackBerry® Administration Service, you must first install the application for the extension plug-in on the computer that hosts the BlackBerry® Enterprise Server Express.
Before you begin: Copy the .dll file for the extension plug-in application to the computer that hosts the BlackBerry Enterprise Server Express.
  1. On the computer that hosts the BlackBerry Enterprise Server Express, on the Start menu, click Run.
  2. Type regedit.
  3. Click OK.
  4. Perform one of the following actions:
    • If you are running a 32-bit version of Windows®, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents.
    • If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node\Research In Motion\BlackBerry Enterprise Server\Agents.
  5. If necessary, create a DWORD value named PlugIns.
  6. Double-click the PlugIns DWORD value.
  7. In the Value data field, type Name=<DLL_Name> Data=<DLL_Path>, where <DLL_Name> is a descriptive name of the .dll file and <DLL_Path> is the full path and file name for the .dll file.
  8. Click OK.
After you finish:
  • Restart the BlackBerry Enterprise Server Express.
  • Add the extension plug-in to a BlackBerry Messaging Agent.

Add an extension plug-in to a BlackBerry Messaging Agent

Before you begin: Install an extension plug-in application on the computer that hosts the BlackBerry® Enterprise Server Express.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Email.
  2. Click the instance that you want to change.
  3. Click Edit instance.
  4. On the Extension plug-ins tab, in the Extension plug-in name field, type the name of the extension plug-in that you want to add.
  5. Click the Add icon.
  6. Repeat steps 4 and 5 for each extension plug-in that you want to add.
  7. If necessary, click the Up and Down icons to set the order that the BlackBerry Messaging Agent uses the extension plug-ins to process email messages in.
  8. Click Save all.

Change how a BlackBerry Messaging Agent uses extension plug-ins

The BlackBerry® Messaging Agent uses a BlackBerry® Enterprise Server Express extension process to load extension plug-ins to process email messages. If you do not add an extension plug-in to the BlackBerry Administration Service, and you install the extension plug-in application on the computer that hosts the BlackBerry Enterprise Server Express, the extension plug-in is loaded directly by the BlackBerry Messaging Agent instead of the extension process. To stabilize and manage your organization's messaging environment, you can change how the BlackBerry Controller starts extension processes. For example, you can configure the BlackBerry Controller to start one extension process for all extension plug-ins, or you can configure the BlackBerry Controller to start separate extension processes for each extension-plug in.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Email.
  2. Click the instance that you want to change.
  3. Click Edit instance.
  4. On the Extension plug-ins tab, in the Extension mode section, in the Extension mode drop-down list, perform one of the following actions:
    • To configure the BlackBerry Controller to start a single extension process that loads all extension plug-ins for all BlackBerry Messaging Agent instances, click single.
    • To configure the BlackBerry Controller to start a dedicated extension process for each BlackBerry Messaging Agent instance, click perAgent.
    • To configure the BlackBerry Controller to start a dedicated extension process that loads each extension plug-in, click perExtension. Each BlackBerry Messaging Agent uses the same extension process to process a specific extension plug-in.
    • To configure the BlackBerry Controller to start a dedicated extension process for each extension plug-in for each BlackBerry Messaging Agent, click perAgentperExtension.
  5. Click Save all.

Was this information helpful? Send us your comments.