Configure Tomcat to use the isCOBOL EIS framework

$CATALINA_HOME is the Tomcat installation directory. The default location on Windows is:

C:\Program Files\Apache Software Foundation\Tomcat 7.0

To configure Tomcat to use the isCOBOL Runtime Framework on Windows you can change the value of the shared.loader property in $CATALINA_HOME/conf/catalina.properties to the following:

shared.loader=/program\ files/veryant/iscobol2017R1/lib/iscobol.jar;/program\ files/veryant/iscobol2017R1/lib/ishttp.jar

On Unix, set the CLASSPATH in Tomcat's startup environment to include iscobol.jar. For example, on Linux add the following line to /etc/tomcat7/tomcat7.conf or other script called during the Tomcat startup:

CLASSPATH=$ISCOBOL/lib/iscobol.jar:$ISCOBOL/lib/ishttp.jar:$CLASSPATH; export CLASSPATH

Make sure that you have a valid license for isCOBOL Evolve in /etc/iscobol.properties (i.e. iscobol.license.<release year>=<license key>) or in the iscobol.properties in the home directory for the user that starts Tomcat.

Disable Persistence Across Restarts

Whenever Apache Tomcat is shut down normally and restarted, or when an application reload is triggered, the standard Manager implementation will attempt to serialize all currently active sessions to a disk file located via the pathname attribute. All such saved sessions will then be deserialized and activated (assuming they have not expired in the mean time) when the application reload is completed. In order to successfully restore the state of session attributes, all such attributes must implement the java.io.Serializable interface. Since not all isCOBOL classes are serializable, it’s strongly suggested to disable this persistence feature.

To disable this persistence feature, create a Context configuration file for your web application and add the following element there:

<Manager pathname="" />

Note - The file context.xml in the Tomcat home directory already includes the above entry, but it’s commented. You can easily disable the persistence for all your web applications by removing the comment markers around the entry.

Relative paths

Relative paths used by COBOL programs in EIS environment are relative to the webapp directory except for iscobol.code_prefix paths that are relative to the Tomcat working directory.