Description

Feature name

SIPDetermineNetworkOperator

Applicable contexts

SIP service

SAS Support

No

Prerequisite Features

None

The SIP Determine Network Operator Feature sets the network operator element of the Sentinel selection key for use in the selection of: feature execution scripts, mappers, and address lists.

The feature will set the Network Operator element of the Sentinel selection key, based on the value returned by the DetermineNetworkOperator function below. This feature requires that the calling party SIP INVITE contains a ‘sentinel-network-operator’ header. If this header is not present, then the platform-configured default network operator is used.

Leg Manager inputs

Leg Name Type Format Description Behaviour if null/invalid

calledParty

InviteRequest

org.jainslee.resources.sip.SipRequest

See Easysip javadoc

INVITE sent to the called party

Runtime exception handled by feature runner

callingParty

InviteRequest

org.jainslee.resources.sip.SipRequest

See Easysip javadoc

INVITE received from the calling party

Runtime exception handled by feature runner

SIP headers

Inputs

Name Format Description Behaviour if absent

sentinel-network-operator

String

Header indicating which network operator to select use

Use default network operator.

Session state

Inputs

Name Type Format Description Behaviour if null/invalid

SentinelSelectionKey

com.opencloud.sentinel.common.SentinelSelectionKey

selection key (for example, <platform>::::)

For selecting configuration data and updating network operator field

Report featureCannotStart, featureHasFinished

Outputs

Name Type Format Description

SentinelSelectionKey

com.opencloud.sentinel.common.SentinelSelectionKey

selection key (for example, <platform>:<network>:::)

Only updated if network operator is determined

Error scenarios

Scenario Handling

No calling party available

Report featureCannotStart (invalid session state)

No called party available

Report featureCannotStart (invalid session state)

Sessionstate SentinelSelectionKey is null

Report featureCannotStart (invalid session state)

“sentinel-network-operator” SIP header present but empty

Increment CouldNotDetermineNetworkOperator, continue executing.

No “sentinel-network-operator” header, and default network operator could not be determined

Report featureFailedToExecute (invalid configuration)

Feature responses

Response Reason

featureCannotStart

Missing called or calling party, missing SentinelSelectionKey, “sentinel-network-operator” SIP header present but empty, or SessionState SentinelSelectionKey is not set.

featureHasFinished

Feature has finished

Configuration profile naming

Configuration Profile Table Name Description Profile Naming

SentinelConfigurationTable

Sentinel configuration table (contains DefaultNetworkOperator)

SentinelConfiguration

Previous page Next page
Sentinel Express Version 4.0.0