ListEventObservations
From The Contingency Market
Contents |
ListEventObservations(ulSessionID,uSequenceID,sIntegrity,sEventID,sAgentID,sSince,uLimit)
Returns at most uLimit observations of this event where the occurrence time is after sSince. Includes any official observation. An observation of an event is either an observation that it occurred, or an observation that it became impossible.
PARAMETERS
-
ulong ulSessionID - ID of authenticated session.
-
uint uSequenceID - Sequence number.
-
string sIntegrity -
md5("ipaddr(sid,seq)->ListEventObservations(sEventID,sAgent,sSince,uLimit)/secret") -
string sEventID - ID of event whose observations should be returned.
-
string sAgentID - ID of agent whose observations should be returned.
-
string sSince - Earliest observation date to count from. NB Not a TimeInstant or DateTime. The timezone is UTC.
-
uint uLimit - Maximum number of event observations to return (0=all).
RETURNS
[ SEventRecordData {sEventID,sParameterValue,sParameterType,sAgentIDObserver,bOccurred,sTimeOccurred,sTimeObserved} ]
-
string sEventID - ID of event observed to occur.
-
string sParameterValue - The value the event parameter is observed to have (blank if unknown).
-
string sParameterType - Type of the parameter.
-
string sAgentIDObserver - Empty if official, otherwise ID of most recent observer.
-
bool bOccurred - True if this is a record of the event occurring, False if a record of the event becoming impossible.
-
string sTimeOccurred - Time at which the event occurred/or not.
-
string sTimeObserved - Time this event record was originally submitted - Blank for official observations.
FAULTS
Session. Time format.
TEST
ListEventObservations() according to the respective template currently returns Event #185d426e5d434d79a044434a376c971a was registered observed by agent # at 1787-09-17T12:00:00.0000000Z to have a perpetual value of 1:Count(Number) as at 1787-09-17T12:00:00.0000000Z, which means that it is occurring.

