Waits for the specified timeout period to return the message ID of the next message that is queued for the given address.
Item | Description | Remarks |
---|---|---|
1 | Address | VARCHAR(128) |
2 | Timeout in milliseconds | INTEGER |
The message ID as VARCHAR(128).
Returns null if there is no queued message for this address within the timeout period.
Use this stored procedure to check synchronously whether there is a message waiting for the specified QAnywhere message address. Use the Listener if you want a SQL procedure to be called asynchronously when a message is available for a specified QAnywhere address.
The message corresponding to the returned message is not considered to be received until the current transaction is committed. Once the receive is committed, the message cannot be received again by this or any other QAnywhere API. Similarly, a rollback of the current transaction means that the message is not received, so subsequent calls to ml_qa_getmessage may return the same message ID.
The properties and content of the received message can be read by the various ml_qa_get stored procedures until a commit or rollback is executed on the current transaction. Once a commit or rollback is executed on the current transaction, the message data is no longer readable. Before committing, you should store any data you need from the message as tabular data or in SQL variables.
The following example outputs the content of all messages sent to the address myaddress to the database server messages window, and updates the database server messages window every 10 seconds if no message has been received:
begin declare @msgid varchar(128); loop set @msgid = ml_qa_getmessagetimeout( 'myaddress', 10000 ); if @msgid is null then message 'waiting for a message...'; else message 'a message with content ' || ml_qa_gettextcontent( @msgid ) || ' has been received'; commit; end if; end loop; end |
Discuss this page in DocCommentXchange. Send feedback about this page using email. |
Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1 |