# tibemsSession_CreateBrowser

Function

## Purpose

Create a queue browser.

## C Declaration

    tibems_status tibemsSession_CreateBrowser(
        tibemsSession session,
        tibemsQueueBrowser* browser,
        tibemsQueue queue,
        const char* messageSelector );

## COBOL Call

    CALL "tibemsSession_CreateBrowser"
         USING BY VALUE session,
               BY REFERENCE browser,
               BY VALUE queue,
               BY REFERENCE messageSelector,
               RETURNING tibems-status
    END-CALL.

Note: `session`, `browser` and `queue` have usage pointer.

## Parameters

Parameter | Description
--- | ---
`session` | Create a browser in this session.
`browser` | The function stores the new browser object in this location.
`queue` | Browse this queue.
`messageSelector` | When non-null, the browser presents only messages that match this selector; see Message Selectors. When null, or the empty string, the browser views all messages in the queue.

## See Also

`tibemsQueue`

`tibemsQueueBrowser`

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