frsm_tsk

ifrsm_tsk

Outline

Forcibly resume suspended task.

C format

 ER      frsm_tsk (ID tskid);

 ER      ifrsm_tsk (ID tskid);

Parameter(s)

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

Explanation

These service calls cancel all of the suspend requests issued for the task specified by parameter tskid (by setting the suspend request counter to 0). As a result, the target task moves from the SUSPENDED state to the READY state, or from the WAITING-SUSPENDED state to the WAITING state.

Note 1 These service calls do not perform queuing of forced cancelation requests. If the target task is neither in the SUSPENDED state nor WAITING-SUSPENDED state, "E_OBJ" is returned.

Note 2 The RI600PX does not support queuing of suspend request. Therefore, the behavior of these service calls are same as rsm_tsk and irsm_tsk.

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 ifrsm_tsk was issued from task. - The frsm_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 frsm_tsk) - Stack pointer points out of user stack for invoking task.
E_OBJ	-41	Object state error. - Specified task is neither in the SUSPENDED state nor WAITING-SUSPENDED state.
E_NOEXS	-42	Non-existent object. - The task specified by tskid does not exist.