MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 106 / 806

106 Chapter 2: ColdFusion Tags
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"
variable = "variable name"
timeout = "Timeout interval">
...
</cfexecute>
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.