2.2.5.2.3 commitmentReceiptRequest Element

  • Article

The SRMP <commitmentReceiptRequest> element MAY be present as a child element of the <services> element. If present:

  • The SRMP <sendTo> element MUST be present as a child element of the <commitmentReceiptRequest> element. The <sendTo> element MUST contain a string that represents the URI of the administration queue to which receipts are sent. The URI MUST use HTTP/HTTPS name formatting (similar to the URI in the <to> element, which is described in section 2.2.4.2). The <sendTo> element corresponds to the Message.AdministationQueueFormatName attribute of the ADM Message data element. For details, see [MS-MQDMPR] section 3.1.1.12.

  • The SRMP <positiveOnly/> element MAY be present as a child element of the <commitmentReceiptRequest> element, as the following example shows. If present, the receiver MUST send a positive commitment receipt if it understands all elements marked with "mustUnderstand=1" and is committed to processing the message. In the context of MSMQ, this means that the message was received, placed in the destination queue at the receiver, and successfully removed from the destination queue by the receiving application. The <positiveOnly/> element corresponds to the Message.AcknowledgementsRequested += AckPosReceive attribute of the ADM Message data element. For details, see [MS-MQDMPR] section 3.1.1.12.

  • The SRMP <negativeOnly/> element MAY be present as a child element of the <commitmentReceiptRequest> element. If present, the receiver MUST send a negative commitment receipt if it attempted to process the message but decided not to commit to complete its processing; or if the message expired before the receiver attempted to process the message. In the context of MSMQ, this means that the message was discarded or otherwise removed from the destination queue before the receiving application was able to receive it. The <negativeOnly/> element corresponds to the Message.AcknowledgementsRequested += AckNegReceive attribute of the ADM Message data element. For details, see [MS-MQDMPR] section 3.1.1.12.

  • If neither <positiveOnly/> nor <negativeOnly/> is present, the receiver MUST NOT send any commitment receipts.

  • If both <positiveOnly/> and <negativeOnly/> are present, the receiver MUST send a positive or negative commitment receipt, depending on the decision, as described previously.

     <commitmentReceiptRequest>
     <sendTo>http://myhostname/MSMQ/private$/deliveryDone</sendTo>
     <positiveOnly/>
 </commitmentReceiptRequest>