First you need to create a project to contain the procedural COBOL program, and make it available for execution from a Java program:
- Launch an instance of
Visual COBOL
for Eclipse.
- When prompted for the workspace name, type the name of a folder into which you wish to store the tutorial project (for example,
~/projects/).
- If you are presented with the Welcome tab, click
Open COBOL Perspective.
- Click
.
This opens the
New COBOL JVM Project dialog box.
- Type
CobolBook in the
Project name field.
- In the
JRE section, ensure that a Java 7 run-time environment is selected by using one of the options available. If a Java 7 version is not already showing for any of the available options, click
Configure JREs and add one.
- Click
Finish.
This creates a JVM COBOL project to contain the sample procedural COBOL program that you will import into the Web application later in this tutorial.
Note: If Eclipse prompts you to switch to the COBOL perspective then do so. In general, any action that uses the CobolBook project is expected to be carried out in the COBOL perspective. Similarly, any action that uses the dynamic Web project, which comes later in this tutorial, is expected to be carried out in the Java EE perspective. To change perspectives, click on the appropriate option in the top right of the Eclipse main window.
Specifying a Java package
By default, COBOL programs are placed in the default root Java package. JVM servlet containers do not always allow root package classes to be loaded, so you must set up a package for the program.
Note: The Java package system is equivalent to the JVM COBOL namespace system; these two terms are interchangeable.
To set up the package:
- In COBOL Explorer, right-click the CobolBook project, and click
New > COBOL JVM Package.
This opens the
New COBOL JVM Package dialog box.
- Type
com.microfocus.book in the
Name field. Click
Finish to create the package.
This process creates a folder structure in the workspace, in which to store the COBOL program, and informs Java where to find it. You are now ready to set up the COBOL program.