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:
- 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.