long FUNCTION c_qcreate(order, duplicates)
char *order; char *duplicates;
A character string indicating the queue's order. Valid strings are:
"ascending": queue items will be stored in ascending order "descending": queue items will be stored in descending order "fifo": queue items will be stored in first-in, first-out order "lifo": queue items will be stored in last-in, first-out order
A character string indicating if duplicates are allowed. If the string "nodups" is sent, then no duplicate entries are allowed in the queue, otherwise duplicates are allowed.
This routine is used to create a new queue. Entries will be stored in the queue indicated by order. The queue may be created to allow or disallow duplicate entries.
c_qcreate() returns
the number of the queue created. -1 --> Operation failed. The program has already created the maximum number of queues allowed (MAXQUEUES), the specified order was not one of the valid values, or an error occurred allocating space for the first queue entry.