User Guide

106 Chapter 2: ColdFusion Tags

cfexecute

Description

Executes a ColdFusion developer-specified process on a server computer.

See also

cfcollection, cfindex, cfobject, cfreport, cfsearch, cfwddx

History

ColdFusion MX 6.1:

• Added the variable attribute.

• Changed file path behavior for the outputFile attribute: if you do not specify an absolute file

path in the

outputFile attribute, the path is relative to the ColdFusion temporary directory.

Attributes

Attribute Req/Opt Default Description

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:

• Windows: passed to process control subsystem for parsing.

• UNIX: tokenized into an array of arguments. The default

token separator is a space; you can delimit arguments that

have embedded spaces with double quotation marks.

If passed as array, it is processed as follows:

• Windows: elements are concatenated into a string of tokens,

separated by spaces. Passed to process control subsystem

for parsing.

• UNIX: elements are copied into an array of exec() arguments.

outputFile Optional File to which to direct program output. If no

outputfile or

variable attribute is specified, output is displayed on the page

from which it was called.

If not an absolute path (starting a with a drive letter and a colon,

or a forward or backward slash), it is relative to the ColdFusion

temporary directory, which is returned by the

GetTempDirectory function.