Support for Web Services Addressing

CICS® supports services that use the Worldwide Web Consortium (W3C) Web Services Addressing (WS-Addressing) specifications. This family of specifications provides transport-independent mechanisms to address web services and facilitate end-to-end addressing.

CICS ensures that your existing web service applications can accept requests from web services that use WS-Addressing. You can also create new web services that use endpoint references and message addressing properties in SOAP messages.

WS-Addressing adds addressing information, in the form of Message Addressing Properties (MAPs), to SOAP message headers. MAPs include messaging information, such as a unique message ID and endpoint references that detail where the message came from, where the message is going to, and where reply or fault messages are to be sent. An endpoint reference (EPR) is a specific type of MAP, which includes the destination address of the message, optional reference parameters for use by the application, and optional metadata.

Features of the WS-Addressing support

CICS includes the following features to support WS-Addressing:
  • Your web service requester and provider applications can interact with other services that are using WS-Addressing without requiring you to redeploy them. A new message handler, the addressing message handler DFHWSADH, in the pipeline routes messages that contain WS-Addressing information to the specified web service.
  • You can write an application that uses the WS-Addressing API commands to create an endpoint reference and to create, update, delete, and query an addressing context.
  • You can route response messages to endpoints other than the requester endpoint; for example, you can route fault messages to a dedicated fault handler.
  • You can pass reference parameters to applications as part of the MAPs in the SOAP header.

Support for WS-Addressing specifications and interoperability

By default, CICS supports the recommendation specifications: These specifications are identified by the http://www.w3.org/2005/08/addressing namespace. Unless otherwise stated, WS-Addressing semantics that are described in this documentation refer to the recommendation specifications.
For interoperability, CICS also supports the submission specification: This specification is identified by the http://schemas.xmlsoap.org/ws/2004/08/addressing namespace. Use the submission specification only if you must interoperate with a client or web service provider that implements the submission specification.


support.html | Timestamp icon Last updated: Thursday, 27 June 2019