Tutorials: Interface Mapping Toolkit

Includes tutorials that teach you how to use the Interface Mapping Toolkit (IMTK) from the Eclipse IDE using a demonstration COBOL application to create and access both SOAP and REST Web services, and a Java EJB service interface.
Restriction: These Interface Mapping Toolkit tutorials apply to Windows platforms only.

Assumptions

These tutorials are written from the perspective that all of the following is true. If you require specific instructions for any of these items, see the Before you begin a tutorial section that follows:

  • Windows File Explorer is set to show file names and extensions (applies to Windows environments only).
  • You have installed the latest version of Micro Focus Enterprise Developer for Eclipse on your local machine using default installation settings.
  • The COBOL environment is set up using the cobsetenv command.
    Note: You must do this step before activating ESCWA.
  • The Enterprise Server Common Web Administration (ESCWA) feature is activated on your local machine before starting Enterprise Developer.
  • Enterprise Developer is started on your local machine, and the Team Developer perspective and Application Explorer view are open..
  • Eclipse options are set to build projects automatically.
  • You have addressed all of the items in the Before you begin a tutorial section below.

Before you begin a tutorial

Set Windows File Explorer options
These tutorials assume that your Windows File Explorer options are set to use the Details layout, and to show file name extensions. See your Windows documentation for more information.
Start Enterprise Developer
Start Enterprise Developer using the default workspace, which is c:\users\username\workspace where username is your operating system login ID. If you need instructions to get Enterprise Developer started on your local machine, see To start Enterprise Developer.
Open the Team Developer Perspective and Application Explorer View in Eclipse
When you start Enterprise Developer for the first time, the Team Developer perspective starts automatically by default, and shows the Application Explorer view. If this is not the case, open the Team Developer perspective as follows:
  1. From the Eclipse IDE, click Open Perspective Open Perspective.
  2. On the Open Perspective dialog box, select Team Developer (default), and then click Open.

In addition, the Enterprise Development Projects system should be loaded in the Application Explorer view. To confirm this:

  • In the Application Explorer view, you should see the Enterprise Developer system. If the system is not shown, to load it:
    1. Right-click in the Application Explorer view, and then click Add System(s).
    2. In the Add System(s) dialog box, select ED System and click OK.
    3. Expand the top-level Enterprise Developer entry in the Application Explorer view.
    4. Right-click Enterprise Development Projects; then click Load Application.
  • Otherwise, expand the Enterprise Developer system. An entry titled Enterprise Development Projects should appear indicating that the system is loaded.
Set Eclipse to build automatically
By default, the Eclipse Build Automatically option is turned on, which means that Eclipse builds a project automatically each time a change is made. To ensure that this Build Automatically is turned on:
  1. From the Eclipse Main Menu, click Project.
  2. Do one of the following:
    • If the Build Automatically menu option has a check mark to its left, it is already turned on. No further action is required.
    • If the Build Automatically menu option does not have a check mark to its left, click the option to turn it on.
Set Interface Mapper preferences
Before you begin the tutorials, you need to set the properties for the Interface Mapper to show both the Reusable Fields and COBOL Assignments panes. You use one or both of these panes while working through the tutorials.
  1. From the Main Menu in Eclipse, click Window > Preferences.
  2. Expand Micro Focus > Service Interfaces; then click Interface Mapper.
  3. Check both Show Reusable Fields pane and Show COBOL Assignments pane; then click Apply and Close.
    Note: If a Preference Synchronization dialog box appears, click No - Preferences will be saved locally.; then click OK.

Sequence

You may do these IMTK tutorials in any order. They are not interdependent.