CFEXECUTE

Enables ColdFusion developers to execute any process on the server machine.

Syntax

<CFEXECUTE 
    NAME=" ApplicationName "
    ARGUMENTS="CommandLine Arguments"
    OUTPUTFILE="Output file name"
    TIMEOUT="Timeout interval in seconds">

NAME

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.

ARGUMENTS

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:

OUTPUTFILE

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.

TIMEOUT

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.

Usage

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.

Exception

CFEXECUTE throws the following exceptions:

Example

<!---------------------------------------------------------------------- 
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>