sus_tsk

isus_tsk

Outline

Suspend task.

C format

 ER      sus_tsk (ID tskid);

 ER      isus_tsk (ID tskid);

Parameter(s)

I/O	Parameter	Description
I	ID tskid;	ID number of the task. TSK_SELF: Invoking task. Value: ID number of the task.

Explanation

These service calls move the task specified by parameter tskid from the RUNNING state to the SUSPENDED state, from the READY state to the SUSPENDED state, or from the WAITING state to the WAITING-SUSPENDED state.

If the target task has moved to the SUSPENDED or WAITING-SUSPENDED state when this service call is issued, these service calls return "E_QOVR".

Note In the RI600PX, the suspend request can not be nested.

Return value

Macro	Value	Description
E_OK	0	Normal completion.
E_ID	-18	Invalid ID number. - tskid < 0 - tskid > VTMAX_TSK - When this service call was issued from a non-task, TSK_SELF was specified for tskid.
E_CTX	-25	Context error. - This service call was issued in the CPU locked state. - The isus_tsk was issued from task. - The sus_tsk was issued from non-task. - This service call was issued in the status "PSW.IPL > kernel interrupt mask level". - The invoking task is specified in the dispatching disabled state.
E_MACV	-26	Memory access violation. (only for sus_tsk) - Stack pointer points out of user stack for invoking task.
E_OBJ	-41	Object state error. - Specified task is in the DORMANT state. - Specified task is in the RUNNING state when isus_tsk is issued in the dispatching disabled state.
E_NOEXS	-42	Non-existent object. - The task specified by tskid does not exist.
E_QOVR	-43	Queuing overflow. - Specified task is neither in the SUSPENDED state nor WAITING-SUSPENDED state.