MC-Basic:TASKSTATE

This query returns a Long value, indicating the state of the task. There are two conditions in which the regular task state is modified:

1) when the task is Locked

2) when the task is Interrupted

A task may be Locked in states 2, 4, and 10 if it is waiting for a system event to complete execution.

In this case, the value 256 (0x100) is added to the regular task state. This could occur when a task has three moves, one after the other. The interpreter is waiting to execute the second move until the first has completed.

If you enter a STOP command from the terminal, the task remains in the Running mode. Enter the IDLETASK command from the terminal and the task switches to a Stopped and Locked state. It is locked because it is waiting for the Proceed command to resume motion. A task is interrupted by either OnEvent or OnError. In this case, the value 512 (0x200) is added to the regular task state.

1: Running (TASK_RUNNING)

2: Stopped due to IDLETASK or after a STEPIN instruction (TASK_STOPPED)

4: Stopped due to runtime error (TASK_ERROR)

5: Terminated .

                     It can be seen momentary  that state at: 
                     1. Terminate program 
                     2. Unload

7: Ready after LOAD (TASK_READY)

9:  Task Kill Start . It's a first state of task termination procedure, after successful

termination state is internally changed to TASK_KILLED(10). In certain circumstances due to incomplete or delayed IO operation task can remain in this state and will require additional kill command.

10: Killed after KILLTASK OR END PROGRAM (TASK_KILLED)

If the task is interrupted by an event, the task state has the value 512 added to it. If the task is Locked, the task state has the value 256 added to it.

Syntax

?TaskState (<task name> )

Availability

Version 3.6.20 and above

Type

<task name> : String

Returned value: Long

Range

Returned value: 1, 2, 4, 5, 7, 9, 10

Scope

Task or Terminal

Limitations

Task must be loaded in memory

Examples

?TaskState(“Task1.prg”)

Or

Common Shared Str1 as String

Str1 = “Task1.prg”

?TaskState(Str1)

See Also

• task.STATUS