B Configuring the Java Runtime Properties

Direct Modification of the jwc_properties.ini File

The jwc_properties.ini file contains all the properties that affect Java configuration and behavior at runtime. In order to edit this file, do the following:

1. Open the jwc_properties.ini that is a part of the Oracle Java ME Embedded bundle (or download it from the board using the Brew MP SDK Loader tool), find the property that should be changed, and modify its value.

2. Copy the modified version of the jwc_properties.ini file to the /sys/mod/java directory on the Qualcomm IoE board using the Brew MP SDK Loader tool.

3. If there is a jwc_properties.inix file located in this directory, delete it.

4. Restart Java on the Qualcomm IoE board.

Using the CLI Setprop Command

To modify a property using the setprop command in the command-line interface (CLI), do the following.

1. Connect to the board using command-line interface (CLI)

2. Execute the "sysmenu on" command

3. Execute the "setprop <property_name> <desired_property_value>

4. Execute the "saveprops" command

5. Restart Java on the board.

Note, that by executing the "setprop" and "saveprops" commands, the jwc_properties.ini file is always updated automatically.

Using CLI Commands to Alter Network-Related Settings

To alter the network-related settings, do the following:

1. Connect to the board using command-line interface (CLI)

2. Execute the "sysmenu on" command

3. Execute a command that starts with prefix "net" to apply a network-related change.

4. Apply the network-related change and restart Java

Restarting Java on the Qualcomm IoE Board

You can use any of the following methods to restart Java on the Qualcomm IoE board.

1. Use the CLI "shutdown -r" command. If the "vmconfig.reboot_type" property is set to "soft" (the default), then only Java will be rebooted. However, if the "vmconfig.reboot_type" property is set to "hard" then the board will be rebooted. Note that the "vmconfig.reboot_type" property also affects Device Access API watchdog's reboot type.

2. Using the CLI "net reconnect" command. This command reconfigures the network and performs a soft Java reboot.

3. Press the "RESET KEY" located on the board, or cycle the power to the board.

For example, here are two methods to change the tooling mode from serial to network. The first method contains the following steps.

1. Open the jwc_properties.ini file and set the "com.oracle.tooling.mode" property to "network".

2. Copy the modified version of the jwc_properties.ini file to the /sys/mod/java directory using the Brew MP SDK Loader application.

3. If there is a jwc_properties.inix file located in this directory, then remove it.

4. Reset the board using the "RESET KEY".

The second method contains the following steps.

1. Connect to the board using command-line interface (CLI).

2. Execute the "sysmenu on" command.

3. Execute a "setprop com.oracle.tooling.mode network" command.

4. Execute the "saveprops" command.

5. Execute a "shutdown -r" command.