Ensures that the current working thread is attached to the Java
VM. It operates as follows:
if the Java VM is not created it creates it.
if the java VM is running, but the current working thread is not
attached as a Java VM thread it attaches it.
if none of the above it returns.
The java_vm_attach() function is
called implicitly in each of the other VSEs, and also when
allocating, copying or deleting a Virtuoso/PL reference to a Java
VM object values.
If the Java VM is already initialized and the classpath is
supplied it will throw a SQL error. If the Java VM is not
initialized, but it is required to execute a statement the server
will implicitly call java_vm_attach
(NULL); . The Virtuoso Java VM integration binary works with
JDK 1.2 and later.
The classpath string to be supplied to the Java VM. If classpath
is NULL the server OS environment variable CLASSPATH will be used
A vector of name/value pairs for the Java VM initialization
parameters. The format and values of the parameters is described in
the JNI Enhancements Introduced in version 1.2 of the JavaTM 2 SDK
document - the description of JNI_CreateJavaVM Invocation API
This example initializes the Java VM by supplying a classpath
and sets the tomcat.home Java
system property to /usr/local/jakarta-tomcat-3.3.1 It is the
equivalent of executing JDK/JRE 1.2 unix java tool using: