Prerequisites

You must install and configure the following in order to complete this tutorial:
  • This tutorial requires your projects to target Java 8.
  • JBoss Tools, a plugin that enables Eclipse to manage the JBoss Runtime.
  • JBoss EAP 6.4, for hosting Web services.
  • Apache Axis2 1.7.8, a tool to generate server and client code to handle Web services protocols.
  • The JVM Micro Focus COBOL Runtime.
  • You also need to download from the Micro Focus Community Web site a .zip file containing source files.

JBoss Tools

Before installing JBoss Runtime you must download and install the JBoss Tools from the Eclipse Marketplace:
  1. Click Help > Eclipse Marketplace

    This opens the Eclipse Marketplace dialog box.

  2. In the Find field, type JBoss Tools, and then press Enter.
  3. Find the JBoss Tools 4.5.3.Final plugin in the returned results list, and then click Install.
  4. In the Confirm Selected Features page, click Confirm.
  5. Accept the license agreement, and then click Finish.

    If you receive a security warning, click Install anyway.

  6. When prompted to restart Eclipse, click Restart Now.
    Note: If this is the first time the workspace settings have been changed then Eclipse might prompt you to store preference information.

JBoss

Download and install JBoss EAP

  1. In a browser, open the 3.3. DOWNLOAD AND INSTALL JBOSS EAP USING THE ZIP page located on the Red Hat Web site.
  2. Follow the instructions provided to download and install the Red Hat JBoss Enterprise Application Platform. See Additional Software Requirements for more information on supported versions.
    Note: This download might require a Red Hat subscription.

Install JBOSS AS tools in Eclipse

To enable Eclipse to manage JBoss Application Server, you need to add the server runtime environment:

  1. Start Eclipse.
  2. Click Window > Preferences > Server > Runtime Environments.
  3. Click Add.

    This opens the New Server Runtime Environment dialog box.

  4. Expand Red Hat JBoss Middleware, and then click Red Hat JBoss Enterprise Application Platform 7.1 Runtime.
  5. Click Next.

    This opens the New Server Runtime Environment dialog box.

  6. Next to the Home Directory field, click Browse, and then select the folder containing JBoss EAP.
  7. Click OK.
  8. Ensure that you are using a Java 8 JRE runtime.
  9. Click Finish.
  10. Click Apply and Close.

Configure JBoss for each new workspace

  1. Start Eclipse.
  2. Click Window > Preferences > Web Services > Server and Runtime
  3. In the Server runtime list, click JBoss version.
  4. Click OK.

Micro Focus COBOL Runtime

The JVM Micro Focus COBOL Runtime (mfcobolrts.jar) is located by default in the Micro Focus COBOL install directory %ProgramFiles(x86)%\Micro Focus\Visual COBOL\bin (Windows) or $COBDIR/bin (UNIX).

The COBOL Runtime file must be added to the Deployment Assembly later in the tutorial.

Axis2

To download Axis2:

  1. Click here to download Axis2.
  2. Click axis2-1.7.8-bin.zip, and download from a suitable mirror site.
  3. Extract into a directory.

You need to configure Axis2 for each new workspace in Visual COBOL:

  1. Click Window > Preferences > Web Services > Axis2 Preferences.
  2. On the Axis2 Runtime tab, click Browse and navigate to the Axis2 top-level folder.
  3. Click Apply and Close.
  4. Click Window > Preferences > Web Services > Server and Runtime.
  5. In the Web service runtime list, click Apache Axis2.
  6. Click Apply and Close.

Source files

  1. On the Micro Focus Community Web site, click Download.
  2. Save the .zip file and extract its content into a directory.
    Note: The extract directory is referred to in this tutorial as <tutorial_source_folder>.
Parent topic: Tutorial: Calling JVM COBOL programs as part of an Axis Web service
Related concepts
Additional Software Requirements on Windows
Additional Software Requirements on Linux and UNIX