Tutorial: CICS Web Service Provider from JSON, Request-Response Top-down Method

Walks you through the steps required to create a new CICS Web service provider application from a set of request and response JSON files.
Restriction: This topic applies to Windows environments (local development) only.

In this tutorial, you use the top-down method to create a CICS Web service provider application that receives a character string in the form of a JSON request. The application reverses the string, and sends the reversed string back to the requester as a JSON response message.

To use the top-down method to create a CICS Web service provider, you start with request and response JSON that describes request and response data structures. From the JSON, you generate a skeleton CICS COBOL provider application, and a WSBIND file that provides mapping between the JSON and the COBOL data structures.

The sample project used in this tutorial to create your Enterprise Developer for Eclipse project contains the reverse.json schema, which describes both the request and response data structures.

Prerequisite

Review the Assumptions and Before you begin a CICS Web services tutorial sections in the Tutorials: CICS Web Services topic to be sure you have your environment configured properly.

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 ReverseJSON Project
    Guides you through the steps required to import the ReverseJSON project used in this tutorial to generate a CICS Web service.
  2. Generate the Reverse CICS Web Service Provider Components
    Provides step-by-step instructions that guide you through the process of generating all components of the Reverse CICS Web service provider from JSON.
  3. Add Reverse Operation Logic
    Guides you through the process of adding logic to the Reverse application that performs the task of reversing input.
  4. Set Up the JSONPROV Enterprise Server Region
    Guides you through the process of creating and configuring the JSONPROV enterprise server region, and installing and verifying resources.
  5. Test the ReverseJSON Web Service Provider
    Provides instructions and the code required to send a JSON request to test the ReverseJSON Web service provider.
Parent topic: Tutorials: CICS Web Services
Related concepts
Tutorials: CICS Web Services