Start Command

This command begins the execution new thread that executes the project-start procedure from a compiled project.

Start project_name [-name thread_name] [-bex] [-break] [-compile] [-event] [-init] [-noevent] [-stack stack_size] [-trace]

Prerequisites

The specified project must be present as a folder in the GPL project area and have been successfully compiled by the Compile command.

Parameters

project_name

The name of a loaded and compiled project. The project-start procedure specified in the project file is started. By default, he name of the new thread is the same as the project name.

-name thread_name

An optional clause the specifies the name of the new thread to be created. This clause overrides the default use of the project name.

-bex

An optional switch that specifies that the thread should 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.

-break

An optional switch that specifies that the thread execution should pause immediately before executing the first instruction of the procedure.

-compile

An optional switch that specifies that the project should be compiled or recompiled before the thread is started. This is equivalent to issuing the Compile command before the Start command. The project must already be loaded.

-event

An optional switch that specifies that thread state-change messages should be sent as events. Otherwise they are displayed as messages on the console.

-init

An optional switch that causes initialization statements to be displayed during trace or during single stepping for debugging. Normally this switch is specified together with either the -break or -trace switch.

-noevent

An optional switch that cancels any previous -event switch. This switch may be used when issuing a Start command from the GDE console, which implicitly asserts -event.

-stack stack_size

An optional switch that specifies the size of the procedure stack, in kilobytes. If omitted, the default value is 4.

-trace

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

Remarks

Once thread begins execution, it continues until it completes, encounters an unhandled exception, hits a breakpoint, or is stopped by a Break command or a Stop command.

Examples

Start My_project

Thread My_project: Running