pSOSystem System Calls - Read

q_avsend pSOS+ System Calls
Notes
Hex Mnemonic Description
0x31 ERR_MSGSIZ Message too large.
0x35 ERR_QFULL Message queue at length limit.
0x3B ERR_NOTVARQ Queue is not variable length.
0x65 ERR_STALEID Object's node has failed.
If an MC_ASYNCERR routine is not provided, the pSOS+m kernel generates a fatal
error.
1. This call is supported only by the pSOS+m kernel.
2. The calling task can be preempted as a result of this call.
3. The pSOS+m kernel must copy the message into a queue buffer or the receiving
task's buffer. Longer messages take longer to copy. Users should account for the
copy time in their designs.
4. q_avsend() asynchronously sends a message to a variable length message
queue. Use q_asend() to send a message asynchronously to an ordinary
message queue.
Multiprocessor Considerations
1. If qid identifies a global queue residing on another processor node, then the
pSOS+m 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_avsend()
call, whether it is on the local or a remote queue, may cause pSOS+m activities
on another processor node.
1-66 pSOSystem System Calls