oAl.Activate sId, sComment, tTimeOn
|sId||(String) The unique text identifier of the alarm item. See "Identifier" configurator.|
|sComment||[optional] (String) The text comment that is stored into the data together with the activated alarm item (it is enabled on the "Storage" page).|
|tTimeOn||[optional] (Date) The activation time of the alarm. If not set, then the computer current time is used.|
If there are several instances of the alarm item with the same identifier (caused by states of alarm items inactive unacknowledged (blue)), then the last, the latest old, alarm item is activated.
After the attempt to activate non-existing alarm item (wrong parameter sId), an error occurs in the INFO system only if in the corresponding object PmaAlarmGroup there is no alarm item with the set "Template for dynamically created items" configurator (i.e. all alarm items of the PmaAlarmGroup 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.