Start of change

Web service server adapter

The Web service server adapter performs outbound Web service requests using the existing Web services support in CICS. Web service adapters are only available when you model, generate and deploy flows using WebSphere® Developer for System z® version 7.

The Web service server adapter is called DFHMASWS and runs under the CMAO transaction. DFHMASWS handles all outbound Web service requests, so it is always invoked by the Adapter Navigator. DFHMASWS sends a Web service request by issuing the EXEC CICS INVOKE WEBSERVICE command. This request is processed in a requester mode pipeline, and sends a SOAP message to the designated Web service provider. DFHMASWS waits for a response from the Web service provider and then returns to the Adapter Navigator.

To support the Web service server adapter, the following CICS resources are required. These are:

PIPELINE
A PIPELINE resource definition is used when a CICS application is in the role of a Web service provider or requester. It provides information about the message handler programs that act on a service request and on the response. The PIPELINE specifies the name of an HFS file which contains an XML description of the message handlers and their configuration. This is called the pipeline configuration file.
WEBSERVICE
A WEBSERVICE resource defines aspects of the runtime environment for a CICS application program deployed in a Web services setting. It defines the pipeline that the Web service should use, as well as the location of the Web service binding file and the Web service description (WSDL).
To enable you to quickly deploy adapter services that contain Web service requests, these resources are created during the post-installation procedures. A sample requester pipeline called DFHMASFR is also provided, and this is the default pipeline that is used by Service Flow Modeler. It contains the basic handlers that are required to process an outbound Web service request and an inbound response message from a Web service provider.
Note: Do not configure this pipeline to include additional handlers. DFHMASFR can be updated when APARs are applied or the product is reinstalled, and you would lose your configuration changes.
If you want to perform additional processing on Web service requests in the pipeline, you can either:
End of change