Default end point references

Most WSDL documents contain the address at which the web service is hosted. In WS-Addressing, the WSDL document can also contain an end point reference (EPR) for the web service. This EPR can contain additional metadata to facilitate communication between the requester and provider applications.

If you use DFHWS2LS to process the WSDL, the EPR is saved in the web service binding and is used by CICS to send request and response messages. Any reference parameters, <wsa:ReferenceParameters>, that are defined in the EPR are included in the SOAP message. This EPR is known as the default EPR, because it can be overridden by the application. If the application does not supply an explicit EPR, the default EPR from the WSDL is used.

The following WSDL 1.1 fragment includes a default EPR: <soap:address location="http://example.ibm.com:12345/exampleTest" />. The <port> element includes a child element, <wsa:EndpointReference>, the address specified by the child element,  2 , must match the address specified by the parent element,  1 :

<service name="exampleService">
   <port name="examplePort" binding="s0:createBinding">
      <soap:address location="http://example.ibm.com:12345/exampleTest" /> 1 
      
      <wsa:EndpointReference
             xmlns:example="http://example.ibm.com/namespace"
             xmlns:wsdli="http://www.w3.org/2006/01/wsdl-instance"
             wsdli:wsdlLocation="http://example.ibm.com/location " 
             title="http://example.ibm.com/example/example_wsdl" 
             class="http://example.ibm.com/example/example.wsdl">
             <wsa:Address>http://example.ibm.com:12345/exampleTest</wsa:Address> 2 
             <wsa:Metadata>
                <wsam:InterfaceName>example:Inventory</wsam:InterfaceName>
             </wsa:Metadata>
             <wsa:ReferenceParameters>
               <example:AccountCode>123456789</example:AccountCode>
               <example:DiscountId>ABCDEFG</example:DiscountId>   
             </wsa:ReferenceParameters>
      </wsa:EndpointReference>
   </port>
</service>


default-epr.html | Timestamp icon Last updated: Sunday, 4 June 2017