RunGlobalProcedureOnFalse

This function directly executes a VBScript procedure when the value of a specified tag/expression becomes FALSE.

Function Group Execution Windows Embedded Thin Client
RunGlobalProcedureOnFalse Tags Database Synchronous Supported Supported Supported

Syntax

RunGlobalProcedureOnFalse("strCondition",strProcedureOnFalse)
strCondition
A project tag or expression.
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.
strProcedureOnFalse
The name of the procedure (in the Procedures folder) to execute when the value of strCondition becomes FALSE (zero).

Returned value

This function returns the following possible values:
Value Description
0 Error
1 Success

Notes

Once this function is called, it remains active until the runtime project is stopped. That means every time the tag/expression becomes FALSE, the procedure is executed. However, the procedure is executed only once when the tag/expression becomes FALSE; it is not continuously executed while the tag/expression is FALSE.

The procedure is executed on the Client. To execute a procedure on the Server, use the RunGlobalProcedureOnServer function.

Examples

When the value of TagOnFalse becomes FALSE (zero), execute the procedure UsingOnFalse:
RunGlobalProcedureOnFalse( "TagOnFalse", "UsingOnFalse" )