|
Summary: eValid's Timer Alarm provides a method for triggering time-based alarms during script playback.
There is a fully worked Timer Alarm Example .
Usage: eValid's Timer Alarm is used to evaluate the elapsed script playback time against preset alarm points entered into a script. If the specified time threshold is reached two actions will happen:
This has many applications, the simplest being a server-side script that sends out an Email with information about the Timer Alarm. Other applications (depending on the programming of the server-side script) include logging to text files and/or databases.
NOTE: The server-side scripts that perform the alarm functions listed above are not provided with eValid. However, eValid has provided an available Email-sending CGI script located on our WebServer that you can use for your Email alarm notices if you like. Click here for more information.
A Timer Alarm can only be added when eValid is in recording mode. Once you have reached the point in the script where you would like to check a time threshold using the Timer Alarm...
NOTE: If this field is blank NO URL will be invoked when an alarm situation is detected. This means that there will be no notification outside of the local Error Logs of the occurrence of an alarm.
eValid has provided a default CGI script which can be used freely:
http://www.e-valid.com/Cgi-Bin/evalid.alarm.cgi
About the Example/Default CGI Alarm Script: The script provided by eValid is located at:
<http://www.e-valid.com/Cgi-Bin/evalid.alarm.cgi>
This CGI script will send Email to the recipient(s) listed in the Email field of the Set Alarm dialog.
NOTE: The Email addresses must be separated by a comma and a space. For example, "john@mycompany.com, bob@mycompany.com" (without quotes).
Creating your own server-side alarm script: eValid uses the standard GET method through HTTP to transfer information to the server-side alarm script.
If you have access to a server-side scripting language that will parse variables through the WebServer, you can create your own alarm script. Some common server-side scripting languages are PERL, ColdFusion, ASP and PHP. Actual programming of the server-side alarm script is beyond the scope of this document.
Variables: The following variables are passed to the server-side alarm script:
NOTE: The variables listed are all UPPER CASE.