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.

Use the New CICS Web Service wizard to generate the components of your Web service provider.

  1. In the Application Explorer view, expand Enterprise Developer > Enterprise Development Projects.
  2. Right-click the Reverse project, and then select New > Interface > CICS Web Service from the context menu.
  3. Click XML message processing.
  4. From the Service type drop-down list, select CICS Web Service Provider (Top-Down); then click Next.

    The Project field should already show the Reverse project name.

  5. Click the Browse button that corresponds to the Service definition field, and browse to the reverse.wsdl file located in the wsdl project folder.
  6. Double-click reverse.wsdl. This populates the Service definition field.
  7. In the Program name field, type reverse, which is the program name for the generated COBOL skeleton program.

    You need to provide a URI that Enterprise Server can use to identify and locate the appropriate Web service upon receiving a request or a response. This information goes into the Service location field.

  8. In the Service location field, type /cwsDemo/reverseMe.

    The Request file prefix and Response file prefix fields are completed for you by default. These are the names of the generated copybooks that support the generated skeleton program file, one for request data structures, and one for response data structures.

    The Program interface field enables 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. From the Program interface drop-down list, select CHANNEL. 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.

  10. Click Finish.

Enterprise Developer generates the following CICS Web service components:

reverse.cbl
A skeleton CICS program.
REQ01.cpy
A copybook containing the COBOL data structures required to send a SOAP request as input.
RESP01.cpy
A copybook containing the COBOL data structures required to receive a SOAP response message as output.
loadlib\reverse.wsbind
A bind file that maps the SOAP request to the data structure in REQ01.cpy, and maps the data structure in RESP01.cpy to the SOAP response message.