Xantech CRM-WIC, Reference Manual

Page: 60 / 99

60
GetEventConcurrent ( EventId )
GetEventConcurrent returns a value signifying whether an Event’s Actions should run concurrently or sequentially.
Syntax
HRESULT GetEventConcurrent(
[in] long EventId,
[out, retval] long* Concurrent
);
Parameters
EventId [in] ID for the specified event.
Concurrent [out, retval] 1 if actions should be executed concurrently, 0 if actions should be executed sequentially.
Remarks
When Actions are set to execute sequentially, the next Action in the list will not execute until the previous Action has
completely executed. So, if the first Action is set as one that executes an infinite number of times, the second Action will
never execute. Use the Up/Dn hyperlinks in the Event Manager Diagnostics screen’s Action list to change the order of the
Actions’ execution.
When Actions execute concurrently, the Event Manager determines the next Action to run by calculating its next run time.
The Event Manager uses the Action’s Delay and Repeat Every values to make this calculation. The Action with the earliest
next run time is run first. If two Actions have the same run time, the first Action in the Action list will be executed first.
This flag can also be obtained user
GetEventOption
.
GetEventSource ( EventId )
The port, variable, or clock that is monitored by the specified Event
Syntax
HRESULT GetEventSource(
[in] long EventId,
[out, retval] BSTR* Source
);
Parameters
EventId [in] ID for the specified event.
Source [out, retval] A string filled with the name of the variable, port, or clock.
Remarks
An Event monitors its Source for changes. When new data arrives, or the data changes, the Event is notified. The setting of
the Event’s match value determines whether the Event is signaled to execute on this change in data.