pSOSystem System Calls - Read

q_asend pSOS+ System Calls
Notes
See Also
Hex Mnemonic Description
0x35 ERR_QFULL Message queue at length limit.
0x3A ERR_VARQ Queue is 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. q_asend() asynchronously sends a message to an ordinary message queue.
Use q_avsend() to send a message asynchronously to a variable length
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, then the
pSOS+m 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_asend() call, whether it is on the local or a remote queue, may cause
pSOS+m activities on another processor node.
Callable From
■ Task
q_send, q_vsend, q_avsend, q_aurgent, q_receive
1-62 pSOSystem System Calls