NEW Issue - Normative descriptions of protocol messages

[Andrew Wilkinson3 <awilkinson@uk.ibm.com>]

Protocol: AT

Artifact:  Specs

Draft:  AT PR-01

Link to the documents referenced:

http://docs.oasis-open.org/ws-tx/wstx-wsat-1.1-spec-pr-01.pdf

Issue type: Editorial

Issue description:

Opened as a result of the discussion of issue 102.

The current descriptions of the protocol messages in sections 3.2 and 3.3 
are not of sufficient quality to be made normative. 

Proposed resolution:

Amend the descriptions of the protocol messages to read as follows 
(messages not listed below remain unchanged):

Section 3.2:


Commit

Upon receipt of this notification, the coordinator knows that the 
participant has completed application processing. A coordinator that is 
Active SHOULD attempt to commit the transaction.

Rollback
Upon receipt of this notification, the coordinator knows that the 
participant has terminated application processing. A coordinator that is 
Active MUST abort the transaction.

Section 3.3:

Prepare
Upon receipt of this notification, the participant knows to enter phase 1 
and vote on the outcome of the transaction. A participant that is Active 
MUST respond by sending an Aborted, Committed or ReadOnly notification as 
its vote.  If the participant does not know of the transaction, it MUST 
send an Aborted notification. If the participant has already voted by 
sending Aborted or Committed, it MUST resend the same vote.

Rollback
Upon receipt of this notification, the participant knows to abort, and 
forget, the transaction. A participant that is Active or Prepared MUST 
respond by sending an Aborted notification and SHOULD then forget all 
knowledge of this transaction. If the participant does not know of the 
transaction, it MUST send an Aborted notification to the coordinator.

Commit
Upon receipt of this notification, the participant knows to commit the 
transaction. A participant that has successfully sent Prepared MUST 
respond by sending a Committed notification and SHOULD then forget all 
knowledge of this transaction. If the participant does not know of the 
transaction, it MUST send a Committed notification to the coordinator.
Committed 
Upon receipt of this notification, the coordinator knows the participant 
has committed, and forgotten the transaction.