Runtime Package

weme-wm2003-arm-ppro10-5.7.0.exe for a Windows environment

weme-wm2003-arm-ppro10-5.7.0.bin for a Linux environment

Note: Although you can use this bin file for any Linux environment, it is only supported on Red Hat 8.0

J2ME Mobile Information Device Next Generation(JSR-118)

This runtime package includes the:

• J9 VM runtime
• MIDP 2.0 class libraries

Note: An example MIDlet application, "Golf Score Midlet," is included and installed when you install this package.

3MB

CAB File

weme-midp20-wm2003-arm_22.CAB

Files that are included in the CAB file can be found in their default location on the device:

Found in \Program Files\J9\MIDP20\bin\

• emulator.exe
• ivemidp20_22.dll
• j9midp20.exe
• j9mjit22.dll
• j9mjitd22.dll
• jclmidp20_22.dll
• java.properties

Found in \Program Files\J9\MIDP20\lib\

• charconv.zip
• j2me.keystore
• security.policy

Found in \Program Files\J9\MIDP20\lib\jclMidp20\

• jclMidp20.jxe
• Ams.jad

Found in \Program Files\J9\MIDP20\examples\jclMidp20\

• Golf ScoreTrackerSuite.jad
• Golf ScoreTrackerSuite.jar
• Golf ScoreTrackerSuite.lnk

J9 - VM for the Java(TM) platform, Version 2.2
(c) Copyright IBM Corp. 1991, 2004 All Rights Reserved
Target: {Encoded Build Number} (Windows XP 5.1 build 2600 Service Pack 1 x86)
IBM is a registered trademark of IBM Corp.
Java and all Java-based marks and logos are trademarks or registered
trademarks of Sun Microsystems, Inc.
Usage: j9 [options] classname [args...]
Usage: j9 [options] -jxe:<jxeFile> [args...]
[options]
    -classpath <path> 
    -cp <path>       set classpath to <path>. 
    -jxe:<jxeFile>   run the named jxe file.
    -D<prop>=<val>   set the value of a system property.
    -debug:<options> enable debug, JDWP standard <options>.
    -jcl:<config>    specify which JCL DLL to use (e.g. cdc, cldc, ...).
    -verbose         [:class,gc,stack,sizes] 
                     enable verbose output(default=class).
    -verify          enable class file verification.
    -X               print help on non-standard options.
 

-? or -help

This command option displays help

-classpath

This command option sets the class path for this invocation of J9. The final value of -classpath is determined by:

1. If the -classpath option is indicated, its value is used.
2. Otherwise, if the CLASSPATH environment variable is set, its value is used.
3. If both are unspecified, the value "." is used.

If the class path includes:

• More than one class path entry, you should separate them with your operating system's path separators (for example, on Windows, use semicolons.)
• A JAR, ZIP or JXE file, you should add the full name of the file to the class path.
• CLASS files, you should specify the top-level directory of the CLASS file tree.

Example: (on windows) -classpath c:\ive\lib\classes.zip; c:\myclasses;c:\myjars\foo.jar

Caution:
The J9 class libraries (classes.zip) and the J9 VM are not compatible with other vendors' class libraries. It is possible that you might have more than one runtime environment installed on your host computer. You must make sure that you do not mismatch these libraries when specifying the class path.

-cp <path>

Set classpath to <path>

This is equivalent to -classpath.

-jxe:<jxeFile>

This command option reads the specified JXE file, looking for the classes in this file. All classes found in the JXE are placed at the end of the "boot path."

Note: When using the -jxe option, do not specify the startup class.

Example: -jxe:hello.jxe

Note: The -jxe option must be the last option on the command line.

Caution:
The -jxe option is not the preferred way to run an application. It is best to use -classpath (where applicable) or -Xbootclasspath: (if the .jxe contains boot classes).

-Dprop=<val>

This command option sets the value of a system property.

For example, -Dmy.property=some.value sets the value of my.property to some.value. -Dprop sets the value to null.

