del_dtq

Outline

Delete data queue.

C format

 ER      del_dtq (ID dtqid);
Parameter(s)

I/O

Parameter

Description

I

 ID      dtqid;
ID number of the data queue.



Explanation

This service call can be called from tasks that belong to Trusted Domain.

This service call deletes the data queue indicated by dtqid.

When there are waiting tasks for the target data queue by using snd_dtq, tsnd_dtq, rcv_dtq or trcv_dtq, this service call cancels the WAITING state of the tasks and returns E_DLT as a return value of the snd_dtq, tsnd_dtq, rcv_dtq or trcv_dtq.

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_ID

-18

Invalid ID number.

- dtqid < 0

- dtqid > VTMAX_DTQ

E_CTX

-25

Context error.

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

- This service call was issued from non-task.

- This service call was issued in the status "PSW.IPL > kernel interrupt mask level".

E_MACV

-26

Memory access violation.

- Stack pointer points out of user stack for invoking task.

E_OACV

-27

Object access violation.

- The invoking task does not belong to trusted domain.

E_NOEXS

-42

Non-existent object.

- The data queue specified by dtqid does not exist.