User Guide

192 CFML Language Reference
CFSERVLET
Executes a Java servlet on a JRun engine. This tag is used in conjunction with the
CFSERVLETPARAM tag, which passes data to the servlet.
Syntax <CFSERVLET
CODE="class name of servlet"
JRUNPROXY="proxy server"
TIMEOUT="timeout in seconds"
WRITEOUTPUT="Yes/No"
DEBUG="Yes/No">
<CFSERVLETPARAM
NAME=”parameter name”
VALUE=”value”
>
...
</CFSERVLET>
CODE
Required. The class name of the Java servlet to execute.
JRUNPROXY
Optional. Specifies a remote machine where the JRun engine is executing. By
default, the JRun engine is assumed to be on the host running ColdFusion. To
indicate the name of a remote host, specify the IP address of the remote host
followed by a colon and the port number at which JRun is listening. By default,
JRun listens at port 8081.
TIMEOUT
Optional. Specifies how many seconds JRun should wait for the servlet to
complete before timing out.
WRITEOUTPUT
Optional. Boolean specifying if the text output of the tag should appear as inline
text on the generated page or if it should be returned inside a ColdFusion variable
for further processing . The default value, YES, means output is returned as text to
appear inline on the generated page. Setting it to NO means no visible text is
returned but, instead, the text is returned as the value of the CFSERVLET.OUTPUT
variable. See the CFSERVLET Variables table under Usage for more information.
DEBUG
Optional. Boolean specifying whether additional information about the JRun
connection status and activity is to be written to the JRun error log. The error log is
in JRunHome/jsm-default/logs/stderr.log. Reading this log is helpful for
debugging server-side problems. The default is No.