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 RI600V4 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_OBJ

-41

Object state error.

- Specified task is neither in the SUSPENDED state nor WAITING-SUSPENDED state.