Appendix: Built-in Scripting Language Tags Database functions These functions are used to directly change the values of project tags. 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. Syntax ExecuteAlarmAck( " strTagName ", optStrComment , optStrAlarmType ) strTagName Name of the tag on which the alarm will be acknowledged. Note: The tag name must be enclosed in quotes, as shown in the syntax diagram, or else the project will try to get the value of the named tag.
optStrComment optStrAlarmType An optional comment to send to the Alarm task, along with the user name and station. 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 Examples ForceTagChange Forces the database to write a value to a tag and act as if it were a tag change even if the new value is equal to the old value. Syntax ForceTagChange( " strTagName ", numValue ) strTagName The name of the tag being forced to accept the new value.
Page 572 InduSoft Web Studio Function Group Execution Windows Embedded Thin Client ExecuteAlarmA ckTags Database Synchronous Supported Supported Supported Value Description 0 Successfully executed. -1 Invalid number of parameters. -2 Invalid tag name. Tag Name Expression Tag ExecuteAlarmAck ("a","Hi alarm in tag a","Hi") // Returned value = 0 if successfully executed Function Group Execution Windows Embedded Thin Client ForceTagChang e Tags Database Synchronous Supported Supported Supported