Tutorial: SOAP Web Service

Walks you through the process of defining a SOAP Web service using the Interface Mapping Toolkit (IMTK), deploying it to an enterprise server instance, and generating and running a client to access it.
Restriction: This topic applies only when the Enterprise Server feature is enabled.
Restriction: This topic applies to Windows environments only.

Prerequisite

Review the Assumptions and Before you begin a tutorial sections in the Tutorials: Interface Mapping Toolkit topic to ensure your Visual COBOL environment is set up properly.

Demonstration application - ScheduleDemo

The COBOL application that you use in this tutorial is the ScheduleDemo demonstration application. The application source code is installed with Visual COBOL in the %PUBLIC%\Documents\Micro Focus\Visual COBOL\Samples\Interface Mapping Toolkit\ServiceInterfaces\ScheduleDemo directory by default.

The ScheduleDemo demonstration application is a system for scheduling and viewing appointments. The application uses the following source and data members:

  • schedule.cbl
  • common.cpy
  • common_78.cpy
  • common_ex.cpy
  • common_ws.cpy
  • consultants.cpy
  • customerinfo.cpy
  • stores.cpy
  • appoint.dat
  • consultants.dat
  • customers.dat

Using the application, you can either schedule a new appointment, or look up an existing appointment. We recommend that you review the application source code to become familiar with how it works.

Sequence

To complete this tutorial, progress through these topics in the order presented here. The bottom of each topic provides Next topic and Previous topic navigational links to help you proceed in the proper sequence:

  1. Set Up the ProgramSOAP Project
    Provides instructions that take you through the process of creating an Eclipse project for the ScheduleDemo demonstration application, setting build properties for the project, and populating the project with demonstration files.
  2. Create the MakeCheckAppt Service Interface
    Walks you through the process of creating the MakeCheckAppt service interface in which to define a SOAP Web service.
  3. Define MakeCheckAppt Operations
    Walks you through the process of defining service interface details for the MakeCheckAppt Web service.
  4. Set Up the ESSOAP Enterprise Server Instance
    Walks you through the process of creating and configuring the ESSOAP enterprise server instance used to run the MakeCheckAppt SOAP Web service.
  5. Deploy the MakeCheckAppt Web Service
    Guides you through the steps required to prepare the ProgramSOAP project and MakeCheckAppt Web service for deployment, deploy the Web service to the ESSOAP enterprise server instance, and verify the deployment results.
  6. Generate a COBOL Client
    Provides instructions for generating a COBOL client to access the MakeCheckAppt Web service.
  7. Debug the COBOL Client
    Guides you through the steps required to create a debug configuration for the generated COBOL client application, and to use the Eclipse debugger to access the MakeCheckAppt Web service from the client application.
Parent topic: Tutorials: Interface Mapping Toolkit
Related concepts
Tutorials: Interface Mapping Toolkit