Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 295

DEVELOPING COLDFUSION 9 APPLICATIONS
Developing CFML Applications
Property variable
cfcatch.Detail
cfcatch.ErrorCode
cfcatch.ExtendedInfo
cfcatch.Message
cfcatch.RootCause
cfcatch.TagContext
cfcatch.Type
Note: If you use the tag to display the cfcatch variable, the display does not include variables that do not have
cfdump
values.
The variable contains an array of tag information structures. Each structure represents one
cfcatch.TagContext
level of the active tag context at the time when ColdFusion detected the exception. That is, there is one structure for
each tag that is open at the time of the exception. For example, if the exception occurs in a tag on a custom tag page,
the tag context displays information about the called custom tag and the tag in which the error occurs.
The structure at position 1 in the array represents the currently executing tag at the time the exception was detected.
The structure at position
ArrayLen
detected the exception.
The following table lists the tagContext structure attributes:
Entry
Column
ID
Line
Raw_Trace
Template
Type
Database exceptions
The following additional variables are available whenever the exception type is database:
Description
A detailed message from the CFML compiler. This message, which can contain HTML formatting, can help
to determine which tag threw the exception.
The value is available in the CFScript
cfcatch.Detail
parameter.
The cfthrow tag can supply a value for this code through the
Type="Database" , cfcatch.ErrorCode
Otherwise, the value of cfcatch.ErrorCode
Custom error message information. This is returned only to
Application or a custom type.
Otherwise, the value of cfcatch.ExtendedInfo
The exception's default diagnostic message, if one was provided. If no diagnostic message is available, this
is an empty string.
The value is included in the value of the CFScript
cfcatch.Message
exceptionVariable parameter.
The Java servlet exception reported by the JVM as the cause of the "root cause" of the exception.
An array of structures structure containing information for each tag in the tag stack The tag stack consists
of each tag that is currently open.
The exception's type, returned as a string.
represents the initial tag in the stack of tags that were executing when the compiler
Description
Obsolete (retained for backwards compatibility). Always 0.
The tag in which the exception occurred. Exceptions in CFScript are indicated by two
question marks (??). All custom tags, including those called directly, are identified as
cfmodule.
The line on the page in which the tag is located.
The raw Java stack trace for the error.
The pathname of the application page that contains the tag.
The type of page; it is always a ColdFusion page.
Last updated 1/20/2012
statement as the
catch
errorCode attribute. For
has the same value as cfcatch.SQLState
is the empty string.
cfcatch tags for which the
is the empty string.
statement
catch
290
exceptionVariable
.
type attribute is