pSOSystem System Calls - Read

q_broadcast pSOS+ System Calls
Notes
Hex Mnemonic Description
0x65 ERR_STALEID Object's node has failed.
1. q_broadcast() is particularly useful in situations where a single event (for
example, an interrupt) must wake up more than one task. In such cases,
q_broadcast() is clearly more efficient than multiple q_send() calls.
2. If the caller is a task, it may be preempted as a result of this call.
3. q_broadcast() can be intermixed with q_send() and q_urgent() calls to
the same queue.
4. q_broadcast() sends messages to an ordinary message queue. Use
q_vbroadcast() to send messages 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 tasks awakened by this call do not reside on the local node, then the pSOS+m
kernel will internally pass the message to each task's node of residence, whose
pSOS+m kernel will ready the task and give it the relayed message. Thus, a
q_broadcast() call, whether it is on the local or a remote queue, may cause
pSOS+m activities on one or more other processor nodes.
1-72 pSOSystem System Calls