Promotic

Activate - method of the PmaAlarmGroup object

Description:
Activation of an existing alarm item (of the PmAlarmItem object).
Syntax:
Empty Activate(String sId, [String sComment], [Date tTimeOn])
Parameters:
sId(String) The unique text identifier of the alarm item. See the "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" tab).
tTimeOn[optional] (Date) The activation time of the alarm. If not set, then the computer current time is used.
Note:
Calling the Activate method over the active alarm has no effect. An inactive alarm is activated. The behaviour of the alarm during the activation is specified by the "Inactivate type" configurator.
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 PmaAlarmGroup object there is no alarm item with the checked configurator "Template for dynamically created items" (it means that all alarm items of the PmaAlarmGroup object are statically configured).
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 to the history to the alarm 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");
oAl.Activate("T1_HI");
PROMOTIC 9.0.18 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.