tibrvcmTransport_SetPublisherInactivityDiscardInterval()

Function

Declaration

tibrv_status tibrvcmTransport_SetPublisherInactivityDiscardInterval(
    tibrvcmTransport    cmTransport,
    tibrv_i32           timeout);

Purpose

Set a time limit after which a listening CM transport can discard state for inactive CM senders.

Remarks

The timeout value limits the time that can elapse during which such a sender does not send a message. When the elapsed time exceeds this limit, the listening transport declares the sender inactive, and discards internal state corresponding to the sender.

Warning 

We discourage programmers from using this call except to solve a very specific problem, in which a long-running CM listener program accumulates state for a large number of obsolete CM senders with non-reusable names.

Before using this call, review every subject for which the CM transport has a listener; ensure that only CM senders with non-reusable names send to those subjects. (If senders with reusable names send messages to such subjects, the listening transport can discard their state, and incorrect behavior can result.)

Parameter

Description

cmTransport

Set the inactivity discard interval of this transport.

timeout

Use this time limit (in whole seconds). The time limit must be non-negative.