Professional Documents
Culture Documents
Comviva SMSRouterv5 0 UMv1 0 1
Comviva SMSRouterv5 0 UMv1 0 1
0
User Manual v 1.0
Reference: SMSRouter-5.0-UM -1.1
Confidentiality Statement
Copyright 2009-2010, Comviva Technologies Ltd. All rights reserved. This product or document may
not, in whole or in part, be copied, photocopied, reproduced, translated, or reduced to any electronic
medium or machine readable form, by any means electronic, mechanical, photographic, optic recording or
otherwise without prior consent, in writing, of the copyright owner. Statutory declaration under section 52A
of the Copyright Act 1957.
iii
Contents
1 Document Overview ................................................................................................................... 1 - 1
1.1 Scope .................................................................................................................................... 1 - 1
1.2 Audience ............................................................................................................................... 1 - 1
1.3 Organization ......................................................................................................................... 1 - 1
1.4 Conventions ......................................................................................................................... 1 - 2
1.5 Acronyms and Abbreviations ............................................................................................. 1 - 3
1.6 References ............................................................................................................................ 1 - 5
1.7 Feedback .............................................................................................................................. 1 - 6
2 Overview...................................................................................................................................... 2 - 1
2.1 SMS ....................................................................................................................................... 2 - 1
2.2 SMSRouter ............................................................................................................................ 2 - 1
2.3 Network Architecture ........................................................................................................... 2 - 1
2.4 System Architecture ............................................................................................................ 2 - 3
2.5 Messaging Types ................................................................................................................. 2 - 5
3 SMSRouter Web Operations...................................................................................................... 3 - 1
3.1 Application Access .............................................................................................................. 3 - 1
3.2 User Management ................................................................................................................ 3 - 3
3.2.1 Provisioning Users .............................................................................................................................. 3 -3
3.2.2 Modifying Passwords ........................................................................................................................ 3 -10
vi
vii
viii
ix
xiN
xii
Figures
Figure 2-1: Network Architecture................................................................................................. 2 - 2
Figure 2-2: System Architecture ................................................................................................. 2 - 4
Figure 3-1: Login ........................................................................................................................... 3 - 2
Figure 3-2: Home Page ................................................................................................................. 3 - 2
Figure 3-3: Menu Map.................................................................................................................... 3 - 3
Figure 3-4: View Users .................................................................................................................. 3 - 4
Figure 3-5: Add User ..................................................................................................................... 3 - 5
Figure 3-6: User Details - Edit ...................................................................................................... 3 - 8
Figure 3-7: Edit User ..................................................................................................................... 3 - 8
Figure 3-8: User Details - Delete .................................................................................................. 3 - 9
Figure 3-9: User Successfully Deleted ........................................................................................ 3 - 9
Figure 3-10: Change Password .................................................................................................. 3 - 10
Figure 3-11: Password Successfully Changed......................................................................... 3 - 10
Figure 3-12: Logout ..................................................................................................................... 3 - 11
Figure 3-13: SMSRouter Manuals .............................................................................................. 3 - 11
Figure 3-14: Office Locations ..................................................................................................... 3 - 12
Figure 3-15: About....................................................................................................................... 3 - 13
Figure 4-1: MO-MT Messaging - Direct Delivery ........................................................................ 4 - 1
Figure 4-2: MO-MT Messaging Redirection ............................................................................. 4 - 2
Figure 4-3: Service Parameter...................................................................................................... 4 - 7
Figure 4-4: Nick Name................................................................................................................. 4 - 12
Figure 4-5: Add Nick Name......................................................................................................... 4 - 13
Figure 4-6: Nick Name................................................................................................................. 4 - 13
Figure 4-7: Add Closed User Group .......................................................................................... 4 - 14
Figure 4-8: Closed User Group List ........................................................................................... 4 - 15
Figure 4-9: Closed User Group ..................................................................................................4 - 16
Figure 4-10: LI Groups List......................................................................................................... 4 - 17
Figure 4-11: Add Lawful Interception Groups .......................................................................... 4 - 17
Figure 4-12: LI Group .................................................................................................................. 4 - 18
Figure 4-13: Rules List ................................................................................................................ 4 - 25
Figure 4-14: MT - FSM Failure ................................................................................................... 4 - 25
Figure 4-15: Rules List ................................................................................................................ 4 - 29
Figure 4-16: SRISM Failure ......................................................................................................... 4 - 30
Figure 4-17: Rules List ................................................................................................................ 4 - 31
Figure 4-18: Source VMSC Redirection..................................................................................... 4 - 31
Figure 4-19: Rules List ................................................................................................................ 4 - 33
Figure 4-20: Source MSISDN and Source TON-NPI Combination Redirection ...................... 4 - 33
Figure 4-21: Rules List ................................................................................................................ 4 - 35
Figure 4-22: Destination MSISDN and Destination TON NPI Combination Redirection ....... 4 - 35
Figure 4-23: Rules List ................................................................................................................ 4 - 37
Figure 4-24: Source MSISDN Based Redirection ..................................................................... 4 - 38
Figure 4-25: Rules List ................................................................................................................ 4 - 39
Figure 4-26: Destination MSISDN Based Redirection .............................................................. 4 - 40
Figure 4-27: Rules List ................................................................................................................ 4 - 41
Figure 4-28: Source and Destination MSISDN Combination Redirection .............................. 4 - 42
Figure 4-29: Rules List ................................................................................................................ 4 - 44
Figure 4-30: TBR (Daily).............................................................................................................. 4 - 44
Figure 4-31: TBR (Weekly) .......................................................................................................... 4 - 44
Figure 4-32: TBR (Monthly)......................................................................................................... 4 - 45
Figure 4-33:TBR (Yearly)............................................................................................................. 4 - 45
Figure 4-34: Rule Already Exists................................................................................................ 4 - 48
xiii
xviii
Tables
Table 1-1: Conventions ................................................................................................................ 1 - 2
Table 1-2: Acronyms & Abbreviations ....................................................................................... 1 - 3
Table 2-1: Messaging Types ........................................................................................................ 2 - 6
Table 3-1: View User Details ........................................................................................................ 3 - 4
Table 3-2: Add User ...................................................................................................................... 3 - 6
Table 4-1: Service Parameter ...................................................................................................... 4 - 8
Table 4-2: View Nick Name ........................................................................................................ 4 - 12
Table 4-3: Add Closed User Group ........................................................................................... 4 - 14
Table 4-4: Closed User Group ................................................................................................... 4 - 15
Table 4-5: LI Groups List ........................................................................................................... 4 - 17
Table 4-6: Rules Definition ........................................................................................................ 4 - 19
Table 4-7: MTFSM Failure ......................................................................................................... 4 - 25
Table 4-8: Error Description ...................................................................................................... 4 - 27
Table 4-9: Source VMSC Redirection ....................................................................................... 4 - 31
Table 4-10: Source MSISDN and Source TON-NPI Combination Redirection ...................... 4 - 34
Table 4-11: Destination MSISDN and Destination TON NPI Combination Redirection ........ 4 - 36
Table 4-12: Source MSISDN Based Redirection ...................................................................... 4 - 38
Table 4-13: Destination MSISDN Based Redirection ............................................................... 4 - 40
Table 4-14: Source and Destination MSISDN Combination Redirection ............................... 4 - 42
Table 4-15: Time Based Rule ..................................................................................................... 4 - 46
Table 4-16: PID Redirection ....................................................................................................... 4 - 49
Table 4-17: Source MSISDN Barring ........................................................................................ 4 - 53
Table 4-18: Source VMSC Barring ............................................................................................ 4 - 59
Table 4-19: LI Groups List ......................................................................................................... 4 - 68
Table 4-20: Lawful Interception ................................................................................................ 4 - 71
Table 5-1: Rules Definition .......................................................................................................... 5 - 8
Table 5-2: Sender Alpha Numeric Barring ............................................................................... 5 - 15
Table 5-3: PID Redirection ........................................................................................................ 5 - 27
Table 5-4: Destination MSISDN and Destination TON NPI Combination Redirection .......... 5 - 28
Table 5-5: MTFSM Failure .......................................................................................................... 5 - 31
Table 5-6: Error Description ...................................................................................................... 5 - 33
Table 5-7: Destination MSISDN Based Redirection ................................................................. 5 - 39
Table 5-8: Retry Policy ............................................................................................................... 5 - 41
Table 5-9: Add New Account ..................................................................................................... 5 - 46
Table 5-10: Service Numbers .................................................................................................... 5 - 67
Table 5-11: Service Numbers .................................................................................................... 5 - 72
Table 6-1: Service Parameter ...................................................................................................... 6 - 5
Table 6-2: Rules Definition .......................................................................................................... 6 - 8
Table 6-3: Add VMSC Redirection ............................................................................................. 6 - 12
Table 6-4: Source MSISDN and Source TON-NPI Combination Redirection ....................... 6 - 14
Table 6-5: Source MSISDN Based Redirection ........................................................................ 6 - 16
xix
xx
xxi
xxii
1 Document Overview
1.1 Scope
SMSRouter is an end-to-end messaging platform, which operates in the GSM network. SMSRouter
processes huge volumes of message traffic thereby resulting in network optimization and improved
delivery efficiency.
This manual explains the functionality, features and architecture of SMSRouter. The manual is for
users who would be operating the application.
Note
This is a generic product user manual and covers
all the features of the current version. However,
only the features proposed in the RFP would be
provided.
1.2 Audience
The manual is intended for the System Administrators and Operators of SMSRouter It is assumed that
the audience is familiar with:
Web Browser operations
Navigation of windows
Basic telecommunication concepts
Messaging concepts
1.3 Organization
This manual is organized as follows:
Chapter 1- Document Overview: This chapter explains the scope and audience
profile of the manual.
Chapter 2 - Overview: This chapter gives an overview about SMSRouter and its
functionality.
Chapter 4 Mobile -to- Mobile Messaging: This chapter explains the call flow and
features of SMSRouter in case of mobile to mobile messaging.
Document Overview
1-1
1.4 Conventions
The set of writing conventions used to highlight and distinguish different information types is listed below:
Information
Window/Screen/Button/Icon/
Menu/Field Names
Convention
All names as seen in the
applications are written in bold
Click
OK to continue.
The
Enter
Names of Files/Sections/
Documents/Folders/Fields/
Parameters
Files/Sections/Documents/
Folders/Fields/Parameters
names are written in Italics
Refer to Information.doc for
details.
Text to be Entered/Commands/
Code
Output text
Key presses
Source: Comviva
1-2
Document Overview
Note
Check
Warning
Document Overview
Acronym
Expansion
AO-SM
Application Originated-Short
Message
MO-MT
Mobile Originated-Mobile
Terminated
MO-AT
Mobile Originated-Application
Terminated
AO-MT
Application Originated-Mobile
Terminated
AO-AT
AT-SM
Application Terminated-Short
Message
BSC
ESME
FSM
DDA
1 - 3N
1-4
Acronym
Expansion
GMSC
VMSC
GSM
HLR
IWMSC
MAP
MIN
MO-SM
Mobile-Originated Short
Message
MS
Mobile Station
MSC
FSM
MT-SM
Mobile-Terminated Short
Message
SMD-PP
SM
Short Message
SMS
SME
SMSC
SMPP
SMTP
SS7
Signaling System 7
UCP
Document Overview
Acronym
Expansion
VLR
MT-FSM
MOR
SRI
MTS
RE
Rule Engine
NDC
MSISDN
NPI
IMSI
PID
Protocol Identification
PLMN
TON
Type of Number
NPI
SRIFSM
VPS
CC
Country Code
Source: Comviva
1.6 References
GSM 01.04: "Digital cellular telecommunication system (Phase 2+); Abbreviations and
acronyms".
GSM 03.40 (ETS 300 536): "Digital cellular telecommunication system (Phase 2); Technical
1 - 5N
GSM 03.47 (ETR 354): "Digital cellular telecommunication system; Example protocol stacks for
(MAP) specification".
CCITT Recommendation E.164 (Blue Book): "Numbering plan for the ISDN era".
CCITT Recommendation E.163 (Blue Book): "Numbering plan for the international telephone
service".
CCITT Recommendation X.208: "Specification of basic encoding rules for Abstract Syntax
1.7 Feedback
It is our goal to provide you with accurate, timely and useful documentation. Send your comments, suggestions and feedback to techwriters@comviva.com.
1-6
Document Overview
2 Overview
2.1 SMS
Short Message Service (SMS) is a globally accepted communication protocol that enables
transmission of text, alphanumeric, flash, and binary messages between two mobile phones and
between the mobile phone and the application.
SMS offers the following benefits to the network Operators:
Increased call completion on wireless and wire-line networks by leveraging the notification
capabilities of SMS
Alternative to alphanumeric paging services
Provisioning of value added services such as e-mail, voicemail and fax mail integration,
provisioning
2.2 SMSRouter
The increase in short message traffic is forcing the Operators to look for alternatives because the
conventional store and forward mode of messaging and the static entry or exit architecture of SMSCs
are not feasible to handle large message volumes. This results in low QoS (Quality of Service).
The solution to this problem is to have intelligent message routing and load balancing algorithms that
are configurable on the fly. SMSRouter enables the Operators to add value to the network by offering
message routing with a click of a button and analyze message details to intelligently route messages.
The SMSRouter solution augments the SMS capacity by reducing expenditure on expensive SMSC
licenses and hardware upgrades for the point-based SMSC installations.
SMSRouter enables the exchange of messages between applications and mobile phones. The
application that connects to SMSRouter to send or receive messages is known as an External Short
Messaging Entity (ESME).
Typical examples of ESMEs are systems that send automated marketing messages to mobile users
and voting systems that process SMS votes. Tele-voting has been most popularly linked with popular
TV shows such as American Idol and other similar competitions around the world.
Release 4.0 of the SMSRouter application supports two types of features: Built-in features and
Configurable features. Built-in features are embedded in the system logic and cannot be modified.
Configurable features can be created and modified by the user. Configurable features are configured
using the SMSRouter GUI.
Overview
2-1
The mobile originated short messages are routed from the MSC to SMSRouter over SS7 or Sigtran.
SMSRouter validates the messages against the rules configured in the system. After the validation checks,
messages are queued in the Hauler for further processing. SMSRouter sends an acknowledgement to
subscribers after the messages are stored in the DB module. It sends an SRIFSM request to the HLR to
retrieve the VMSC and IMSI information of the destination mobiles and attempts to deliver the messages
using MTFSM. SMSRouter may either interface with another MSC directly over SS7 or use SIGTRAN for
tunneling messages over IP to a capable Signal Transfer Point (STP). If temporary delivery failure occurs,
the messages are routed to any of the legacy SMSCs (Fallback SMSCs) or to peer SMSRouter nodes over
SMPP or UCP or CIMD. Messages can also be forwarded to Comvivas SMSC (Comvivas SMSC can also
act as a legacy SMSC) for further retry attempts over the proprietary interface. The Fallback SMSC retries
message delivery as per the retry policy. If the Delivery report option is enabled for the subscribers,
SMSRouter collects the Delivery report and forwards it to subscribers. The Delivery reports are queued in
for collection. The reports are collected in a FIFO manner.
The flow of mobile originated messages is as follows:
Message is sent from the mobile to the MSC.
MSC routes the message to SMSRouter.
SMSRouter makes a Direct Delivery Attempt (DDA) to the destination mobile.
If the DDA succeeds, a Delivery report is generated and sent to the sender mobile.
If the DDA fails, SMSRouter stores the message in its secondary memory. Message delivery is
retried based on the retry policy configured for the destination number or account ID.
Messages can also be forwarded to the Fallback SMSC.
2-2
Overview
Based on the rules configured in the system, SMSRouter may not attempt to directly deliver the
received messages. In such cases, it forwards the messages to the attached legacy SMSCs in
the network over IP or SS7 or proprietary protocols or to Comvivas SMSC (over the proprietary
protocol) for further delivery.
All the AO messages are sent to SMSRouter through SMPP or CIMD or UCP. The flow of application originated messages is as follows:
ESME forwards the messages to SMSRouter over SMPP or UCP or CIMD.
SMSRouter makes a Direct Delivery Attempt (DDA) to the destination mobile.
If the DDA succeeds, a Delivery report is generated and sent to the ESME client.
If the DDA fails, SMSRouter stores the message in its secondary memory. Message delivery is
retried based on the retry policy configured for the destination number or account ID.
Messages can also be forwarded to the Fallback SMSC.
Based on the rules configured in the system, SMSRouter may not attempt to directly deliver the
received messages. In such cases, it forwards the messages to the attached legacy SMSCs in
the network over IP or SS7 or proprietary protocols or to Comvivas SMSC (over the proprietary
protocol) for further delivery.
If the ESME has registered for a Delivery report, the Delivery report is sent to the ESME in the
Overview
2 - 3N
VMSC of the destination MSISDNs. After receiving a SRI response, the SRI module checks the
IMSI and VMSC against the barring rules (configured in the system). The valid messages are
forwarded to the MTS module for further processing.
MTS Module: The MTS module makes an attempt to deliver the messages (updated with the
IMSI and VMSC of the destination MSISDNs) received from the SRI module. On the basis of
the results of the delivery attempt, MTS sends a Delivery report to the message sender or
2-4
Overview
redirects or re-attempts the delivery of the message based on the rules configured in the
system.
Redirection (RR) Module: The RR module receives the messages redirected from the other
SMSRouter modules (MOR, SRI and MTS). This module communicates with the Rule Engine
(RE) to check whether or not the configured legacy SMSC is connected to SMSRouter. If the
SMSC is connected, the Rule Engine returns socket information for message delivery. The
messages are updated with the relevant socket information and forwarded to SMPP Client for
further processing.
DB Module: The DB module uses intelligent retry mechanisms to schedule delivery attempt of
messages, which are not delivered due to temporary or permanent errors. The module stores
the messages received from the different modules in the database. On the basis of the retry
policies configured in the system, SMSRouter retries to deliver the stored messages. The DB
module also pulls messages from the database and forwards them to the SRI module for
further processing.
CRM Module: In a cluster setup, the CRM module routes application-terminated messages to
peer SMSRouter nodes. In this setup, ESMEs can connect to any of nodes using the load
balancer. The CRM module routes messages to the node, on which the destination ESME is
connected. If the ESME is not connected to any node, the CRM module forwards the
messages to the DB module, which stores messages in the database.
Log Server: The Log server receives log packets from all the modules and writes log data to log
files.
Rule Engine: The Rule Engine controls the flow of messages in SMSRouter. The Rule Engine
loads or reloads all the rules from the database to the system memory. It interacts with all the
modules (MOR, SRI, MTS, and RR) to check whether rules need to be updated or changed
whenever the rules are changed through the SMSRouter GUI. If rules are changed, the GUI
sends a UDP signal to the Rule Engine. The Rule Engine updates the changes in the relevant
modules.
ESME Client: ESME Clients receive messages (that contain SMSC details) from the RR
module. The ESME Client transmits messages to the external Fallback SMSC configured in the
system over SMPP/UCP for further processing. The ESME Client maintains connection with
the SMSC for message transmission.
ESME Server: The external ESME Clients interact with the ESME server over SMPP/UCP. The
ESME server receives messages from the external ESME Clients and forwards these
messages to the SRI module for further processing. The ESME server delivers Application
Terminated messages to the external ESME Clients.
Stack: The MAP stack maintains connectivity between SMSRouter and SS7 network. The MAP
stack is configured to interact with SS7 network over LSL/HSL/M3UA/SUA links. In a clustered
setup, the stack distributes the messages in a round robin manner to distribute load evenly
among the multiple SMSRouter applications connected to it.
Signaling Server: The Signaling server acts as an interface between SMSRouter and the MAP
stack.
MySQL Database: The MySQL database is used to store all the configuration, statistics and
rule information. MySQL is also used for storing messages that need to be retried.
2 - 5N
The following table briefly describes the different message types handled by SMSRouter:
Message Type
Definition
MO-MT Messaging
AO-MT Messaging
AO-MT Messaging
AO-AT Messaging
Application originated
Application Terminated
messages. This is a very rare
situation in a live network.
Source: Comviva
The call flow and the features supported in each messaging type are discussed in the subsequent
sections. Messages are handled in four different ways:
Direct Delivery Attempt: SMSRouter tries to deliver messages in the first attempt before opting
for the conventional store and forward mode of message delivery. This enhances throughput
capabilities for message handling and optimizes the usage of the SMSRouter network.
Store & Forward (S&F): SMSRouter and SMSC functionalities can be combined together to
support the store & forward mode of message delivery. The message delivery takes place
through one of the two modes listed below:
Direct
If
AO messages have the store and forward flag enabled, the messages are stored in
the secondary memory of SMSRouter before attempting message delivery. If the
message cannot be delivered in the first attempt, the message delivery is reattempted
based on the retry policy configured for the destination account.
2-6
Overview
If S&F flag is not enabled in a message, SMSRouter attempts to deliver the message
before storing the message for future delivery. The Operator can enable the S&F flag for
specific accounts. The S&F flag is enabled for non-critical messages. The Direct Delivery
Attempt flag is enabled for critical messages.
DDA Failure Forwarding: If a message cannot be delivered in the first attempt, the message is
forwarded to a Fallback SMSC configured in the system. The Fallback SMSC takes care of the
message delivery attempts and the handling of Delivery reports. Message forwarding is based
on the rules defined in SMSRouter.
Message Forwarding: SMSRouter can be configured to forward messages to other entities
(STP, SMSC, SMS Hub) based on redirection rules and generic interfaces.
Overview
2 - 7N
2-8
Overview
Note
System Administrators can create any number of
super and customized users.
After configuring the Web server (refer to the SMSRouter Installation Manual for details on Web server
configuration) with an IP address and port number, you can access the application and administer
SMSRouter services.
To access and log on to the SMSRouter application:
Start the Browser (Internet Explorer or Mozilla Firefox).
Type the following URL in the Address bar:
Note
URL is the IP address of the Linux server where
SMSRouter is installed.
3-1
GUI.
Click Login.
The System Administrator can access all the available menu options:
3-2
Viewing Users
SMSRouter Web Operations
3 - 3N
This option is used to view details of the users who can access the SMSRouter application.
To view existing user details:
User Management > Provision Users
The following table lists the fields of the User Details screen:
Field
Description
Validation
NA
Account Status
NA
Active
Inactive
Account Type
NA
Type of user:
Super
user
Customized
user
Activation Date
NA
Expiry Date
NA
Edit Privileges
NA
Delete
NA
Source: Comviva
3-4
Adding Users
The Add User option is used to create Super users and Customized users in the system.
Note
Multiple super user and customized users can be
created.
To add a user:
User Management > Provision Users > Add User
The following table lists the fields of the Add User screen:
3 - 5N
Field
Description
Validation
User Name*
Should
Alphanumeric
Special
characters (, *, #)
except for the underscore are
not allowed.
Password*
Should
Minimum
Maximum
Confirm Password*
Account Type
two characters
nine characters
Same as password
Type of user:
NA
Super
user
Customized
user
Date of Activation*
NA
Date of Expiry*
NA
Account Status
NA
Active
Inactive
Source: Comviva
Note
User Privileges and Clear are disabled on selecting
Super User as the account type.
Select the date of activating the user account in Date of Activation.
Select the date of expiry of the user account in Date of Expiry.
Select Active to activate the account or select Inactive to deactivate the account.
3-6
Management
Virtual
Service Center
Networks
IMSI
Network
Service
Parameters
Address
Nick
Closed
Rules
Translation
Name
User Groups
Management
Redirection
Accounts
Redirection
List
Rules
Configuration
Canned
Retry
ESME
Message
Policy
Management
ESME
Accounts
Distribution
List
Ports
Service
Performance
Numbers
Analysis
Statistics
Redirection
Network
VMSC
IMSI
Statistics
Statistics
Account
Statistics
Network
Statistics
Live
Message
statistics
Management
Query
User
Statistics
Statistics
Status
Management
Change
Password
Or
Click Clear to reset the fields.
Or
Click Cancel to return to the User Details screen.
3 - 7N
Modifying Users
The System Administrator can modify the access privileges of existing users.
To modify user access privileges:
User Management > Provision Users
3-8
Note
You cannot edit User Name, Password, and Date
of Activation.
Deleting Users
This option is used to delete super and customized user accounts.
To delete a user account:
User Management > Provision Users
Click Delete to delete a given user account. A pop-up window appears to reconfirm the
operation.
Click OK.
3 - 9N
3 - 10
Click Logout.
3 - 11N
Contact Us
The screen displays Comviva office addresses in different parts of the world.
3 - 13N
3 - 14
1. The Short Message (SM) from the Originating Mobile Station (MS) goes to the Mobile
Service Center (MSC).
2. MSC sends the SM to SMSRouter using the Forward Short Message (FSM) operation.
3. SMSRouter sends an acknowledgement to the MSC.
Mobile -to- Mobile Messaging
4-1
4.
5.
6.
7.
1. The Short Message (SM) from the Originating Mobile Station (MS) goes to the Mobile
Service Center (MSC).
2. MSC sends SM to SMSRouter using the Forward Short Message (FSM) operation.
4-2
Temporary
Permanent
Note
A Delivery report is sent only when the report is
requested for, irrespective of the success or failure
of message delivery.
4 - 3N
specification) SMSRouter splits the message into several parts and delivers the message.
Each message is spilt in two parts:
User
Actual
Picture Messages and Operator Logo: Operator logos are graphic images that are displayed on
a phone when the phone enters a GSM network. An Operator logo is identified by the country
code and mobile network code. GSM handsets supporting this technology store multiple
images at a time. When a handset moves between networks, the mobile displays the logo of
the current Operator. SMSRouter supports streaming of picture messages using appropriate
Data Coding Scheme (DCS) or User Data Header (UDH) values.
Ring Tones: Ring tones are played when the GSM phone rings. Ring tones can be composed
using an editor and sent as SMS messages. SMSRouter supports streaming of ring tones
using appropriate DCS or UDH values.
V Card: V Card defines the format of electronic business cards. All the devices supporting V
Card can exchange information such as phone numbers and addresses. SMSRouter supports
streaming of these messages.
4-4
Note
The maximum buffer size is based on the operating
system and hardware memory constraints.
4 - 5N
4-6
4 - 7N
Field
Blocking of Delivery
Report
Description
Used to enable or disable
Delivery reports. Select to stop
the generation of Delivery
reports.
Validations
NA
NA
NA
Numeric
Minimum
4-8
Route Application
Terminated Message
NA
Numeric
Maximum length of MO
messages.
Numeric
NA
Flash Message
Alphanumeric
Maximum
length is 10 characters
Field
Translation Type
Description
Indicates the type of translation
for Global Title translation.
Values can be:
0
Validations
NA
- Unknown
[1-63]:InternationalServices
Numbering Plan(NP)
255 - Reserved
NA
E164
X121
TELEX
NATIONAL
PRIVATE
Internet
IP
EXTENSION
NA
NA
4 - 9N
Field
Description
Validations
NA
Presentation SC
NA
Source: Comviva
4 - 10
The Nick Name option enables the Operator to create the nicknames for source MSISDNs. The nickname
replaces the source MSISDNs while delivering messages.
For example, the CLI from which stock alerts are sent to the subscribers is masked as National Stock
Exchange (NSE).
Viewing Nicknames
This option is used to view the following:
Masked MSISDNs
Nicknames assigned to the MSISDNs
Type of Number (TON) of a MSISDN. TON can be of the following types:
International:
International TON implies that the number starts with the Country Code
followed by the National Destination Code and the subscriber number.
National:
National TON implies that the number starts with the country code followed
by the National Destination Code and the subscriber number.
Network
Specific: Network specific TONs starts with the network specific code followed
by the MSISDN. Refer to GSM 03.40, Technical realization of the Short Message
Service Specifications for details.
Subscriber:
Subscriber TONs starts without the international and national codes. Refer
to GSM 03.40, Technical realization of the Short Message Service Specifications for
details.
Alphanumeric:
Abbreviated:
Extension:
Numbering Plan Indicator (NPI) of the MSISDN. NPI can be of the following types:
E164
X121
TELEX
NATIONAL
PRIVATE
Internet
IP
EXTENSION
4 - 11N
The following table lists the fields of the Nick Name screen:
Field
Description
Validation
Number
NA
Length
NA
Nick Name
NA
TON
NA
NPI
NA
Source/Destination
NA
Edit
NA
Delete
NA
Source: Comviva
To view the nickname assigned to a particular MSISDN, enter the MSISDN in Number and click
Search.
By default, 25 rows are displayed on the screen. You can change the number of rows that can
be displayed on a page. Specify the number of rows to be displayed in a single page in No. of
Rows/Page and click Go.
Adding Nicknames
The Add Nick Name option enables the Operator to add nicknames to the source MSISDNs.
To add nicknames:
4 - 12
Note
For field descriptions, refer to View Nick Name
table.
Enter the MSISDN whose CLI needs to be masked in Source Number.
Select the type of number. Number can be source or destination.
Assign a nick name to the MSISDN in Nick Name.
Select the TON of the MSISDN from Replace TON drop-down list.
Select the NPI of the MSISDN from Replace NPI drop-down list.
Click Done to save changes.
4 - 13N
Click Delete to delete the nickname. A dialog box pops-up to re-confirm the operation.
Click OK.
The following table lists the fields of the Add Closed User Group screen:
Field
Group Name
4 - 14
Description
Name of the group.
Validation
NA
Field
Description
Validation
Application Terminated
NA
Mobile Numbers
Field
Description
Validation
Group Name
NA
Group Numbers
NA
Edit
NA
Delete
NA
Source: Comviva
4 - 15N
Click Delete to delete a given group. A dialog box pops-up to re-confirm the operation.
Click OK to delete the group.
4 - 16
The following table lists the fields of the LI Groups List screen:
Field
Description
Validation
Group Name
NA
Group Number
NA
Edit
NA
Delete
NA
Source: Comviva
4 - 17N
Click Delete to delete a given group. A pop-up window appears to reconfirm the operation.
Click OK to delete the group.
4 - 18
Rule
Definition
Scenarios/Examples
Subscriber A (+919810012345)
is not charged for sending
message from VMSC
+919811012439. The same
subscriber is charged for sending
message when roaming in the
VMSC +919811012437.
4 - 19N
Rule
Source and Destination
Combination MSISDN
Redirection
Definition
Redirects all messages
originating from a given source
MSISDN/MSISDN series to a
given MSISDN/MSISDN series
to a Redirection list.
Scenarios/Examples
Sigmatel SMSRouter delivers the
local SMS messages from
subscribers directly whereas,
international SMS messages are
redirected to the SMSC.
Exmaple: Sigmatel can redirect
messages sent from the
MSISDN series 919845
(MSISDN series of Circle A) to
the MSISDN series
919741(MSISDN series of
country B) to a Fallback SMSC
through TCP/IP.
This helps Sigmatel to avoid
usage of international
(international links are costlier)
links.
4 - 20
Rule
Definition
Scenarios/Examples
Lawful Interception
PID Barring
MT-FSM Failure
PID Redirection
4 - 21N
Rule
Definition
The
redirection is periodic:
Daily:
Weekly:
Monthly:
Yearly:
4 - 22
Scenarios/Examples
SRI-SM Failure
Rule
Definition
Scenarios/Examples
MO Relay
4 - 23N
Note
For information on rules, refer to Rules Definition
4 - 24
The following table lists the fields of the Add Rule screen:
Field
Rule Type*
Description
Name of the rule to be
configured.
Validation
NA
4 - 25N
Field
Error Desc*
Description
Network errors defined for a MT
message:
Absent
Call
SS
NA
Subscriber
Barred
Incompatibility
Facility
not supported
Subscriber
SM-Delivery
Message
System
Data
Failure
missing
Absent
Busy
Failure
Unexpected
No
Validation
data value
subscriber
subscriber reply
Numeric
System ID
NA
Action*
Action to be taken:
NA
Destination MSISDN
Maximum
length is 15 digits
NA
Rule Status*
NA
Active:
Inactive:
Select Inactive to
deactivate the rule.
Reason
4 - 26
Field
Description
Validation
Source: Comviva
Error
Description
Absent Subscriber
Call Barred
SS Incompatibility
Mobile-Terminated Short
Message Transfer (MT-SMS)
cannot be completed due to one
of the following reasons:
Delivery
System Failure
4 - 27N
Error
Description
Data Missing
Busy subscriber
Subscriber is busy.
No subscriber reply
Absent Subscriber
MSISDN or MSISDN series (specified in Destination MSISDN) are either redirected or retried.
It is an optional parameter.
Note
It is mandatory to enter either the Destination
MSISDN or to select the system ID of the ESME
account.
Select the action to be taken:
Redirect:
Retry:
SRI-SM Rules
4 - 28
SMSRouter sends the following two types of requests to the GSM network:
Send Routing Information (SRI) request is sent to HLR to retrieve the IMSI and VMSC details of
message.
If the SRI response during MO-MT messaging is negative, this rule redirects messages to a Fallback
SMSC defined in the Redirection list.
Note
For information on rules, refer to Rules Definition.
4 - 29N
Note
For more information on field descriptions and how
to configure the rule refer to MT-FSM Failure Rules.
Note
For information on rules, refer to Rules Definition.
4 - 30
The following table lists the fields of the Add Rule screen:
Field
Rule Type*
Description
Name of the rule to be
configured.
Validation
NA
4 - 31N
Field
Description
Validation
Action*
NA
Redirection List *
NA
Rule Status*
NA
Reason
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
4 - 32
Note
For information on rules refer to Rules Definition.
To configure source MSISDN and source TON NPI -based redirection rules:
Rules Management>Rules Configuration
4 - 33N
The following table lists the fields of the Add Rule screen:
Field
Description
Validation
Rule Type*
NA
Source MSISDN *
Source TON *
NA
Source NPI *
NA
Min Length *
Action*
NA
Redirection List *
NA
Rule Status*
NA
Reason
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
4 - 34
Note
For information on rules , refer to Rules
Definition.
Figure 4-22: Destination MSISDN and Destination TON NPI Combination Redirection
4 - 35N
Table 4-11: Destination MSISDN and Destination TON NPI Combination Redirection
Field
Description
Validation
Rule Type*
NA
Destination MSISDN *
Destination TON *
NA
Destination NPI *
NA
Min Length *
Action*
NA
Redirection List *
NA
Rule Status*
NA
Reason
Note
For more information on how to configure the rule,
refer to Source MSISDN and Source TON & NPIbased Redirection Rules.
Click Done to save the changes.
4 - 36
can use the following combination to create and configure rules to effectively utilize the configured
Fallback SMSCs/SMSRouter:
Source MSISDN
Destination MSISDN
Source and Destination MSISDN
Note
For information on rules, refer to Rules Definition.
4 - 37N
The following table lists the fields of the Add Rule screen:
Field
Description
Validation
Rule Type*
NA
Source MSISDN *
Numeric
Action*
NA
Redirection List*
NA
Rule Status*
NA
Reason
Maximum
length is 15 digits
Source: Comviva
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
4 - 38
Active:
Inactive:
Note
For information on rules, refer to Rules Definition.
4 - 39N
Field
Description
Validation
Rule Type*
NA
Numeric
Action*
NA
Redirection List*
NA
Rule Status*
NA
Reason
Maximum
length is 15 digits
Source: Comviva
Note
For more information on how to configure the rule,
refer to Source MSISDN Based Redirection
(SMBR) Rules.
4 - 40
Note
For information on, refer to Rules Definition.
To configure source and destination based redirection rules:
Type list.
4 - 41N
The following table lists the fields of the Add Rule screen:
Field
Description
Validation
Rule Type*
NA
Source MSISDN *
NA
Destination MSISDN *
NA
Action*
NA
Redirection List
NA
Rule Status*
NA
Reason
4 - 42
Select Redirect from the Action list to redirect messages to the Fallback SMSC selected in
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Note
For information on rules, refer to Rules
Definition.
To configure time-based redirection rules:
Rules Management>Rules Configuration
4 - 43N
The Add Rule screen changes as per the Time Frequency selected as shown below:
4 - 44
The following table lists the fields of the Add Rule screen:
Mobile -to- Mobile Messaging
4 - 45N
Field
Description
Validation
Rule Type*
NA
Source MSISDN
Numeric
Numeric
Time Duration*
Time
Time Frequency*
Frequency of message
redirection:
NA
Destination MSISDN
Maximum
Maximum
length is 15 digits
length is 15 digits
Daily
Weekly
Monthly
Yearly
Week Days*
The
Day of Month*
Numeric
Maximum
length is 2 digits
The
4 - 46
Day of Year*
The
Start Date*
NA
End Date*
NA
Action*
NA
Field
Description
Validation
Redirection List*
NA
Rule Status*
NA
Reason
Note
It is mandatory to enter either source or destination
MSISDN.
Enter the originating MSISDN in Source MSISDN.
Enter the destination MSISDN in Destination MSISDN.
Enter the duration (in Hour: Minute format) for which the rule is active in Time Duration.
Select the frequency of message redirection in Time Frequency:
Daily:
Weekly:
Select the days on which you want to redirect messages in Week Days.
Monthly:
Yearly:
Select
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Multiple rules cannot be defined for a given time duration and frequency.
4 - 47N
based routing rules, refer to A-party and B-party Based Redirection Rules rules.)
VLR-based routing (SS7 &TCP-IP based protocols) (For more information on VLR-based
Note
For information on rules, refer to Rules Definition.
4 - 48
Field
PID Number*
Description
Messages with the selected
protocol ID are redirected.
Validation
Range:
0 - 255
Numeric
Maximum
length is 21 digits
4 - 49N
Note
For information on the remaining field descriptions
and steps to configure the rule, refer to Source
MSISDN Based Redirection (SMBR) Rules.
4 - 50
Note
For information on the field descriptions and steps
to configure the rule, refer to Source and
Destination MSISDN Combination Redirection
Rules.
4 - 51N
Note
For information on rules, refer to Rules Definition.
given series can be barred. Operators can unbar a given MSISDN within the barred series. In
addition, MSISDNs that start with a given number can be unbarred.
MSISDN Barring: Specific MSISDNs can be barred.
4 - 52
The following table lists the fields of the Add Rule screen:
Field
Description
Validations
Rule Type*
NA
Source MSISDN*
Numeric
Action*
Action to be taken:
NA
Maximum
length is 15 digits
Allowed:
Barred:
Rule Status*
NA
Active
Inactive
Reason
Maximum 50 characters
Source: Comviva
Select the status of the rule from the Rule Status list. Status can be:
Active:
4 - 53N
Inactive:
4 - 54
Note
For field descriptions and steps to configure the
rule, refer to Source MSISDN Barring Rules.
4 - 55N
Destination
codes.
Select the action to be taken in Action:
Allowed:
Barred:
Bar the source MSISDN from sending messages to the destination MSISDN.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
4 - 56
Allow messages from the application with the specified PID to SMSRouter.
Bar messages from the application with the specified PID to SMSRouter.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
4 - 57N
The following table lists the fields of the Add Rule screen:
4 - 58
Field
Description
Description
Rule Type*
NA
Source VMSC*
Numeric
Special
Maximum
Action*
Action to be taken:
length is 15 digits.
NA
Allowed:
Barred:
Rule Status*
NA
Active
Inactive
Reason
Maximum 50 characters
Source: Comviva
SMSRouter does not process the messages received from the specified
VMSC
Select the status of the rule from Rule Status.
Give the reason for barring the VMSC in Reason.
Click Done to save the changes.
4 - 59N
Note
For information on field descriptions and how to
configure the rule, refer to Source VMSC Barring
Rules.
4 - 60
4 - 61N
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
4 - 62
Note
For information on how to configure the rule, refer
to Source IMSI Barring Rules.
4 - 63N
Allow messages from the source MSISDN and source VMSC to the
destination MSISDN.
Barred:
Bar the MSISDN and VMSC from sending messages to the destination
MSISDN.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Note
For information on rules, refer to Rules Definition.
4 - 64
Enter the MSISDN to which messages are sent in Destination MSISDN. Messages sent to this
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
4 - 65N
Note
SMS spams are junk message delivered to a
mobile phone as text messages through the Short
Message Service.
Example:
SMSRouter can be configured to receive messages from the MSISDN series starting with 9198450 and
not receive messages from the MSISDN 919845012345.
For more information on how to black-list/white-list MSISDN/MSISDN series, refer to section Black/White
List Support Rules.
4.5.8
Operators can define rules to charge subscribers for messages on the basis of the source VMSC.
Note
For information on rules, refer to Rules Definition
4 - 66
Charged
Charged
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
4 - 67N
Viewing LI Groups
The LI Groups option is used to view the existing groups.
To view existing LI groups:
Rules Management > LI Group
The following table lists the fields of the LI Groups List screen:
Field
Description
Validation
Group Name
NA
Group Number
NA
Edit
NA
Delete
NA
Source: Comviva
4 - 68
Click Delete to delete a given group. A pop-up window appears to reconfirm the operation.
Click OK to delete the group.
4 - 69N
4 - 70
Field
Description
Validation
Rule Type*
NA
Source MSISDN
Numeric
Numeric
Action to be taken:
NA
Destination MSISDN
Action*
Maximum
Maximum
length is 15 digits
length is 15 digits
Intercepted:
Not
Intercepted: Messages
are not copied. Interception
List, Add New Group and
Edit Group are disabled.
Interception List*
NA
Rule Status*
NA
Reason
Note
It is mandatory to enter either the source or the
destination MSISDN.
Enter the MSISDN sending messages in Source MSISDN.
Enter the MSISDN to which messages are sent in Destination MSISDN.
Select the type of action in Action:
4 - 71N
Intercepted:
Not
Intercepted: Messages are not copied. The Interception List, Add New Group
and Edit Group get disabled.
4 - 72
5 Application-to-Mobile
Messaging
SMSRouter supports messaging between applications and mobile stations. This message exchange is
referred to Application Originated-Mobile Terminated (AO-MT) messaging.
5-1
6.
7.
8.
9.
Temporary
Permanent
4. SMSRouter forwards the submit_sm packet to the Fallback SMSC, based on the SRI
response (step 3).
5. The Fallback SMSC sends the delivery_sm packet for the Delivery report to SMSRouter.
6. SMSRouter sends the Delivery report to the ESME.
5-2
Application-to-Mobile Messaging
Note
The Delivery report is sent only when the
report it is requested for, irrespective of the
success or failure of message delivery.
Actual
Flash Messages: These messages are different from the traditional messages. Flash messages
are immediately displayed on the screen of the phone and are not automatically saved in the
Application-to-Mobile Messaging
5 - 3N
Message Inbox of the subscriber handset. SMSRouter supports streaming of flash messages
using appropriate DCS values. This feature is applicable to AO-MT messages.
Picture Messages and Operator Logo: Operator logos are graphic images that are displayed on
a phone when the phone enters a GSM network. An Operator logo is identified by the country
code and mobile network code. GSM handsets supporting this technology store multiple
images at a time. When a handset moves between networks, the mobile displays the logo of
the current Operator. SMSRouter supports streaming of picture messages using appropriate
Data Coding Scheme (DCS) or User Data Header (UDH) values.
Ring Tones: Ring tones are played when the GSM phone rings. Ring tones can be composed
using an editor and sent as SMS messages. SMSRouter supports streaming of ring tones
using appropriate DCS or UDH values.
OTA Settings: Over-the-air (OTA) SMS messages are used to send configuration information
such as software updates, GPRS configuration settings and security locks. These messages
are particularly useful for mobile device management. SMSRouter supports the streaming of
these messages using appropriate DCS or UDH values.
Type 0/Silent Messages: Silent message are used to check the availability of subscribers.
These messages are not displayed on the handset of subscribers after they are successfully
delivered to the handsets. To send Type 0 or Silent messages, PID value needs to be
configured as 64.
Application-to-Mobile Messaging
8%79%00%41%69%72%74%65%6c%47%50%52%53%5f%4e%41%50%49%44%00%68%74%7
4%70%3a%2f%2f%77%77%77%2e%79%61%68%6f%6f%2e%63%6f%6d%00%45%C6%56%0
1%87%07%06%83%00%01%87%15%06%83%0B%01%01%C6%55%01%87%07%06%83%00%0
1%87%11%06%83%1c%01%87%10%06%AB%01%87%08%06%03%61%69%72%74%65%6c%2
d%63%69%2d%67%70%72'
curl 'http://127.0.0.1:14213/cgi-bin/
sendsms?user=test&pass=test&to=919845072234&dcs=f5&udh=%0B%05%04%0
B%84%23%F0%00%03%9F%03%02&text=%73%2e%63%6f%6d%00%01%87%09%06%89%0
1%01%C6%51%01%87%07%06%83%00%01%87%15%06%83%0B%01%87%1C%06%83%2d%0
1%C6%52%01%87%2F%06%03%41%69%72%74%65%6c%47%50%52%53%5f%50%68%50%7
2%6f%78%79%00%01%87%20%06%03%30%2e%30%2e%30%2e%30%00%01%87%21%06%8
5%01%87%22%06%83%1c%01%C6%53%01%87%23%06%03%30%00%01%01%01%01%C6%0
0%01%55%01%87%36%00%00%06%03%77%32%00%01%87%07%06%83%00%01%87%00%0
1%39%00%00%06%83%0B'
curl 'http://127.0.0.1:14213/cgi-bin/
sendsms?user=test&pass=test&to=919845072234&dcs=f5&udh=%0B%05%04%0
B%84%23%F0%00%03%9F%03%03&text=%01%C6%00%01%59%01%87%07%00%00%06%8
3%00%01%87%00%01%3A%00%00%06%83%2d%01%87%1C%01%01%01%01'
MMS Settings / OTA Message:
curl 'http://127.0.0.1:14213/cgi-bin/
sendsms?user=test&pass=test&to=919845072234&dcs=f5&udh=%0B%05%04%0
B%84%23%F0%00%03%9F%03%01&text=%9F%06%01%B6%03%0B%6A%2d%41%69%72%7
4%65%6c%4d%4d%53%31%00%41%69%72%74%65%6c%4d%4d%53%31%5f%50%72%6f%7
8%79%00%41%69%72%74%65%6c%4d%4d%53%31%5f%4e%41%50%49%44%00%45%C6%5
6%01%87%07%06%83%00%01%87%15%06%83%10%01%01%C6%55%01%87%07%06%83%0
0%01%87%11%06%83%1c%01%87%10%06%AB%01%87%08%06%03%61%69%72%74%65%6
c%2d%63%69%2d%6d%6d%73%2e%63%6f%6d%00%01%87%09%06%89%01%01%C6%51%0
1%87%07%06%83%00%01'
curl 'http://127.0.0.1:14213/cgi-bin/
sendsms?user=test&pass=test&to=919845072234&dcs=f5&udh=%0B%05%04%0
B%84%23%F0%00%03%9F%03%02&text=%87%15%06%83%10%01%C6%52%01%87%2F%0
6%03%41%69%72%74%65%6c%4d%4d%53%31%5f%50%68%50%72%6f%78%79%00%01%8
7%20%06%03%31%30%2e%32%30%30%2e%36%31%2e%31%37%00%01%87%21%06%85%0
1%87%22%06%83%1c%01%C6%53%01%87%23%06%03%39%32%30%31%00%01%01%01%0
1%C6%00%01%55%01%87%36%00%00%06%03%77%34%00%01%87%07%06%83%00%01%8
7%00%01%39%00%00%06%83%10%01%87%00%01%34%00%00%06%03%68%74%74%70%3
a%2f%2f%31%30%2e%32'
curl 'http://127.0.0.1:14213/cgi-bin/
sendsms?user=test&pass=test&to=919845072234&dcs=f5&udh=%0B%05%04%0
B%84%23%F0%00%03%9F%03%03&text=%30%30%2e%36%31%2e%31%37%2f%73%65%7
2%76%6c%65%74%73%2f%6d%6d%73%00%01%01%01'
Note
SMSC Gateway needs to accept the VMS
messages for successful transmission to the
subscriber.
Application-to-Mobile Messaging
5 - 5N
Application-to-Mobile Messaging
retry attempts when there are minor problems in the Operators network. Once the threshold limit is
crossed, SMSRouter rejects incoming messages through MO and AO channels.
Note
The maximum buffer size is based on the
operating system and hardware memory constraints.
5.2.9 MAP1, MAP2 and MAP3 Support for SRI and MT Messages
SMSRouter supports MAP1, MAP2 and MAP3 versions for MT messages. The system tries to deliver MT
FSM in the default MAP version of the network. If the system encounters an error while delivering
messages, it retries to deliver messages using a lower MAP version. The process goes on till the message
delivery is successful.
MAP1, MAP2 and MAP3 support for SRI requests and responses
MAP1, MAP2 and MAP3 support for MT messages
Application-to-Mobile Messaging
5 - 7N
Example:
SMSRouter receives messages from CNN.com for Peter. If the Peters mobile is out of the network
coverage area, message delivery fails and SMSRouter sends a failed Delivery report to the application.
When the mobile is within the network coverage area, the HLR sends an alert to SMSRouter about the
updated status of Peters mobile. If the alert service center flag is enabled, SMSRouter forwards the alert
to CNN.com to resend the message.
Rule
Account ID and Destination IMSI
Based Barring
5-8
Definition
Bars message transfers from a
source ESME account ID to a
destination IMSI/IMSI series.
Scenarios/Examples
Orange Telecom can restrict a
specific ESME account such as
CNN.com from sending
messages to a specific IMSI
series 9197411as it does not
have an agreement for sharing
transmission revenue between
mobile Operators and content
providers.
Application-to-Mobile Messaging
Rule
Definition
Scenarios/Examples
System ID Barring
Application-to-Mobile Messaging
5 - 9N
Rule
Destination IMSI Barring
Definition
Scenarios/Examples
5 - 10
PID Barring
PID Redirection
MT-FSM Failure
SRI-SM Failure
Application-to-Mobile Messaging
Rule
Definition
Scenarios/Examples
5 - 11N
Note
ESME account ID is numeric and is internally generated by the SMSRouter system. This ID is not
shared with the ESME clients.
Select the ID of the ESME account sending messages from Account ID list.
5 - 12
Application-to-Mobile Messaging
Bar the ESME account ID from sending messages to the destination IMSI.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
list.
Application-to-Mobile Messaging
5 - 13N
Select the system ID of the ESME account sending messages from the System ID list.
Enter the MSISDN to which messages are sent in Destination MSISDN.
Select the action to be taken in Action:
Allowed:
Barred:
Bar the ESME System IF from sending messages to the destination MSISDN.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
5 - 14
Application-to-Mobile Messaging
The following table lists the fields of the Add Rule screen:
Field
Rule Type*
Application-to-Mobile Messaging
Description
Name of the rule to be
configured.
Validation
NA
5 - 15N
Field
Sender Alpha Numeric Address*
Description
Alphanumeric address of the
sender application.
Validation
Alphanumeric
Special
Maximum
Action*
Action to be taken:
length is 15 digits
NA
Allowed
Barred
Rule Status*
NA
Source: Comviva
Enter the alphanumeric address of the sender in Sender Alpha Numeric Address.
Select the type of action from the Action drop-down list. The action can be:
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
Enter the reason for barring the sender address from sending messages.
Click Done to save the changes.
5 - 16
Application-to-Mobile Messaging
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
Application-to-Mobile Messaging
5 - 17N
5 - 18
Application-to-Mobile Messaging
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
Application-to-Mobile Messaging
5 - 19N
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
5 - 20
Application-to-Mobile Messaging
SMSRouter does not process the messages to send to the specified VMSC
5 - 21N
Select the status of the rule from the Rule Status drop-down list. The status can be:
5 - 22
Active
Application-to-Mobile Messaging
Inactive
Application-to-Mobile Messaging
5 - 23N
Allow messages from the application with the specified PID to SMSRouter.
Bar messages from the application with the specified PID to SMSRouter.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
5 - 24
Application-to-Mobile Messaging
Destination
codes.
Select the action to be taken in Action:
Allowed:
Barred:
Bar the source MSISDN from sending messages to the destination MSISDN.
Select the status of the rule from the Rule Status list. Status can be:
Application-to-Mobile Messaging
5 - 25N
Active:
Inactive:
5 - 26
Application-to-Mobile Messaging
Field
Description
PID Number*
Validation
Range:
0 - 255
Numeric
Maximum
length is 21 digits
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Note
For information on rules, refer to Rules
Definition.
Application-to-Mobile Messaging
5 - 27N
Figure 5-26: Destination MSISDN and Destination TON NPI Combination Redirection
Table 5-4: Destination MSISDN and Destination TON NPI Combination Redirection
Field
5 - 28
Description
Validation
Rule Type*
NA
Destination MSISDN *
Application-to-Mobile Messaging
Table 5-4: Destination MSISDN and Destination TON NPI Combination Redirection
Field
Description
Validation
Destination TON *
NA
Destination NPI *
NA
Min Length *
Action*
NA
Redirection List *
NA
Rule Status*
NA
Reason
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Application-to-Mobile Messaging
5 - 29N
The system configures MT-FSM failure and SRI-SM failure rules to redirect messages on the occurrence
of any of the following temporary errors:
Absent subscriber
Call barred
Supplementary Services (SS) incompatibility
Subscriber busy for MTSMS
Facility not supported
SM-Delivery failure
System failure
Data missing
Message waiting list full
Unexpected data value
Absent subscriber for SRI
Busy subscriber
No subscriber reply
Any other errors
Note
For information on rules, refer to Rules Definition
5 - 30
Application-to-Mobile Messaging
The following table lists the fields of the Add Rule screen:
Field
Rule Type*
Application-to-Mobile Messaging
Description
Name of the rule to be
configured.
Validation
NA
5 - 31N
Field
Error Desc*
Description
Network errors defined for a MT
message:
Absent
Call
SS
NA
Subscriber
Barred
Incompatibility
Facility
not supported
Subscriber
SM-Delivery
Message
System
Data
Failure
missing
Absent
Busy
Failure
Unexpected
No
Validation
data value
subscriber
subscriber reply
Numeric
System ID
NA
Action*
Action to be taken:
NA
Destination MSISDN
Maximum
length is 15 digits
NA
Rule Status*
NA
Active:
Inactive:
Select Inactive to
deactivate the rule.
5 - 32
Application-to-Mobile Messaging
Field
Description
Reason
Validation
Error
Description
Absent Subscriber
Call Barred
SS Incompatibility
Mobile-Terminated Short
Message Transfer (MT-SMS)
cannot be completed due to one
of the following reasons:
Delivery
System Failure
Application-to-Mobile Messaging
5 - 33N
Error
Description
Data Missing
Busy subscriber
Subscriber is busy.
No subscriber reply
Absent Subscriber
MSISDN or MSISDN series (specified in Destination MSISDN) are either redirected or retried.
It is an optional parameter.
Note
It is mandatory to enter either the Destination
MSISDN or to select the system ID of the ESME
account.
Select the action to be taken:
Redirect:
Retry:
Retry message delivery after pre-defined time intervals (For more information
on message retry, refer to Configuring Account-based Retries.)
SRI-SM Rules
SMSRouter sends the following two types of requests to the GSM network:
5 - 34
Application-to-Mobile Messaging
Send Routing Information (SRI) request is sent to HLR to retrieve the IMSI and VMSC details of
message.
If the SRI response during MO-MT messaging is negative, this rule redirects messages to a Fallback
SMSC defined in the Redirection list.
Note
For information on rules, refer to Rules Definition.
Application-to-Mobile Messaging
5 - 35N
Note
For more information on field descriptions and how
to configure the rule refer to MT-FSM Failure Rules.
Note
For information on rules, refer to Rules Definition.
5 - 36
Application-to-Mobile Messaging
Enter the short code of the application in Short Code. Messages originating from the specified
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
5 - 37N
Note
For information on rules, refer to Rules Definition.
5 - 38
Application-to-Mobile Messaging
Field
Description
Validation
Rule Type*
NA
Numeric
Action*
NA
Redirection List*
NA
Rule Status*
NA
Reason
Maximum
length is 15 digits
Source: Comviva
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Application-to-Mobile Messaging
5 - 39N
Depending on the validity period of a message, SMSRouter makes up to ten attempts to ensure that the
message reaches its destination.
5 - 40
Application-to-Mobile Messaging
Select an account from the Account Name list to view the retry policies configured for the
account.
The following table lists the fields of the Retry Policy screen:
Field
Error Type
Description
GSM errors can be classified into
the following categories:
User
Provider
Error: Errors
returned by the Map stack
Internal
Errors: Errors
returned by the SMSC
Error Code
Error Name
Attempts
Application-to-Mobile Messaging
5 - 41N
Field
Description
Source: Comviva
Note
For field descriptions, refer to the Retry Policy
table.
Error Name: Select the error for which a retry policy is to be defined.
Retry Attempts: Enter the retry interval period for each attempt. The retry interval should be in
seconds.
Click Done to save the changes.
5 - 42
Application-to-Mobile Messaging
Note
The retry intervals can be defined for different
errors.
Click Delete to delete the retry policy. A dialog box pops-up to re-confirm the operation.
Click OK.
5 - 43N
5 - 44
Application-to-Mobile Messaging
Application-to-Mobile Messaging
5 - 45N
Field
System ID*
Description
Login ID used by the client to
connect to SMSRouter. The field
validates the identity of the client
attempting to connect to
SMSRouter.
Validation
Should
Alphanumeric
Special
Not
Password*
Confirm Password
Protocol*
case sensitive
Maximum
Same as Password
NA
Case
9 characters
sensitive
SMPP
UCP
CIMD
System Type*
Alphanumeric
Special
Case
Port*
NA
Account Type*
NA
sensitive
Send
Send
and Receive: It signifies that a client has the privilege to transmit and receive
messages.
5 - 46
Application-to-Mobile Messaging
Field
Description
Default Address*
Validation
Numeric
Numeric
NA
Maximum
Maximum
length is 6 digits
length is 3 digits
Application-to-Mobile Messaging
Numeric
Range:
0 - 10
Maximum
length is 3 digits
5 - 47N
Field
Maximum Receive (MSLA)
Description
Validation
Numeric
Enter
0 if Account Type is
Send Only.
Enter
Transmission precedence
assigned by SMSRouter to the
messages submitted by the client
application. Four priority levels
are supported:
0:
1:
Level 1 priority
2:
Level 2 priority
3:
NA
Numeric
Maximum
length is 3 digits
NA
5 - 48
NA
Application-to-Mobile Messaging
Field
Description
Validation
NA
Message Length*
Numeric
NA
Values
Reject:
SMSRouter rejects
the message if the message
exceeds the pre-defined
length.
NA
Yes:
Select if SMSRouter
should convert special characters, such as @ and #, to conform to GSM standards.
No:
Date of Activation*
NA
Date of Expiry*
NA
Application-to-Mobile Messaging
5 - 49N
Field
Binary Allowed*
Description
Indicates whether ESME is
allowed to send messages in
binary formats such as ring
tones, logos, and pictures. The
selection depends on the
account type opted by the client:
Validation
NA
Yes:
Select if ESME is
allowed to send messages in
binary formats.
No:
Alphanumeric Allowed*
NA
Yes:
No:
Access List*
Numeric
Maximum
six IP addresses
are allowed
5 - 50
NA
NA
Outbind Enable
Outbind Host
Valid IP Address
Application-to-Mobile Messaging
Field
Description
Validation
Outbind Port
NA
Support data_sm
NA
ValidityPeriod
Numeric
Value
ranges from 0 to
864000 seconds
Source: Comviva
Enter the login ID to be used by the client to connect to SMSRouter in System ID.
Enter the password to be used to connect to SMSRouter in Password.
Re-enter the password in Confirm Password.
Select the type of protocol from the Protocol list. You can either select SMPP, CIMD or UCP for
communication.
Enter the type of connection in System Type.
Select the port from the Port list. Depending on the selected protocol, port list gets populated.
Select Account Type. SMSRouter supports two types of accounts:
Send
Send
and Receive: Indicates that a client has the privilege to transmit and receive
messages.
Enter the default address of the application in Default Address. Message packets transmitted
by a client contain the source address and the destination address. A client transmitting
messages to SMSRouter may, however, enter NULL in the default address field. In such a
Application-to-Mobile Messaging
5 - 51N
case, SMSRouter substitutes the source address with the default address. The parameter is
particularly useful for interfaces unfamiliar with the notion of source address for a short
message (for instance, voice mail systems).
Note
The default source address of the ESME client may
be a number most commonly associated with the
application. Operators may assign the same default
address to different client applications.
Note
Two accounts cannot have the same service number. However, two applications can be assigned the
same allowed sender prefix.
Note
Administrators should ensure that the total
SMSRouter capacity does not exceed the expected
concurrent traffic. In the initial weeks of SMSRouter
installation, it is recommended that transmission
threshold limits for any client do not exceed 15
messages per second.
Enter the number of short codes to be defined for an ESME application in No. of Service
Numbers.
Select the All Service Numbers Allowed option. Values can be:
Yes: Select to allow the ESME
Select to allow the ESME client to transmit messages with numeric sender address
configured for the account.
Enter the maximum number of sessions a client can maintain with SMSRouter to transmit
levels are supported. Level 0 has the lowest priority while Level 3 has the highest priority. An
application cannot exceed the priority level assigned during account creation.
Select the criteria for message acceptance in Message Acceptance Criteria. Values can be:
5 - 52
Application-to-Mobile Messaging
Truncate:
Reject:
length.
Select whether or not GSM conversion is required in GSM Conversion Req. Values can be:
Yes:
No:
Select if the ESME application converts the special characters to conform to GSM
standards.
Select Alphanumeric Allowed if SMSRouter supports only alphanumeric messages. You can
message.
Select Store and Forward to enable store and forward of messages if DDA fails.
Select Outbind Enable to enable SMPP outbind feature.
Enter the IP address of the ESME application that connects to SMSRouter on receiving a
Number Range.
Select ESME Prepaid Enable to indicate whether or not the ESME account is prepaid or
postpaid.
Select Support data_sm to indicate whether the ESME account can receive data in data_sm
format.
Enter the validity period of messges originating from the ESME account in Validity Period.
Click Continue to add Service Numbers, Standard Reply, and Failure Reply.
Application-to-Mobile Messaging
5 - 53N
Click Delete to delete the given ESME account. A pop-up window appears to confirm the
operation.
Click OK to confirm deletion.
5 - 54
Application-to-Mobile Messaging
In such cases, SMSRouter provides the provision to configure a standard failure response that can be sent
out to the users sending requests to the application. The Operator can configure the failure message
through the application GUI. In addition, SMSRouter buffers all the requests received during the
application down-time and delivers the requests to the application whenever it starts functioning.
Example:
During New Year or Christmas, subscribers often request for ring tones that are suitable for the occasion
for. If the ring tone application cannot handle the sudden surge in the requests, it may stop responding to
subscriber requests. In such scenarios, Operators can configure the following failure response and send to
the subscribers requesting for ring tones in SMSRouter:
We are unable to process your request at this time. Please try
later.
To configure failure replies:
New Account.)
Click Continue. (Refer to : Add ESME Account)
Enter the failure response SMSRouter that should be automatically sent to the users when the
Application-to-Mobile Messaging
5 - 55N
If the limits are exceeded, SMSRouter sends the excess messages back to the ESME accounts. Defining
limits helps to control the flow of messages towards SMSRouter.
To set limits on the message count:
ESME Management > ESME Accounts >Add New Account
5 - 56
Application-to-Mobile Messaging
Enter the number of messages that can be transmitted by the ESME client in a second in
Message Per second. There is no theoretical limit on the number of messages that can be
sent to SMSRouter.
Note
Administrators should ensure that the total
SMSRouter capacity does not exceed the expected
concurrent traffic. In the initial weeks of SMSRouter
installation, it is recommended that transmission
threshold limits for any client do not exceed 15
messages per second.
Message Per Minute, Message Per Hour, Message Per Day are automatically populated
Note
For field descriptions, refer to Add New Account
table.
Click Done to save changes.
Application-to-Mobile Messaging
5 - 57N
Enter the required field values in : Add ESME Account. (For more information, refer to the
5 - 58
Application-to-Mobile Messaging
Application-to-Mobile Messaging
5 - 59N
Enter the number of short codes to be associated with the application in No. Of Service
Numbers.
Note
For information on the fields, refer to Table: Add
New Account.
Click Continue.
Enter the short codes defined for the ESME account in Service Number.
In Standard Reply, enter the standard response to be sent to users sending service requests.
In Failure Reply, enter the failure response to be sent to users when the application is not
functional.
Click Done to save changes.
5 - 60
Application-to-Mobile Messaging
Users can subscribe to an application for ring tones, jokes, news, and stock alerts. To subscribe for ring
tones, the application can have multiple service numbers ranging from 5000- 5099. This indicates that the
first service number of the range is 5000 and the maximum length of the service number is four. Based on
the maximum length defined, the SMSRouter system automatically defines the last service number of the
range (in this case it is 5099).
To configure range based service number provisioning:
Enter the required field values in Add New Account screen. (For more information, refer to the
Enter the service number of the application in Service Number (in the example given above,
5 - 61N
5 - 62
Application-to-Mobile Messaging
established SMPP session are similar to a normal SMPP receiver session. Depending on the account
type, the Operator can enable this feature and configure one IP and port pair per account.
Example:
SMSRouter can use this feature to deliver large message volumes to ESME during televoting and
broadcasting election results.
To enable SMPP outbind sessions:
ESME Management > ESME Accounts >Add New Account
Select Account Type as Send and Receive.
Application-to-Mobile Messaging
5 - 63N
Select Yes in Outbind Enable. (This field is enabled only if the Account Type is Send and
Receive.)
Enter the IP address of the ESME application connecting with SMSRouter in Outbind Host.
Enter the port number of the ESME application connecting with SMSRouter in Outbind Port.
5 - 64
Application-to-Mobile Messaging
Note
For other field descriptions, refer to Creating ESME
Accounts.
messages are stored and retried based on the retry policy configured for the account. If retry
policy and error-based redirection is not defined for the account, retry is attempted based on the
default retry policy.
The store and forward enabled messages received from ESME accounts are recorded in the
secondary memory before attempting message delivery. If not delivered in the Direct Delivery
Attempt, delivery of messages is retried according to the retry policies configured for the
account.
If S&F is not configured, SMSRouter attempts to deliver the messages before storing the messages in the
database. Operators can enable the S&F functionality for specific accounts. The S&F feature is generally
enabled for messages that are not critical such as the promotional messages.
To enable store and forward for message delivery:
ESME Management > ESME Accounts >Add New Account
Enter the required field values in : Add ESME Account. (For more information, refer to the
Application-to-Mobile Messaging
5 - 65N
Select Yes in Store and Forward Enable to enable the store and forward functionality.
5 - 66
Application-to-Mobile Messaging
Column
Description
System ID
Session Type
Node IP
Bind Time
Disconnect
Application-to-Mobile Messaging
5 - 67N
ESME account. SMSRouter supports a maximum of two groups per account. Each group can have
maximum of 20 destination addresses.
Example:
The ESME application of a bank can send salary credit alerts to the employees of an organization through
SMSRouter.
This option is used by ESME applications to form a group of subscribers for sending messages in bulk. A
maximum of two distribution lists can be created for each application account. Each distribution list can
contain a maximum of 25 MSISDNs. An application can send the name of the Distribution list in a
submit_multi message. The submitted message is transmitted to all the MSISDNs in the Distribution list.
This option is used to:
View Distribution Lists
Add Groups
Edit Groups
Delete Groups
5 - 68
Application-to-Mobile Messaging
The screen displays the ID assigned to the application account and the names of the distribution group
created for the application.
Select the application account for which distribution lists is to be created from the Account
Name list.
Enter a name for the first distribution list in Distribution List1.
Enter a name for the second distribution list in Distribution List 2.
Click Add.
After defining the group or distribution list names, add the MSISDNs to each Distribution List.
5 - 69N
Select the TON (Destination) and NPI (Destination) values from the drop-down lists.
Enter the MSISDNs to be added in the group.
Click Add.
Click Save.
5.4.9 Ports
The Ports option lists all the SMPP, CIMD and UCP ports that are used by applications to connect to
SMSRouter server.
To view the ports:
5 - 70
Application-to-Mobile Messaging
The screen displays the list of SMPP, CIMD and UCP ports.
5 - 71N
Note
By default, 25 entries are displayed on the Service
Numbers screen.
The following table lists the fields of the Service Numbers screen.
Field
Description
Validation
Allowed Sender
NA
System ID
NA
Length
NA
Standard Reply
NA
Failure Reply
NA
Edit
NA
Delete
NA
Source: Comviva
5 - 72
Application-to-Mobile Messaging
Application-to-Mobile Messaging
5 - 73N
Click Delete to delete the given service numbers. A pop-up window appears to reconfirm the
operation.
Click OK to confirm deletion.
Example:
SMSRouter can create a Happy New Year greeting and share the ID of the greeting with the ESMEs.
Instead of sending the greetings repeatedly, the ESME can send the ID of greeting message to
SMSRouter. This saves on network resources and cuts down on costs since message transmission
through SS7 links is costlier.
5 - 74
Application-to-Mobile Messaging
Canned Message: Enter the message text. The message text should not be more then 160
characters.
Click Done to save the changes.
Note
Each canned message is assigned a message ID.
A maximum of only 254 canned messages can be
stored (excluding canned message numbers 0 and
255).
5 - 75N
Click Delete to delete a given canned message. A dialog box pops-up to re-confirm the
operation.
Click OK.
5 - 76
Application-to-Mobile Messaging
Source: Enter the source address of the message entity. This can be a short code or an
MSISDN and it allows you to perform the query for a particular SME.
Destination: Enter the destination address of the message.
Status: Delivery status of the message. Status can be:
Error:
Success:
All:
Pending:
Application-to-Mobile Messaging
5 - 77N
Note
For field descriptions, refer to Figure : Query
Details for All Messages
5 - 78
Application-to-Mobile Messaging
Note
For field descriptions, refer to Figure : Query
Details for All Messages.
Application-to-Mobile Messaging
5 - 79N
Send Only
ESMEs can use SMSRouter to send messages. An ESME that opts for a Send Only account is not
authorized to receive messages from an application or a mobile station.
Example:
ESMEs that send promotional messages, awareness messages, jokes, news alerts, and cricket scores to
subscribers.
5 - 80
Application-to-Mobile Messaging
from SMSRouter over a single session. When an application needs to send messages and
receive response for the sent messages, the transceiver mode is used. For example,
applications such as Who wants to be a Millionaire push contest questions to subscribers and
receive answers for the delivered questions.
Note
For UCP connections, only Send and Receive
account types are applicable.
5 - 81N
dramatic and sudden surges in messaging traffic by controlling the mobile-originated short message
submission rates without degrading the overall system performance. SMSRouter configures the threshold
for accepting short messages. All messages beyond the threshold level are dropped.
The Operator configures the Message Per Second limit for ESME accounts. Refer to the Creating ESME
Accounts menu to set threshold limits.
Example:
Peter sends a message of 200 characters to Michael. SMSRouter splits the message into two parts. The
first part of the message contains 160 characters while the second part contains 40 characters. Both the
messages are recombined after delivering to subscriber B.
5 - 82
Application-to-Mobile Messaging
Application-to-Mobile Messaging
5 - 83N
5 - 84
Application-to-Mobile Messaging
6 Mobile-to-Application
Messaging
SMSRouter enables SMS exchange between mobile stations and applications. This message
exchange is referred to Mobile Originated-Application Terminated (MO-AT) messaging.
Mobile-to-Application Messaging
6-1
4. The MSC returns the outcome of the Mobile Originated-Short Message (MO-SM)
operation to the MS.
5. SMSRouter sends the data_sm packet to ESME.
6. The ESME acknowledges the delivery and sends a data_sm response to SMSRouter.
7. SMSRouter sends a Delivery report to the MS.
DDA Failure Forwarding
The sequential flow diagram depicting the DDA failure forwarding of MO-AT message is as follows:
6-2
Mobile-to-Application Messaging
Actual
Note
The maximum buffer size is based on the operating
system and hardware memory constraints.
Mobile-to-Application Messaging
6 - 3N
Example:
Peter sends a message to the American Idol application. On receiving the message, SMSRouter
immediately delivers the message to American Idol application. If American Idol application is not
connected, SMSRouter redirects the message to the secondary SMSC.
6-4
Mobile-to-Application Messaging
Field
Blocking of Delivery
Report
Description
Used to enable or disable
Delivery reports. Select to stop
the generation of Delivery
reports.
Validations
NA
NA
Mobile-to-Application Messaging
NA
6 - 5N
Field
Retry Attempts (In Sec)
Description
Validations
Numeric
Minimum
NA
Numeric
Minimum
Maximum
length is 10 characters
Maximum length of MO
messages.
Numeric
NA
Flash Message
Alphanumeric
Translation Type
NA
- Unknown
[1-63]:InternationalServices
Numbering Plan(NP)
255 - Reserved
NA
E164
X121
TELEX
NATIONAL
PRIVATE
ERMES
EXTENSION
6-6
Mobile-to-Application Messaging
Field
Description
Validations
NA
NA
NA
Source: Comviva
Mobile-to-Application Messaging
6 - 7N
SMSRouter supports dynamic configuration of rules, thus helping the Operator to configure rules to handle
messages more effectively based on the traffic situation and other requirements without any system
restarts or downtime. SMSRouter supports TCP based re-direction. TCP/IP links are cheaper than SS7
resources and the bandwidth over TCP/IP is higher than over SS7. TCP/IP works out to be a flexible and
cost-effective solution to manage message bursts. In case of delivery failure, messages are forwarded to
the SMSC for further retries over TCP/IP.
SMSRouter stores the configured rules in the database. After configuring the rules through the Web-based
GUI, SMSRouter applies the rules to redirect/reject messages handled by the system.
The following table lists all the rules defined in SMSRouter:
Rule
6-8
Definition
Scenarios/Examples
Subscriber A (+919810012345)
is not charged for sending
message from VMSC
+919811012439. The same
subscriber is charged for sending
message when roaming in the
VMSC +919811012437.
Mobile-to-Application Messaging
Rule
Source IMSI Barring
Definition
Block messages based on the
source IMSI. Using this rule,
messages received from an
MSISDN whose IMSI or IMSI
range is blacklisted are rejected.
Scenarios/Examples
Operators can bar a specific
IMSI series instead of barring a
set of MSISDN series from
sending messages to avoid
spam ming and unauthorized
access.
Example: Sigmatel bars the
prepaid IMSI series 9798450
from sending international SMS
messages.
PID Barring
PID Redirection
Mobile-to-Application Messaging
6 - 9N
Rule
Time -based Redirection
Definition
Scenarios/Examples
The
redirection is periodic:
Daily:
Weekly:
Monthly:
Yearly:
Source MSISDN-based
Redirection
MO Relay
6 - 10
Mobile-to-Application Messaging
Note
For information on rules, refer to Rules Definition.
Mobile-to-Application Messaging
6 - 11N
The following table lists the fields of the Add Rule screen:
Field
Description
Validation
Rule Type*
Action*
NA
Redirection List *
NA
Rule Status*
NA
Reason
NA
Source: Comviva
Redirection List.
6 - 12
Mobile-to-Application Messaging
Inactive:
Note
For information on rules, refer to Rules Definition.
To configure source MSISDN and source TON NPI -based redirection rules:
Rules Management>Rules Configuration
Mobile-to-Application Messaging
6 - 13N
The following table lists the fields of the Add Rule screen:
Field
Description
Validation
Rule Type*
NA
Source MSISDN *
Source TON *
NA
Source NPI *
NA
Min Length *
Action*
NA
Redirection List *
NA
Rule Status*
NA
Reason
6 - 14
Mobile-to-Application Messaging
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Note
For information on rules, refer to Rules Definition.
Mobile-to-Application Messaging
6 - 15N
The following table lists the fields of the Add Rule screen:
Field
Description
Validation
Rule Type*
NA
Source MSISDN *
Numeric
Action*
NA
Redirection List*
NA
Rule Status*
NA
Reason
Maximum
length is 15 digits
Source: Comviva
Redirection List.
6 - 16
Mobile-to-Application Messaging
Inactive:
Note
For information on rules, refer to Rules
Definition.
To configure time-based redirection rules:
Rules Management>Rules Configuration
Mobile-to-Application Messaging
6 - 17N
The Add Rule screen changes as per the Time Frequency selected as shown below:
6 - 18
Mobile-to-Application Messaging
The following table lists the fields of the Add Rule screen:
Mobile-to-Application Messaging
6 - 19N
Field
Description
Validation
Rule Type*
NA
Source MSISDN
Numeric
Destination MSISDN
Numeric
Time Duration*
Time
Time Frequency*
Frequency of message
redirection:
NA
Maximum
Maximum
length is 15 digits
length is 15 digits
Daily
Weekly
Monthly
Yearly
Week Days*
The
Day of Month*
Numeric
Maximum
length is 2 digits
The
6 - 20
Day of Year*
Start Date*
NA
End Date*
NA
Action*
NA
Mobile-to-Application Messaging
Field
Description
Validation
Redirection List*
NA
Rule Status*
NA
Reason
Note
It is mandatory to enter either source or destination
MSISDN.
Enter the originating MSISDN in Source MSISDN.
Enter the destination MSISDN in Destination MSISDN.
Enter the duration (in Hour: Minute format) for which the rule is active in Time Duration.
Select the frequency of message redirection in Time Frequency:
Daily:
Weekly:
Select the days on which you want to redirect messages in Week Days.
Monthly:
Yearly:
Select
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Multiple rules cannot be defined for a given time duration and frequency.
Mobile-to-Application Messaging
6 - 21N
based routing rules, refer to Source MSISDN - based Redirection (SMBR) Rules rules.)
VLR-based routing (SS7 &TCP-IP based protocols) (For more information on VLR-based
Note
For information on rules, refer to Rules Definition.
6 - 22
Mobile-to-Application Messaging
Field
PID Number*
Description
Messages with the selected
protocol ID are redirected.
Validation
Range:
0 - 255
Numeric
Maximum
length is 21 digits
Mobile-to-Application Messaging
6 - 23N
Note
For information on the remaining field descriptions
and steps to configure the rule, refer to Source
MSISDN - based Redirection (SMBR) Rules.
6 - 24
Mobile-to-Application Messaging
Note
For information on the field descriptions and steps
to configure the rule, refer to Source MSISDN based Redirection (SMBR) Rules.
Note
For information on rules, refer to Rules Definition.
Mobile-to-Application Messaging
6 - 25N
6 - 26
Mobile-to-Application Messaging
The following table lists the fields of the Add Rule screen:
Field
Description
Validations
Rule Type*
NA
Source MSISDN*
Numeric
Action*
Action to be taken:
NA
Maximum
length is 15 digits
Allowed:
Barred:
Rule Status*
NA
Active
Inactive
Reason
Maximum 50 characters
Source: Comviva
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Mobile-to-Application Messaging
6 - 27N
6 - 28
Mobile-to-Application Messaging
Destination
Destination
codes.
Select the action to be taken in Action:
Allowed:
Barred:
Bar the source MSISDN from sending messages to the destination MSISDN.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
Mobile-to-Application Messaging
6 - 29N
Allow messages from the application with the specified PID to SMSRouter.
Bar messages from the application with the specified PID to SMSRouter.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
6 - 30
Mobile-to-Application Messaging
The following table lists the fields of the Add Rule screen:
Field
Description
Description
Rule Type*
NA
Source VMSC*
Numeric
Special
Maximum
Action*
Action to be taken:
length is 15 digits.
NA
Allowed:
Barred:
Rule Status*
NA
Active
Inactive
Reason
Maximum 50 characters
Source: Comviva
Mobile-to-Application Messaging
6 - 31N
SMSRouter does not process the messages received from the specified
VMSC
Select the status of the rule from Rule Status.
Give the reason for barring the VMSC in Reason.
Click Done to save the changes.
6 - 32
Mobile-to-Application Messaging
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
Mobile-to-Application Messaging
6 - 33N
Allow messages from the source MSISDN and source VMSC to the
destination MSISDN.
Barred:
Bar the MSISDN and VMSC from sending messages to the destination
MSISDN.
Select the status of the rule from the Rule Status list. Status can be:
Active:
Inactive:
6 - 34
Mobile-to-Application Messaging
Note
For information on rules, refer to Rules Definition.
Mobile-to-Application Messaging
6 - 35N
Enter the MSISDN to which messages are sent in Destination MSISDN. Messages sent to this
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
Note
SMS spams are junk message delivered to a
mobile phone as text messages through the Short
Message Service.
Example:
SMSRouter can be configured to receive messages from the MSISDN series starting with 9198450 and
not receive messages from the MSISDN 919845012345.
6 - 36
Mobile-to-Application Messaging
For more information on how to black-list/white-list MSISDN/MSISDN series, refer to section Black/White
List Support Rules.
6.4.9
Operators can define rules to charge subscribers for messages on the basis of the source VMSC.
Note
For information on rules, refer to Rules Definition
Mobile-to-Application Messaging
6 - 37N
Charged
Charged
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
Note
For information on rules, refer to Rules Definition.
6 - 38
Mobile-to-Application Messaging
Enter the short code of the application in Short Code. Messages sent to the specified short
Redirection List.
Select the Fallback SMSC from the Redirection List.
Select the status of the rule from the Rule Status drop-down list. The status can be:
Active
Inactive
Mobile-to-Application Messaging
6 - 39N
Depending on the validity period of a message, SMSRouter makes up to ten attempts to ensure that the
message reaches its destination.
6 - 40
Mobile-to-Application Messaging
Select an account from the Account Name list to view the retry policies configured for the
account.
The following table lists the fields of the Retry Policy screen:
Field
Error Type
Description
GSM errors can be classified into
the following categories:
User
Provider
Error: Errors
returned by the Map stack
Internal
Errors: Errors
returned by the SMSC
Error Code
Error Name
Mobile-to-Application Messaging
6 - 41N
Field
Attempts
Description
Number of attempts made to
deliver the message at preconfigured intervals. Depending
on the validity period of the
message, SMSRouter makes a
maximum number of ten
attempts to ensure that the
message reaches its destination.
The System Administrators can
define the retry parameters for
each error.
Source: Comviva
6 - 42
Mobile-to-Application Messaging
Note
For field descriptions, refer to the Retry Policy
table.
Error Name: Select the error for which a retry policy is to be defined.
Retry Attempts: Enter the retry interval period for each attempt. The retry interval should be in
seconds.
Click Done to save the changes.
Note
The retry intervals can be defined for different
errors.
Click Delete to delete the retry policy. A dialog box pops-up to re-confirm the operation.
Mobile-to-Application Messaging
6 - 43N
Click OK.
6 - 44
Mobile-to-Application Messaging
Mobile-to-Application Messaging
6 - 45N
Field
Description
Login ID used by the client to
connect to SMSRouter. The field
validates the identity of the client
attempting to connect to
SMSRouter.
System ID*
Validation
Should
Alphanumeric
Special
Not
Password*
Confirm Password
Protocol*
case sensitive
Maximum
Same as Password
NA
Case
9 characters
sensitive
SMPP
UCP
CIMD
System Type*
Alphanumeric
Special
Case
Port*
NA
Account Type*
NA
sensitive
Send
Send
and Receive: It signifies that a client has the privilege to transmit and receive
messages.
6 - 46
Mobile-to-Application Messaging
Field
Description
Validation
Default Address*
Numeric
Numeric
NA
Maximum
Maximum
length is 6 digits
length is 3 digits
Mobile-to-Application Messaging
Numeric
Range:
0 - 10
Maximum
length is 3 digits
6 - 47N
Field
Maximum Receive (MSLA)
Description
Validation
Numeric
Enter
0 if Account Type is
Send Only.
Enter
Transmission precedence
assigned by SMSRouter to the
messages submitted by the client
application. Four priority levels
are supported:
0:
1:
Level 1 priority
2:
Level 2 priority
3:
NA
Numeric
Maximum
length is 3 digits
NA
6 - 48
Mobile-to-Application Messaging
Field
Description
Validation
NA
NA
Message Length*
Numeric
NA
Values
Reject:
SMSRouter rejects
the message if the message
exceeds the pre-defined
length.
NA
Yes:
Select if SMSRouter
should convert special characters, such as @ and #, to conform to GSM standards.
No:
Date of Activation*
NA
Date of Expiry*
NA
Mobile-to-Application Messaging
6 - 49N
Field
Binary Allowed*
Description
Indicates whether ESME is
allowed to send messages in
binary formats such as ring
tones, logos, and pictures. The
selection depends on the
account type opted by the client:
Validation
NA
Yes:
Select if ESME is
allowed to send messages in
binary formats.
No:
Alphanumeric Allowed*
NA
Yes:
No:
Access List*
Numeric
Maximum
six IP addresses
are allowed
6 - 50
NA
NA
Outbind Enable
Mobile-to-Application Messaging
Field
Description
Validation
Outbind Host
Valid IP Address
Outbind Port
NA
Support data_sm
NA
Source: Comviva
Enter the login ID to be used by the client to connect to SMSRouter in System ID.
Enter the password to be used to connect to SMSRouter in Password.
Re-enter the password in Confirm Password.
Select the type of protocol from the Protocol list. You can either select SMPP, CIMD or UCP for
communication.
Enter the type of connection in System Type.
Select the port from the Port list. Depending on the selected protocol, port list gets populated.
Select Account Type. SMSRouter supports two types of accounts:
Send
Mobile-to-Application Messaging
6 - 51N
Send
and Receive: Indicates that a client has the privilege to transmit and receive
messages.
Enter the default address of the application in Default Address. Message packets transmitted
by a client contain the source address and the destination address. A client transmitting
messages to SMSRouter may, however, enter NULL in the default address field. In such a
case, SMSRouter substitutes the source address with the default address. The parameter is
particularly useful for interfaces unfamiliar with the notion of source address for a short
message (for instance, voice mail systems).
Note
The default source address of the ESME client may
be a number most commonly associated with the
application. Operators may assign the same default
address to different client applications.
Note
Two accounts cannot have the same service number. However, two applications can be assigned the
same allowed sender prefix.
Note
Administrators should ensure that the total
SMSRouter capacity does not exceed the expected
concurrent traffic. In the initial weeks of SMSRouter
installation, it is recommended that transmission
threshold limits for any client do not exceed 15
messages per second.
Enter the number of short codes to be defined for an ESME application in No. of Service
Numbers.
Select the All Service Numbers Allowed option. Values can be:
Yes: Select to allow the ESME
Select to allow the ESME client to transmit messages with numeric sender address
configured for the account.
Enter the maximum number of sessions a client can maintain with SMSRouter to transmit
6 - 52
Mobile-to-Application Messaging
Select the priority of messages from a client application in Maximum Priority. Four priority
levels are supported. Level 0 has the lowest priority while Level 3 has the highest priority. An
application cannot exceed the priority level assigned during account creation.
Select the criteria for message acceptance in Message Acceptance Criteria. Values can be:
Truncate:
Reject:
length.
Select whether or not GSM conversion is required in GSM Conversion Req. Values can be:
Yes:
No:
Select if the ESME application converts the special characters to conform to GSM
standards.
Select Alphanumeric Allowed if SMSRouter supports only alphanumeric messages. You can
message.
Select Store and Forward to enable store and forward of messages if DDA fails.
Select Outbind Enable to enable SMPP outbind feature.
Enter the IP address of the ESME application that connects to SMSRouter on receiving a
Number Range.
Select ESME Prepaid Enable to indicate whether or not the ESME account is prepaid or
postpaid.
Select Support data_sm to indicate whether the ESME account can receive data in data_sm
format.
Click Continue to add Service Numbers, Standard Reply, and Failure Reply.
Mobile-to-Application Messaging
6 - 53N
Click Delete to delete the given ESME account. A pop-up window appears to confirm the
operation.
Click OK to confirm deletion.
6 - 54
Mobile-to-Application Messaging
In such situations, users keep sending service requests because of not receiving any response from the
service number. To avoid confusion for users, standard automated responses can be sent to users
whenever there are delays in sending a response to users. The message content can be configured and
the response can be sent for multiple sessions.
Example:
User sends a MO-AT request to a given service number to download a ring tone. If there is a delay in
getting a response from the application, the user resends the request until the ring tone is delivered to the
user. By enabling an auto-reply on the service number, SMSRouter sends a pre-configured response to
acknowledge the receipt of the request. This saves the user from resending requests.
.
To configure auto-replies:
ESME Management > ESME Accounts >Add New Account
Enter the required field values in : Add ESME Account (For more information, refer to the Add
New Account.)
Click Continue. (Refer to : Add ESME Account)
Enter the standard automated response that SMSRouter sends to the message sender in
Standard Reply.
Click Done to save the changes.
6 - 55N
through the application GUI. In addition, SMSRouter buffers all the requests received during the
application down-time and delivers the requests to the application whenever it starts functioning.
Example:
During New Year or Christmas, subscribers often request for ring tones that are suitable for the occasion
for. If the ring tone application cannot handle the sudden surge in the requests, it may stop responding to
subscriber requests. In such scenarios, Operators can configure the following failure response and send to
the subscribers requesting for ring tones in SMSRouter:
We are unable to process your request at this time. Please try
later.
To configure failure replies:
New Account.)
Click Continue. (Refer to : Add ESME Account)
Enter the failure response SMSRouter that should be automatically sent to the users when the
If the limits are exceeded, SMSRouter sends the excess messages back to the ESME accounts. Defining
limits helps to control the flow of messages towards SMSRouter.
6 - 56
Mobile-to-Application Messaging
Enter the number of messages that can be transmitted by the ESME client in a second in
Message Per second. There is no theoretical limit on the number of messages that can be
sent to SMSRouter.
Mobile-to-Application Messaging
6 - 57N
Note
Administrators should ensure that the total
SMSRouter capacity does not exceed the expected
concurrent traffic. In the initial weeks of SMSRouter
installation, it is recommended that transmission
threshold limits for any client do not exceed 15
messages per second.
Message Per Minute, Message Per Hour, Message Per Day are automatically populated
Note
For field descriptions, refer to Add New Account
table.
Click Done to save changes.
6 - 58
Mobile-to-Application Messaging
Enter the required field values in : Add ESME Account. (For more information, refer to the
Mobile-to-Application Messaging
6 - 59N
6 - 60
Mobile-to-Application Messaging
Enter the number of short codes to be associated with the application in No. Of Service
Numbers.
Note
For information on the fields, refer to Table: Add
New Account.
Click Continue.
Mobile-to-Application Messaging
6 - 61N
Enter the short codes defined for the ESME account in Service Number.
In Standard Reply, enter the standard response to be sent to users sending service requests.
In Failure Reply, enter the failure response to be sent to users when the application is not
functional.
Click Done to save changes.
6 - 62
Mobile-to-Application Messaging
Enter the required field values in Add New Account screen. (For more information, refer to the
Enter the service number of the application in Service Number (in the example given above,
Mobile-to-Application Messaging
6 - 63N
Mobile-to-Application Messaging
established SMPP session are similar to a normal SMPP receiver session. Depending on the account
type, the Operator can enable this feature and configure one IP and port pair per account.
Example:
SMSRouter can use this feature to deliver large message volumes to ESME during televoting and
broadcasting election results.
To enable SMPP outbind sessions:
ESME Management > ESME Accounts >Add New Account
Select Account Type as Send and Receive.
Mobile-to-Application Messaging
6 - 65N
Select Yes in Outbind Enable. (This field is enabled only if the Account Type is Send and
Receive.)
Enter the IP address of the ESME application connecting with SMSRouter in Outbind Host.
Enter the port number of the ESME application connecting with SMSRouter in Outbind Port.
6 - 66
Mobile-to-Application Messaging
Note
For other field descriptions, refer to Creating ESME
Accounts.
messages are stored and retried based on the retry policy configured for the account. If retry
policy and error-based redirection is not defined for the account, retry is attempted based on the
default retry policy.
The store and forward enabled messages received from ESME accounts are recorded in the
secondary memory before attempting message delivery. If not delivered in the Direct Delivery
Attempt, delivery of messages is retried according to the retry policies configured for the
account.
If S&F is not configured, SMSRouter attempts to deliver the messages before storing the messages in the
database. Operators can enable the S&F functionality for specific accounts. The S&F feature is generally
enabled for messages that are not critical such as the promotional messages.
To enable store and forward for message delivery:
ESME Management > ESME Accounts >Add New Account
Enter the required field values in : Add ESME Account. (For more information, refer to the
Mobile-to-Application Messaging
6 - 67N
Select Yes in Store and Forward Enable to enable the store and forward functionality.
6.6.12 Ports
The Ports option lists all the SMPP, CIMD and UCP ports that are used by applications to connect to
SMSRouter server.
6 - 68
Mobile-to-Application Messaging
The screen displays the list of SMPP, CIMD and UCP ports.
Mobile-to-Application Messaging
6 - 69N
6 - 70
Mobile-to-Application Messaging
7 Generic Features
The features explained in the subsequent sections are applicable to all types of messaging.
Example:
Peter sends a message in Arabic to Rehman. SMSRouter accepts the message and decodes and
encodes the message as per UCS2 character set specifications and delivers the message.
Sample Message
curl 'http://127.0.0.1:13013/cgi-bin/
sendsms?user=test&pass=test&to=00919767213659&text=%06%4A%00%20
%06%41%06%25%06%46%00%20%06%27%06%44%06%44%06%47%00%20%06%44%06
%27%06%4A%06%3A%06%4A%06%31%00%20%06%45%06%27%06%28%06%42%06%48
%06%45&coding=3'
Note
SMSC Gateway needs to accept the message
for successful transmission to the subscriber.
7-1
configure the message count for direct deliveries and retries. The system buffers incoming messages for
retry attempts when there are minor problems in the Operators network. Once the threshold limit is
crossed, SMSRouter rejects incoming messages through MO and AO channels.
Note
The maximum buffer size is based on the
operating system and hardware memory constraints.
Example:
James sends a message to Peter. On receiving the message, SMSRouter immediately delivers the
message to Peter. If Peters mobile is unreachable, SMSRouter redirects the message to the secondary
SMSC.
segments. The shared memory interface is the best possible interface when high logging
throughput is expected and the Log server needs to handle multiple log files at the same time.
OS Message Queues: The Log server can retrieve log data through OS message queues. This
interface is, however, not recommended because it impacts and lowers down system
performance.
Database Logging: The Log server can log data directly on to the database. The Log server
configuration needs to be mapped with the data to be logged. The database in which the data
is logged also needs to be mapped with the Log server.
7-2
Generic Features
Note
For more information on the OAM module and
its components, refer to the Common OAM
User Manual.
Generic Features
7 - 3N
System overloads or malfunctions can slow down SMSRouter operations. The CSMD module of the OAM
application analyses the resource utilization of SMSRouter. Based on this data, Operators take corrective
action to release resources.
In the event of problems, the Heart Beat Manager (OAM application module) sends status alarms to the
Alarm Manager (OAM application module).
files are deleted from the SMSRouter system. The billing system should provide FTP access to
SMSRouter. The frequency and duration to push the CDRs is configurable through a cron
scheduler (For information on the cron scheduler, refer to the Comviva SMSRouter v4.0 OAM
Manual v 1.0).
7-4
Generic Features
Example:
SMSRouter of Circle A can act as a virtual service center for multiple Circles (Circle B, C and D). The
Operator of Circle A needs to configure the service center addresses of Circles B, C and D in SMSRouter
of Circle A.
Example:
An Operator can integrate SMSRouter with multiple MSCs. Each MSC has an unique point code. During
stack configuration, the Operator needs to define the point codes of all the MSCs to be connected to
SMSRouter.
Example:
Consider a situation where the SMSRouter in network A serves as a virtual SMSC for network B and
network C. All the short messages originating from network B and network C are directed to SMSRouter (in
network A) for delivery to destination addresses. The destination address could be within the same
network or across networks (A, B, C). The Operator can enable or disable the status of Delivery reports for
different service centers.
The subscribers of Circle A send MO messages to subscriber of the same Circle.The MO messages go to
Generic Features
7 - 5N
the Mobile Service Center (MSC). The MSC sends the messages to SMSRouter using the Forward Short
Message (FSM) operation. SMSRouter accepts messages and forwards it to the destination subscribers.
The message service center number stored in the SIM card of the senders mobile is the virtual service
center number (SMSRouter of Circle B). This service center can also act as a virtual service center for
Circle C. The Operator can enable the Delivery report flag for Circle A. In this case, the destination mobile
delivers the message delivery status to the originating mobile. Similarly, the Operator can disable Delivery
reportS for Circle B. If disabled, the destination mobile does not send the Delivery report to the originating
mobile.
In case of AO traffic, different accounts can be assigned different service center addresses.
7-6
Generic Features
The Virtual Service Center Details screen fields are explained in the table below:
Field
Description
SC Number
SC Name
Rules
Accounts
Service Numbers
To view the rules configured for the account, click View Rules.
Generic Features
7 - 7N
The fields of the Rule List screen are explained in the table below:
Field
Description
Validation
Condition
NA
Input Scenarios
NA
Example:
Source IMSI is the input
parameter for Source IMSI
Barring (SIB) rule.
Action
Action to be taken:
NA
Allowed
Barred
Redirect
Status
Rule status:
NA
Active
Inactive
7-8
User
NA
Date
NA
Reason
NA
Edit
NA
Generic Features
Field
Description
Delete
Validation
NA
Source: Comviva
Click Delete to delete the service center. A dialog box pops-up to re-confirm the operation.
Click OK.
number from the national to international format. The MSC of any network accepts messages
only from MSISDNS, which are in international formats. For optimal message delivery, country
codes are prefixed to the MSISDNs.
Example:
To send messages to the MSISDN 9845012345, SMSRouter translates it to international
format by prefixing 91 (country code).
Suffix: Numbers are suffixed to a MSISDN/MSISDN series to differentiate them from other
MSISDNs.
Generic Features
7 - 9N
Example:
To block the billing of messages sent from a given MSISDN or MSISDN series, a suffix is
added to the MSISDN or MSISDN series. A 44 is suffixed to a MSISDN/MSISDN series so that
the CDR details of messages sent from the suffixed MSISDN/MSISDN series are not sent to
dBILL for billing. Suffixes are added to numbers to hide the CLI of numbers.
Strip: This refers to removing a given set of digits from a MSISDN starting from a given position.
Digits are deleted from a specific position. This rule can be used to delete the national dialing
code (NDC) and international dialing code of the destination address.
Example:
Subscriber A (MSISDN is 9845112334) sends a message to Subscriber B (MSISDN
9845112313). When sending the message, Subscriber A may enter the MSISDN of Subscriber
B as 09845112313. SMSRouter deletes 0 from the destination number to convert the MSISDN
to a compatible format.
Replace: In this type of address manipulation, a specific part of the source or destination
MSISDN is replaced with a new value. This rule can be used to replace the entire MSISDN or a
part of it to make it a unique number.
Example:
The different Customer Care Executive MSISDNs are replaced with a common Helpdesk
number to help subscribers with easy and instant access.
Replace IF: In this type of address translation, SMSRouter searches for a specific part of the
source or destination MSISDN and replaces it with a new value. This rule is primarily used to
convert the numbers to a compatible format.
Example:
SMSRouter of Circle A searches for the number 88, in the MSISDN series of subscribers
sending messages to the subscribers of Circle B. The system replaces 88 with 288 because
Circle B does not support the 88 MSISDN series.
Addresses are translated to modify the source or destination addresses as per the Operator
requirements. The original TON or NPI of MSISDNS can also be replaced with a new TON or
NPI. Messages originating from MSISDNs, which are invalid are rejected.
The Super user can:
View existing address translation rules
Create new address translation rules
Delete address translation rules
7 - 10
Generic Features
Field
Description
Validation
Group Name
Data Type:
Alphanumeric
Number_Serie
s
Maximum 25 character.
Should be a valid
number or mobile
number series
Number Type
NA
Source
number
Destination
SCCP
Generic Features
number
7 - 11N
Field
TON
Description
Type of Number (TON) of the MSISDN or MSISDN series:
Validation
NA
International
National
Network
Specific
Subscriber
Alphanumeric
Abbreviated
Extension
NPI
NA
E164
X121
Telex
National
Private
Ermes
Extension
Min Length
Maximum 25
Give minimum length
7 - 12
Generic Features
Field
Action
Description
Validation
Select the action to be taken from the list. Actions can be:
PREFIX: To prefix the specified digits to the source/
destination address.
Offset/Value: This field is kept blank because the digits
are prefixed at the beginning of the string.
Length: Number of prefixed digits.
Value: Value to be prefixed.
SUFFIX: To suffix the specified digits to the source/
destination address.
Offset/Value: This field is kept blank because the digits are
always added at the end of the string.
Length: Number of digits to be used as a suffix.
Value: Value to be suffixed.
STRIP: Delete a given number of digits starting from a
be replaced.
Length: Number of digits to be replaced.
Value: Value with which the existing digits are to be
replaced.
REPLACE_IF: It is the same as REPLACE but applicable if
a pre-defined condition is satisfied.
Offset/Value: The search pattern to be used to replace the
required digits.
Length: Position of the digits to be searched. Values can be1
or 2.
1- Used to look for the search pattern at the beginning of the
number.
2- Used to look for search pattern anywhere in the number
(replace on the first occurrence).
Value: Value to be replaced if the search pattern is found in
the number.
Generic Features
7 - 13N
Field
Replace TON
Description
Validation
NA
International:
National:
Network
Subscriber
Number: The number starts without the international and national codes.
Alphanumeric:
character.
Abbreviated:
Replace NPI
Same as Alphanumeric.
NA
ISDN
Data
Telex
Land
Mobile
National
Private
ERMES
Internet
WAP
Client ID
Source: Comviva
Enter the name of the group for which the address translation rule is to be configured in Group
Name.
Enter the number series for which the address translation rule is configured in Number_Series.
Select the type of number from the Number Type list.
Select the Type of Number (TON) of the SMPP client application from the list.
Select the NPI of the application from the list.
Enter the minimum length of the number series in Min Length.
Select the type of action to be taken from the Action list.
Enter the offset or value or pattern for the rule in Offset/Value/Pattern.
Enter the length of the number to be prefixed or suffixed or stripped or replaced in Length.
7 - 14
Generic Features
The following table lists the fields of the Address Translation screen.
Field
Description
Validation
Number Series
NA
Length
Num_Type
NA
Generic Features
7 - 15N
Field
Rules
Description
The type of translation to be
done.
Validation
NA
PREFIX
SUFFIX
STRIP
REPLACE
REPLACE_IF
Edit
NA
Delete
NA
Source: Comviva
To view the rules applicable on a given MSISDN, enter the mobile number in Number and click
Search.
By default, 25 rows are displayed on the screen. You can change the number of rows that can
be displayed on a page. Specify the number of rows to be displayed in a single page in No. of
Rows/Page and click Go.
7 - 16
Generic Features
Click Delete to delete a given rule. A dialog box pops-up to re-confirm the operation.
Click OK to delete the rule.
Adding Networks
The Add Network option is used to add new network Operators to the SMSRouter database.
To add a network:
Service Management > Networks > Add Network
The following table lists the fields of the Add Network screen:
Generic Features
7 - 17N
Field
Operator Name
Description
Name of the network Operator.
Validation
Should
Alphanumeric
Special
Up
CC
Country Code
A unique code indicating the
country in which the network is
located.
NDC
to 50 characters.
Can
ues.
Up
to 2 digits
Can
only.
Up
to 4 digits.
Numeric
Up
values only.
to 2 digits.
Maximum
Numeric
Up
length is 15.
values only.
to 2 digits.
Maximum
length is 15.
Source: Comviva
number on the basis of the NDC. Multiple NDCs can be connected with a single CC by adding
multiple records with the same Operator name.
Specify the minimum number of characters required in a MSISDN in MSISDN (Min).
Enter the maximum number of digits allowed in a MSISDN in MSISDN (Max).
Click Done to validate the entries.
Viewing Networks
Existing GSM Operators details stored in the SMSRouter database can be viewed.
7 - 18
Generic Features
Field
Description
Validation
Operator Name
NA
CC
Country Code
NA
NA
NA
NA
Edit
NA
Delete
NA
Generic Features
7 - 19N
Field
Description
Validation
Source: Comviva
Deleting Networks
This option is used to delete the network Operators from the database.
Service Management > Networks
To delete a network:
Click Delete to delete a given network. A pop-up window appears to reconfirm the operation.
Click OK to confirm deletion.
7 - 20
Generic Features
Adding IMSIs
The Add IMSI Network option is used to add new IMSIs to the database.
To add new IMSIs:
Service Management > IMSI Network > Add IMSI Network
Generic Features
7 - 21N
Field
Description
Validation
Operator Name
NA
MCC
NA
NA
NA
NA
Edit
NA
Delete
NA
Source: Comviva
Deleting IMSIs
IMSI series of different network Operators can be deleted from the SMSRouter database.
To delete an IMSI:
7 - 22
Generic Features
Click Delete to delete a given IMSI. A pop-up window appears to reconfirm the operation.
Click OK to confirm deletion.
The following table lists the fields of the Redirection Account List screen:
Field
Description
Validations
SMSC ID
NA
NA
System ID
NA
Generic Features
7 - 23N
Field
Connection Type
Description
Protocol used to connect
SMSRouter and the Fallback
SMSC.
Validations
NA
Msg Redirection/Hour
NA
Edit
NA
Delete
NA
Redirection List
NA
Source: Comviva
Click View List against the SMSC to view the Fallback SMSCs configured for the SMSC
account.
7 - 24
Generic Features
clients can send/receive messages through the configured accounts. One or more service numbers can be
configured for each ESME account.
Each message, operation or response sent through SMPP consists of a header and data. A packet
number is assigned to each message.
Syntax
Hexdump
00 00 00 3C 00 00 00 04 00 00 00 00 00 00 00 05 00 02 08 35 35 35 00 01 01
35 35 35 35 35 35 35 35 35 00 00 00 00 00 00 00 00 00 00 0F 48 65 6C 6C 6F
20 77 69 6B 69 70 65 64 69 61
PDU Header
'command_length', (60)... 00 00 00 3C
'command_id', (4)... 00 00 00 04
'command_status', (0)... 00 00 00 00
'sequence_number', (5)... 00 00 00 05
PDU Body
'service_type', ()... 00
'source_addr_ton', (2)... 02
'source_addr_npi', (8)... 08
'source_addr', (555)... 35 35 35 00
'dest_addr_ton', (1)... 01
'dest_addr_npi', (1)... 01
'dest_addr', (555555555)... 35 35 35 35 35 35 35 35 35 00
'esm_class', (0)... 00
'protocol_id', (0)... 00
'priority_flag', (0)... 00
'schedule_delivery_time', ()... 00
'validity_period', ()... 00
'registered_delivery', (0)... 00
'replace_if_present_flag', (0)... 00
'data_coding', (0)... 00
'sm_default_msg_id', (0)... 00
'sm_length', (15)... 0F
'short_message', (Hello wikipedia)... 48 65 6C 6C 6F 20 13 77 69 6B 69 70
65 64 69 61'
Generic Features
7 - 25N
Note
SMPP is a standard telecommunication protocol.
For more information on SMPP protocol specifications, refer to http://www.greennetwork.es/archivos/
SMPP_v34.pdf.
7 - 26
Generic Features
The fields of the Add SMSC Account screen are explained in the table below:
Field
SMSC Account Name*
Description
Name of the SMPP account to
connect to SMSC.
Validation
Alphanumeric
Special
Maximum
15 characters
SMSC Details
Maximum 20 characters
Numeric
NA
*
Message Redirection (Per Min)
values only.
Maximum
15 digits.
7 - 27N
Field
Description
Validation
NA
NA
SMPP Host*
Valid address.
SMPP Port*
NA
SMPP Password*
NA
System Type*
Alphanumeric
Case
Address Range
Maximum Pending*
NA
Transceiver Mode*
NA
Special
True
False
7 - 28
Generic Features
Field
Keep Alive (In Sec.)
Description
Validation
NA
NA
International
National
Network
Specific
Subscriber
Alphanumeric
Abbreviated
Extension
NA
E164
X121
Telex
National
Private
Ermes
Extension
NA
International
National
Network
Specific
Subscriber
Alphanumeric
Abbreviated
Extension
Generic Features
7 - 29N
Field
Destination Address NPI*
Description
Numbering Plan Indicator (NPI)
of the SMPP client application
destination address:
Validation
NA
E164
X121
Telex
National
Private
Ermes
Extension
Message ID Type*
NA
1:
2:
3:
Note
If the type of NPI is not known, select Unknown.
Redirection (Per Sec.). Message Redirection (Per Min) and Message Redirection (Per
7 - 30
Generic Features
Hour) are automatically populated based on the value entered in Message Redirection (Per
Sec.).
Enter the IP address of the SMPP server in SMPP Host.
Enter the port to connect to the server in SMPP Port.
Enter the SMPP login user name in SMPP User Name.
Enter the SMPP login password in SMPP Password.
Enter the type of application connected to SMSRouter in System Type.
Enter the short codes to access the SMSC Account in Address Range.
Enter the maximum number of messages that can be kept in queue in Maximum Pending.
In Transceiver mode, select any one of the following values:
False:
True:
Enter the duration for which dummy data packets are to be exchanged between SMSRouter
and SMPP server to keep the connection alive in Keep Alive messages.
Select the type of source address of the SMPP client application. The source address has
three parts:
Type
of Number (TON)
Numbering
Source
Address
Select the Source Address NPI. This field gives the Numbering Plan Indicator (NPI) for the
SMPP client application source address. There are seven types of Source Address Number
Plan indicators:
E164
X121
TELEX
NATIONAL
PRIVATE
ERMES
EXTENSION
Note
Refer to GSM 03.40, Technical realization of the
Short Message Service Specifications for details
on TON and NPI types.
Select Destination Address TON. It specifies the destination address type for the SMPP client
of Number (TON)
Numbering
Source
Address
7 - 31N
Network
Specific
Subscriber
Alphanumeric
Abbreviated
Extension
Select Destination Address NPI. The Destination Address NPI specifies the Numbering Plan
Indicator (NPI) of the SMPP client application destination address. There are seven types of
Destination Address Number Plan indicators:
E164
X121
TELEX
NATIONAL
PRIVATE
ERMES
EXTENSION
7 - 32
Generic Features
SMSRouter has successfully acknowledged the message, and a timestamp is suffixed to the phone
number to display the time of delivery.
Note
UCP is a standard telecommunication protocol. For
more information on UCP protocol specifications,
refer to http://www.nowsms.com/discus/messages/
1/EMI_UCP_Specification_40-8156.pdf.
Generic Features
7 - 33N
The following table lists the fields of the Add SMSC Account screen:
Field
SMSC Account Name*
Description
Name of the UCP account to
connect to SMSC.
Validation
Alphanumeric
Special
Maximum
15 characters
SMSC Details
Maximum 20 characters
Numeric
Numeric
*
Message Redirection (Per Min)
Maximum
15 digits
values
Maximum
15 digits
7 - 34
Generic Features
Field
Description
Validation
Maximum
15 digits.
NA
UCP Host*
Valid address
UCP Port*
Alternate Host
Valid IP address
Alternate Port
Our Host
Valid IP address
Our Port
Receive Port
NA
UCP Password*
NA
NA
NA
Idle Time-out
Generic Features
7 - 35N
Field
Flow control
Description
Flow control is the process of
managing the rate of data
transmission between two nodes
to prevent a fast sender from
over running a slow receiver.
Validation
NA
protocol
Window
NA
Wait Back
NA
Possible values:
0x00:
disconnect/reconnect
0x01:
Re-queue
Source: Comviva
Redirection (Per Sec.). Message Redirection (Per Min) and Message Redirection (Per
Hour) are automatically populated based on the value entered in Message Redirection (Per
Sec.).
Enter the IP address of the UCP server in UCP Host.
Enter the port to connect to the UCP server in UCP Port.
7 - 36
Generic Features
Enter the alternate IP address of the machine hosting the UCP server in Alternate Host.
Enter the alternate port number of the machine hosting the UCP server in Alternate Port.
Enter the IP address of the machine hosting SMSRouter in Our Host.
Enter the port number of the machine hosting SMSRouter in Our Port.
Enter the port number of the machine on which the UCP client listens to TCP/IP connection in
Receive Port.
Enter the UCP login user name in UCP User Name.
Enter the UCP login password in UCP Password.
Enter the duration for which dummy data packets are to be exchanged between SMSRouter
and UCP server to keep the connection alive in Keep Alive Messages.
Enter the duration of Idle Time-out.
Enter the Flow Control mode.
Enter the size of the Window used to send messages.
Enter the action to be taken in case the acknowledgement of a message expires in Wait Back.
Click Done to save the changes.
Generic Features
7 - 37N
Note
CIMD is a proprietary protocol of Nokia.
The following table lists the fields of the Add SMSC Account screen:
7 - 38
Generic Features
Field
SMSC Account Name*
Description
Name of the CIMD account to
connect to SMSC.
Validation
Alphanumeric
Special
Maximum
15 characters
SMSC Details
Maximum 20 characters
Numeric
Numeric
*
Message Redirection (Per Min)
Maximum
Maximum
15 digits
15 digits
Numeric
Maximum
15 digits
NA
Valid address
CIMD Port*
NA
CIMD Password*
NA
Generic Features
7 - 39N
Field
Description
Our Port
Reconnect Delay*
Validation
NA
Redirection (Per Sec.). Message Redirection (Per Min) and Message Redirection (Per
Hour) are automatically populated based on the value entered in Message Redirection (Per
Sec.).
Enter the IP address of the UCP server in CIMD Host.
Enter the port to connect to the UCP server in CIMD Port.
Enter the port number of the machine hosting SMSRouter in Our Port.
Enter the CIMD login user name in CIMD User Name.
Enter the CIMD login password in CIMD Password.
Enter the duration for which dummy data packets are to be exchanged between SMSRouter
and the CIMD server to keep the connection alive in Keep Alive Messages.
Enter the duration of Reconnect Delay.
Click Done to save the changes.
7 - 40
Generic Features
The following table lists the fields of the Add SMSC Account screen:
Field
SMSC Account Name*
Description
Name of the CIMD account to
connect to SMSC.
Validation
Alphanumeric
Special
Maximum
Generic Features
15 characters
7 - 41N
Field
Connection Type*
Description
Type of connection between
SMSRouter and SMSC.
Validation
NA
GT Address Type
Numeric
NA
Maximum
21 digits
VMSC
SGSN
Type
Source: Comviva
Click Delete to delete the SMSC account. A pop-up window appears to reconfirm deletion.
7 - 42
Generic Features
If an SMSC account is part of the Redirection list, it cannot be deleted. It can only be deleted when the
SMSC account is removed from the Redirection list. If you attempt deletion, an error message is displayed.
the same capacity to effectively handle high message volumes. In this mode, messages are
distributed to the SMSCs in a round-robin mode to balance the load.
To effectively manage load, the messages are redirected to the Fallback SMSCs based on the selected
redirection mode. To implement redirection, a list of Fallback SMSCs is created. Messages are redirected
based on the selected mode of redirection to the SMSCs in the Redirection list. Redirection can be based
on one of the following modes:
Round Robin: In this mode, messages are redirected in the order of SMSCs configured in
SMSRouter. For example, if there are three SMSCs in SMSRouter, the first message is
redirected to the first Fallback SMSC, the second message to the second Fallback SMSC, the
third message is redirected to the third Fallback SMSC and the fourth to the first Fallback
SMSC.
Priority: SMSCs are assigned a priority level. All the messages are directed to the SMSC with
the highest priority till the SMSC reaches its maximum message threshold limit, after which
messages are sent to the SMSC with the next priority level.
Percentage: Based on the percentage of messages allowed per SMSC, a given percentage of
messages are redirected to each SMSC. Percent based load balancing also supports
configurable sampling rates, which helps the Operator to fine tune SMSRouter.
Generic Features
7 - 43N
Note
The Add Redirection List screen differs based on
the redirection type. The screens are the same for
Round Robin and Priority modes but different for
the Percentage mode.
Table 7-13: Add Redirection List Round Robin or Priority Redirection Type
Field
Redirection List Name*
Description
Name of the redirection list.
Validation
Maximum
Should
20 characters
bet.
7 - 44
Generic Features
Table 7-13: Add Redirection List Round Robin or Priority Redirection Type
Field
Redirection List Type*
Description
Indicates the type of redirection.
Message redirection is based on
the type of protocol used for
redirection of messages: IP or
SS7.
Validation
NA
If ESME is selected,
the SMSC accounts connected over SMPP/CIMD/
UCP get populated in the
SMSC list.
SS7:
Redirection Type*
Type of redirection.
NA
Robin
Priority
Percentage
Source: Comviva
To add an SMSC to the redirection list, select the Fallback SMSC from the list box on the left.
Click Add. The SMSC is added to the list box on the right.
To remove an SMSC from the list, select the SMSC to be deleted from the list box on the right.
Click Remove.
Click Done to save the changes.
Generic Features
7 - 45N
The fields of the Add Redirection List screen are described in the table below:
Field
Redirection List Name
Description
Name of the redirection list.
Validation
Maximum 20 characters
Should begin with an alphabet.
NA
If ESME is selected,
the SMSC accounts connected over SMPP/CIMD/
UCP get populated in the
SMSC list.
SS7:
Redirection Type
Type of redirection.
NA
Robin
Priority
Percentage
7 - 46
Generic Features
Field
Sample Value
Description
Percentage of messages (out of
the total number of messages
received by SMSRouter) to be
redirected to the configured
Fallback SMSCs.
Validation
NA
Source: Comviva
Enter the percentage of messages to be redirected to the Fallback SMSC in Sample Value. For
click Add. The SMSCs are added to the list box on the right.
To remove an SMSC from the list, select the SMSC to be deleted from the list box on the right.
Click Remove.
Click Done.
For each Fallback SMSC, enter the traffic (in percentage) to be redirected. The value added for
Note
You cannot add two Redirection lists with the same
name.
Generic Features
7 - 47N
The following table lists the fields of the Redirection List screen:
Field
Description
Validation
NA
Redirection Type
NA
Round
Robin
Priority
Percentage
Edit
NA
Delete
NA
Rules
7 - 48
Generic Features
Click Delete against the redirection list to be deleted. A pop-up window appears to reconfirm the
operation.
Click OK.
If the redirection list is part of the configured rules, the list cannot be deleted. If you attempt to delete it, an
error message appears.
To delete the Redirection list, remove the list from the rules configured in the system.
Generic Features
7 - 49N
of delivered messages
Number
of failed messages
SRI
counters
Number
of MT messages
Number
Number
ESME
Peak
SMSRouter
SS7
7 - 50
Graph
Generic Features
Bar
Graph
Spreadsheet
Tabular Format
By default, data is displayed as rows and columns where rows show the actual data while the columns list
the parameters of the respective message transfers.
To view statistics:
Graphical
To view data in a graphical format, select Chart Type and click Show Graph.
There are three chart types:
Line: The Line chart type displays tabular data in the form of a Line graph.
Generic Features
7 - 51N
Bar: The Bar chart type displays tabular data in the form of a Bar graph.
3D Column: The 3D Column displays data as a three-dimensional image and the data is
7 - 52
Generic Features
Spreadsheet
To view tabular data in an Excel sheet, click the Convert To Excel link.
Yearly Statistics
Yearly Statistics generates a statistical report of the SMS traffic pattern for different years. For each year,
the report displays the total number of P2P, P2A and A2P messages successfully transmitted by SMSRouter
and the number of delivery reports received by SMSRouter.
Generic Features
7 - 53N
The following table lists the report columns of the Yearly Statistics screen.
Column
Year
Description
Year for which the data is shown.
The values are hyper linked to
show the message statistics for
the selected year.
Validation
NA
NA
P2A
NA
A2P
NA
Feature SMS
DLVR Reports
NA
Total
NA
Source: Comviva
7 - 54
Generic Features
The following table lists the report columns of the Yearly Delivery Report Statistics screen.
Column
Year
Description
Year for which the data is shown.
The values are hyper linked to
show the message statistics for
the selected year.
Validation
NA
NA
Redirect
NA
Error
NA
Total
NA
Source: Comviva
Generic Features
7 - 55N
Yearly P 2 P Statistics
The report gives the total number of:
successfully transmitted P2P messages
redirected P2P messages
error messages
P2P messages
The following table lists thereport columns of the Yearly P2P Statistics screen.
Column
Year
Description
Year for which the data is shown.
The values are hyper linked to
show the message statistics for
the selected year.
Validation
NA
7 - 56
Success
NA
Redirect
NA
Error
NA
Generic Features
Column
Total
Description
Total number of messages
transmitted (whether successful
or unsuccessful).
Validation
NA
Source: Comviva
The screen displays the error count and the error description for the different type of errors.
Monthly Statistics
Monthly statistics generates the SMS traffic pattern statistics on a monthly basis.
Generic Features
7 - 57N
The following table lists the report column of the Monthly Statistics screen.
Column
Description
Validation
Month
NA
P2P
NA
P2A
NA
A2P
NA
DLVR Reports
NA
Total
NA
Source: Comviva
7 - 58
Generic Features
Daily Statistics
Daily statistics generates the SMS traffic pattern statistics on a daily basis.
To view daily statistics:
The following table report columns the fields of the Daily Statistics screen.
Columns
Description
Validation
Date
NA
P2P
NA
P2A
NA
Generic Features
7 - 59N
Columns
Description
Validation
A2P
NA
DLVR Reports
NA
Total
NA
Source: Comviva
Hourly Statistics
Hourly statistics generates the hourly SMS traffic pattern statistics.
To view hourly statistics:
Performance Management > Statistics > Year > Month > Date
7 - 60
Generic Features
Column
Description
Hour
Validation
NA
NA
P2A
NA
A2P
NA
DLVR Reports
NA
Total
NA
Source: Comviva
Graph
Graph
Three
dimensional form
Spreadsheet
Generic Features
7 - 61N
The following table lists the report columns of the Redirection Based Statistics screen:
Column
Description
Validation
SMSC Name
NA
Success
NA
Error
NA
Total
NA
Source: Comviva
7 - 62
Generic Features
To view the success or error statistics for a given period select day, month and year from the
Click a year to view the monthly statistics for the given year.
Note
For field descriptions, refer to Redirection Based
Statistics. table.
Note
The View Statistics Graphically option is disabled.
Generic Features
7 - 63N
Click a month to view the daily statistics for the given month.
Click on a value in the Error column to view the number of errors of each type.
The screen displays the error count and error description for different type of errors.
Graph
Graph
Three
7 - 64
dimensional form
Generic Features
Spreadsheet
The following table lists the report columns of the Network Statistics screen:
Column
Description
Validation
Operator ID
NA
Success
Number of messages
successfully delivered.
NA
Generic Features
7 - 65N
Column
Redirect
Description
Number of message
transmissions redirected to the
Fallback SMSCs.
Validation
NA
NA
Total
NA
Source: Comviva
To view the success or error or redirect statistics for a given period select day, month and year
7 - 66
Generic Features
Note
For field descriptions, refer to Network Statistics
table.
Click a year to view the monthly statistics for the given year.
Click a month to view the daily statistics for the given month.
Click on the Error field to view the total number of errors of each error type.
Generic Features
7 - 67N
Graph
Graph
Three
dimensional form
Spreadsheet
7 - 68
Generic Features
The following table lists the report columns of the VMSC Statistics screen:
Column
Description
Validation
VMSC
NA
Operator ID
NA
Success
Number of messages
successfully delivered.
NA
Redirect
Number of message
transmissions redirected to the
Fallback SMSCs.
NA
Generic Features
7 - 69N
Column
Description
Validation
Error
NA
Total
NA
Source: Comviva
To view the success/error/redirect statistics for a given period select day, month and year from
Note
For field descriptions, refer to VMSC Statistics
table.
Click a year to view the monthly statistics for the given year.
7 - 70
Generic Features
Click a month to view the daily statistics for the given month.
Click on the Error field to view the total number of errors of each error type.
7 - 71N
Graphical
Line
Bar
Graph
Graph
Three
dimensional form
Spreadsheet
The following table report columns the fields of the IMSI Statistics screen:
Column
7 - 72
Description
Validation
Operator ID
NA
Success
Number of messages
successfully delivered.
NA
Generic Features
Column
Redirect
Description
Number of message
transmissions redirected to the
Fallback SMSCs.
Validation
NA
NA
Total
NA
Source: Comviva
To view the success or error or redirect statistics for a given period select day, month and year
Generic Features
7 - 73N
Note
For field descriptions, refer to IMSI Statistics table.
Click a year to view the monthly statistics for the given year.
Click a month to view the daily statistics for the given month.
Click on the Error field to view the total number of errors of each error type.
7 - 74
Generic Features
Graph
Graph
Three
dimensional form
Spreadsheet
The following table lists the report columns of the Account Based Statistics screen:
Generic Features
7 - 75N
Column
Description
Validation
NA
Account ID
AO Accept Count
Number of application-originated
messages accepted by SMSRouter node
Success
NA
Redirect
NA
NA
Total
NA
Source: Comviva
To view statistics for a given period select day, month and year from the DD, MM, YYYY list
respectively.
Click Submit.
7 - 76
Generic Features
Note
For field descriptions, refer to Account Based Statistics table.
Click a year to view the monthly statistics for the given year.
Note
The View Statistics Graphically option is disabled.
Click a month to view the daily statistics for the given month.
Generic Features
7 - 77N
Click on the Error field to view the total number of errors for each error type.
7 - 78
Generic Features
The following table lists the report columns of the Subscriber Penetration screen:
Column
Description
Validation
NA
Unique Subscribers
NA
Total SMS
NA
NA
Source: Comviva
Generic Features
7 - 79N
The following table lists thereport columns of the Live Statistics screen:
Column
Description
Validation
NA
Node
NA
Flow Type
NA
AO
MO
SRI
MT
AT
MO-MT
AO-MT
MO-AT
MO Total
7 - 80
NA
Generic Features
Column
Description
Validation
MO Suc
NA
MO Fail
NA
SRI Total
NA
SRI Suc
NA
SRI Fail
NA
FSM Total
NA
FSM Suc
NA
FSM Fail
NA
AO Total
NA
AO Suc
NA
AO Fail
NA
AT Total
NA
AT Suc
NA
AT Fail
NA
Source: Comviva
Generic Features
7 - 81N
The screen displays the line graph of the pending messages for different SMSRouter nodes.
7 - 82
Generic Features
Field
ID
Description
Message ID;
A unique number assigned to a
MO-SMS by SMSRouter.
TM
OM
Originating address
DM
Destination address
SID
Source account ID
DID
Destination account ID
Port
Omsg
DMsg
DCS
Generic Features
7 - 83N
Field
Description
ESM
PID
OVMSC
DVMSC
Atmpt
SRR
0:
UDHI
TON
7 - 84
NPI
Result Code
MTRES
Generic Features
Field
ST
Description
Final delivery status of the SM:
0=Message
Accepted
1=Successful
2=Pending
because of time
out
3=Expired
4=Failed
5=Cancelled
6=Pending
message
because of tempo-
rary error
7=Discarded
message (For
intermediate and flash message)
8=Dropped
9=Transaction
Failed sched-
because of tempo-
rary error
HID
MD
TR
TS
CR
TP
CP
MFI
Generic Features
7 - 85N
Field
Description
DI
OV
OI
NA
Network Attempt.
0=Delivery
1=Delivery
attempted over
GSM
2=Delivery
attempted over
GPRS
3=Delivery
STON
SNPI
DSGSN
OID
Origination Message ID
Valid value in case of a Delivery
report, intermediate Delivery
report and flash message
0=in all other cases
Source: Comviva
7 - 86
Generic Features
message rate
Optional Parameters: Optional parameters are fields that may be optionally included in a
reserved.
General Errors
SMPP Error
Hex Value
Error Definition
ESME_RINVMSGLEN
0x00000001
ESME_RINVCMDLEN
0x00000002
ESME_RINVCMDID
0x00000003
Invalid command ID
ESME_RUNKNOWNERR
0x000000FF
Unknown error
Source: Comviva
Bind Errors
SMPP Error
Hex Value
Error Definition
ESME_RINVBNDSTS
0x00000004
ESME_RALYBND
0x00000005
ESME_RSYSERR
0x00000008
System error
ESME_RBINDFAIL
0x0000000D
Bind failed
87
SMPP Error
Hex Value
Error Definition
ESME_RINVPASWD
0x0000000E
Invalid password
ESME_RINVSYSID
0x0000000F
Invalid system ID
ESME_RINVSYSTYP
0x00000053
Submit Errors
88
SMPP Error
Hex Value
Error Definition
ESME_RINVPRTFLG
0x00000006
ESME_RINVREGDLVFLG
0x00000007
ESME_RINVSRCADR
0x0000000A
ESME_RINVDSTADR
0x0000000B
ESME_RINVMSGID
0x0000000C
Message ID is invalid
ESME_RCANCELFAIL
0x00000011
Cancel SM Failed
ESME_RREPLACEFAIL
0x00000013
Replace SM Failed
ESME_RINVSERTYP
0x00000015
ESME_RINVDLNAME
0x00000034
ESME_RINVDESTFLAG
0x00000040
ESME_RINVSUBREP
0x00000042
ESME_RINVESMCLASS
0x00000043
ESME_RCNTSUBDL
0x00000044
ESME_RSUBMITFAIL
0x00000045
ESME_RINVSRCTON
0x00000048
ESME_RINVSRCNPI
0x00000049
ESME_RINVDSTTON
0x00000050
SMPP Error
Hex Value
Error Definition
ESME_RINVDSTNPI
0x00000051
ESME_RINVREPFLAG
0x00000054
ESME_RINVSCHED
0x00000061
ESME_RINVEXPIRY
0x00000062
ESME_RINVDFTMSGID
0x00000063
ESME_RX_P_APPN
0x00000065
ESME_RX_R_APPN
0x00000066
ESME_RQUERYFAIL
0x00000067
ESME_RDELIVERYFAILURE
0x000000FE
Throttle Errors
SMPP Error
Hex Value
Error Definition
ESME_RMSGQFUL
0x00000014
ESME_RTHROTTLED
0x00000058
SMPP Error
Hex Value
Error Definition
ESME_RINVOPTPARS
TREAM
0x000000C0
ESME_ROPTPARNOT
ALLWD
0x000000C1
89N
SMPP Error
Hex Value
Error Definition
ESME_RINVPARLEN
0x000000C2
ESME_RMISSINGOPT
PARAM
0x000000C3
ESME_RINVOPTPARA
MVAL
0x000000C4
SMPP Error
Hex Value
Error Definition
ESME_VREP_ATTEMPT
0x00000400
ESME_VREP_FINALSTAGE
0x00000401
90
Error Code
Message
01
Checksum error
02
Syntax error
03
04
05
06
ADC invalid
07
Authentication failure
Error Code
Message
08
09
GA not valid
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
30
Subscriber hang-up
31
32
33
91N
Error Code
Message
34
35
36
37
Delivery in progress
38
Message forwarded
Source: Comviva
SMSRouter Codes
SMSRouter logs all mobile and application-originated messages, which can be traced from the log files.
The errors encountered by SMSRouter in the transmission of messages can be categorized as follows:
Result Codes: Parameter R in SMSRouter logs (submitism_backup and retry) signifies a result
code.
Message Status Codes: The st parameter of the mts_cdr.log indicates the message status
code.
Error Codes: Parameter E in SMSRouter logs signifies an error. Errors are of three types:
User
Errors: User errors indicate errors returned by the GSM network. These are
further categorized into:
Send
Forward
Forward
Provider
Error Codes: R:03 errors returned by the MAP service provider (Stack).
Internal
Error: If there are internal errors in any module of SMSRouter, the messages
are redirected to the rr module. The rr module further redirects the messages to the
Fallback SMSC. In such cases, the value of E = -1 and the value of R = -1 in the CDR
log.
Each error code has an error type associated with the error. T stands for Temporary and indicates that
SMSRouter reattempts to deliver the message; P stands for Permanent and indicates that SMSRouter
does not make any further delivery attempts for the message.
92
Error Types
Errors are classified into the following types:
User Error
Provider Error
Internal Error
User Errors
These errors occur while transmitting messages and are due to disruption in the GSM network. They may
be temporary or permanent.
Temporary errors: Errors due to which message delivery is retried later. The errors for MT
messages could be due to absent subscribers or busy subscribers.
Permanent errors: Errors due to which messages are discarded and not retried for delivery.
The errors could be because the service is not provisioned or due to unidentified or unknown
subscribers.
Provider (Network) Error
These errors are due to network congestion, disruption in communication between the stack and the MSC,
routing problems between the network and SMSRouter. (Examples are unknown base station, unknown
MSC or a system failure.)
Internal Error
These errors are caused when there is a disruption in communication between the Signaling server and
the stack or the Signaling server and SMSRouter (for instance, an internal time-out).
93N
Result Codes
Hex Code
Result Code
Result Definition
0x00
No_Info
No Information Received
0x01
NO_Error
No Error
0x02
User_Error
0x03
Prov_Error
0x04
INT_Error
Hex Code
Result Definition
0x00
0x01
0x02
0x03
Message Expired
0x04
0x05
0x06
0x07
94
Error
(Decimal)
Code
Error
(Hex)
Code
Error Name
Error Type
Description
0x01
Unknown
Subscriber
No such subscription
exists
0x05
Unidentified
Subscriber
0x06
Absent
Subscriber for
SM
The mobile-terminated
short message transfer
cannot be completed
because the network
cannot contact the
subscriber.
0x09
Illegal
Subscriber
The authentication
procedure has identified
the subscriber access
as illegal.
11
0X0b
Teleservice
Not
Provisioned
12
0x0c
Illegal
Equipment
13
0x0d
Call Barred
21
0x15
Facility Not
Supported
27
0x1b
Absent
Subscriber
95N
Error
(Decimal)
31
Code
Error
(Hex)
0x1f
Code
Error Name
Error Type
Description
Subscriber
Busy for MTSMS
96
32
0x20
SM Delivery
Failure
33
0x21
Message
Waiting List
Full
34
0x22
System Failure
A job cannot be
performed because of a
problem in another
entity. Checking the
network resource usage
can help identify the
type of entity or network
resource.
35
0x23
Data Missing
An optional parameter
required by the context
is missing.
36
0x24
Unexpected
Data Value
45
0x2d
Busy
Subscriber
46
0x2e
No Subscriber
Reply
Error
(Decimal)
Code
Error
(Hex)
Code
Error Name
Error Type
Description
Source: Comviva
Error Code
(Decimal)
Error
(Hex)
Code
Description
Type
Error
0x00
Duplicate Invoke ID
0x01
0x02
Mistyped Parameter
0x03
Resource Limitation
0x04
Initiating Release
0x05
Unexpected Response
0x06
0x07
of
Source: Comviva
Error Code
Result Code
Description
Type
Error
0x04
No Response from
Stack
400
0x00
No Response from
Signaling Server
500
0x00
Invalid Destination
Address
900
0x00
Transaction Failed
of
Source: Comviva
97N
Error Code
(Decimal)
Error
(Hex)
Code
Description
Type
Error
0x00
0x01
0x02
0x03
0x04
0x05
0x06
of
Source: Comviva
98
Error Code
(Decimal)
Error
(Hex)
Code
Description
Type
Error
0x01
Unknown Subscriber
0x02
0x03
Unknown MSC
0x05
Unidentified Subscriber
0x06
0x07
Unknown Equipment
0x08
0x09
Illegal Subscriber
10
0x0a
11
0X0b
12
0x0c
Illegal Equipment
of
Error Code
(Decimal)
Error
(Hex)
13
Description
Type
Error
0x0d
Call Barred
14
0x0e
15
0x0f
CUG rejected
16
0x10
17
0x11
SS error status
18
0x12
SS not available
19
0x13
20
0x14
SS incompatible
21
0x15
25
0x19
26
0x1a
27
0x1b
Absent Subscriber
28
0x1c
Incompatible Terminal
29
0x1d
30
0x1e
31
0x1f
32
0x20
SM Delivery Failure
33
0x21
34
0x22
System Failure
35
0x23
Data Missing
36
0x24
37
0x25
Registration Failure
39
0x27
40
0x28
45
0x2d
Busy Subscriber
46
0x2e
No Subscriber Reply
47
0x2f
Forwarding failed
Code
of
99N
Error Code
(Decimal)
Error
(Hex)
48
Code
Description
Type
Error
0x30
49
0x31
50
0x32
51
0x33
Resource limitation
52
0x34
53
0x35
54
0x36
58
0x3a
71
0x47
Unknown alphabet
72
0x48
117
0x75
Gateway error
of
Source: Comviva
Internal Error
Error Code
(Decimal)
Error
(Hex)
Code
Description
Type
Error
0x1
0x2
0x3
0x4
Handover
Network
Call
cancellation
path release
release
Associated
Remote
100
0x7
of
procedure failure
operations failure
Error Code
(Decimal)
Error
(Hex)
10
0xa
Code
Description
Unrecognized
Type
Error
message type
of
Transaction
11
0xb
Unrecognized transaction ID
received
12
0xc
13
0xd
14
0xe
15
0xf
20
0x14
Network failure
Network congestion
21
0x15
22
0x16
23
0x17
30
0x1E
0X1F
32
0X20
33
0X21
Unknown error
34
0X22
Incorrect GT address
35
0X23
101N
Error Code
(Decimal)
Error
(Hex)
36
37
Code
Description
Type
Error
0X24
0X25
of
Source: Comviva
Provider Error
Error Code
(Decimal)
Error
(Hex)
Code
Description
Type
Error
0x00
Duplicate
Invoke ID
0x01
Service Not
Supported
0x02
Mistyped
Parameter
0x03
Resource
Limitation
0x04
Initiating
Release
0x05
Unexpected
Response
0x06
Service
Completion
Failure
0x07
No Response
From Peer
SMSC
0x08
Invalid
Response
of
Source: Comviva
102
Priority
Rules
PID Barring
Priority
Redirection Rule
MO Relay
PID Redirection
103
Priority
Redirection Rule
10
11
12
13
14
15
16
17
18
19
20
21
104
Priority
Barring Rule
PID Barring
Priority
Redirection Rule
PID Redirection
Application Termination
Redirection
10
Priority
Barring Rule
PID Barring
105N
Priority
Redirection Rules
PID Redirection
106
10
11
12
13
14
Description of
Changes
Change
Mode
Comments
Date of
Change
Author
(A/M/D)
1.0
Initial
Sutapa
107
Contact Us
Delhi Headquarters
A-26, Info City
Sector 34
Gurgaon 122001
Haryana, India
Tel:+91-124-4819000
Fax:+91-124-4819777
Bangalore Office
4, 12th Km Stone
Bellary Road, Jakkur
Bangalore 560064
India
Tel:+91-80-43401600
Fax:+91-80-28565854
Mumbai Office
Unit No 1234, Ist Floor
Paradigm Tower, Tower B
Mindspace, Off New Link Road
Malad-West 400064
India
Tel: +91 22 40774300
Fax: +91 22 40774333
Contact Us
109