c_qdestroy - Destroy a queue

SYNTAX

long FUNCTION c_qdestroy(q)

     long q;

PARAMETERS

q (long, input)

The number of the queue to be destroyed. This number is returned by c_qcreate().

DESCRIPTION

This routine is used to destroy an existing queue. All memory allocated for entries is freed and the queue number is made available for a new queue.

RETURN VALUE

c_qdestroy() returns

      0 --> Successful completion.  The queue was destroyed.
     -1 --> Operation failed.  No such queue exists.