Copyright © TIBCO Software Inc. All Rights Reserved

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.

Parameters

 

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.

Copyright © TIBCO Software Inc. All Rights Reserved