support: Customer Portal
Focused on delivering choice, investment protection and flexibility to organizations with valuable COBOL assets

Veryant Knowledge Base
Home > All Categories > isCOBOL IDE > Guide to update the isCOBOL development environment
Question Title Guide to update the isCOBOL development environment

This guide has four sections, the first two discuss how to update to a later build or release of the IDE, and how to update to a later isCOBOL SDK. The last two sections can be followed when you just need to take advantage of a compiler enhancement that you updated on the SDK but can be leveraged by the IDE without having to update the IDE as well or when you want to update the IDE to use any enhancement on it but still use and older compiler version from the SDK.

If your update is for a later year release you'll need to request development licenses for your products for that year and update the properties file where you have your license keys before taking the steps below. To learn more about that you can review the video about licenses on Veryant's YouTube channel:

1. Updating the isCOBOL IDE
If you are updating to a later build of the same IDE release, then you can just install in the same folder and continue using the IDE without further steps.
Example: Updating the IDE 2022.1.1060.5 to the 2022.1.1060.7.

If you are updating from a prior release to a later one, especially from a prior year release, you may want to remain with the prior version of the IDE during the transition while you test that the new IDE is working without errors with your applications. This is easily done because the IDE is installed in different folders and they are very self-contained so that they do not interfere with each other.

When installing a different year IDE version, it is a good practice to create a clean new workspace, start the new IDE in that clean workspace and import the projects from the older one.
Example: If you had the IDE 2020R2 and you now install the IDE 2022R1, you might create a new workspace called "workspace22r1". This option is useful to give you an independent workspace for each version of the IDE while you run your general tests during the transition.

Another option, especially useful if you update the IDE every year, is to continue using the same workspace. In this case you should keep a backup of it before accessing the workspace to use with the later IDE.

2. Updating the isCOBOL SDK
If you are installing a later build of the same release, install in the same folder. You do not need further steps to continue working.

If you are installing a different release, the default installation will install in a different folder by default. This will allow you to keep the older version for possible parallel testing or usage during the version transition.

After installing the new release while keeping the prior, you need to make sure you are accessing the correct version of the SDK. The easiest way to do this in Windows is to use the isCOBOL Shell command prompt, found in the Start menu. You can start the isCOBOL Shell for the specific version you want to run to ensure you are accessing the correct version of the SDK. You can test to see which version you're using by running the command "iscrun -version".

If your SDK was installed on Linux and you use shell scripts to run commands, or you use batch scripts in Windows instead of using the isCOBOL Shell command prompt, you can add SET/EXPORT commands in those scripts to point to the correct version you want.

For instance (example for 2022R1 and JDK 8u321):

   set ISCOBOL=C:VeryantisCOBOL_SDK2022R1
   set ISCOBOL_JDK_ROOT=C:Program FilesJavajdk1.8.0_321
   export ISCOBOL=/opt/veryant/isCOBOL_SDK2022R1
   export ISCOBOL_JDK_ROOT=/opt/jdk1.8.0_321
   export CLASSPATH=$ISCOBOL/lib/*:$ISCOBOL/jars/*:$ISCOBOL_JDK_ROOT/lib/tools.jar:$CLASSPATH
In Windows environments you can also set these environment variables at the computer level in your Windows system properties when you discard your older SDK version and remain with the latest you installed.

3. Updating the SDK compiler and use it in your IDE

In this scenario you are advised that a compiler enhancement was made and you update the isCOBOL SDK with that, but you also want the IDE to take advantage of it. After updating the isCOBOL SDK as described above in section 2 you do not need to update the IDE as well, just configure the IDE to use the external SDK compiler.

To do that use the Window > Preferences > isCOBOL > Installed isCOBOL option. There you will find the "Embedded isCOBOL" libraries.
Click the Add button and browse to the folder where the isCOBOL SDK is installed (the one that contains the lib and bin subfolders) and select it.
Then click the check-box of that new entry. That will unselect the default "Embedded isCOBOL" and select the SDK that was updated, so the compiler of that installation will be used by the IDE from then on.

4. Updating the IDE and have it use a prior SDK compiler

The last scenario is when a later IDE release has a development enhancement that you want to use, but you need to still use an older compiler from the SDK. This may happen for instance if your production environment still remains on a prior release.

In this case you can update the IDE as described above in section 1, then use the Window > Preferences > isCOBOL > Installed isCOBOL option described above in section 3 to point to the SDK compiler of your prior version.

Authored by: Veryant Support This question has been viewed 535 times so far.
Click Here to View all the questions in isCOBOL IDE category.
File Attachments File Attachments
There are no attachment file(s) related to this question.
How helpful was this article to you?
User Comments User Comments Add Comment
There are no user comments for this question. Be the first to post a comment. Click Here
Related Questions Related Questions
  1. How do I set up a CVS repository and access it from Eclipse and the isCOBOL IDE?
  2. How do I resolve the error "Unhandled event loop exception"?
  3. How to filter the problems view to avoid seeing the errors of so many different programs in a project?
  4. isCOBOL IDE or Eclipse error "Workspace in use or cannot be created, choose a different one"
  5. Can you recommend a book for learning the Eclipse based isCOBOL IDE?
  6. How do I make an isCOBOL program that will run on a mobile device, like iPad?
  7. isCOBOL IDE Eclipse Troubleshooting
  8. Does Veryant provide a plugin to Eclipse or did Veryant customize Eclipse to be the IDE for isCOBOL?
  9. What are the steps to add an external tool or integrate a utility such as JDBC2FD into the isCOBOL IDE?
  10. How do I install support for Subversion (SVN) in Eclipse or isCOBOL IDE?
  11. On which version of Eclipse are the isCOBOL 's built?
  12. Generate stopped working after upgrading the isCOBOL IDE
  13. What is the current working directory when I launch my program from the IDE?
  14. How do I configure the IDE to put logs and other files in separate project folders?
  15. How do I install new plugins received from Veryant Support?
  16. Were you aware of the ability of "block selection" in the isCOBOL Editor under Eclipse?
  17. Toggling comments in the properties file editor
  18. Is there a way to stop the pop up from coming up when I start to type in code in the program?
  19. How to create groups of fields on the IDE screen painter, that use the same area on the screen, but visible at different moments?
  20. How can I work with the java property 'file.encoding' inside the isCOBOL IDE?
  21. Did you know you can compare text files using the isCOBOL IDE?
  22. How to generate and compile an isCOBOL IDE workspace in background-mode
  23. How can we avoid having to select the way a program will be "Run As" or "Debug As" in the IDE each time we run it?
  24. How to create a report with the IDE Report Designer
  25. How to use existing FD/SL copybooks in the Screen Programs without generating FD/SL from IDE Data View
  26. How to run batch programs on a Linux server and compile and debug them from the IDE
  27. Working with Remote Projects
Article Information Additional Information
Article Number: 328
Created: 2022-05-16 3:30 AM
Rating: No Rating
Article Options Article Options
Print Question Print this Question
Email Question Email Question to Friend
Export to Adobe PDF Export to PDF File
Export to MS Word Export to MS Word
Bookmark Article
Subscribe to Article Subscribe to Article
Search Knowledge Base Search Knowledge Base


© Veryant - All Rights Reserved
Veryant and isCOBOL are trademarks or registered marks of Veryant in the United States and other countries. All other marks are the property of their respective owners.