Before you start

You must install and configure the following in order to complete this tutorial:
  • Enterprise Developer
  • JBoss 6.1.0 Server, an application server for hosting web services
  • Axis2 1.6.2, a tool to generate server and client code to handle web services protocols
  • JBossAs Tools, a plugin that allows Eclipse to managed JBoss Application Server
  • You also need to download from the Micro Focus Community Web site a .zip file containing the source files.

JBoss 6.1

The JBoss 6.1 installer is found at http://www.jboss.org/jbossas/downloads/. Scroll down to 6.1.0.Final and click on Download. Save the jboss-as-distribution-6.1.0.Final.zip file and unzip into a directory.

You need to configure JBoss for each new workspace:

  1. Start Eclipse.
  2. Select Window > Preferences > Web Services > Server and Runtime.
  3. Click Server runtime and change to JBoss Enterprise Application Platform 6.x.
  4. Click Apply and OK.

Micro Focus COBOL Runtime

The JVM Micro Focus COBOL Runtime is contained in the Micro Focus COBOL install directory, in the bin directory (Windows) or the lib directory (UNIX).
  1. Copy the files mfcobolrts.jar and mfcobol.jar to [your-jboss-installation-folder]\server\default\lib.

Axis2

Axis2 is found at http://axis.apache.org/axis2/java/core/download.cgi.

Scroll down to the 1.6.2 release Binary Distribution zip. Click on zip. Save the axis2-1.6.2-bin.zip file and unzip into a directory.

You need to configure Axis2 for each new workspace:

  1. Select Window > Preferences > Web Services.
  2. For Axis2 preferences, click on Browse and select the top level folder for the Axis2 install location. Click OK to close the Browse for Folder dialog box. Then Apply and OK to accept and close the Preferences dialog box.
  3. For server and runtime preferences, click Web service runtime and change to Apache Axis2.
  4. Click Apply and OK.

JBossAs Tools

JBossAs Tools can be installed in the initial stage of creating a Dynamic Web Project.

  1. In Eclipse select File > New > Other. Type Dynamic Web in the text box which should show Dynamic Web Project. Select and click Next.
  2. In the New Dynamic Web Project dialog box, click New Runtime to bring up a New Server Run Time Environment dialog box.
  3. Click Download additional server adapters which brings up a Install New Extension dialog box.
  4. Find and click on JBossAs Tools then Next.
  5. Accept the license agreement and click Finish.
  6. Click OK on any security warnings.
  7. When a confirmation dialog box appears, click Yes. This will download the plugin and offer the option to restart Eclipse.

Source files

  1. Save the .zip file on the Web page http://community.microfocus.com/microfocus/cobol/visual_cobol/m/mediagallery/123.aspx and unzip it. The folder where the extracted files are held is referred to in this tutorial as <tutorial_source_folder>.