Calling The Cftrace Tag - MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX Develop Manual

•
If a page has many nested
conditional block to trace the execution flow. When you do this, you should use the condition
variable in the message or
•
If you find that the ColdFusion server is hanging, and you suspect a particular block of code
(or call to a cfx tag, COM object, or other third-party component), you can put a
before and after the suspect code, to log entry and exit.

Calling the cftrace tag

The tag takes the following attributes. All attributes are optional.
cftrace
Attribute
abort
category
inline
text
404 Chapter 18: Debugging and Troubleshooting Applications
and
cfif cfelseif
attribute.
var
Purpose
A Boolean value. If you specify True, ColdFusion stops processing the current
request immediately after the tag. This attribute is the equivalent of placing a
tag immediately after the
cfabort
is True, the output of the
in the file includes the text "[ABORTED]".
A text string specifying a user-defined trace type category. This attribute lets you
identify or process multiple trace lines by categories. For example, you could sort
entries in a log according to the category.
The attribute is designed to identify the general purpose of the trace
category
point. For example, you might identify the point where a custom tag returns
processing to the calling page with a "Custom Tag End" category. You can also
use finer categories; for example, by identifying the specific custom tag name in
the category.
You can include simple ColdFusion variables, but not arrays, structures, or
objects, in the category text by enclosing the variable name in pound signs (#).
A Boolean value. If you specify True, ColdFusion displays trace output in-line in
the page. The default is False.
The attribute lets you display the trace results at the place that the
inline
call is processed. This provides a visual cue directly in the ColdFusion page
display.
Trace output also appears in a section in the debugging information display.
A text message describing this trace point. You can include simple ColdFusion
variables, but not arrays, structures, or objects, in the text output by enclosing the
variable name in pound signs (#).
tags you can put
tag. The default is False. If this attribute
cftrace
call appears only in the cftrace.log file. The line
cftrace
tags in each
cftrace
cftrace
tag
cftrace