c_qcreate - Create a new queue

SYNTAX

long FUNCTION c_qcreate(order, duplicates)

char *order; 
char *duplicates; 

PARAMETERS

order (char *, input)

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

duplicates (char *, input)

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.

DESCRIPTION

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.

RETURN VALUE

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.