Creating a service provider application from a Web service description

Using the CICS® Web services assistant, you can create a service provider application from a Web service description.

Your Web services description must be in a file in HFS.
  1. Generate a Web service binding file. Use batch program DFHWS2LS to generate a Web service binding file. As well as the Web service binding file, the program generates a language data structure.
  2. Copy the Web service binding file to the pickup directory of the PIPELINE resource that you want to use for your Web service application.
  3. Use the language data structure generated in 1 to write your wrapper program. The wrapper program will manipulate the data into the correct form to interact with the business logic.
  4. If you do not have a suitable PIPELINE resource definition in your system, create and install one. The PIPELINE resource specifies the XML file which defines the message handlers which will be used to process the inbound request and the reply. Typically, many applications can use the same PIPELINE definition, and if you already have a suitable PIPELINE in your system, you do not need to perform this step.
  5. Create and install a URIMAP which matches the URI used to invoke the Web service. The URIMAP specifies the names of the WEBSERVICE resource, and of the PIPELINE resource that provide further details of how the Web service request is processed.

    The URIMAP can be created automatically using the scan mechanism. In this case, CICS gets the information needed to build the URIMAP from the Web service binding file.

  6. Create and install a WEBSERVICE which specifies the location of the WSDL and of the WSBIND file. Although you can use RDO to create a WEBSERVICE, the recommended method is to scan for WSBIND files. This creates WEBSERVICE definitions which are consistent with the WSDL.