CFEXECUTE | |
Description
Executes a ColdFusion developer-specified process on a server computer. |
|
Category
Extensibility tags, Flow-control tags | |
Syntax<cfexecute name = " ApplicationName " arguments = "CommandLine Arguments" outputFile = "Output file name" timeout = "Timeout interval"> ... </cfexecute> | |
See also
cfcollection, cfindex, cfobject, cfreport, cfsearch, cfwddx
|
|
Usage
Do not put other ColdFusion tags or functions between the start and end tags of cfexecute. You cannot nest cfexecute tags. |
|
Exception
Throws the following exceptions:
The time out values must be between zero and the longest time out value supported by the operating system. |
|
Example <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> |
NAME | |
Required | |
Absolute path of the application to execute. On Windows, you must specify an extension; for example, C:\myapp.exe. |
ARGUMENTS | |
Optional | |
Command-line variables passed to application. If specified as string, it is processed as follows:
If passed as array, it is processed as follows:
|
OUTPUTFILE | |
Optional | |
File to which to direct program output. If not specified, output is displayed on page from which it was called. |
TIMEOUT | |
Optional | |
Default value: "0"
Length of time, in seconds, that ColdFusion waits for output from the spawned program.
If the value is 0:
|