Set Thread Command

This command sets one or more thread attributes for a thread.

Set Thread thread_name [-lineline_number] [-trace] [ -notrace] [ -bex ] [ -nobex ]

Prerequisites

The specified thread must have been activated by a Start command. The thread must be paused if the -line parameter is specified otherwise it may be either active or paused.

Parameters

thread_name

The name of the thread.

-line line_number

An optional clause that changes the next procedure step to be executed. The line_number value specifies the number of the line within the source file of the next procedure step when the thread is continued. The -line parameter requires the thread to be paused.

-trace

An optional switch that specifies that the statements executed by the thread should be displayed on the console as they are executed. This option greatly degrades the performance of procedure execution.

-notrace

An optional switch that specifies that the statements executed by the thread should not be displayed on the console as they are executed. This option cancels any current trace mode that may be enabled.

-bex

An optional switch that specifies "break on exception" for the thread. The thread will pause immediately if an exception occurs, rather then passing control to any Try / Catch exception handler. Continuing after the pause then passes control to the exception handler.

-nobex

An optional switch that cancels "break on exception" for the thread. The thread will not pause if an exception occurs. Exceptions are handled normally.

Remarks

This command is normally used only when debugging a procedure.

If the next-step line number is changed, the new line number must fall within the same procedure as the current line number, and there must be an executable statement at that line in the file.

Examples

Set Thread My_project -line 25 -notrace
Continue My_project
Execution of the thread continues starting at line 25 in the procedure source file. Tracing of procedure steps is disabled.