Difference between revisions of "MQOPEN()"
From Recital Documentation Wiki
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
Line 9: | Line 9: | ||
==See Also== | ==See Also== | ||
− | [[MQCLOSE()]], [[MQCREATE()]], [[MQCURMSGS | + | [[MQCLOSE()]], [[MQCREATE()]], [[MQCURMSGS()]], [[MQRECEIVE()]], [[MQSEND()]] |
Revision as of 17:26, 17 November 2009
Purpose
Open a pointer to a message queue
Syntax
MQOPEN(<expC> [,<expN>])
See Also
MQCLOSE(), MQCREATE(), MQCURMSGS(), MQRECEIVE(), MQSEND()
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 |
---|---|
? | ? |
? | ? |
? | ? |
? | ? |
The MQCLOSE() function is used to close a queue which has been opened with MQOPEN().
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) end do mqclose(mqdes)
Products
Recital, Recital Server