You can use multiple instances of this option by repeating the option statement separated with a space. Example:

j9 -Dprop1=val1 -Dprop2=val2 -Dprop3=val3

Note: Spacing is important in this option's syntax. There is never a space between the initial -D, its property argument, the equals sign, or the value argument.

Example: -Dname="John Smith"

-debug:<options>

This command enables debug, Java Debug Wire Protocol (JDWP) standard <options>

-jcl:<config>

This command option specifies which JCL DLL to use (which JNI natives are used by the class library Java code.)

If you use the -jcl:<config> without indicating a -Xbootclasspath: <path>, then the value for the -Xbootclasspath: <path> is assumed (%JAVAHOME%/lib/jclLibraryName/classes.zip). However, if the class libraries are stored in a non-default location, then you must include the -Xbootclasspath: <path> in order to direct the VM to the classes.zip file.

Note: If the -Xbootclasspath and the -jcl VM options are mismatched, the VM will generate an "Incompatible class library" error.

The possible library arguments are:

• -jcl:foun10 (jclFoundation10 class library)
• -jcl:ppro10 (jclPPro10 class library)
• -jcl:midp20 (jclMidp2.0 class library)
• -jcl:max (jclMax class library)
• -jcl:rm (jclRM class library)

Note: Not all these options are available for all platforms.

-verbose[:class, gc, stack, sizes]

This command option turns one of the following:

• class displays each fully-qualified class name as it is loaded (that is, enable verbose class loading). This is the default value.
• gc displays garbage collection information.
• stack displays stack information.
• sizes displays default VM sizes.

-verify

This command option enables bytecode verification. The -verify option is on by default. To disable bytecode verification specify -noverify.

-X

This command option prints help on non-standard options.

-Xbootclasspath:<path>     set bootstrap classpath to <path>
-Xbootclasspath/p:<path>   prepend <path> to bootstrap classpath
-Xbootclasspath/a:<path>   append <path> to bootstrap classpath
-Xrun<dll>[:options]       Load helper libraries, such as those used with JVMPI
-Xint             run interpreted only 
-Xnoaot           do not run precompiled code
-Xfuture          enable strictest checks, anticipating future default

Arguments to the following options are expressed in bytes.
Values suffixed with "k" (kilo) or "m" (mega) will be factored accordingly.
-Xmca<x>          set RAM class segment increment to <x> 
-Xmco<x>          set ROM class segment increment to <x>
-Xmn<x>           set initial/maximum new space size to <x>
-Xmns<x>          set initial new space size to <x>
-Xmnx<x>          set maximum new space size to <x>
-Xmo<x>           set initial/maximum old space size to <x>
-Xmos<x>          set initial old space size to <x>
-Xmox<x>          set maximum old space size to <x>
-Xmoi<x>          set old space increment to <x>
-Xms<x>           set initial memory size to <x>
-Xmx<x>           set memory maximum to <x>
-Xmr<x>           set remembered set size to <x>
-Xmrx<x>          set maximum size of remembered set to <x>
-Xmso<x>          set OS thread stack size to <x>
-Xiss<x>          set initial java thread stack size to <x>
-Xss<x>           set maximum java thread stack size to <x>
-Xmine<x>         set minimum size for heap expansion to <x>
-Xmaxe<x>         set maximum size for heap expansion to <x>
 
Arguments to the following options are expressed as a decimal from 0 to 1.
A value of 0.3 represents a request of 30%
-Xminf<x>         minimum percentage of heap free after GC
-Xmaxf<x>         maximum percentage of heap free after GC

Arguments to the following options are expressed as decimal numbers.
-Xgcthreads<x>          set number of GC threads
-Xnoclassgc             disable dynamic class unloading
-Xclassgc               enable dynamic class unloading
-Xalwaysclassgc         enable dynamic class unloading on every GC
-Xnocompactexplicitgc   disable compaction on a system GC
-Xcompactexplicitgc     enable compaction on a system GC
-Xcompactgc             enable compaction
-Xnocompactgc           disable compaction
-Xlp                    enable large page support
 
