sta_tsk

ista_tsk

Outline

Activate task (does not queue an activation request).

C format

 ER      sta_tsk (ID tskid, VP_INT stacd);

 ER      ista_tsk (ID tskid, VP_INT stacd);

Parameter(s)

I/O	Parameter	Description
I	ID tskid;	ID number of the task.
I	VP_INT stacd;	Start code of the task.

Explanation

These service calls move the task specified by parameter tskid from the DORMANT state to the READY state.

As a result, the target task is queued at the end on the ready queue corresponding to the initial priority and becomes subject to scheduling by the RI600PX.

At this time, processing described in Table 19-3 is done.

These service calls do not perform queuing of activation requests. If the target task is in a state other than the DORMANT state, the status manipulation processing for the target task is therefore not performed but "E_OBJ" is returned.

The stacd is passed to the target task.

Return value

Macro	Value	Description
E_OK	0	Normal completion.
E_ID	-18	Invalid ID number. - tskid < 0 - tskid > VTMAX_TSK
E_CTX	-25	Context error. - This service call was issued in the CPU locked state. - The ista_tsk was issued from task. - The sta_tsk was issued from non-task. - This service call was issued in the status "PSW.IPL > kernel interrupt mask level".
E_MACV	-26	Memory access violation. (only for sta_tsk) - Stack pointer points out of user stack for invoking task.
E_OBJ	-41	Object state error - Specified task is not in the DORMANT state.
E_NOEXS	-42	Non-existent object. - The task specified by tskid does not exist.