Enables ColdFusion developers to execute any process on the server machine.
<CFEXECUTE NAME=" ApplicationName " ARGUMENTS="CommandLine Arguments" OUTPUTFILE="Output file name" TIMEOUT="Timeout interval in seconds">
Required. The full path name of the application that is to be executed.
Note: On Windows systems, you must specify the extension, for example, .exe, as part of the application's name.
Optional. Any command-line arguments that should be passed to the program.
If ARGUMENTS is specified as a string, it is processed as follows:
If ARGUMENTS is passed as an array, it is processed as follows:
Optional. The file where the output of the program is to be directed. If this is not specified, the output appears on the page from which it was called.
Optional. Indicates how long in seconds the ColdFusion executing thread will wait for the spawned process. Indicating a timeout of 0 is equivalent to the non-blocking mode of executing. A very high timeout value is equivalent to a blocking mode of execution. The default is 0; therefore, the ColdFusion thread spawns a process and immediately returns without waiting for the process to terminate.
If no output file is specified, and the timeout value is zero, then the program's output will be directed to the bit bucket.
CFEXECUTE is available on Windows NT 4.0 and UNIX platforms. Do not put any other ColdFusion tags or functions between the start and the end tags of CFEXECUTE. Also, CFEXECUTE tags cannot be nested.
CFEXECUTE throws the following exceptions:
<!---------------------------------------------------------------------- This example illustrates use of the CFEXECUTE tag. -----------------------------------------------------------------------> <HTML> <HEAD> <TITLE>CFEXECUTE</TITLE> </HEAD> <BODY> <H3>CFEXECUTE</H3> <P> This example executes the Windows NT version of the netstat network monitoring program, and places its output in a file. <CFEXECUTE NAME="C:\WinNT\System32\netstat.exe" ARGUMENTS="-e" OUTPUTFILE="C:\Temp\output.txt" TIMEOUT="1"> </CFEXECUTE> </BODY> </HTML>