TibrvCmQueueTransport::setTaskBacklogLimit...()

Method

Declaration

TibrvStatus setTaskBacklogLimitInBytes(
    tibrv_u32    byteLimit);
TibrvStatus setTaskBacklogLimitInMessages(
    tibrv_u32    msgLimit);

Purpose

Set the scheduler task queue limits of a distributed queue transport.

Remarks

The scheduler stores tasks in a queue. These properties limit the maximum size of that queue—by number of bytes or number of messages (or both). When no value is set for these properties, the default is no limit.

When the task messages in the queue exceed either of these limits, Rendezvous software deletes new inbound task messages.

Programs may call each of these methods at most once. Those calls must occur before the transport assumes the scheduler role; after a transport acts as a scheduler, these values are fixed, and subsequent attempts to change them result in status code TIBRV_NOT_PERMITTED.

Parameter	Description
byteLimit	Use this size limit (in bytes). Zero is a special value, indicating no size limit.
msgLimit	Use this message limit (number of messages). Zero is a special value, indicating no limit on the number of messages.

See Also

Distributed Queue, in TIBCO Rendezvous Concepts