User Task Present

Command

UTP <task number>

Description

If a controller resident user task is running this command returns true. If it is not running it returns false. This command is often used to monitor a task to know when it has finished. The parameter is a number corresponding to the user task number in the name UserTask1, UserTask2, etc.

Escapes

If the task number is specified that is less than 1 or greater than the MaxUserTasks constant inside the AsciiCommands package a Parameter Out Of Range Escape Code error will occur. MaxUserTasks has a value of 16 but can be adjusted if more tasks need to be invoked from the host. Note that only 14 additional tasks can run at one time as two are used to sustain host communication.

Examples

The following resident procedure named UserTask1 performs a variety of moves:

The following list of commands begin the task and then determine when it is finished:

Related Topics

Yield
Abort User Task
Begin User Task