Outline

Resume suspended task.

C format

ER rsm_tsk ( ID tskid ); ER irsm_tsk ( ID tskid );

Assembly format

MOV A, #tskid CALL !!_rsm_tsk MOV A, #tskid CALL !!_irsm_tsk

Parameter(s)

I/O	Parameter	Description
I	ID tskid;	ID number of the task to be resumed.

Explanation

This service call subtracts 0x1 from the suspend request counter for the task specified by parameter tskid, and then cancels the SUSPENDED state of the target task.

As a result, the target task is moved from the SUSPENDED state to the READY state, or from the WAITING-SUSPENDED state to the WAITING state.

If a suspend request is queued (subtraction result is other than 0x0) when this service call is issued, the counter manipulation processing is not performed but only the suspend request counter decrement processing is executed.

Note 1 If the target task is moved to the READY state after this service call is issued, this service call also re-queues the task at the end of the ready queue corresponding to the priority of the task.

Note 2 This service call does not perform queuing of cancellation requests. If the target task is in a state other than the SUSPENDED or WAITING-SUSPENDED state, "E_OBJ" is therefore returned.

Return value

Macro	Value	Description
E_OK	0	Normal completion.
E_OBJ	-41	Object state error (specified task is neither in the SUSPENDED state nor WAITING-SUSPENDED state).