oAlEv.Activate sId, sComment, tTimeOn
|sId||(String) The unique text identifier of the alarm/event item. See the configurator "Identifier".|
|sComment||[optional] (String) The text note that is stored into the data together with the activated alarm/event item (it is enabled on the Storage page).|
|tTimeOn||[optional] (Date) The activation time of the alarm. If not set, then the activation time equals to the time of calling this method.|
If there are several instances of the alarm/event item with the same identifier (caused by states of alarm/event items inactive unacknowledged (blue)), then the last, the latest old, alarm/event item is activated.
After the attempt to activate non-existing alarm/event item (wrong parameter sId), an error arises in the INFO system only if in the corresponding object PmAlarmEvent there is no alarm/event item with the set configurator Template for dynamically created items (i.e. all alarm/event items of the PmAlarmEvent object are statically configured).
The method is synchronous, i.e. it is processed immediately by the alarm subsystem. Nevertheless writing the history to disk is asynchronous, it means that this method passes the request for writing to the history to the alarm subsystem, it is placed into the queue of requests and it is processed later by the alarm subsystem.