Exception Class Properties
In this section, we discuss the Exception class properties, in alphabetical order.
Description
This property returns a string description of the location of the condition in PeopleCode or other processing. This might contain a stack backtrace at the point of the exceptional condition.
This property is read-only.
Example
This is the “At” part of the error message display. For example, for an exception thrown in Record.Field Event QE_31DIGREC1.QE_31DIGFLD5 FieldChange function EachComp at PeopleCode program counter 671, statement 11 of the source program, the Context would be:
At QE_31DIGREC1.QE_31DIGFLD5.FieldChange EachComp PCPC:671 Statement:11
Description
This property sets a string to use as the basic message text for the exception when the message can't be found in the message catalog.
This property is read/write.
Description
This property is the message number for a message describing the exceptional condition.
This property is read-only.
Description
This property is the message set number for a message describing the exceptional condition.
This property is read-only.
Description
This property is the message severity as a string for a message describing the exceptional condition. The message severity is set for the message when it's created in the message catalog. The values are:
Numeric Value |
Constant Value |
Description |
---|---|---|
C |
%MsgSeverity_Cancel |
Message severity is Cancel. |
E |
%MsgSeverity_Error |
Message severity is Error. |
M |
%MsgSeverity_Message |
Message severity is Message. |
W |
%MsgSeverity_Warning |
Message severity is Warning. |
This property is read-only.
Description
This property returns a string with the complete stack trace. This includes the whole context, (that is, current location + called from X + called from. . . )
You can process the returned string by breaking it into pieces using the Split function, and using "Called from" as the value to use for separating the string. For example,
Local Array of String &Pieces;
/* get exception */
&Pieces = Split(&E.StackTrace, "Called from:");
This property is read-only.
Example
The following is an example of a trace stack.
In C (0,0) AEMINITEST.MAIN.GBL.default.1900-01-01.Step02.OnExecute Name:C PCPC
:136 Statement:2
Called from:AEMINITEST.MAIN.GBL.default.1900-01-01.Step02.OnExecute Name:B Sta
tement:6
Called from:AEMINITEST.MAIN.GBL.default.1900-01-01.Step02.OnExecute Name:A Sta
tement:13
Called from:AEMINITEST.MAIN.GBL.default.1900-01-01.Step02.OnExecute Statement:1
8
Description
This property returns the number of substitution strings in the message text as a number.
The number of substitutions comes from the subslist of the CreateException function.
This property is read-only.