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.
- 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.
- Click
XML message processing.
- 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.
- Click the
Browse button that corresponds to the
Source file field, and navigate to the
LOANPAYM.cbl file located in the
cbl project folder.
- 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.
- 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.
- 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.
- Click the
Browse button that corresponds to the
Request copybook field, and browse to the
cpy project folder.
- Select
LOANINP.cpy; then click
OK.
- Repeat the process in the previous two steps to add the
LOANOUT.cpy copybook to the
Response copybook field.
- 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.