rsm_tsk

irsm_tsk

Outline

Resume suspended task.

C format

 ER      rsm_tsk (ID tskid);
 ER      irsm_tsk (ID tskid);
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 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_ID

-18

Invalid ID number.

- tskid < 0x0

- tskid > Maximum ID number

E_CTX

-25

Context error.

- This service call was issued in the CPU locked state.

E_OBJ

-41

Object state error.

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

E_NOEXS

-42

Non-existent object.

- Specified task is not registered.