TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Using the Catch/Propagate Exception Dialog Box

The Debug > Catch, Debug > Propagate, and Exceptions > New commands use the Catch/Propagate Exception dialog box.

Exception Field

In the Exception field, enter the exception name.

Location Field

The Location field is at the top of the this dialog box. Selecting this field displays two options: On Line and On Location.

File Name

If On Line is selected, you must enter a debugger pathname denoting a program unit in this field.

Statements

The entry in this section can take several forms. It can be an expression that is evaluated each time the breakpoint is reached. This evaluation takes place in the environment of the location of the exception breakpoint. If the expression is False, the exception is propagated and the program continues. If the expression is True, the breakpoint is announced.

The Statements area can also contain a sequence of one or more debugger commands that automatically execute when the exception occurs. The following format is used:

Note that you do not need to enter begin or end statements. You can enter the command on the same line separated by semicolons or enter each command on its own line. The second method (separate lines) is recommended. As each command of commands is entered on its own line, the debugger prompts with ?? for each new command until the sequence terminates with end (or an else in the case of an if...then...else).

Conditional

If the catching/propagation of the exception is to be determined by a set of conditions, select this button. A new screen appears with areas to enter the conditions under which this request is to operate.

Action

The Action field indicates the operation to perform. Select Catch to catch the exception and cause the debugger to stop execution. Select Propagate to have the debugger ignore this exception without stopping execution. The default is based on the command that displayed this dialog box.

For more information on exceptions, see Using the Apex Debugger.

Additional Topics

For more information, click on a topic:


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS