Creating a Request-Response JSON web service from high-level language structures

How to create a JSON web service, starting from high-level language structures in COBOL, C, or PL/I, or channel description documents.

Procedure

  1. Create high-level language structures or channel description documents for the request and response data structure for the CICS® program. For existing CICS programs, you may already have an appropriate file or you may need to create one to match the program specification.
  2. Run the JSON web services assistant to create a WSBind file and JSON Schemas.
  3. Configure CICS Transaction Gateway with an HTTP or HTTPS protocol handler and a JSON web service using the generated WSBind file. For more information, see Configuring JSON web services.
  4. Start CICS TG and test that you can invoke the JSON web service. Generated JSON Schemas can be used to develop a JSON web services client to invoke the web service.

Creating a channel description document

If the CICS program uses channels with multiple containers, create a channel description document that describes how each container appears in the JSON Schemas. Alternatively, you can use a single container in a channel and not create a channel description document. For more information, see Creating a channel description document.

The JSON assistant

Run the CICS TG JSON web services assistant by customizing and submitting the CTGLS2JS sample JCL. The assistant generates a WSBind file and JSON schemas from the language structures. CTGLS2JS contains the required parameters for the LS2JS mapping mode. For more information, see Creating a Request-Response WSBind file from a language structure.

The ctgassist program and samples are shipped with the CICS TG SDK in the webservices directory