B Using the Command Line Emulator

The Oracle Java ME SDK 3.4 emulator can be started from a Windows command line. Once started, it runs and behaves the same as it does when started from the NetBeans or Eclipse IDE.

Starting the emulator from the Windows command line allows you a number of emulator options. For more information, see "Useful Command Line Emulator Commands".

Finding the Oracle Java ME SDK Emulator

You can find the Oracle Java ME SDK command line emulator within the bin directory of the Oracle Java ME SDK 3.4 installation.

For example, if the Oracle Java ME SDK 3.4 is installed in C:\Java_ME_platform_SDK_3.4, then the emulator would be located at: C:\Java_ME_platform_SDK_3.4\bin\emulator.exe

Using the Oracle Java ME SDK Emulator

To start the emulator from the Windows command line:

Open the Windows command line from the Start Menu, using Start > Run.
Change to the bin directory of the Oracle Java ME SDK 3.4 distribution:

C:\>cd Java_ME_platform_SDK_3.4\bin
Enter the following command, as shown here:

emulator.exe -Xdevice:IMPNGDevice1 -Xdescriptor:location_of_jad_file

For example:

emulator.exe -Xdevice:IMPNGDevice1 -Xdescriptor:C:\Java_ME_platform_SDK_3.4\apps\sample\sample_imlet.jad

Note:

You can run the emulator command without the .exe extension. It works both ways, with the extension and without

Useful Command Line Emulator Commands

This section provides a list of ME SDK emulator commands you may find useful, which can be entered on the Windows command line.

Note:

For a complete list of ME SDK emulator commands, type: emulator -help.

To show a list of installed IMlets, use the -Xjam:list subcommand:

EmulatorDir>emulator -Xjam:list
To see a list of all supported devices, use the -Xquery subcommand:

EmulatorDir>emulator -Xquery
To install a JAD over the air (OTA) and execute a IMlet, use the -Xjam:install subcommand:

EmulatorDir>emulator -Xjam:install=<JAD_file_URL>

For example:

EmulatorDir>emulator -Xjam:install=http://www.appstore.com/TestJAD.jad
To run an installed IMlet, use the -Xjam:run subcommand:

EmulatorDir>emulator -Xjam:run=[storage_name | storage_number]

Provide either the storage name or storage number for the IMlet to run. You can get the storage name and storage number from the list of IMlets shown by the -Xjam:list subcommand.
To remove an installed IMlet, use the -Xjam:remove subcommand:

EmulatorDir>emulator -Xjam:remove=[storage_name | storage_number | all]

Provide either the storage name or storage number for the IMlet to remove. To remove all IMlets, use all. You can get the storage name and storage number from the list of IMlets shown by the -Xjam:list subcommand.
To install a JAD file, execute the IMlet locally, and remove the IMlet when completed, use the -Xdescriptor subcommand:

EmulatorDir>emulator -Xdescriptor:<JAD_file_name>
To set an IMlet's security domain, use the -Xdomain subcommand:

EmulatorDir>emulator -Xdomain:<domain_name>
To run in autotest mode, use the -Xautotest subcommand:

EmulatorDir>emulator -Xautotest:<JAD_file_URL>

For example:

EmulatorDir>emulator -Xautotest:http://127.0.0.1:8080/getNextApp.jad