-Xdbg:<options>               enable debug, JDWP standard options
-Xrunjdwp:<options>           enable debug, JDWP standard options
-Xdbginfo:<symbol file path>  enable debug info server
-Xrdbginfo:<host><port>       enable remote debug info server
 

-Xbootclasspath:<path>

This command option sets the bootstrap classpath to <path>.

Note: When using this command line option, the -jcl:LibraryName option must be used to indicate which class library natives the application should use:

-Xbootclasspath:c:\ive\lib\jclCldc\classes.zip

If you use the -jcl:<path> without indicating a -Xbootclasspath: <path>, then the value for the Xbootclasspath: <path> is assumed (%JAVAHOME%/lib/jclLibraryName/classes.zip). However, if the class libraries are stored in a non-default location, then you must include the -Xbootclasspath: <path> in order to direct the VM to the classes.zip file.

-Xbootclasspath/p:<path>

This command option prepends <path> to the bootstrap classpath.

Note: This option is useful for applying temporary fixes and/or adding to the bootstrap classpath.

-Xbootclasspath/a:<path>

This command option appends <path> to the bootstrap classpath.

Note: This option is useful for applying temporary fixes to application classes and/or adding to the bootstrap classpath.

-Xrun<dll>[:options]

Load helper libraries, such as those used with JVMPI.

-Xint

This command option runs interpreted only. This disables both the JIT and AOT support.

-Xjit:<x>

This command enables JIT.

• bcount=250
• classLoadPhaseInterval=50
• classLoadPhaseThreshold=2
• code=1024(KB)
• count=1000
• data=1024 (KB)
• mtcount=1
• samplingFrequency=10

-Xnoaot

This command option prevents running the precompiled code.

-Xgcpolicy:optthruput

This command option sets no scavenger and no concurrent mark. This is the default.

This garbage collection policy delivers very high throughput to applications, but at the cost of occasional pauses, which can vary from a few milliseconds to many seconds, depending on the size of the heap and the quantity of garbage.

Garbage collection cycles introduce occasional unexpected pauses in the execution of application code. Because applications grow in size and complexity, and heaps become correspondingly larger, this garbage collection pause time tends to grow in size and significance. This garbage collection policy is the default.

-Xgcpolicy:optavgpause

This policy enables two garbage collection technologies whose aim is to minimize pause times; namely scavenger and concurrent mark. Provided the weak hypothesis that most objects die young holds true then the scavenger helps reduce pause times by concentrating the garbage collection effort on the nursery since it is there that most recyclable space will be found. Rather than occasional but lengthy pause times to collect the entire heap, the nursery is collected more frequently and provided the nursery is small enough, pause times will be comparatively short.

However, over time the tenure area may become full if too many objects live too long. So in order to minimize the pause time when a collection of the tenure area is necessary, concurrent mark is enabled to perform some garbage collection activities concurrently with normal program execution. The optavgpause option substantially reduces the time that is spent in these garbage collection pauses, in addition to limiting the effect of increasing heap size on the length of the garbage collection pause. This option is particularly relevant to configurations that have large heaps. However, with the reduced pause time, you might experience some reduction of application throughput, which varies from application to application.

This command option sets scavenger and concurrent mark.

-Xfuture

This command option enables the strictest checks, anticipating a future default.

-Xmca<x>

This command line option sets the RAM class segment increment to <x>.

RAM class segments contain the portion of the Java classes that needs to be modified at runtime, like the pointers to the class loader, super classes, implemented interfaces, statics, first instance and so forth. There is at least on RAM class segment per Class Loader. If more space for the RAM classes is needed, then the J9 VM allocates a new segment in the same size.

-Xmco<x>

This command line option sets the ROM class segment increment to <x>.

The code of Java classes loaded from .class files is stored in special ROM Classes segment types called Dynamically Loaded Classes whose size are determined by this parameter. There is at least on ROM class segment per Class Loader. If more space for the dynamically loaded classes is needed, then the J9 VM allocates a new segment in the size determined by the class loader.

