Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Using the sample Push Initiators

You can run the sample Push Initators to better understand how the Push Service SDK works by sending push messages to push-enabled applications on BlackBerry devices. Using the web interface for either the high-level or low-level sample Push Initiator, you can type a text message or attach a .txt, .gif, .jpg, .png, .xml, or .html file, and send it to a push-enabled application. The text message or file can't be more than 8KB in size.

The sample Push Intiators are installed if, in the setup application for the Push Service SDK, you select the high-level and low-level API distributions along with an Apache Tomcat server with the sample Push Initiators deployed on the server. For more information about the setup application, see Installing the SDK.

Before you run the sample Push Initiators, download and install a push-enabled application on a device. You can install your own push-enabled application, or you can install one of our sample push-enabled applications. We include sample push-enabled applications in the following SDKs as separate downloads, along with documentation that explains how to configure and register the applications.

You can also use the BlackBerry WebWorks SDK to develop a push-enabled application for BlackBerry 7 and earlier devices. For more information, see the API Reference.

If you're using one of our push-enabled applications with the low-level sample Push Initiator, configure and register the push-enabled application after you download and install it on a device.

If you're using one of our push-enabled applications with the high-level sample Push Initiator, don't configure and register the push-enabled application after you download and install it on a device. You'll perform the configuration and registration when you use the high-level sample Push Initiator to send a push message to the push-enabled application.

Use the high-level sample Push Initiator

Before you begin, obtain the application ID and password from the confirmation email message that you received when you registered with Research In Motion. If you're using the BlackBerry Enterprise Server or the BlackBerry Device Service, check with your administrator to see if you need a username or password to send push messages.

  1. Start the Apache Tomcat server.
  2. Browse to https://localhost:8443/high-level-sample to open the sample Push Initiator.
  3. If you're using the sample Push Initiator for the first time, the Application Management screen appears. Perform the following actions:
    1. Choose the type of PPG that you're using, and click Submit.
    2. Fill in the fields in the Add push application form.

      You can specify details about the push-enabled application (for example, the application name, ID, and version number), and details about the PPG (for example, the level of service). You can also indicate that you want the Push Initiator to reconcile push messages, and specify the relevant details (for example, the URL that the PPG uses to send result-notification request messages).

    3. Click Add application to add a record for the application with the SDK.
  4. Go to the push-enabled application that you downloaded and installed on the device, and configure and register the application. Be sure to specify the URL for the Push Initiator when you configure the application. Also, make note of the user name that you use when you register the application because you need it in step 6 below.
  5. In the sample Push Initiator, in the Push Management drop-down list, click Push.
  6. In the Push Application drop-down list, click the push-enabled application that you want to deliver the push message to.
  7. In the Subscribers field, type the username that you used to register the push-enabled application in step 3. The sample Push Initiator translates the username into a subscriber ID.
  8. Specify a file or type the text that you want to send to the push-enabled application.
  9. Click Send Push.

Use the low-level sample Push Initiator

Before you begin, perform the following actions:

  • If you're using the BlackBerry Internet Service as the PPG, obtain the application ID and password from the confirmation email message that you received when you registered with Research In Motion. If you're using the BlackBerry Enterprise Server or the BlackBerry Device Service, check with your administrator to see if you need a username or password to send push messages.
  • Obtain the PIN of the device where the push-enabled application is installed.
  • If you're using one of our push-enabled applications, configure and register the push-enabled application after you download and install it on a device.
  1. Start the Apache Tomcat server.
  2. Browse to https://localhost:8443/low-level-sample to open the main page of the sample Push Initiator.
  3. In the Push Management drop-down list, click Push.
  4. In the Application Id and Password fields, type the application ID or username and password.
  5. Specify a file or type the text that you want to send to the push-enabled application.
  6. In the Addresses field, type the PIN of the device where the push-enabled application is installed.
  7. Click Send Push Request.