proposal: test indicator (1)

[christopher ferris <chris.ferris@east.sun.com>]

As discussed on yesterday's conference call (at length) here is
the first of two formal proposals for a test/production indicator. 

(yeah, yeah, yeah... they're out of order... sue me;-)

Cheers,

Chris

Proposal 1 Test indicator with pass-through semantics

7.9.2 CPAInfo
The TPAInfo element follows the From and To elements in the
Header element structure. The CPAInfo element is a composite set
of information that relates to the Collaboration Protocol Agreement
under which the message is governed. The CPAInfo element has five
child elements as follows:
	- CPAId 
	- ConversationId
	- Service
	- Action
	- Usage

...

7.9.2.5
The Usage element has a cardinality of zero or one. It has a single 
attribute, Mode, which has two possible values; 'test' and 'production'.

A Message Service Handler implementation is REQUIRED to provide
the information implied by the Usage element, (e.g. that the message
is either a production or a test message) to the layer of software
above it in the stack (such as the receiving application). 

If the Usage element is NOT present in the ebXMLHeader document
of a given message, then that message is REQUIRED to be treated 
as if it were a 'production' message. 

This specification makes no claims on the behavior expected of
the application receiving a message which has a Usage Mode of
'test'. It is up to the application receiving the message and
the Usage indicator as to how it is expected to handle processing
of a 'test' message.

The authors of this specification have added this element to
the specification of the ebXMLHeader so as to accommodate
mappings to other protocols which may choose to adopt ebXML
as their messaging protocol. It is RECOMMENDED that caution
be taken by IT organizations contemplating use of this feature
because of the implications it may have should a 'test' message
be treated as if it were a 'production' message.

Appendix A.1

	<!ELEMENT TPAInfo (..., Usage?)>
	...
        <!ELEMENT Usage EMPTY>
        <!ATTLIST Usage  Mode  (test | production)  "production" >