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

Veryant Knowledge Base
Home > All Categories > isCOBOL General > Deployment > What are the minimum files I need for a runtime-only installation? How do I create a launcher?
Question Title What are the minimum files I need for a runtime-only installation? How do I create a launcher?

The minimum files you need for a runtime-only installation are:

  1. JRE 1.4.2 or later (Java Runtime Environment - which includes java.exe/javaw.exe and the rt.jar files which are required to run any Java-based application)
  2. isrun.jar from the isCOBOL installation lib folder (isrun.jar is the same as iscobol.jar but does not include the isCOBOL compiler)
  3. A properties file containing the isCOBOL license key (e.g. iscobol.license.2010)
  4. Your application .class files (or put them into a .jar file using the jar utility that comes with the JDK)
  5. Any other third-party .jar or other files that your application requires

There are many ways to create a launcher for your application. Veryant has tested and recommends Launch4j (free) and exe4j (commercial).

Or you can instruct the user to install Java from and then send them an executable JAR file (See "isCOBOL Getting Started Guide : Working with isCOBOL : Packaging Applications and Executing Using a Jar File" for more information).

Or you could manually create your own distribution that includes the JRE. You can either include the JRE installer (e.g. jre-6u21-windows-i586.exe). Or you can simply include the necessary files.

For example, on Windows you can create a new folder named myapp with the following subfolders:

Copy all of the folders and files
C:\Program Files\Java\jdk1.6.0_21\jre

C:\Program Files\Veryant\isCOBOL2010\lib\isrun.jar

Copy your COBOL program .class files and your file which contains your license key and other isCOBOL runtime framework properties

Then in the myapp folder you can create a desktop shortcut to run the program with the following target value:

%windir%\system32\cmd.exe /c jre\bin\javaw.exe -cp lib\isrun.jar;classes MYPROGRAM

Leave the "Start in" field blank to set the folder containing the shortcut to be the current working directory.

You can avoid a console window from popping up by choosing "Minimized" from the "Run" drop-down.

You can change the icon by pressing "Change Icon" and looking for icons in %windir%\system32\shell32.dll.

If you make sure that the JRE is installed on the machine, then you can specify %SystemRoot%\system32\javaw.exe in the shortcut target field. For example,

%SystemRoot%\system32\javaw.exe -cp lib\isrun.jar;classes MYPROGRAM

The above methods will allow you to install your application folder anywhere on the machine.

If you know the absolute path to your directory structure you can use it in the shortcut target field. For example,

C:\myapp\jre\bin\javaw.exe -cp lib\isrun.jar;classes MYPROGRAM

In this case you would set "Start in" to C:\myapp

As you can see there are many options. Please contact Veryant Support for further assistance.

Authored by: Veryant Support This question has been viewed 9709 times so far.
Click Here to View all the questions in Deployment 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. Did you know you can create temporary files in memory?
  2. How can I encode a URL String?
  3. Working with sequential files on Pipes
  4. Did you know isCOBOL IDE allows you to easily understand how to invoke a method in a Java Class?
  5. What can I use to perform an email validation during entry-field accept?
  6. How do I generate an executable for deployment?
  7. How do I create an installation package for my COBOL application?
  8. Is there a way to to emulate the W$GETC routine?
  9. Did you know isCOBOL IDE allows you to easily understand how to invoke a method in a Java Class?
  10. Did you know you could choose from different languages for isCOBOL message?
  11. Did you know you could set a background image from isCOBOL IDE's painter?
  12. How can I read data correctly from a line-sequential file that has a different encoding from the one used by isCOBOL?
  13. Did you know these two ways of finding out the working directory in use?
  14. Can I mix versions of Java, isCOBOL compiler and isCOBOL runtime?
  15. How can I read a data written with a different encoding?
  16. How can I use the Call/Cancel custom HOOK program to get the start and end time of every CALLed program?
  17. How can I tell if my application is running in the WebClient environment or another environment?
Article Information Additional Information
Article Number: 144
Created: 2010-08-19 10:51 PM
Rating: 1 Star
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.