Common Problems

Table of Contents

1. Memory Problems
   1. Java Heap Space
   2. Slow Compilation
2. Thread Management
   1. WARNING: missing modifyThread permission

Memory Problems

Java Heap Space

If you see messages that refer to "Java Heap Space" while running the compiler, then the java virtual machine does not have enough memory to compile the given templates. You must increase the amount of memory allocated to the java virtual machine when you start the compiler. See the section [Doc/compiler/running Running the Compiler] for how to specify the VM memory.

Slow Compilation

If the compilation appears to be slow, check that the compiler is not thrashing because of a limited amount of memory. With the verbose option set, successful compilations will produce a summary like:

48 templates
517/0/517 compiled, 48/48 built
0/0 obj, 48/48 xml, 48/48 dep
0 errors, 31289 ms, 86 MB/506 MB heap, 11 MB/112 MB nonheap

The last line with gives the maximum amount of heap memory used and the maximum available (the value marked "heap"). If the maximum used is more than about 80% of the maximum available, then you should consider increasing the memory allocated to the java virtual machine. See the section [Doc/compiler/running Running the Compiler] for how to specify the VM memory.

Thread Management

WARNING: missing modifyThread permission

The java-implementation of the pan language compiler is completely multi-threaded. Internally, it controls several thread pools to handle compilation, execution, and serialization in parallel. At the end of a compilation, the compiler will normally destroy the thread pools that were created. The java security model requires that a program have the "modifyThread" permission to destroy threads. In some environments (notably eclipse), this permission may not be given to the compiler. If this is the case, then the message "WARNING: missing modifyThread permission" is printed on the standard error. Lacking this permission causes a "thread leak", but the effects are minor unless an extremely large number of templates are being compiled. If this is the case, then you should either change the configuration to grant this permission to the compiler, or work in an environment that grants it by default (e.g. using ant from the command line).