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.

Assumptions

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 Enterprise Developer, which has been installed on your local machine using default installation settings.
  • 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 Host Access for the Cloud. If you are using an alternative emulator, adjust the instructions as required to accommodate your software.
  • For Tutorial: CICS Screen Web Service only, you have started the HACloud session server. For instructions on how to do this, see Starting the HACloud Session Server.
  • 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:

Enterprise Server Security
In this release, the Enterprise Server security features are enabled by default. Tutorials that use enterprise server regions, however, assume that Enterprise Server security is not configured. To work though this tutorial unchanged, you need to disable any configured Enterprise Server security. See To Disable the Default Enterprise Server Security Configuration for details.
Important: Micro Focus does not recommend disabling the security permanently. Re-enable it as soon as possible after completing tutorials. See To Recreate the Default Enterprise Server Security Configuration. For more information, see also After Installing > Enterprise Server Security Considerations.
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.
Note: If Visual Studio prompts you on startup to select an initial action, click Continue without code.

Sequence

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