Install the BlackBerry Smartphone Simulator package

  1. In the folder where you extracted the BlackBerry Messenger SDK file, open the BlackBerry smartphone simulator folder.
  2. Double-click the BlackBerry_Simulators_<version>_<model>.exe file.
  3. Complete the instructions on the screen. After you finish installing the BlackBerry® Smartphone Simulator package, two .bat files, sim1.bat and sim2.bat, are available in the folder in which you installed the BlackBerry Smartphone Simulator package. These .bat files launch two instances of the BlackBerry Smartphone Simulator. These instances communicate with each other over the BlackBerry Messenger platform using the BlackBerry MDS Simulator running on the same computer. To learn how to run the BlackBerry Smartphone Simulator instances and the BlackBerry MDS Simulator on separate computers, see Configuring the BlackBerry Smartphone Simulator.

Configuring the BlackBerry Smartphone Simulator

If you want to run the BlackBerry Smartphone Simulator without launching the two .bat files that are bundled with the BlackBerry Messenger SDK .zip file, you can create your own .bat files that specify the following parameters to support the BlackBerry Messenger SDK.

Parameter

Description

app-param=regDestIP

This parameter specifies the IP address of the computer running the BlackBerry MDS Simulator. If the BlackBerry MDS Simulator is running on the same computer as the BlackBerry Smartphone Simulator, specify 127.0.0.1.

app-param=regDestPort

This parameter should specify the default port, 19781. If you use a different value, make sure it is the same for every instance of the BlackBerry Smartphone Simulator.

app-param=DisableSyncServiceRecord

This parameter must be specified to make PIN-to-PIN communication between devices possible. If you have run the BlackBerry Smartphone Simulator without specifying this parameter in the past, in the BlackBerry Java Plug-in for Eclipse, click BlackBerry > Clean Simulator to delete the file system and remove the SYNC service record from the previous instance.

session

The session number must be unique for each instance of the simulator.

app-param=regSrcPort

The port number must be unique for each instance of the simulator.

pin

This parameter must be 0x2100000 or greater and unique for each instance of the simulator.

Example

The following example demonstrates how to run two instances of the BlackBerry Smartphone Simulator using the same instance of the BlackBerry MDS Simulator. Create a .bat file with the following contents to launch each custom BlackBerry Smartphone Simulator instance:

Simulator 1 .bat file contents:

@echo off
fledge.exe /app=Jvm.dll /handheld=9800 /session=Sim1 /app-param=JvmAlxConfigFile:9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x2100000A /app-param=regVersion=3 /app-param=regDestIP=127.0.0.1 /app-param=regDestPort=19781 /app-param=regSrcPort=19780 /app-param=DisableSyncServiceRecord

Simulator 2 .bat file contents:

@echo off
fledge.exe /app=Jvm.dll /handheld=9800 /session=Sim2 /app-param=JvmAlxConfigFile:9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x2100000B /app-param=regVersion=3 /app-param=regDestIP=127.0.0.1 /app-param=regDestPort=19781 /app-param=regSrcPort=19782 /app-param=DisableSyncServiceRecord
Back To Top

Was this information helpful? Send us your comments.