This feature converts USSD text to/from encoded forms

Feature cheat sheet

Feature Name Network Operator Data Used in PlanId(s) Stateful or Stateless POJO Feature or SBB Feature

ConvertUssiText

No

USSI

Stateless

POJO

Feature parameters

The Convert USSI Text feature supports the following parameters that may be passed in a feature execution script run statement:

Name Allowed Values Description

mode

xmlToEncoded and encodedToXml

This is used to determine what action the feature should take when run.

Session Input variables

The feature reads the following fields in Session State

Session State variable name Variable type Comments
UssdTextAsText

String

USSD text to be encoded into a byte array

UssdTextAsBytes

byte[]

Byte array to be decoded to USSD text

Session Output variables

The feature sets the following fields in Session State

Session State variable name Variable type Comments
UssdTextAsText

String

USSD text that has been decoded from a byte array

UssdTextAsBytes

byte[]

Byte array that has been encoded from USSD text

Statistics

ConvertUssiText statistics are tracked by the sentinel.ipsmgw SBB and can be found under the following parameter set in REM:
SLEE-Usage → sentinel.ipsmgw service → sentinel.ipsmgw SBB → feature → ConvertUssiText
or with rhino-stats:
"SLEE-Usage.Services.ServiceID[name=sentinel.ipsmgw,vendor=OpenCloud,version=3.1.0].SbbID[name=sentinel.ipsmgw,vendor=OpenCloud,version=3.1.0].feature.ConvertUssiText"

Name Description
Started

Incremented when the feature is started.

FailedToStart

Incremented when Sentinel encounters an error while attempting to start the feature.

IssuedWarning

Incremented when a non-fatal problem is encountered and the feature and issues a warning.

FailedDuringExecution

Incremented when a fatal problem is encountered and the feature cannot execute correctly.

TimedOut

Incremented when the feature takes too long to complete and Sentinel aborts execution.

StartedXmlToEncoded

Incremented when the feature is started in the XmlToEncoded mode

StartedEncodedToXml

Incremented when the feature is started in the EncodedToXml mode

RejectWithDefaultMessage

Incremented when the feature is started in the XmlToEncode mode and the configuration states that the feature should reject with a default message

Behaviour

This feature reads one of the two session state fields and encodes or decodes it into the other session state field. The encoding is done as GSM 7-bit.

The feature will encode or decode based on the feature parameter passed to it from the feature script.

  • When started with xmlToEncoded the feature reads from UssdTextAsText and encodes it into UssdTextAsBytes if RejectAllUssiWithDefaultErrorMessage is not set. In the event that RejectAllUssiWithDefaultErrorMessage is set the feature will instead stop Ussi conversation and a static message will be generated by another feature downstream. Also the features for ussi will not contact the HLR.

  • When started with encodedToXml the feature reads from UssdTextAsBytes and decodes it into UssdTextAsText.

Previous page Next page
Sentinel IP-SM-GW Version 3.1.0