pSOSystem System Calls - Read

q_delete pSOS+ System Calls
Notes
See Also
Hex Mnemonic Description
0x3A ERR_VARQ Queue is variable length.
0x53 ERR_ILLRSC Queue not created from this node.
1. Once created, a queue is generally used by multiple tasks for communication
and synchronization. There is rarely a reason for deleting a queue, even when it
is no longer used, except to allow reuse of the QCB.
2. The calling task may be preempted after this call, if a task that is waiting for a
message from the deleted queue has higher priority.
3. Any pending messages are lost.
4. q_delete() deletes an ordinary message queue. Use q_vdelete() to delete a
variable length message queue.
Multiprocessor Considerations
If qid identifies a global queue, q_delete will notify the master node so that the
queue can be removed from its Global Object Table. Thus, deletion of a global queue
always causes activity on the master node.
Callable From
■ Task
q_create, q_vdelete
1-78 pSOSystem System Calls