Exchange Events
These are the event_output events related to the WSF_EXCHANGE_PROCESSOR.
EXCHANGE_COMPLETED¶
This event is generated when two platforms have ended a transaction previously negotiated. The event is tagged with the time at which a transaction in progress has successfully completed.
event_output Signature:
<time> <complete-type> from <supplier> to <receiver> ID=<identifier> DESIRED=<amount> OFFERED=<amount> TRANSFERRED=<amount> CONTAINER=<name> QUANTITY=<amount>
Signature Elements:
Fields |
Description |
|---|---|
<time> |
The current simulation time |
<complete-type> |
The event name, which is either EXCHANGE_REQUEST_COMPLETED or EXCHANGE_RESPONSE_COMPLETED |
<supplier> |
Name of platform that provided the commodity or service |
<receiver> |
Name of platform that received the commodity or service |
<identifier> |
Name of the commodity or service exchanged |
<amount> |
Amount of the commodity or service exchanged (units are implementation-defined) |
<rate> |
Rate at which the commodity or service was exchanged (units are implementation-defined; zero denotes instantaneously) |
EXCHANGE_NEGOTIATED¶
This event denotes that two interested platforms have shared interactions via the EXCHANGE_QUERIED events, and have discerned that they will initiate planned transfer of a commodity or service, beginning now, but ending some time in the future. This event will likely happen twice, when each side of the transaction discerns the transaction is to begin. The planned final transaction amounts may vary if the exchange is terminated early. NOTE: This is a low-level event that occurs between platforms who have negotiated and exchange. End-users will likely be more interested in EXCHANGE_COMPLETED at the culmination of an exchange.
event_output Signature:
<time> <negotiation-type> <sender> to <listener> N=<serial-request-id> ID=<identifier> DESIRED=<amount> OFFERED=<amount> NEGOTIATED=<amount> DESIRED_RATE=<rate> OFFERED_RATE=<rate> NEGOTIATED_RATE=<rate> STATUS=<result>
Signature Elements:
Fields |
Description |
|---|---|
<time> |
The current simulation time |
<negotiation-type> |
The event name, which is either EXCHANGE_REQUEST_NEGOTIATED or EXCHANGE_RESPONSE_NEGOTIATED |
<sender> |
Name of platform recognizing that the negotiation is complete |
<listener> |
Name of platform that is the perceived other side of the transaction |
<identifier> |
Name of the commodity or service exchanged |
<amount> |
Amount of the commodity or service exchanged(units are implementation-defined) |
<rate> |
Rate at which the commodity or service was exchanged (units are implementation-defined; zero denotes instantaneously) |
EXCHANGE_QUERIED¶
NOTE: This is a low-level event that occurs between many different platforms, some disinterested from each other, with potentially no distinguishable result. End-users will likely be more interested in EXCHANGE_COMPLETED at the culmination of an exchange.
event_output Signature:
<time> <query-type> <sender> to <listener> N=<serial-request-id> ID=<identifier> DESIRED=<amount> OFFERED=<amount> NEGOTIATED=<amount> DESIRED_RATE=<rate> OFFERED_RATE=<rate> NEGOTIATED_RATE=<rate> STATUS=<result>
Signature Elements:
Fields |
Description |
|---|---|
Tag |
Description |
<time> |
The current simulation time |
<query-type> |
The event name, which is either EXCHANGE_REQUEST_QUERIED or EXCHANGE_RESPONSE_QUERIED |
<sender> |
Name of platform that sent the query for potential exchange |
<listener> |
Name of platform that is to evaluate the query for applicability to itself |
<serial-request-id> |
Unique identifier to link transactor transactions together |
<identifier> |
Name of the proposed commodity or service for exchange |
<amount> |
Amount of the proposed commodity or service for exchange (units are implementation-defined) |
<rate> |
Rate at which the commodity or service is proposed to be exchanged (units are implementation-defined; zero denotes instantaneously) |
EXCHANGE_REQUEST_FAILED¶
This event has not been documented yet.
