Everything

get_tid

iget_tid

Outline
Reference task ID in the RUNNING state.
C format
 ER      get_tid (ID *p_tskid);
 ER      iget_tid (ID *p_tskid);
Parameter(s)
I/O
Parameter
Description
O
 ID      *p_tskid;
Pointer to the area returning the task ID number.

Explanation
These service calls store the ID of a task in the RUNNING state in the area specified by parameter p_tskid.
This service call stores TSK_NONE in the area specified by parameter p_tskid if no tasks that have entered the RUNNING state exist.
Return value
Macro
Value
Description
E_OK
0
Normal completion.
E_PAR
-17
Parameter error.
- p_tskid == NULL
E_CTX
-25
Context error.
- This service call was issued in the CPU locked state.
- This service call was issued in the status PSW.IPL > kernel interrupt mask level.
Note When the iget_tid is issued from task or the get_tid is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.
E_MACV
-26
Memory access violation. (only for get_tid)
- The operand-write access to the area indicated by p_tskid has not been permitted to the invoking task.