F.71 ctThrdQueueOpen

---

Open a message queue.

Short Name

ctThrdQueueOpen

TYPE

Threading function

DECLARATION

NINT ctThrdQueueOpen()

DESCRIPTION

ctThrdQueueOpen opens a queue returning a small queue handle used as the queue identifier in the other queue calls. Any number of queues may be opened.

RETURN

ctThrdQueueOpen returns the queue handle. On failure, it returns the error code as a negative value. Typically a queue open will fail only if insufficient memory exists for the queue control structures.

Value	Symbolic Constant	Explanation
0	NO_ERROR	Successful function.
10	SPAC_ERR	Too much space required.

See Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide for a complete listing of valid c-tree Plus error values.

EXAMPLE

See ctmtap.c for ctThrdQueueOpen examples.

LIMITATIONS

Can only be used with a ctThrd library.

SEE ALSO

ctThrdQueueClose, ctThrdQueueCount, ctThrdLIFOWrite, ctThrdQueueMlen, ctThrdQueueRead, and ctThrdQueueWrite.