Everything

ref_tex

iref_tex

Outline
Reference task exception state.
C format
 ER      ref_tex (ID tskid, T_RTEX *pk_rtex);
 ER      iref_tex (ID tskid, T_RTEX *pk_rtex);
Parameter(s)
I/O
Parameter
Description
I
 ID      tskid;
ID number of the task.
TSK_SELF: Invoking task.
Value: ID number of the task.
O
 T_RTEX  *pk_rtex;
Pointer to the packet returning the task exception state.

[Task exception state packet: T_RTEX]
 typedef struct  t_rtex {
     STAT    texstat;        /*Task exception handling state*/
     UINT    pndptn;         /*Pending exception code*/
 } T_RTEX;

Explanation
Stores task exception state of the task specified by parameter tskid in the area specified by parameter pk_rtex.
- tskstat
Stores task exception handling state.
TTEX_ENA: Task exception enabled state
TTEX_DIS: Task exception disabled state
- pndptn
Stores the pending exception code.
Return value
Macro
Value
Description
E_OK
0
Normal completion.
E_PAR
-17
Parameter error.
- pk_rtex == NULL
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.
- This service call was issued in the status "PSW.IPL > kernel interrupt mask level".
Note When the iref_tex is issued from task or the ref_tex 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 ref_tex)
- The operand-write access to the area indicated by pk_rtex has not been permitted to the invoking task.
E_NOEXS
-42
Non-existent object.
- The task specified by tskid does not exist.