The Run command executes the specified program.

<exe file> The name of the file to be executed.

• Run command can spawn only windows executable programs (EXE) files. You can pass command line arguments to these EXE programs. This EXE program can communicate with Xtend IVR script using the $varfile variable. Xtend IVR keeps all active variables in a text file and the name of the text file is available in variable $varfile. You can call the EXE program with this $varfile as its command line parameter like:

  RUN "myprogram.exe" $varfile

• It is the programmer's responsibility to parse the variable file passed as a command line argument to his program. The modified variables are written back to the same file which will be loaded into the script after the termination of the program. Some of the system variables like $date, $time etc. are also available in the file in read-only mode. The programmer can also add new variables.
• Normally, the $VarFile is added to the Run command so that the file containing the script variables is passed on to the program and the modified values can be reloaded. The program has to read in the script variables from the file, perform any processing and write the new values for the variables back to the file. After the program has been executed, the IVR will read in the lines from the $VarFile and update the values for the variables which can then be accessed in the script.
• This is not normally recommended in large deployments due to heavy CPU usage. A medium configuration system of upto 8 channels is considerable.
• The window of the child application may or may not appear depending upon the INI settings. The IVR script will wait for the child program to terminate. The termination code will be available from the variable $ExitCode. The script will stop its execution if the child program hangs up. In such a situation, a RUNTIMEOUT can be used to timeout the child program which will forcefully kill the child program and jump to ONRUNTIMEOUT label. But this is not recommended normally.

:MAIN
	answer
	// external application timeout is set as 5 seconds
	runtimeout 5 
	
	// calls windows notepad application
	// please ensure that the AppWindow option is enabled in xivr configuration (xivrcfg.exe)
	// If AppWindow option is disabled, you will not see the window of the application.
	$cmdline = format("%s\notepad.exe",fs.GetEnv("SystemRoot"))
	
	// start notepad and wait for 5 seconds.
	// You will see notepad terminating within 5 seconds
	run $cmdline $varfile
	MsgBox("Application closed by user")
	hangup
	goto MAIN	
	
:ONRUNTIMEOUT
	MsgBox("Time expired. Application terminated.")
	hangup
	goto MAIN