Contents

Return to Tags or Functions

cfexecute

Syntax

<cfexecute
	[arguments="any"]
	[name="string"]
	[outputfile="string"]
	[terminateontimeout="boolean"]
	[timeout="number"]
	[variable="string"]>
&</cfexecute>

This tag is also supported within cfscript.

<cfscript>
  execute
	[arguments="any"]
	[name="string"]
	[outputfile="string"]
	[terminateontimeout="boolean"]
	[timeout="number"]
	[variable="string"] {
}
</cfscript>

[] = Optional attribute

Description

Enables developers to execute a process on a server computer.

Body

This tag must have a body.

Attributes

The attributes for this tag are fixed. Except for the following attributes no other attributes are allowed.

Name Type Required Description
arguments any No Command-line arguments passed to the application.
name string No The full pathname of the application to execute.
Note: On Windows, you must specify the extension as part of the application's name. For example,
myapp.exe,
outputfile string No The file to which to direct the output of the program. If not specified, the output is
displayed on the page from which it was called.
terminateontimeout boolean No terminate execution of proccess when timeout occur
timeout number No Indicates how long, in seconds, the executing thread waits for the spawned process.
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 thread spawns
a process and returns without waiting for the process to terminate.If no output file is specified,
and the timeout value is 0, the program output is discarded.
variable string No Variable in which to put program output.
If no outputfile or variable attribute is specified,
output is displayed on page from which it was called.

category Categories: