Warning 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

Pre

SipAccess_SipRequest SipEndSession

Post

SipAccess_SipResponse

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 example, <platform>::::

For selecting configuration data

Increment InputParameterErrors,
common cleanup actions

CallEstablished

Boolean

true or false

true if the session has been established

Initially set to false.

MaxCallDuration

Long

null or a value greater than or equal to 0

null value feature will use configuration data. 0 value feature will be disabled for unlimited call length. Greater than 0 will set the Maximum call duration (ms)

Initially set to null a value less than 0 will be ignored.

Feature responses

Response Reason

featureHasFinished

feature has finished

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.

Previous page Next page
Sentinel Express Version 3.1.0