Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsSession_CreateConsumer
> Function
> Purpose
> Create a message consumer.
> C Declaration
> tibems_status tibemsSession_CreateConsumer(
> tibemsSession session,
> tibemsMsgConsumer* consumer,
> tibemsDestination destination,
> const char* messageSelector,
> tibems_bool noLocal );
> COBOL Call
> CALL "tibemsSession_CreateConsumer"
> USING BY VALUE session,
> BY REFERENCE consumer,
> BY VALUE destination,
> BY REFERENCE messageSelector,
> BY VALUE noLocal,
> RETURNING tibems-status
> END-CALL.

> | session, consumer and destination have usage pointer.

> Parameters

> Parameter | Description
> session | Create the consumer in this session.
> consumer | The function stores the new consumer object in this location.
> destination | Create a consumer for this destination. The argument may be any destination (queue or topic).
> messageSelector | When non-null, the server filters messages using this selector, so the consumer receives only matching messages; see Message Selectors. When null, or the empty string, the consumer receives messages without filtering.
> noLocal | When true, the server filters messages so the consumer does not receive messages that originate locally—that is, messages sent through the same connection. When false, the consumer receives messages with local origin.

> See Also
> tibemsDestination on page 144
> tibemsMsgConsumer on page 162

Copyright © TIBCO Software Inc. All Rights Reserved