tibemsQueueBrowser_GetNext

Function

Purpose

Get the next message from the browser.

C Declaration

tibems_status tibemsQueueBrowser_GetNext(
    tibemsQueueBrowser queueBrowser,
    tibemsMsg* msg );

COBOL Call

CALL "tibemsQueueBrowser_GetNext"
     USING BY VALUE queueBrowser,
           BY REFERENCE msg,
           RETURNING tibems-status
END-CALL.
Note: queueBrowser and msg have usage pointer.

Parameters

Parameter Description
queueBrowser Get the next message from the queue of this browser.
msg Stores the next message.

Remarks

A browser is a dynamic enumerator of the queue (not a static snapshot). The queue is at the server, and its contents change as message arrive and consumers remove them. Meanwhile, while the browser is at the client. This function gets the next message from the server.

If prior calls to this function have exhausted the messages in the queue, the function returns TIBEMS_NOT_FOUND.