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.

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 project template used in this tutorial to create your Enterprise Developer for Visual Studio 2019 project contains the reverseReq.json and reverseResp.json schemas for this purpose.

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 create 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, and then building the project in Visual Studio.
  4. Set Up the CWSJSON Enterprise Server Region
    Guides you through the process of creating and configuring the CWSJSON 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