Guide to update the isCOBOL runtime libraries on isCOBOL Web Applications running on Tomcat

Before discussing the details of this update, let's talk about the update of the license.
When your update is for a later year release you need to request development licenses for your products for that year and update the properties file where you have your license keys.
To learn more about that you can review the video on Veryant's YouTube channel: https://youtu.be/R6ScVpdT1XM

The .war archive you use to deploy your isCOBOL web application in Tomcat uses a specific folder structure holding your isCOBOL libraries and your own application's classes and resources.

That folder structure is usually the following:
(your app may have more) 

   web-app-name/WEB-INF
   web-app-name/WEB-INF/classes
   web-app-name/WEB-INF/lib
The WEB-INFlib is the one to update with the isCOBOL libraries of the new release that your application uses.
It includes at least the iscobol.jar and the itext-*.jar.
If your application uses any other libraries, then include those as well. Copy these files from the /lib folder of the isCOBOL SDK installation directory.

You may want to recompile the isCOBOL programs of your web app and update the WEB-INFclasses folder in some situations, for example:
  1. there are new features in the updated isCOBOL compiler that can benefit your application
  2. your isCOBOL classes were compiled by a much old version of the compiler.
Once you have updated the isCOBOL libraries (and the classes if necessary), recreate the .war archive by using the jar command available with the JRE or JDK.


Article ID: 332
Created: October 4, 2022
Last Updated: April 21, 2023
Author: Support KB Author

Online URL: https://support.veryant.com/phpkb/article.php?id=332