Difference between revisions of "MQOPEN()"
Yvonne.milne (Talk | contribs) m (1 revision) |
m (Text replace - "Recital" to "Lianja") |
||
Line 54: | Line 54: | ||
==Products== | ==Products== | ||
− | + | Lianja, Lianja Server | |
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
[[Category:Messaging]] | [[Category:Messaging]] | ||
[[Category:Messaging Functions]] | [[Category:Messaging Functions]] |
Revision as of 02:00, 8 December 2012
Purpose
Open a pointer to a message queue
Syntax
MQOPEN(<expC> [,<expN>])
See Also
MQCLOSE(), MQCREATE(), MQCURMSGS(), MQRECEIVE(), MQSEND(), MQUNLINK(), XML_DECODE(), XML_ENCODE(), XML_GATHER(), XML_SCATTER()
Description
The MQOPEN() function opens an existing message queue. It returns a numeric pointer when the queue is opened successfully, or a -1 if unsuccessful. The <expC> is the name of the queue to open. Since the pointer is required to identify an open queue to other messaging functions, always assign the return value to a memory variable. The optional <expN> determines the queue access mode:
<expN> | Access Mode |
---|---|
Unspecified | Read only access |
0 | Read only access |
1 | Write only access |
2 | Read/Write access |
The MQCLOSE() function is used to close a queue which has been opened with MQOPEN() or MQCREATE().
For more examples of handling message queues, please see the examples/mqueue programs in the software distribution.
Example
mqdes=mqopen("/myqueue") if (mqdes < 0) messagebox(strerror()+",errno="+alltrim(str(error()))) return endif do while (mqcurmsgs(mqdes) > 0) mstr=mqreceive(mqdes) if (empty(mstr)) messagebox(strerror()+",errno="+alltrim(str(error()))) return endif messagebox(mstr) enddo mqclose(mqdes)
Products
Lianja, Lianja Server