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. 

queueBrowser and msg have usage pointer.

Parameter
Description
queueBrowser
Get the next message from the queue of this browser.
msg
The function stores the next message in this location.

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.


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com