Generate loanPaym Web Service Components

Provides step-by-step instructions to generate all required components of the loanPaym Web service from the LoanDemo project.

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

  1. From the Application Explorer view, right-click the LoanDemo project, and select New > Interface > CICS Web Service from the context menu. This starts the New CICS Web Service Wizard.
  2. Click XML message processing.
  3. From the Service type drop-down list, select CICS Web Service (Bottom-Up); then click Next.

    The Project field should already show the LoanDemo project name.

  4. Click the Browse button that corresponds to the Source file field, and navigate to the loanPaym.cbl file located in the cbl project folder.
  5. Double-click loanPaym.cbl. This populates the Source file field, and populates the Program name field with loanPaym, which is the name defined in the program.
  6. In the Service location field, type:

    /cics/services/loanpaym

    This is the endpoint URL that you use to invoke the Web service. It specifies the server, port, and a URI used to identify the Web service in Enterprise Server.

    The loanPaym program contains a COMMAREA interface; therefore, you can accept the default setting in the Program Interface field.

  7. Click Next.

    By default, the wizard assigns an operation name that consists of the program name followed immediately by Operation.

    The request and response structures for your Web service are contained in the LoanDemo project's two copybooks.

  8. Click the Browse button that corresponds to the Request copybook field, and browse to the cpy project folder.
  9. Select LOANINP.cpy; then click OK.
  10. Repeat the process in the previous two steps to add the LOANOUT.cpy copybook to the Response copybook field.
  11. Click Finish.

In your LoanDemo project, you should now see an entry for Web Services > loanPaym > loanPaymOperation.

The loadlib project folder should now contain the following generated files:

loanPaym.wsbind
A bind file that maps the SOAP request to the data structure in LOANIN.cpy, and maps the data structure in LOANOUT.cpy to the SOAP response message.
loanPaym.wsdl
The Web service definition file that describes the loanPaym application.