TRMESS, TRSUCC, and TRFAIL Elements

The TRMESS, TRSUCC, and TRFAIL elements are for Messages, Successes and Failures respectively.

Operations and output commands are able to have any number of messages attached to them. They will be generated by local operation during their execution and be stored. Remote operations will receive messages from their output commands that will:

• generate messages relating to transaction events (sends, acknowledgements etc.),

• receive messages from the execution of commands at other site,

• receive transaction event messages forwarded through other site remote operations.

Operations and output commands have a TRSUCC attribute stating a success or (relative) failure. Each point of failure will generate a single TRFAIL element (e.g. failure to claim an element). Each point of success will generate a single TRSUCC element (E.g. an element claimed).

The attributes of TRSUCC and TRFAIL elements are equivalent. They include:

• A reference to an element involved in the operation (e.g. the reference of a claimed element).

• A double integer code relating to a message or error (0,0 if not known or relevant).

• A text string which is a representation of the said message or error.

• An integer qualifier to be used for such things as session numbers, etc.

The result of a command (TROUCO) is the sum of all TRSUCC and TRFAIL elements owned by its operations and output commands. All of these are communicated back to either the User (if it is a local command) or propagated to the originating site (if it is a foreign command). In the latter case the compounded errors will appear under the relevant originating TROUCO operation and hence onwards and upwards.

Whether a TROPER itself is classed as a success is determined by its execute method. Input commands are successes if all its operations and output commands are successes. An output command is a success if the input command it spawned returns a success. Results are only passed on to the generating TROUCO when the input command is totally finished.

Messages are sent immediately they are generated before waiting for operation or command conclusion. They go the same route as the result, being compounded by a TROUCO and transmitted to other site TROPER elements. They are only stored under the final TRINCO generated from a User command.

Attributes for Elements %TRSUCC and %TRFAIL

Attributes for Element %TRMESS