This feature is deprecated as of version 2.8.0.3 of Sentinel SIP. Its functionality is now handled by the Session Refresh Feature. |
The Max Call Duration Feature monitors the call duration and terminates the call if the maximum call time has been exceeded.
On an incoming initial ACK or when the callEstablished
session state field is true
, a timer is set.
The timer length is controlled by the MaxTimerInterval
and MaxCallDuration
parameters in the feature’s configuration.
MaxCallDuration
can be overridden with a session state value to enable unlimited call duration or a session specific max call duration.
A feature should override the MaxCallDuration
in the initial call setup phase not during mid-call.
On the expiry of the timer, the feature checks the call time against the maximum call duration.
If the maximum call time has been exceeded, LegManager.endSession
is instructed.
If not, then the timer is reset to the minimum of MaxTimerInterval
and the remaining MaxCallDuration
.
Details
Feature script name |
MaxCallDuration |
---|---|
Applicable contexts |
SIP service |
SAS Support |
No |
Prerequisite features |
N/A |
Feature execution points |
|
Timer usage |
Feature-targeted timer triggers feature directly on expiry. Does not need to be registered against SipAccess_ServiceTimer execution point. |
Session state inputs and outputs
Inputs
Name | Type | Format | Description | Behaviour if null/invalid |
---|---|---|---|---|
SentinelSelectionKey |
com.opencloud.sentinel.common.SentinelSelectionKey |
selection key |
For selecting configuration data |
Increment InputParameterErrors, |
CallEstablished |
Boolean |
|
|
Initially set to |
MaxCallDuration |
Long |
|
|
Initially set to |
Call Duration configuration
Parameter | Type | Description |
---|---|---|
MaxTimerInterval |
long |
Interval of periodic timer (ms) |
MaxCallDuration |
long |
Maximum call duration (ms) |
Statistics
Name | Description |
---|---|
CallLimitReached |
Counter incremented when the call has been ended due to reaching the maximum call duration. |