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.