tibrvcmTransport_SetTaskBacklogLimit...()

Function

Declaration

tibrv_status tibrvcmTransport_SetTaskBacklogLimitInBytes( 
    tibrvcmTransport    cmTransport,
    tibrv_u32           limitBySizeInBytes);
tibrv_status tibrvcmTransport_SetTaskBacklogLimitInMessages( 
    tibrvcmTransport    cmTransport,
    tibrv_u32           limitByMessages);

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 either these properties, the default is no limit.

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

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

Parameter

Description

cmTransport

Set the size limit of the task queue of this distributed queue transport.

limitBySizeInBytes

Use this size limit (in bytes).

Zero is a special value, indicating no size limit.

limitByMessages

Use this message limit (number of messages).

Zero is a special value, indicating no limit on the number of messages.

See Also

tibrvcmTransport_GetTaskBacklogLimits()

Distributed Queue in TIBCO Rendezvous Concepts