sta_tsk/ista_tsk | CS+ V5.00.00

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 );

Assembly format


MOVW BC, #stacd_lo MOVW DE, #stacd_hi MOV A, #tskid CALL !!_sta_tsk MOVW BC, #stacd_lo MOVW DE, #stacd_hi MOV A, #tskid CALL !!_ista_tsk

Parameter(s)


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

Explanation

These service calls move a 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 RI78V4.

Note 1 This service call does not perform queuing of activation requests. If the target task is in a state other than the DORMANT state, the counter manipulation processing is therefore not performed but "E_OBJ" is returned.

Note 2 A start code "stacd" is passed to the task activated by issuing this service call.

Return value


Macro	Value	Description
E_OK	0	Normal completion.
E_OBJ	-41	Object state error (specified task is not in the DORMANT state).