pSOSystem System Calls - Read

q_aurgent pSOS+ System Calls
Notes
See Also
Hex Mnemonic Description
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_aurgent() asynchronously sends an urgent message to an ordinary
message queue. Use q_avurgent() to asynchronously send an urgent
message 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_aurgent() call, whether it is on the local or a remote queue, may cause
pSOS+m activities on another processor node.
Callable From
■ Task
q_urgent, q_vurgent, q_avurgent, q_asend, q_receive
1-64 pSOSystem System Calls