Runtime Framework

isCOBOL Evolve : SDK User's Guide : Compiler and Runtime : Runtime Framework

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. There are two kinds of library: Java jar libraries and operating system native libraries.

This is the list of the Java jar libraries that compose the isCOBOL Runtime Framework:

Library	Description
asm-7.2.jar asm-commons-7.2.jar asm-tree-7.2.jar jacoco-core-0.8.5.jar	provides the Code Coverage feature
bcprov-jdk14-1.38.jar	Bouncy Castle library used for PDF encryption. If your programs don’t encrypt PDF files using either the ENCRYPTION attribute or the iscobol.print.attribute.encryption configuration property, you could safely remove this library
charva.jar	support for "green" terminals
commons-codec-1.13.jar commons-collections4.4.4.jar commons-compress-1.19.jar commons-math3-3.6.1.jar poi-4.1.2.jar poi-ooxml-4.1.2.jar poi-ooxml-schemas-4.1.2.jar xmlbeans-3.1.0.jar	provides the ability to manage XLS and XLSX files. They’re required by the Grid control export features
commons-logging-api.jar	implementations of commons-logging wrapper APIs
commons-logging.jar	implementatinos of commons-logging
ctree-rtg.jar	ctreej interface
DJNativeSwing-SWT.jar DJNativeSwing.jar swt-<platform>.<bits>.jar	default web-browser control implementation
image4j-0.7.2.jar	provides support for 1 and 32 bits .bmp files
iscobol.jar	isCOBOL Compiler, Framework, Debugger and Application Server
isupdater.jar	isCOBOL Software Updater tool
isprofiler.jar	isCOBOL Profiler
itext-2.1.7v5.jar	allow to generate PDFs for print files assigned to "-P PDF"
javassist.jar	isCOBOL Profiler dependences
jcalendar-1.3.3.jar	date-entry control implementation
jcommon-1.0.23.jar jcommon-xml-1.0.23.jar jfreechart-1.5.1.jar	allows you to create charts via java-bean technology
jdom.jar	allow the COBFILEIO, EfdParser and XML2WRK to parse XML files
jna.jar jna-platform.jar	allow the C$SYSTEM routine to create a process on Windows. Allow the C$OPENSAVEBOX routine to display native file chooser dialogs on Windows. Required also by the default web-browser control implementation
joe-1.3.jar	allow to execute joe scripts
wow.jar wowax.jar	isCOBOL WOW support

These libraries are installed in the isCOBOL lib folder on all platforms. All these libraries are portable to different platforms except for "swt-<platform>.<bits>.jar" that includes native items and therefore is different on every operating system.

This is the list of native libraries included in the isCOBOL Runtime Framework:

Library	Description
ctree	allow to interact with a c-tree server
dyncall	allows programs compiled without -cp option to call dynamic link libraries
dyncall_n	allows programs compiled with -cp option to call dynamic link libraries
iscobolc	allows programs compiled without -cp option to be called by C programs
iscobolc_n	allows programs compiled with -cp option to be called by C programs
Terminal	Curses implementation (native part) of Charva. Note - This library is not available on the Windows 64 bit platform.

On Windows systems these libraries are installed in the isCOBOL bin folder and have dll extension (e.g. bin\dyncall.dll).

On Linux/Unix systems these libraries are installed in the isCOBOL native/lib folder, they have the lib prefix and so extension (e.g. native/lib/libdyncall.so).

On Mac OSX systems these libraries are installed in the isCOBOL native/lib folder, they have the lib prefix and jnilib extension (e.g. native/lib/libdyncall.jnilib).

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.

Paths in Program-Name are considered only if iscobol.code_prefix is set. Relative paths in Program-Name are appended to the code-prefix paths.