Puts a message at a specific place in a queue.
int insq(q, emp, mp) register queue_t *q; register mblk_t *emp; register mblk_t *mp;
The insq utility places the message pointed to by the mp parameter in the message queue pointed to by the q parameter, immediately before the already-queued message pointed to by the emp parameter.
If an attempt is made to insert a message out of order in a queue by using the insq utility, the message will not be inserted and the routine is not successful.
The queue class of the new message is ignored. However, the priority band of the new message must adhere to the following format:
emp->b_prev->b_band >= mp->b_band >= emp->b_band.
On successful completion, the insq utility returns a value of 1. Otherwise, it returns a value of 0.
This utility is part of STREAMS Kernel Extensions.
The getq utility.
List of Streams Programming References and Understanding STREAMS Messages in AIX Version 4.3 Communications Programming Concepts.