pSOSystem System Calls - Read

q_avurgent pSOS+ System Calls
q_avurgent (pSOS+m kernel only) Asynchronously posts a message at the head of a
variable-length message queue.
#include
unsigned long q_avurgent(
unsigned long qid, /* queue identifier */
void *msg_buf, /* message buffer */
unsigned long msg_len, /* length of message */
)
Description
Arguments
Return Value
Error Codes
This system call functions the same as q_vurgent except that q_avurgent
executes asynchronously. Refer to the description of q_vurgent for further
information. For a more detailed description of asynchronous services, refer to the
pSOSystem System Concepts manual.
qid Specifies the queue identifier.
msg_buf Points to the message to send.
msg_len Specifies the length of the message.
When called in system running pSOS+m, this call always returns 0. The pSOS+
kernel (the single processor version) returns ERR_SSFN.
The following error codes may be reported if a q_avurgent() call fails and the
node’s MC_ASYNCERR routine (if present) is invoked:
Hex Mnemonic Description
0x05 ERR_OBJDEL Queue has been deleted.
0x06 ERR_OBJID qid incorrect; failed validity check.
0x07 ERR_OBJTYPE Object type doesn’t match object ID;
failed validity check.
1-68 pSOSystem System Calls