CFX_Execute (1.3) December 05 2004

Description

PREAMBLE
This is one of a set of clones of the cf functions CFFILE, CFDIRECTORY and CFEXECUTE, etc. They operate essentially the same the built-in 4.5.x versions. They may have some additional features or lack a few (irrelevant) features.

CFX_Execute
<CFX_Execute
NAME="Application"
ARGUMENTS="Command line arguments"
OUTPUTFILE="Output file name"
VARIABLE="Output variable name"
TIMEOUT="Timeout seconds"
>
This is a clone of CFEXECUTE. It has been machined to work exactly like CF4.5's CFEXECUTE except that

There is an additional parameter called VARIABLE that allows the output to be placed in the variable specified.
It doesn't throw hard exceptions if there's a problem (they can't be handled by pre-cf4.5 servers).
Errors are returned in the ExecuteError variable.

Return codes, if any, are returned in ExecuteReturnCode.

My best guess is the C++ code is probably very similiar to the actual CFXECUTE function. This tag should be considered an upgrade from CFX_ConsoleCommand, CFX_SpawnL, etc.

Installation
Register the tag execute.dll as cfx_Execute. (Optionally, on pre-MX versions of ColdFusion, click the autoinstall script.)

Version History

• version 1.3     November 18 2004
  

  Recompiled. Permanently integrated old ASCII v1.3 Log class. Added installer.

• version 1.2     April 20 2004
  

  From: Dkerr dkerr@fusionpage.com
  Subject: CFX_EXECUTE question
  
  Thank you for the custom tag. I works great for setup of sites DNS in executing dnscmd.exe on Windows 2003 server:
  
  ... snip ...
  
  However, I can't seem to get it to execute the setup of IIS websites running the file located in c:winntsystem32iisweb.vbs .
  
  ... snip ...
  
  Can you shed some more light on the correct syntax for executing vbs scripts in CFX_EXECUTE?
  
  Your consolecommand worked great for DNS/IIS setup for me for a couple years on windows 2000, but failed to work on Windows 2003 Server.
  
  If you can help, I really could use it. I on a deadline to get 700 domains back online asap on 2003.
  Thank you,
  Don
  
  1. Added new error logging class.
  2. Fixed a few issues of the code not being quite tight enough (which probably never made any difference to the operation.)
  3. Fixed a bug that might leave created files locked by the operating system.
  4. Debugged an issue someone had with VBS scripts and added in a new VBS example.
  5. Fixed it so that both "variable" and "outputfile" can be used at the same time.

• version 1.1     March 04 2004
  

  Slight tinkering to verify works under CFMX 6.1. For unknown reasons tag still talked about "secExecute" (which was it's secure parent). Removed references.

• version 1.0     July 17 2003
  

  Reworked to run under Java CFMX without crashing.

• version 0.2a     October 02 2001
  

  Cleaned up examples a bit. The tag doesn't change at all.

• version 0.2     February 24 2001
  

  This tag diverges. The original CFX_secExecute is folded into IHTK. This FREEWARE copy has the security stripped out to make an enhanced clone of CFEXECUTE that can run on CF versions 4.x and possibly 3.x (though my copy of 3 has been sitting in a box in the closet for a year or so now so I can't say for sure.)

• version 0.1     February 11 2001
  

  Cleanup. (Music by Candlemass.)
  

• version 0.0     February 10 2001
  

  Initial contract build and release.
  

[Manual friendly version]