Web service server adapter

The Web service server adapter performs outbound Web service requests using the existing Web services support in CICS.

The Web service server adapter is called DFHMASWS and runs by default under the CMAO transaction. You can override the transaction that runs DFHMASWS in the service flow project tools. DFHMASWS handles all outbound Web service requests, so it is always invoked by the flow navigator. DFHMASWS sends a Web service request by issuing the EXEC CICS INVOKE WEBSERVICE command. This request is processed by message handlers in a requester mode pipeline and CICS 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 flow navigator.

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

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 zFS file that contains an XML description of the message handlers and their configuration. This file 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 will use, 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 the default pipeline that is used by service flow project tools. 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.

Do not configure this pipeline to include additional handlers. DFHMASFR might be updated when APARs are applied or the product is reinstalled, causing you to lose your configuration changes. To perform additional processing on Web service requests in the pipeline:
  • Use an existing CICS requester mode pipeline when you are modeling the flow.
  • Create a new pipeline in CICS to handle Web service requests from adapter services and add your own handlers using the pipeline configuration file. Change the default pipeline to the new pipeline when you are modeling the flow.


dfhcr_adapter_ws.html | Timestamp icon Last updated: Sunday, 4 June 2017