Administration Guide

Local Navigation

Managing push application requests

The BlackBerry® MDS Connection Service receives push application requests from server-side push applications and sends the requests to applications on BlackBerry devices. You can control how the BlackBerry MDS Connection Service processes, stores, and sends push application requests.

For more information about types of push requests, visit www.blackberry.com/developers to see the BlackBerry Java Development Environment Development Guide.

Specify device ports for application-reliable push requests

Application developers can create BlackBerry® Java® Applications to manage application-reliable push requests. When a BlackBerry Java Application receives an application-reliable push request, it sends a delivery confirmation message to the BlackBerry MDS Connection Service, which sends the message to the server-side push application. You must specify the device port numbers that the BlackBerry Java Applications listen on for application-reliable push requests.
Before you begin: Contact your organization's application developers for the unique port numbers that they defined for BlackBerry Java Applications that support application-reliable push requests.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > BlackBerry MDS Connection Service.
  2. Click the instance that you want to specify device ports for.
  3. Click Edit instance.
  4. In the Device ports enabled for reliable pushes field, type the device port number.
  5. Click the Add button.
  6. Repeat steps 4 to 5 for each device port number that you want to add.
  7. Click Save all.
  8. Click Restart instance.

Store push application requests in the BlackBerry Configuration Database

To manage memory and system resources in your organization's environment, you can configure a BlackBerry® MDS Connection Service to store PAP and Research In Motion® push requests in the BlackBerry Configuration Database. You can also configure storage settings for the BlackBerry Configuration Database. For more information about types of push requests, visit www.blackberry.com/developers to see the BlackBerry Java Development Environment Development Guide.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > BlackBerry MDS Connection Service.
  2. Click the instance that you want to change.
  3. Click Edit instance.
  4. In the Push access protocol section, in the Store push submissions drop-down list, click Yes.
  5. Click Save all.
  6. Click Restart instance.
After you finish: Configure the settings for storing push requests in the BlackBerry Configuration Database.

Configure the settings for storing push requests in the BlackBerry Configuration Database

To manage your organization's system resources, you can configure storage settings for push requests that are stored in the BlackBerry® Configuration Database.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
  2. Click BlackBerry MDS Connection Service.
  3. Click Edit component.
  4. In the Push message settings section, in the Maximum number of push messages stored field, type the number of push requests that you want the BlackBerry Configuration Database to store.
  5. In the Maximum push message age field, type the maximum length of time, in minutes, that you want the BlackBerry Configuration Database to store a push request before the BlackBerry® Enterprise Server deletes it from the BlackBerry Configuration Database.
  6. Click Save all.

Configure the maximum number of active connections that a BlackBerry MDS Connection Service can process

You can configure the maximum number of push connections that a BlackBerry® MDS Connection Service can process at the same time. The BlackBerry MDS Connection Service queues the push connections that exceed this limit.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > BlackBerry MDS Connection Service.
  2. Click the instance that you want to configure active connections for.
  3. Click Edit instance.
  4. In the Push access protocol section, in the Maximum number of active connections field, type a number.
  5. Click Save all.
  6. Click Restart instance.

Configure the maximum number of queued connections that a BlackBerry MDS Connection Service can process

The BlackBerry® MDS Connection Service queues push connections when the number of connections exceeds a limit that you specify. You can configure the maximum number of push connections that a BlackBerry MDS Connection Service can queue. The BlackBerry MDS Connection Service sends a "service unavailable" message to BlackBerry devices when the number of pending push connections in the queue exceeds the limit.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > BlackBerry MDS Connection Service.
  2. Click the instance that you want to configure the maximum number of queued connections for.
  3. Click Edit instance.
  4. In the Push access protocol section, in the Maximum number of queued connections field, type a number.
  5. Click Save all.
  6. Click Restart instance.

Delete requests from the push request queue manually

An automated process runs daily to delete outstanding requests from the push request queue on a Microsoft® SQL Server®. To delete requests from the push request queue manually, you can run the RIMPurgeMDSMsg<database_name> process from the Microsoft SQL Server management console.

  1. Perform one of the following actions:
    • If you are using the Microsoft SQL Server Enterprise Manager, navigate to Console Root\Microsoft SQL Servers\SQL Server Group\<BlackBerry_Configuration_Database_server>\Management\SQL Server Agent\Jobs.
    • If you are using the Microsoft SQL Server Management Studio, navigate to SQL Server Agent\Jobs.
  2. Start the RIMPurgeMDSMsg<database_name> process.

Was this information helpful? Send us your comments.