Prerequisites

You must install and configure the following in order to complete this tutorial:
  • This tutorial requires your projects to target Java 7.
  • JBossAS Tools, a server adapter that enables Eclipse to manage the JBoss Application Server.
  • JBoss EAP 6.4, for hosting Web services.
  • Apache Axis2 1.6.4, 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.

JBossAS Tools

Before installing JBoss Application Server you must download and install the JBossAS Tools server adapter:
  1. Click Window > Preferences > Server > Runtime Environments.
  2. Click Add.

    This opens the New Server Runtime Environment dialog box.

  3. Expand Red Hat JBoss Middleware.
  4. Click JBoss AS, WildFly, & EAP Server Tools, and then click Next.
  5. Accept the license agreement, and then click Finish.
  6. If you are presented with a security warning about unsigned content, ignore it by clicking OK.
  7. Click Yes to restart Eclipse.
    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

  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. For a list of supported versions, see Additional Software Requirements.
    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 install the JBoss AS tools in Eclipse:

  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.
  5. Click JBoss AS, WildFly, & EAP Server Tools, and then click Next.
  6. Accept the license agreement, and then click Finish.
  7. If you are presented with a security warning about unsigned content, ignore it by clicking OK.
  8. Click Yes to restart Eclipse.
    Note: If this is the first time the workspace settings have been changed then Eclipse might prompt you to store preference information.

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.6.4-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 OK.
  4. Click OK.
  5. Click Window > Preferences > Web Services > Server and Runtime.
  6. In the Web service runtime list, click Apache Axis2.
  7. Click OK.

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