<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type='text/xsl' href='UpdatedBibl.xsl'?>
<!DOCTYPE spec PUBLIC "-//W3C//DTD Specification V2.2//EN" "xmlspec.dtd" [
	<!ENTITY % entities SYSTEM "entitiesedcopy.dtd">
	%entities;
	<!ENTITY status "Editors Copy $Date$">
]>
<spec w3c-doctype="wd" role="editors-copy">
	<header>
		<title>SOAP 1.2 Part 3: One-Way MEP</title>
		<w3c-designation>&w3c-designation;</w3c-designation>
		<w3c-doctype>&status;</w3c-doctype>
		<pubdate>
			<day>&draft.day;</day>
			<month>&draft.month;</month>
			<year>&draft.year;</year>
		</pubdate>
		<publoc>
			<loc href="&basename;">&basename;</loc>
		</publoc>
		<latestloc>
			<loc href="&dated;.html">&dated;.html</loc> ( <loc href="&dated;.xml">xml</loc> )
		</latestloc>
		<prevlocs>
			<loc href="&dated0720;.html">&dated0720;.html</loc> ( <loc href="&dated0720;.xml">xml</loc> )
		</prevlocs>
		<authlist>
			<author>
				<name>David Orchard</name>
				<affiliation>BEA Systems</affiliation>
			</author>
		</authlist>
		<abstract>
			<p>SOAP Version 1.2 Part 2 provides a request-response MEP and a response-only MEP.  This, the SOAP 1.2 Part 3, provides a one-way MEP.</p>
		</abstract>
		<status>
			<p>
				<emph>This section describes the status of this document
          at the time of its publication. Other documents may
          supersede this document. The latest status of this document
          series is maintained at the W3C.</emph>
			</p>
		</status>
		<langusage>
			<language id="en">English</language>
		</langusage>
		<revisiondesc>
			<p>Last Modified: $Date$ CET</p>
		</revisiondesc>
	</header>
	<body>
		<div1 id="intro">
			<head>Introduction</head>
			<p>SOAP Version 1.2 Part 2 provides a request-response MEP and a response-only MEP.  This, the SOAP 1.2 Part 3, provides a one-way MEP.   
			</p>
			<div2 id="notcon">
				<head>Notational Conventions</head>
				<p>The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL",
	  "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",
	  and "OPTIONAL" in this document are to be interpreted as
	  described in RFC 2119 <bibref ref="RFC2119"/>.</p>
				<p>With the exception of examples and sections explicitly marked
    	as "Non-Normative", all parts of this specification are
    	normative.</p>
			</div2>
		</div1>
		<div1 id="singlereqmep">
			<head>SOAP One-way Message Exchange Pattern</head>
			<p>This section defines the message exchange pattern (MEP) called "One-way". The
	  description is an abstract presentation of the operation of
	  this MEP. It is not intended to describe a real
	  implementation or to suggest how a real implementation should
	  be structured.</p>
			<div2 id="mepname">
				<head>SOAP Feature Name</head>
				<p>This message exchange pattern is identified by
	  the URI (see SOAP 1.2 Part 1 <bibref ref="SOAP-PART1"/>
					<xspecref xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" href="&dated-part1;/#soapfeature">SOAP Features</xspecref>):</p>
				<ulist>
					<item>
						<p>
							<attval>http://www.w3.org/2006/06/soap/mep/one-way/</attval>
						</p>
					</item>
				</ulist>
			</div2>
			<div2 id="bindinfdesc">
				<head>Description</head>
				<p>The SOAP One-way MEP defines
	    properties for the exchange of a SOAP message. In the absence of failure in the underlying
	    protocol, this MEP consists of one SOAP message. The scope of a one-way MEP is limited to
       the exchange of a message between
       one sending and one receiving SOAP node. Implementations MAY choose
       to support multiple meps at the same time.</p>
				<p>The sending node MUST send the SOAP Message provided in http://www.w3.org/2003/05/soap/mep/OutboundMessage to the node identified by http://www.w3.org/2003/05/soap/mep/ImmediateDestination.  The sender is not required to detect whether transmission succeeds or fails, but the sender SHOULD fault in a binding specific manner if it discovers that transmission is unsuccessful. </p>
				<p>The receiving node MUST determine whether a given message is successfully received, and if so, MUST populate http://www.w3.org/2003/05/soap/mep/InboundMessage with the received message AND MUST process the message in http://www.w3.org/2003/05/soap/mep/InboundMessage according to the SOAP Processing Model (see SOAP 1.2 Part 1 <bibref ref="SOAP-PART1"/>
					<xspecref xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" href="&dated-part1;/#procsoapmsgs">Processing SOAP messages</xspecref>).  Determination of success by the receiver MAY be conservative, I.e. the receiver may in exceptional circumstances treat as erroneous or lost  a message which is received intact (typical reasons for making such decisions might include shortage of buffer space, network interface overruns, etc.).  Receivers MAY fault in a binding-specific manner if some particular message is declared in error (note, however, that in many cases where receipt is unsuccessful, information identifying the message or its sender may be unreliable, in which case there may be little if any value in reflecting a message-specific fault.)</p>
				<p>Abnormal operation during a one-way message exchange
       might be caused by a failure to transfer the message or a
       failure at the receiving SOAP node to process the
       message.  Such
       failures might be silent at either or both of the sending and
       recieving SOAP nodes involved, or might result in the generation of a SOAP 
       or binding-specific fault (see <specref ref="bindfaulthdn"/>).
       Also, during abnormal operation
       each SOAP node involved in the message exchange might differ in
       its determination of the successful completion of the message
       exchange. </p>
			</div2>
			<div2 id="bindformdesc">
				<head>Property Description</head>
				<p>The One-way MEP defines a set of properties described below.</p>
				<table border="1" id="tabonewayprops">
					<caption>Property definitions for One-way MEP</caption>
					<tbody>
						<tr>
							<th>Property Name</th>
							<th>Property Description</th>
							<th>Property Type</th>
						</tr>
						<tr>
							<td>
								<att>http://www.w3.org/2003/05/soap/mep/InboundMessage</att>
							</td>
							<td>An abstract structure that represents the current
		  inbound message in the message exchange. This
		  abstracts both SOAP Envelope and any other
		  information structures that are transferred along
		  with the envelope.  This property is populated if and only if the message is successfully received.</td>
							<td>Not specified</td>
						</tr>

						<tr>
							<td>
								<att>http://www.w3.org/2003/05/soap/mep/OutboundMessage</att>
							</td>
							<td>An abstract structure that represents the current
		  outbound message in the message exchange. This
		  abstracts both SOAP Envelope and any other
		  information structures that are transferred along
		  with the envelope.</td>
							<td>Not specified</td>
						</tr>
						<tr>
							<td>
								<att>http://www.w3.org/2003/05/soap/mep/ImmediateDestination</att>
							</td>
							<td>The identifier of the immediate destination of an
		  outbound message.</td>
							<td>xs:anyURI</td>
						</tr>
						<tr>
							<td>
								<att>http://www.w3.org/2003/05/soap/mep/ImmediateSender</att>
							</td>
							<td>The identifier of the immediate sender of an inbound
		  message.</td>
							<td>xs:anyURI</td>
						</tr>
						<tr>
							<td>
								<att>http://www.w3.org/2003/05/soap/bindingFramework/ExchangeContext/FailureReason</att>
							</td>
							<td>A value that denotes a pattern-specific, binding-independent reason for the failure of a message exchange. Underlying protocol binding specifications may define properties to convey more binding-specific details of the failure. </td>
							<td>xs:anyURI</td>
						</tr>
						
					</tbody>
				</table>
				<p>There may be other properties related to the operation of
           the message exchange and are processed according to their own feature specifications.
           </p>
			</div2>
			<div2 id="bindfaulthdn">
				<head>Fault Handling</head>
				<p>During the operation of the One-way MEP, the
	    participating SOAP nodes may generate SOAP faults.  This MEP makes no claims about the disposition or
           handling of SOAP faults generated by the sending SOAP node or the receiving SOAP node.</p>
			</div2>
		</div1>
		<div1 id="refs">
			<head>References</head>
			<div2 id="refs-norm">
				<head>Normative References</head>
				<blist>
					<bibl key="SOAP Part 1" href="http://www.w3.org/TR/2003/REC-soap12-part1-20030624/" id="SOAP-PART1">W3C Proposed Recommendation
	  "SOAP Version 1.2 Part 1: Messaging
	  Framework", Martin Gudgin, Marc Hadley, Noah Mendelsohn, Jean-Jacques Moreau,
	  Henrik Frystyk Nielsen, 24 June 2003</bibl>
					<bibl key="SOAP Part 2" href="http://www.w3.org/TR/2003/REC-soap12-part2-20030624/" id="SOAP-PART2">W3C Proposed Recommendation
	  "SOAP Version 1.2 Part 2: Adjuncts", Martin Gudgin, Marc Hadley, Noah Mendelsohn, Jean-Jacques Moreau,
	  Henrik Frystyk Nielsen, 24 June 2003</bibl>
					<bibl key="RFC 2119" id="RFC2119" href="http://www.ietf.org/rfc/rfc2119.txt">IETF "RFC 2119:
	  Key words for use in RFCs to Indicate Requirement Levels",
	  S. Bradner, March 1997.</bibl>
					<bibl key="RFC 2396" id="RFC2396" href="http://www.ietf.org/rfc/rfc2396.txt">IETF "RFC 2396:
	  Uniform Resource Identifiers (URI): Generic Syntax",
	  T. Berners-Lee, R. Fielding, L. Masinter, August
	  1998.</bibl>
				</blist>
			</div2>
			<div2 id="refs-inform">
				<head>Informative References</head>
				<blist>
					<bibl key="SOAP Part 0" href="http://www.w3.org/TR/2003/REC-soap12-part0-20030624/" id="SOAP-PART0">W3C Proposed Recommendation "SOAP Version 1.2 Part 0:
    	Primer", Nilo Mitra, 24 June 2003</bibl>
					<bibl key="XMLP Comments" href="http://lists.w3.org/Archives/Public/xmlp-comments/" id="CommentArchive">XML Protocol Comments Archive</bibl>
					<bibl key="XMLP Dist-App" href="http://lists.w3.org/Archives/Public/xml-dist-app/" id="DiscussionArchive">XML Protocol Discussion
	    Archive</bibl>
					<bibl key="XMLP Charter" href="http://www.w3.org/2000/09/XML-Protocol-Charter" id="XMLPCharter">XML Protocol Charter</bibl>
					<bibl key="RFC 2045" href="http://www.ietf.org/rfc/rfc2045.txt" id="RFC2045">IETF "RFC2045: Multipurpose Internet Mail
	    Extensions (MIME) Part One: Format of Internet Message
	    Bodies", N. Freed, N. Borenstein, November 1996.</bibl>
					<bibl key="RFC 2026" id="RFC2026" href="http://www.ietf.org/rfc/rfc2026.txt">IETF "RFC 2026:
	  The Internet Standards Process -- Revision 3", section
	  4.2.3, S. Bradner, October 1996.</bibl>
				</blist>
			</div2>
		</div1>
	</body>
	<back>
		<inform-div1 id="changelog">
			<head>Change Log</head>
			<table border="1">
				<caption>Changes</caption>
				<thead>
					<tr>
						<th>Who</th>
						<th>When</th>
						<th>What</th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td>DBO</td>
						<td>20041208</td>
						<td>Initial Revision</td>
					</tr>
					<tr>
						<td>DBO</td>
						<td>20060330</td>
						<td>2nd Revision</td>
					</tr>
					<tr>
						<td>DBO</td>
						<td>20060530</td>
						<td>Adding sending and receiver MUSTs</td>
					</tr>
					<tr>
						<td>DBO</td>
						<td>20060720</td>
						<td>Update date parts, checked into cvs, and moved abnormal operation paragraph to end of 2.2</td>
					</tr>
					<tr>
						<td>DBO</td>
						<td>20060803</td>
						<td>Added InboundMessage property and text about populating, removed State property, other minor edits.  Moved to xmlspec 2.10 dtd and xmlspec.xsl 1.54 (2005/10/13) </td>
					</tr>
				</tbody>
			</table>
		</inform-div1>
	</back>
</spec>
