Patterns: Extended Enterprise SOA and Web Services

516 Patterns: Extended Enterprise SOA and Web Services

C.3 Creating and hosting a ManufacturerC Web service

This section provides a high-level overview of how to implement a Web service in

CICS Transaction Server using the top-down approach. This Web service

implementation can be used as the ManufacturerC Web service in the scenario

implementations described in this redbook.

For more detailed information about how to perform the following steps, consult

the CICS Transaction Server V3.1 InfoCenter at:

http://publib.boulder.ibm.com/infocenter/cicsts31/index.jsp

Perform the following tasks

1. Upload Manufacturer.wsdl into Unix System Services. You will also need to

upload all of the WSDL and XSD files that Manufacturer.wsdl imports. You

can find all of these files in the additional material supplied with this redbook

in the \DirectConnection\wsdl directory.

2. Open Manufacturer.wsdl in a text editor and modify the following line (it is the

first line in the WSDL file):

<?xml version="1.0" encoding="UTF-8"?>

Remove the encoding attribute, as this attribute is incorrect for a z/OS

environment. The line should now read:

<?xml version="1.0">

Repeat this for each XSD and WSDL file you upload to z/OS.

3. Run the DFHWS2LS utility, specifying Manufacturer.wsdl as the WSDL

interface to use. This generate a language structure and Web service binding

file.

4. Create a CICS application (in a programming language of your choice) that

uses the language structure. The only requirement of this application is that it

populates the ackPO Web service response message with the following text

string:

Manufacturer_C has received and processed a request.

5. Configure a CICS region for Web service support, and add deploy the new

ManufacturerC application to it.

6. Update the ManufacturerC_Impl.wsdl file to point to the CICS Web service

you have created.