Difference between revisions of "MQSEND()"
Helen.george (Talk | contribs) |
|||
Line 1: | Line 1: | ||
==Purpose== | ==Purpose== | ||
Send a message to an open message queue | Send a message to an open message queue | ||
− | |||
==Syntax== | ==Syntax== | ||
MQSEND(<expN>, <expC>) | MQSEND(<expN>, <expC>) | ||
− | |||
==See Also== | ==See Also== | ||
[[MQCLOSE()]], [[MQCREATE()]], [[MQCURMSGS()]], [[MQOPEN()]], [[MQRECEIVE()]], [[MQUNLINK()]], [[XML_DECODE()]], [[XML_ENCODE()]], [[XML_GATHER()]], [[XML_SCATTER()]] | [[MQCLOSE()]], [[MQCREATE()]], [[MQCURMSGS()]], [[MQOPEN()]], [[MQRECEIVE()]], [[MQUNLINK()]], [[XML_DECODE()]], [[XML_ENCODE()]], [[XML_GATHER()]], [[XML_SCATTER()]] | ||
− | |||
==Description== | ==Description== | ||
Line 17: | Line 14: | ||
For more examples of handling message queues, please see the examples/mqueue programs in the software distribution. | For more examples of handling message queues, please see the examples/mqueue programs in the software distribution. | ||
− | |||
==Example== | ==Example== | ||
Line 35: | Line 31: | ||
mqclose(mqdes) | mqclose(mqdes) | ||
</code> | </code> | ||
− | |||
==Products== | ==Products== |
Revision as of 13:03, 11 December 2012
Purpose
Send a message to an open message queue
Syntax
MQSEND(<expN>, <expC>)
See Also
MQCLOSE(), MQCREATE(), MQCURMSGS(), MQOPEN(), MQRECEIVE(), MQUNLINK(), XML_DECODE(), XML_ENCODE(), XML_GATHER(), XML_SCATTER()
Description
The MQSEND() function sends a message to an open message queue. The <expN> is the pointer to a queue opened with MQCREATE() or MQOPEN(). The <expC> is the character string message to send. It returns 0 (zero) if the message is sent successfully. If an error occurs and it is unable to send the message, it returns -1 and the ERRNO() function can be checked to determine the error.
The MQCLOSE() function is used to close a queue which has been opened with MQCREATE() or MQOPEN().
For more examples of handling message queues, please see the examples/mqueue programs in the software distribution.
Example
// Open up the queue for read/write access mqdes=mqcreate("/myqueue2", 2) if (mqdes < 0) messagebox(strerror()+",errno="+alltrim(str(error()))) return endif // send a message to the queue rc = mqsend(mqdes, "Test message") if (rc < 0) messagebox(strerror()+",errno="+alltrim(str(error()))) return endif mqclose(mqdes)
Products
Lianja, Lianja Server