pSOSystem System Calls - Read

pSOS+ System Calls q_avurgent
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 present, 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 asynchronously send a message 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
internally passes the message to the task's node of residence, whose pSOS+m
kernel readies the task and gives it the relayed message. Thus, a
q_avurgent() call, whether it is on the local or a remote queue, can cause
pSOS+m activity on another processor node.
pSOSystem System Calls 1-69
1