ExecuteAlarmAck
This function acknowledges an active alarm on the specified tag. The advantage of using this function is that if used from the Thin Client, the Alarm task will store the user name and station from which the alarm was acknowledged.
Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
---|---|---|---|---|---|---|
ExecuteAlarmAck | Tags Database | Synchronous | Supported | Supported | Supported |
Syntax
ExecuteAlarmAck( "strTagName", optStrComment, optStrAlarmType )
- strTagName
- Name of the tag on which the alarm will be acknowledged.
Note: The tag name should be enclosed in quotes, as shown in the syntax diagram, or else the function will try to use the value of the tag.
- optStrComment
- An optional comment to send to the Alarm task, along with the user name and station.
- optStrAlarmType
- If more than one alarm is active on the specified tag, you can specify which alarm (e.g., Hi, Lo, HiHi, LoLo) to acknowledge. Otherwise, the function acknowledges the most recently activated alarm.
Returned value
Value | Description |
---|---|
0 | Successfully executed. |
-1 | Invalid number of parameters. |
-2 | Invalid tag name. |
-3 | Executed, but did not wait for confirmation from Alarms task. See note. |
Notes
When this function is used to acknowledge an alarm, it typically waits for confirmation from the Alarms task before returning a value of 0 to indicate successful execution. In some cases, however, waiting for confirmation might cause the project runtime to hang. When that happens, if the function is properly formed with valid parameters, then it will execute as intended but it will not wait for confirmation.
Examples
Acknowledge the active Hi alarm on tag A, with the comment Hi alarm on tag A:
ExecuteAlarmAck ( "A", "Hi alarm on tag A", "Hi" )