# 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`.

Copyright © Cloud Software Group, Inc. All rights reserved.