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_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.