Previous Topic Next topic Print topic

Micro Focus Enterprise Developer 2.3 for Eclipse > Welcome > Getting Started > Mainframe Tutorials > Getting started with Micro Focus Enterprise Developer for Eclipse

Getting started with Micro Focus Enterprise Developer for Eclipse

This set of tutorials guides you through the use of Micro Focus Enterprise Developer for Eclipse. They provide a basic understanding of how the product operates.

These tutorials are designed for developers who have experience with developing COBOL on the mainframe but do not necessarily have a working knowledge of the Eclipse Integrated Development Environment (IDE). The tutorials provide a basic understanding of the features offered in Enterprise Developer for Eclipse to develop and maintain both simple COBOL and mainframe subsystem applications.

Other tutorials, which are designed for Administrators, are available.

Demonstration application

A preconfigured, fully executing application, MFETDUSER, is available in the installation folder for the samples for this product, %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples by default, and in the Mainframe\BankDemo subfolder. This product does not officially support Windows XP but, if you are using it on this platform, the samples are installed in a different folder, C:\Documents and Settings\All Users\Documents\Micro Focus\Enterprise Developer\Samples.

The demonstration application includes all the source files needed to run it. The application is both a batch and online application which assesses data on a fictitious bank system. The bank data is stored in VSAM files.

Important: Before attempting this tutorial, create a directory named MFETDUSER on the root of your local drive (C:). Then, copy the entire directory structure for the BankDemo demonstration from the %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\BankDemo\MFETDUSER folder into the new C:\MFETDUSER folder.

As part of this tutorial, you use the standard Eclipse COBOL project template to set up a development environment for this application. The tutorials show how you can:

  • Edit the source files
  • Compile the source code
  • Execute and debug the application

Prerequisites

You must have the following software installed:

  • Micro Focus Rumba or an equivalent TN3270 terminal emulator is required to run the CICS application.
    Note: A license for Micro Focus Rumba is included with Enterprise Developer. If you do not have Rumba installed, please refer to the Micro Focus Web site.

Using a remote enterprise server instance for the tutorials

If you have an active firewall on the machine that is running your Directory Server and enterprise server instances, and you want remote clients to be able to connect to them, you must ensure that the firewall allows access to the ports that you are using.

For example, Directory Server is configured, by default, to use port 86. Your must configure your firewall to allow TCP and UDP access to this port. Similarly, the default enterprise server instance, ESDEMO, has a Web Services and J2EE listener that uses port 9003. For remote clients to be able to submit requests to this listener, your firewall must permit access to this port.

We recommend that, if you want remote users to access Enterprise Server functionality through the firewall, you use fixed port values so that you can control access via these.

Note: Windows XP is not officially supported. If you are, however, using Microsoft Windows XP and have installed Service Pack 2, you might find that you cannot see certain Enterprise Server Administration pages, because of firewall restrictions. To get round this, you need to enable access to the ports you are using, for example, 86 for the Enterprise Server Administration Home page and 9003 for the default enterprise server, ESDEMO. Use the Windows Security Center to do this.
  1. Starting the Eclipse Integrated Development Environment
    The main Eclipse window includes a number of views. The views and their layout depend on whether you have used Eclipse before. You can move, resize and minimize views which is why they might not look exactly as described here.
  2. Importing the BankDemo Project and Adding the Source Files
    You need to create the BankDemo project from a template in your workspace and then add the source files to this project to be able to build, develop and test the application.
  3. Editing Source Files
    This topic describes the editing features for the various file types (COBOL, JCL, IMS, BMS, and Data Files).
  4. Compiling the Source Code
    By default, the Eclipse IDE is set to build projects automatically. Whenever you add new COBOL or BMS files to the Bankdemo project, the IDE starts an automatic build (compilation).
  5. Unit Testing the Batch Application
    The first thing you need to do is check that the Bankdemo application is executing correctly.
  6. Unit Testing the Online Application
    In the previous step, Unit Testing the Batch Application, you used the Bankdemo enterprise server. You are going to use it again for online testing.
  7. Debugging the Batch Application
    You are going to debug the batch Bankdemo application.
  8. Debugging the Online Application
    You are going to debug the online Bankdemo Application.
Parent topic: Mainframe Tutorials
Previous Topic Next topic Print topic