Note: This parameter does not apply for classes loaded from a Jxe. The "rom.classes" entry in the Jxe is mapped directly to a ROM class segment.

-Xmn<x>

This command line option sets the initial and maximum NewSpace size to <x>.

Note: This sets the size of the NewSpace and SurvivorSpace. This command is only relevant if -Xgcpolicy:optavgpause is set.

-Xmns<x>

This command line option sets the initial NewSpace size to <x>.

-Xmnx<x>

This command line option sets the maximum NewSpace size to <x>.

-Xmo<x>

This command line option sets the initial and maximum OldSpace size to <x>.

-Xmos<x>

This command line option sets the initial OldSpace size to <x>.

-Xmox<x>

This command line option sets the maximum OldSpace size to <x>.

-Xmjit<x>

This command line option enables the micro JIT.

Note: The micro JIT is not enabled by default. You must explicitly enable the micro JIT on platforms that support it or J9 will run in interpreted mode only.

-Xmoi<x>

This command line option sets the OldSpace increment to <x>.

This value used to expand the OldSpace. A value of 0 means no expansion is allowed. If -Xmoi is not specified then there are no restrictions on the expansion size of OldSpace.

-Xms<x>

This command line option sets the initial memory size to <x>.

Note: This option is the same as -Xmos<x> plus -Xmnx<x>.

-Xmx<x>

Memory object heap memory size

-Xmx>=NewSpace size plus OldSpace size

scavenger enabled: minimum size 1536 bytes on 32 bit architectures, 6072 bytes on 64 bit architectures

scavenger disabled: minimum size 512 bytes on 32 bit architectures, 2048 bytes on 64 bit architectures

-Xmr<x>

This command line option sets the remembered set size to <x>.

-Xmrx<x>

This command line option sets the maximum size of remembered set to <x>.

-Xmso<x>

This command line option sets the OS thread stack size to <x>.

-Xiss<x>

This command line option sets the initial Java thread stack size to <x>.

-Xss<x>

This command line option sets the maximum Java thread to <x>.

-Xmine<x>

This command line option sets the minimum size for heap expansion to <x>.

-Xmaxe<x>

This command line option sets the maximum size for heap expansion to <x>.

-Xmdx<x>

This command line option sets the default memory space maximum size. Xmdx <=Xmx. Defaults to -Xmx/8. -Xmx - -Xmdx is the space available for user memory spaces created with the com.ibm.oti.vm.MemorySpace class provided in jclRM.

Note: This is ignored if -Xresman is also used.

-Xresman<x>

This command line option enables resource managed support with the com.ibm.oti.vm.MemorySpace class in jclRM.

-Xminf<x>

This command line option sets the minimum percentage of heap free after GC.

-Xmaxf<x>

This command line option sets the maximum percentage of heap free after GC.

-Xgcthreads<x>

This command line option sets the number of GC threads

-Xnoclassgc

This command line option disables dynamic class unloading

-Xclassgc

This command line option enables dynamic class unloading only on class loader changes (default)

-Xalwaysclassgc

This command line option enables dynamic class unloading during global collection

-Xnocompactexplicitgc

This command line option will disable compaction on a system GC.

-Xcompactexplicitgc

This command line option will enable compaction on every system GC.

-Xcompactgc

This command line option will enable compaction.

-Xnocompactgc

This command line option will disable compaction.

-Xlp

This command line option will enable large page support.

-Xdbg:<options>

This command line option enables standard Java Debug Wire Protocol (JDWP) debug options.

-Xrunjdwp:<options>

This command line option enables standard JDWP debug options.

Note: Start a JDWP server. For more information on the JDWP options, see the Connection and Invocation Details web site.

-Xdbginfo:<symbol file path>

This command line option enables the debug info server.

-Xrdbginfo:<host>:<port>

This command line option enables the remote debug info server.