MACROMEDIA COLDFUSION 4.5-DEVELOPING WEB, Develop Manual

Page: 124 / 380

98 Developing Web Applications with ColdFusion
Tag context information
The ColdFusion Administrator’s debugging settings page allows you to"Enable CFML
stack trace." When this setting is enabled, CFCATCH blocks make available an array of
structures called CFCATCH.TagContext. Each structure represents one level of the
ColdFusion runtime’s active tag context at the time when the ColdFusion interpreter
detected the exception.
The structure at position 1 of the array represents the outermost tag in the stack of tags
that were executing when the interpreter detected the exception. The structure at
position ArrayLen(CFCATCH.TAGCONTEXT) represents the currently executing tag at
the time the interpreter detected the exception.
The TagContext structures have the following attributes:
TEMPLATE — The pathname of the application page that contains the tag.
LINE and COLUMN — The tag's line number and column number within the
application page.
Note
Turn off "Enable CFML stack trace" to avoid having production servers
expend resources creating a traceback stack by default. When this setting
is disabled, CFCATCH.TAGCONTEXT is a zero-length array.
CFCATCH.ERRORCODE Any exception that is a part of the CFML exception
hierarchy supplies a value for this variable.
For TYPE="Application" CFTHROW tags may
supply a value for this code via the ERRORCODE
attribute. For
Type="Database"
CFCATCH.ERRORCODE has the
same value as CFCATCH.SQLSTATE. Otherwise,
the value of CFCATCH.ERRORCODE is the empty
string.
CFCATCH.TAGCONTEXT Provides the name and position of each tag in the tag
stack and the full path names of the files that contain
the tags in the tag stack.
Exception Property Variables (Continued)
Property variable Description