Activate - method of the PmAlarmItem object
Description:
Alarm item activation.
Syntax:
Empty Activate([String sComment], [Date tTimeOn])
Parameters:
| sComment | [optional] (String) The text comment that is stored into the data together with the activated alarm item (it is enabled on the "Storage" tab). |
|---|
| tTimeOn | [optional] (Date) The activation time of the alarm.
If not set, then the computer current time is used. |
|---|
Note:
Calling
Activate method over the
active alarm has no effect. An
inactive alarm is activated. The behavior of the alarm during the activation is specified in the "
Inactivate type" configurator. If the alarm is activated without parameters, then the simplier way can be used by writing the value
true into the
Active property.
The method is
synchronous, it means that 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 into the history of alarms subsystem, it is placed into the queue of requests and it is processed later by the alarm subsystem.
Example:
JavaScriptVBScriptSelect and copy to clipboard
var oAl = pMe.Pm("/Alarm");
var oAlItem = oAl.Item("Temperature");
oAlItem.Activate("max");
Dim oAl
Set oAl = pMe.Pm("/Alarm")
Dim oAlItem
Set oAlItem = oAl.Item("Temperature")
oAlItem.Activate "max"