# The wsrm plugin for client applications and stand-alone services

## WS-ReliableMessaging Setup

The material in this section relates to the WS-ReliableMessaging and WS-Addressing (2005) specifications.

To use the wsrm plugin:

1. Run wsdl2h -t typemap.dat on a WSDL of a service that requires WS-ReliableMessaging and WS-Addressing headers. The typemap.dat file included in the gSOAP package is used to recognize and translate header blocks.
2. Run soapcpp2 -a on the header file produced by wsdl2h. To enable reliable-messaging and addressing-based service operation selection, you MUST use soapcpp2 option -a. This allows the service to dispatch methods based on the WS-Addressing action information header value (when the wsa plugin is registered).
3. (Re-)compile and link stdsoap2.c/pp, dom.c/pp (when needed), plugin/wsrmapi.c, plugin/wsaapi.c, custom/duration.c, and the generated source files.
4. Use the wsrm plugin API functions described below. The wsrm plugin uses the wsa plugin to implement the WS-Addressing 2005 operations. Both must be registered, but there is no need to explicitly use the wsa plugin API when using the wsrm plugin API.

An example wsa client/server application can be found in samples/wsrm.

THIS DOCUMENTATION IS TO BE COMPLETED FOR THE FULL RELEASE.