Tutorials: Interface Mapping Toolkit - Mainframe

Includes tutorials that guide you through the process of using the Interface Mapping Toolkit (IMTK) to define service interfaces derived from a CICS screen definition in a BMS mapset, the COMMAREA of a CICS program, and the a IMS Screen definition in an MFS map. In addition, each tutorial provides instructions for creating and configuring an enterprise server region on which to deploy the service interface to run as a Web service, and for accessing the Web service from one or more generated clients.


These tutorials are written from the perspective that all of the following is true. Specific instructions for setting up your environment to adhere to these assumptions is found in the Before you begin these tutorials section that follows:

  • You are familiar with the concept and implementation of a service interface.
    Note: To read up on IMTK technology, see the introductory IMTK information in this documentation, and review other relevant topics as needed.
  • Windows File Explorer is set to show file names and extensions.
  • You are running the latest version of Micro Focus Enterprise Developer, which has been installed on your local machine using default installation settings, including the Rumba+ Desktop option.
  • Enterprise Developer is started on your local machine.
  • User Account Control (UAC) is disabled.
    Note: This is required to avoid possible compiler errors; however, if disabling UAC is not possible, run Enterprise Developer as an administrator as a workaround. See To run Enterprise Developer as an administrator for details.
  • Your parent project directory is c:\tutorials\IMTK. If you choose to use an alternative parent project directory, adjust the instructions accordingly.
  • For Tutorial: CICS Screen Web Service only, all instructions regarding use of a TN3270 emulator assume that you are using the Micro Focus Rumba+ TN3270 emulator. If you are using an alternative emulator, adjust the instructions as required to accommodate your software.
  • You have addressed all of the items in the Before you begin this tutorial section below.

Before you begin these tutorials

Before beginning, be sure you have addressed each of the following items:

Disable User Account Control (UAC)
From the Windows Control Panel, set User Account Control to the most restrictive setting, for example, Never Notify. See your Windows documentation for instructions.
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.
Create a parent project directory
Create a directory in which to store the project files imported or created while completing this tutorial, which cites a parent project directory of c:\tutorials\IMTK.
Start Visual Studio
If you need instructions to get Visual Studio started on your local machine, see To start Visual Studio.
Set Rumba+ TN3270 options
Note: Required for Tutorial: CICS Screen Web Service only.
  1. In Visual Studio, click Tools > Options; then expand Micro Focus Tools and click TN3270 Display.
  2. In the right frame, ensure that Rumba (Embedded) is selected, and that Connect automatically is checked.
  3. Close the Options page.


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