The error "Could not start the BlackBerry Mobile Data Service on Local Computer. Error 203 The system could not find the environment option that was entered" is received when starting the BlackBerry MDS Connection Service

• BlackBerry® Enterprise Server version 4.0 to 5.0
  

After applying updates to the computer on which BlackBerry Enterprise Server is located, the following error message is displayed:

Could not start the BlackBerry Mobile Data Service on Local Computer. Error 203: The system could not find the environment option that was entered.

The issue may be caused by one of the following:

1. The Java® Runtime Environment (JRE™) is not installed on the BlackBerry Enterprise Server.
2. An incorrect version of the JRE is installed, or the JRE has been recently updated on the BlackBerry Enterprise Server.
3. The BlackBerry Enterprise Server is not pointing to the jvm.dll file.

Complete the appropriate resolution for the cause.  If the error still occurs after completing the resolution, follow the instructions in the Additional Information section.

Cause 1

The JRE is not installed on the BlackBerry Enterprise Server.

Resolution 1

To check if the JRE is installed on the BlackBerry Enterprise Server, search for Java Runtime Environment in the list of currently installed programs in the Add/Remove Programs list.

If the JRE is not installed, go to the Sun Developer Network web site to download and install the correct version of the JRE. Please note the following:

• JRE version 1.4.2 is required for BlackBerry Enterprise Server version 4.0
• JRE version 1.5 or 1.6 is required for BlackBerry Enterprise Server version 4.1 and 5.0

Cause 2

An incorrect version of the JRE is installed, or the JRE has been recently updated on the BlackBerry Enterprise Server.

Resolution 2

To resolve this issue, complete the following steps:

1. In Windows® Explorer, navigate to C:\Program Files\Java\j2re1.4.2_03.
2. If a supported version of JRE is not installed, go to the Sun Developer Network web site to download and install the correct JRE version.

Note: Remove any existing version of the JRE prior to installing this version.

• JRE version 1.4.2 is required for BlackBerry Enterprise Server version 4.0
• JRE version 1.5 or 1.6 is required for BlackBerry Enterprise Server version 4.1 and 5.0

Cause 3

The BlackBerry Enterprise Server is not pointing to the jvm.dll file. Check for the ImagePath string value in the following registry key:

For BlackBerry Enterprise Server version 4.0:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BlackBerry Mobile Data Service

If the ImagePath string value exists, the Value data field is blank or is pointing to the JRE folder from a previous version of the JRE.

For BlackBerry Enterprise Server version 4.1 and 5.0:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BlackBerry MDS Connection Service

Resolution 3

Warning: The following procedure involves modifying the computer registry.  This can cause substantial damage to the Windows® operating system.  Document and back up the registry entries prior to implementing any changes.

To resolve this issue, complete the following steps:

1. Open the Registry Editor.
2. Go to the registry key listed above to check for the ImagePath string value.
3. If the ImagePath string value does not exist, repair the BlackBerry Enterprise Server installation through Add/Remove Programs.  This updates the BlackBerry® Mobile Data Service registry keys.  For more information, see the BlackBerry Enterprise Server Installation Guide.

   Note: For BlackBerry Enterprise Server version 4.1 SP3 to 4.1 SP6 and 5.0, the option to repair is not available.  Re-apply the service pack to replace the registry key.

   If the ImagePath string value exists, double-click it and type the correct path to the jvm.dll file in the Value data field, as shown in the following example for BlackBerry Enterprise Server version 4.1 and 5.0:

   "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\bin\bmds.exe" -s jvmpath="C:\Program Files\Java\<JRE folder>\bin\client\jvm.dll" -XX:+DisableExplicitGC-Xss64K -Xmx256M -Xms96M -XX:NewSize=32M -XX:MaxNewSize=96M-XX:NewRatio=2 classpathdir="C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\classpath\\" wrkdir="C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\Servers\<server_name>\\" webserverdir="C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\webserver\\" -log.console -rbes "<server_name>"

   where <server_name> is the name of the BlackBerry Enterprise Server MDS Connection Service and <JRE folder> is the name of the JRE folder located in C:\Program Files\Java\.

4. Press Enter and close the Registry Editor.
5. Restart BlackBerry MDS from the Windows administrative tools.

Important: Restarting certain BlackBerry Enterprise Server services will delay email message delivery to BlackBerry smartphones. For more information, see KB04789.

If the error still appears after completing the steps in the Resolution section, complete the following steps:

1. Go to<drive>:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\classpath
2. Check for missing files in this directory. The following are common files that may be missing:
   • bmds.jar
   • clibwrapper_jiio.jar
   • commons-fileupload-1.0.jar
   • dom.jar
   • ecma.jar
   • jai_codec.jar
3. If the files are missing, repair the BlackBerry Enterprise Server by selecting BlackBerry Enterprise Server in Add\Remove Programs in the Control Panel.
4. Click Support Information and select Repair.
5. Verify that the missing files are now installed on the BlackBerry Enterprise Server, and then restart BlackBerry MDS.

Important: Restarting certain BlackBerry Enterprise Server services will delay email message delivery to BlackBerry smartphones. For more information, see KB04789.