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.

Use the Generate Web Service dialog box to generate the components of your Web service provider.

Generate Web service components

  1. From the Solution Explorer, expand the ReverseJSON project's json folder; then Ctrl-click both the reverseReq.json and reverseResp.json files.
  2. Right-click the selected .json files; then select Generate Web Service from the context menu.
  3. In the Generate Web Service dialog box, ensure that reverseReq.json populates the (For request) field, and reverseResp.json populates the (For response) field.
  4. In the Generate group, select the Service radio button.
  5. In the Name field associated with the Service radio button, replace reverseReq with reverse, which is the name for the generated service interface.
  6. In the Program group's Name field, type reverse, which is the name for the generated COBOL skeleton program.
  7. In the Program group, check CICS.

    The Type radio buttons in the Program group enable you to specify the generation of either a Commarea or a Channel interface in the skeleton program. In this tutorial, you want to generate a Channel interface.

  8. In the Type group, select the Channel radio button. This activates the Container name field.

    The default container name is DFHWS-DATA, which is the top-level container used in service provider applications for CICS Web services.

  9. Click OK.

Enterprise Developer generates the following CICS Web service components in the reverse project folder:

reverse.cbl
A skeleton CICS program.
reverse.svi
A service interface file.
reverI01.cpy
A copybook containing the COBOL data structures required to send a JSON request as input. This file is generated but does not appear in the Solution Explorer.
reverO01.cpy
A copybook containing the COBOL data structures required to receive a JSON response message as output. This file is generated but does not appear in the Solution Explorer.

Generate and move the reverse.wsbind file

  1. In the Solution Explorer, right-click the reverse.svi file; then select Generate WSBIND.

    Because the reverse.wsbind file is generated to the ReverseJSON project's json\reverse folder, but the output path is set to the project's loadlib folder, you need to move the file from the ReverseJSON project's json\reverse directory to the project's loadlib directory so that Enterprise Server finds the correct file.

  2. Using Windows File Explorer or at a command prompt, change to the ReverseJSON project directory.
  3. Copy or move reverse.wsbind file from the project's json\reverse directory to the project's loadlib directory.