Generate Reverse Web Service Provider Components

Provides step-by-step instructions to generate CICS Web service provider components from the Reverse project, and describes each output component. It also provides instructions for separately generating a WSBIND file.

Generate CICS Web Service provider components

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

  1. From the Solution Explorer, expand the Reverse project's wsdl folder.
  2. Right-click the reverse.wsdl file; then select Generate Web Service from the context menu.
  3. Ensure that reverse appears in both the WSDL Service and WSDL Port fields. This is represents default settings.
  4. In the Operation(s) field, select reverseRequest from the drop-down list.
  5. In the Generate group, if not selected by default, select the Service radio button.
  6. In the Name field associated with the Service radio button, ensure that reverse is specified as the name for the generated service interface.
  7. In the Program group's Name field, ensure that reverse is specified. This is the name for the generated COBOL skeleton program.
  8. 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.

  9. In the Type group, select the Channel radio button. This activates the Inline array size limit and Container name fields.

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

  10. In the Inline array size limit field, type 1. This turns on container mappings in the generated service.
  11. Click OK.

Enterprise Developer generates the following CICS Web service components in the wsdl\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 SOAP 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 SOAP 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 Reverse project's wsdl\reverse directory, but the output path is set to the project's loadlib directory, you need to move the file from the Reverse project's wsdl\reverse 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 Reverse project directory.
  3. Copy or move the reverse.wsbind file from the wsdl\reverse project directory to the loadlib project directory.