Product information

This section lists product information for the BlackBerry® Java® SDK 7.0 MR, Bundle 63.

MDS-CS Simulator

Changes have made to the functionality of the MDS-CS Simulator to support BlackBerry® Messenger simulation. Please read the following to understand new system requirements and procedures for running the MDS-CS Simulator. This support has been tuned off by default, but instructions for enabling the support are included in a README.txt file included with the download.

The MDS Simulator requires a minimum of JRE™ 1.6.0 update 20, with unlimited strength encryption enabled. You can download the latest version of the JRE at http://www.oracle.com/technetwork/java/javase/downloads/index.html.

For legal and export reasons, policy files that allow unlimited encryption are not supplied with the simulator. If your country is eligible, you can download them at www.oracle.com. Once you've downloaded them, replace the following files:

<java-home>/lib/security/local_policy.jar

<java-home>/lib/security/US_export_policy.jar

Where <java-home> is the location, on your hard drive, of the J2SE® runtime environment. When using the default installation location on a computer running Windows®, <java-home> will often be C:\Program Files\Java\jre6\, but can differ based on your operating system, and where you installed Java®.

An unlimited strength version of these files, indicating no restrictions on cryptographic strengths, is available on the Oracle® website for those living in eligible countries. Those living in eligible countries may download the unlimited strength versions, and replace the strong cryptography .jar files with the unlimited strength files.

Running the MDS-CS Simulator

To activate both BlackBerry Messenger and the BlackBerry® Browser, start the MDS-CS Simulator using the run.bat file in the directory where you installed the simulator.

If you plan on running a simulator on a machine other than the one MDS is running on, you must change a property located in the rimpublic.property file. You can find this file in the following location: <JDE 7.0 install directory>\MDS\Servers\MDS1\config\, where <JDE 7.0 install directory> is the directory you installed the BlackBerry Java SDK to.

Open this file in a text editor. In this file, change UDP.send.host to match the IP address of the computer the MDS simulator is using.

Running the BlackBerry Smartphone Simulator

When running the BlackBerry Smartphone Simulator a few extra parameters need to be specified in the sim1.bat and sim2.bat files included in the BlackBerry® Messenger SDK for it to support BlackBerry Messenger. As above, you need to open these files in a text editor and make the following changes:

Parameter

Description

/app-param=regDestIP

Where regDestIP is the IP address of the computer running the MDS-CS simulator.

You can set it to the local host IP, 127.0.0.1 if you intend to run both the BlackBerry Smartphone Simulator and the MDS-CS Simulator on the same computer.

/app-param=regDestPort=portNumber

Where portNumber specifies the port you want the MDS-CS simulator to communicate over. The port number used in regDestPort= should be the same over all instances of the BlackBerry Smartphone Simulator.

Example: /app-param=regDestPort=19781 will use TCP port 19781 to communicate.

/session=sessionNumber

The sessionNumber variable must be unique for all instances of the BlackBerry Smartphone Simulator running on the same computer.

/app-param=regSrcPort=srcPortNum

Where srcPortNum specifies a TCP port number. This parameter should be unique for all instances of the BlackBerry Smartphone Simulator running on the same computer.

Example: /app-param=regSrcPort=19780 will use TCP port 19780.

/pin=devicePIN

Where devicePIN specifies a device PIN number. The PIN must have a value of 0x21000000 or greater.

Example: sim1.bat
@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=true
Example: sim2.bat
@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=true

Was this information helpful? Send us your comments.