Runtime Framework

Overview

Source code compiled with isCOBOL needs a Runtime Framework to run. The Runtime is the engine that runs the application. The Runtime Framework consists of a number of libraries that provide all the functionality required to run the application. These JAR files are installed in the "lib" directory of isCOBOL and are named:

•	charva.jar

•	itext-2.1.7v3.jar

•	jcalendar-1.3.3.jar

•

jna.jar

•	jna-platform.jar

•	swt-{Platform}.jar

•	DJNativeSwing.jar

•	DJNativeSwing-SWT.jar

The full path of these JAR files must be listed in the CLASSPATH variable in order to run the application properly. Some additional features require other JAR files to be accessed by Java. Those modules are platform dependent and are installed in the “native” directory of isCOBOL.

A program compiled with isCOBOL can be executed with the following command:

iscrun ProgramName

Note - On Windows this command should be launched from inside the isCOBOL Shell. Otherwise you need to set ISCOBOL and ISCOBOL_JRE_ROOT environment variables before using iscrun.

This command is a wrapper which automatically adds all of the JAR files listed above to the class path before executing java and passing ProgramName to it. When running on Windows, the following command can be used in the same way to call javaw.exe:

isrun ProgramName

Javaw.exe runs the program without displaying the command line console window.

When using isrun.exe, since standard output and standard error are not available in this case, the console output printed on two files called "isrun_out.log" and “isrun_err.log” in the bin directory of isCOBOL.