User manual MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE REFERENCE

[. . . ] CFML Language Reference ColdFusion 4. 5 Allaire Corporation Copyright Notice 1999 Allaire Corporation. This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. The content of this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Allaire Corporation. Allaire Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this book. [. . . ] 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. Specifies how many seconds JRun should wait for the servlet to complete before timing out. 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. 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. Chapter 1: ColdFusion Tags 193 Usage The syntax of the CFSERVLET tag is designed to be consistent with the HTML markup <SERVLET> and <PARAM> used by some web servers to invoke Java servlets from . shtml pages in what is known as SSI, Server-Side Includes. CFSERVLET Variables Variable Name CFSERVLET. Output Description Inline text output of the servlet is directed to this structure if the WRITEOUTPUT attribute is set to No. The CFSERVLET return structure also contains the values of any response headers returned by the servlet. To access a response header, specify its name in servletResponseHeaderName. CFSERVLET. servletResponseHeaderName Note The servlet must exist somewhere in the class path of the JRun engine executing the servlet. The JRun "servlet" subdirectory is a good location since it is already in JRun's class path and because classes in this directory are automatically reloaded by JRun if they change. CODE="MyServletName" Example <CFSERVLET JRUNPROXY="236. 3. 3. 4:8083" TIMEOUT="300" WRITEOUTPUT="YES"> <CFSERVLETPARAM NAME="Param1" VALUE="Value1"> <CFSERVLETPARAM NAME="Param2" VALUE="Value2"> <CFSERVLETPARAM NAME="Attribute1" VARIABLE="CFVar1"> <CFSERVLETPARAM NAME="Attribute2" VARIABLE="CFVar2"> </CFSERVLET> 194 CFML Language Reference CFSERVLETPARAM The CFSERVLETPARAM is a child of CFSERVLET. Each CFSERVLETPARAM tag within the CFSERVLET block passes a separate piece of data to the servlet. See also CFSERVLET. Syntax <CFSERVLET . . . > <CFSERVLETPARAM NAME="servlet parameter name" VALUE="servlet parameter value" > . . . <CFSERVLETPARAM NAME="servlet attribute name" VARIABLE="ColdFusion variable name" TYPE="INT" or "DOUBLE" or "BOOL" or "DATE" or "STRING" > . . . If used with the VALUE attribute, it is the name of the servlet parameter. If used with the VARIABLE attribute, it is the name of the servlet attribute. See the Usage section for details on passing parameters. See the Usage section for details on passing parameters. [. . . ] In the second example, a fourth argument is provided that forces the function to replace all occurrences of "Foo" with "Boo". Chapter 4: ColdFusion Expressions: Operators and Other Constructs 581 Pound Signs Pound signs (#) have special meaning in ColdFusion. When a CFML application page is processed, ColdFusion treats text delimited by pound signs differently from plain text. Two simple and very important points about pound signs in CFML are: Use pound signs to distinguish expressions from plain text. When expressions are evaluated, the resulting value is substituted for the expression text. [. . . ]