MQSEND()

From Recital Documentation Wiki
Jump to: navigation, search

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

Recital, Recital Server