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.

Testing applications that require an HTTP connection

The BlackBerry MDS Simulator is designed to simulate the BlackBerry MDS Connection Service component of the BlackBerry Enterprise Server. You are able to use the BlackBerry Smartphone Simulator with the BlackBerry MDS Simulator to test network, push, and browser applications that are designed for use with a BlackBerry Enterprise Server. If you are testing applications that require an HTTP connection, you will require the BlackBerry Smartphone Simulator and the BlackBerry MDS Simulator. You can download the BlackBerry Smartphone Simulator and the BlackBerry MDS Simulator by visiting http://us.blackberry.com/developers/resources/simulators.jsp.

Testing push applications

Map the internet messaging address to the BlackBerry Smartphone Simulator PIN

In a production environment, the BlackBerry Enterprise Server automatically maps an Internet messaging address to the PIN of its BlackBerry device. Using the BlackBerry Smartphone Simulator, you can simulate the mapping between Internet messaging addresses and PIN. You must provide the mappings.

You are required to map Internet messaging addresses to PIN values if you are testing a push application. For more information, see the API reference for the BlackBerry Java SDK.

  1. Navigate to the \Program Files\Research In Motion\BlackBerry Email and MDS Services Simulators x.x.x\MDS\config folder.
  2. With a text editor, open the rimpublic.property file.
  3. In the [Simulator] section, add or change entries for Simulator.<PIN> properties.
  4. In the push application, change the email address to the address of the specified BlackBerry Smartphone Simulator, so that when the push application sends data, it sends data to the specified simulator.

Example: Mapping an internet messaging address to a PIN

The following entry in the rimpublic.property file assigns PIN 12A34B56C to email address user01@example.com:

Simulator.12A34B56C=localhost:81, user01@example.com

Change the BlackBerry Smartphone Simulator PIN

The PIN for the BlackBerry Smartphone Simulator can only be changed through a command line option. The default PIN is 0x2100000A.

  1. At the command prompt or in the batch file that contains the command for the BlackBerry Smartphone Simulator, add the following option to the command: /pin=<new_pin>
  2. Start the BlackBerry Smartphone Simulator with the new command.
After you finish: The port must match the value set in the IPPP.push.listen.tcp.port parameter. The default number is 81.

Testing messaging applications

The BlackBerry Email Simulator is designed to send and receive messages between the BlackBerry Smartphone Simulator and either a messaging application, such as Microsoft Outlook, or POP3 and SMTP servers. You do not require a BlackBerry Enterprise Server. The BlackBerry Email Simulator is available for download from the BlackBerry Developer Zone web site at http://us.blackberry.com/developers/resources/simulators.jsp.

BlackBerry Email Simulator

You can use the BlackBerry Email Simulator to simulate sending and receiving messages. To get the BlackBerry Email Simulator, visit www.blackberry.com/developers and download the BlackBerry Email and MDS Services Simulator Package.

Send a message

  1. Start the BlackBerry Email Simulator.
  2. In the Email Server Simulator window, select the Standalone mode option.
  3. Choose a name and an email address.
  4. Click Launch.
  5. Start the BlackBerry Smartphone Simulator.
  6. In the BlackBerry Smartphone Simulator, click the Messages icon.
  7. In the Messages application of the simulated BlackBerry device, open the menu.
  8. Click Compose Email.
  9. In the To field, type an email address.
  10. Complete the Cc, Subject, and Body fields.
  11. Open the menu.
  12. Click Send.

Receive a message

  1. Start the BlackBerry Email Simulator.
  2. In the Email Server Simulator window, select the Standalone mode option.
  3. Click Launch.
  4. Start the BlackBerry Smartphone Simulator.
  5. When the BlackBerry Smartphone Simulator receives an email, in the BlackBerry Smartphone Simulator, open the Messages application.

Route the BlackBerry Browser through the BlackBerry MDS Simulator

Before BlackBerry Smartphone Simulator 6.0, the BlackBerry MDS Simulator was required for the BlackBerry Browser to connect to a website. In version 6.0 and later, the BlackBerry Browser connects directly to a website. However, you can continue to route your BlackBerry Browser connections through the BlackBerry MDS Simulator to use a proxy server or its logging capabilities.

  1. Append the parameter /app-param=MdsIP=xxx.x.x.x , to the batch file or command that you use to start the BlackBerry Smartphone Simulator, where xxx.x.x.x is the IP address of the computer that is running the BlackBerry Smartphone Simulator (for example 192.0.2.0).

  2. Start the BlackBerry MDS Simulator and wait for it to finish loading.

  3. Start the BlackBerry Smartphone Simulator.

  4. On the home screen, click Manage Connections.

  5. Clear the Wi-Fi check box.

  6. On the home screen, open Options > Device > Advanced System Settings > Service Book.

  7. Delete the TCP service books that are listed (these may not exist in all simulators):

    a) Highlight the service book.

    b) Press the Menu key.

    c) Click Delete.

  8. Start the BlackBerry Browser.