Appendix C. Environment variables

This appendix contains a list of all environment variables used by the Jamaica tools.

Table C-1. JamaicaVM environment variables

NameDescription
CLASSPATHPathlist to search for class files
JAMAICA_SCHEDULINGSelect native thread scheduling mode:

  • OTHER -- default scheduling

  • RR -- Round Robin

  • FIFO -- FIFO

JAMAICAVM_HEAPSIZEHeap size in bytes (e. g., 1M).
JAMAICAVM_JAVA_STACKSIZEJava stack size in bytes (e. g., 5k).
JAMAICAVM_NATIVE_STACKSIZENative stack size in bytes (e. g., 5k).
JAMAICAVM_NUMTHREADSMaximum number of Java threads.
JAMAICAVM_IMMORTALSIZESize of immortal memory.

Table C-2. JamaicaVM Builder environment variables

NameDescription
JAMAICA The Jamaica Home directory. When working with multiple Jamaica installations, this variable sets the path of Jamaica to be used. Under Unix-systems this have to be a Unix-style pathname, under Windows this have to be a DOS-style pathname.
JAMAICA_BUILDER_HEAPSIZEHeap size of the jamaica programme itself in bytes.
JAMAICA_BUILDER_JAVA_STACKSIZEJava stack size of the jamaica programme itself in bytes.
JAMAICA_BUILDER_NATIVE_HEAPSIZENative stack size of the jamaica programme itself in bytes.
HEAPSIZEHeap size of the application to be built in bytes. Min=85k.
JAVA_STACKSIZEJava stack size of the application to be built in bytes. Minimal size is 1k.
C_STACKSIZEC stack size of the applicatino to be built in bytes. A size of 0 means 'umlimited' stack size.
NUMTHREADSMaximum number of Java threads used by the application to be built. Min=1.
JAMAICA_DEBUGLEVELDefines the debug level of an application that was built with the option -debug

Level of 0 :only little debug output is printed
Level of 10 :very detailed debug output is printed. Already a simple HelloWorld application will produce thousands of lines

A good choice is a level of about 5.
JAMAICA_DEBUGCALLNATIVEDefines a string of a native method. Any call to that method is printed additionally to the other debug output. Requires a minium debug level of 5. If the variable is not set or '*', any native call is printed.
JAMAICA_DEBUGCALLJAVADefines a string of a Java class or method. Any call to that entity is is printed additionally to the other debug output. Requires a minium debug level of 5. If the variable is not set or '*', any call is printed. E. g.: JAMAICA_DEBUGCALLJAVA=java/lang/String.length will print any call to the method java.lang.String.length().

Table C-3. JamaicaH environment variables

NameDescription
JAMAICA_JAMAICAH_HEAPSIZEHeap size of the jamaicah programme in bytes.

Table C-4. Numblocks environment variables

NameDescription
JAMAICA_NUMBLOCKS_HEAPSIZEHeapsize of the numblocks programme in bytes.