OmniMark Java VM is an encapsulation of the OmniMark run-time as a Java component. OmniMark Java VM is packaged as part of OmniMark Concurrent Processing Engine, OmniMark Single Processing Engine, and OmniMark Studio for Eclipse.
You can write and compile OmniMark programs using OmniMark Studio for Eclipse, or use OmniMark Desktop Compiler or OmniMark Batch Compiler to compile. OmniMark Studio for
Eclipse, OmniMark Desktop Compiler and OmniMark Batch Compiler can
compile OmniMark source code into byte code which is executed by OmniMark Java VM. Compiled OmniMark programs
have the extension
.xvc
. .xvc
files are platform-independent: that is, they can be run by OmniMark Java VM on all supported
platforms.
On a Windows machine, you install OmniMark Java VM by running the OmniMark installer. When prompted for the type of installation, choose a custom installation: you will then be able to check the optional OmniMark Java VM component along with other selections. You will be guided through the installation and licensing process.
OmniMark ships with a number of external function libraries. Your OmniMark programs can call functions in these libraries. You can also write your own external function libraries or obtain them from third parties.
When searching for external function libraries, OmniMark Java VM searches in the following order:
setExternalFunctionLibraryPaths ()
.
On a UNIX machine, OmniMark Java VM is installed automatically when installing OmniMark Concurrent Processing Engine, OmniMark Single Processing Engine, or OmniMark Studio for Eclipse.
OmniMark ships with a number of external function libraries. Your OmniMark programs can call functions in these libraries. You can also write your own external function libraries or obtain them from third parties.
When searching for external function libraries, OmniMark Java VM searches in the following order:
setExternalFunctionLibraryPaths ()
.
LD_LIBRARY_PATH
on Linux and Solaris, and
LIBPATH
on AIX.
To build a Java program that uses the OmniMark Java VM,
JOmniVM
class,
setXVCFileName ()
method of the JOmniVM
class to set the filename of the compiled OmniMark program that will be run,
Run ()
method of the JOmniVM
class, and
javac -classpath <JOmniVM installation path> <program name>.javaand
You can then run the compiled Java program using
java -classpath <JOmniVM installation path>/JOmniVM.jar;..;. -Djava.library.path=<JOmniVM installation path> <program name>
Optionally, you may want to define a class that implements the JOmniLogger
interface, in order to
implement custom error-handling.
For a description of the properties and methods of OmniMark Java VM, see the etr83.rtf
document
and the javadocs in the OmniMark Java VM installation directory.