pSOSystem System Calls - Read

q_vsend pSOS+ System Calls
Notes
Hex Mnemonic Description
0x3B ERR_NOTVARQ Queue is not variable length.
0x65 ERR_STALEID Object's node has failed.
1. If the caller is a task, it may be preempted as a result of this call.
2. The pSOS+ kernel must copy the message into a queue buffer or the receiving
task's buffer. Longer messages take longer to copy. User's should account for
the copy time in their design, especially when calling from an ISR.
3. q_vsend() sends a message to a variable length message queue. Use
q_send() to send a message to an ordinary queue.
Multiprocessor Considerations
1. If qid identifies a global queue residing on another processor node, the local
kernel will internally make an RSC to that remote node to post the input
message to that queue.
2. If a task awakened by this call does not reside on the local node, the local kernel
will internally pass the message to the task's node of residence, whose pSOS+m
kernel will ready the task and give it the relayed message. Thus, a q_vsend()
call, whether it is on the local or a remote queue, may cause pSOS+m activities
on another processor node.
1-102 pSOSystem System Calls