SMS Service Configuration Mode Commands

The SGSN uses the SMS Service component to communicate via the Gd interface with a gateway message service controller (GMSC) to send short text messages (up to 140 octets in length) to a mobile (SMS-MT) and/or receive messages from a mobile (SMS-MO) .

When this mode is accessed, the command line will appear similar to

[<ctx_name>]asr5000(config-map-service-<map_service_name>-sms-service)#

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

cp-data

Enables the SGSN to send and/or receive cp-data (text messages).

Platform:

ASR 5000

Product:

SGSN

Privilege:

Security Administrator, Administrator

Syntax

cp-data max-retransmission retries_numdefault cp-data max-retransmissions

default

This keyword resets the SGSN’s max-retransmission to the default number of retries.

max-retransmission retries_num

retries_num: enter an integer from 1 to 3.

Usage:

Use this command to configure the number of times the SGSN will attempt to retransmit a message.

Example:

cp-data max-retransmission
 2

end

Exits the current configuration mode and returns to the Exec mode.

Product:

All

Privilege:

Security Administrator, Administrator

Syntax

end

Usage:

Use this command to return to the Exec mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product:

All

Privilege:

Security Administrator, Administrator

Syntax

exit

Usage:

Use this command to return to the parent configuration mode.

mo-message-forwarding-destination

This command defines the SGSN’s handling policy for MO (mobile originating) message.

Platform:

ASR 5000

Product:

SGSN

Privilege:

Security Administrator, Administrator

Syntax

[ default ] mo-message-forwarding-destination
 { gmsc-selected-from-imsi | smsc-supplied-by-subscriber }

default

Resets the SMS service configuration to the default message forwarding technique.

gmsc-selected-from-imsi

Entering this keyword enables SMS-MO messages to be forwarded on the basis of their IMSI prefix.

smsc-supplied-by-subscriber

Entering this keyword enables SMS-MO messages to be forwarded on the basis of the SMSC (SMS controller) address provided by the subscriber.

Usage:

Use this command to define how the mobile originated SMS are to be routed.

Example:

mo-message-forwarding-destination gmsc-selected-from-imsi

smsc-address-restiction-list

Define the list of SMS-C addresses to be screened.

Platform:

ASR 5000

Product:

SGSN

Privilege:

Security Administrator, Administrator

Syntax

smsc-address-restriction-list isdn-no +no smsc-address-restriction-list isdn-no

Delete an SMS-C address (ISDN number) from the list.

isdn-no +

Enter up to 10 ISDN numbers, each up to 15 digits. Put a single space, without a comma, between each ISDN number being added to the list with one command.

Usage:

Use this command to identify a list of SMS-C that are to be screened and restricted from receiving forwarded SMS. This list is part of the SMS-C address denial mechanism. For the mechanism to actually function, a second command must be configured, the smsc-address-restriction-list command.

Example:

Add 3 ISDN numbers to the list of restricted SMS-C addresses.

smsc-address-restriction-list
 443719933751427
422311198977765 901231445513131

Remove an ISDN number from the list of restricted SMS-C addresses.

no smsc-address-restriction-list
 443719933751427

smsc-address-restiction-type

Define the list of SMS-C addresses to be screened.

Platform:

ASR 5000

Product:

SGSN

Privilege:

Security Administrator, Administrator

Syntax

smsc-address-restriction-type { mo-mt-sms | mo-sms | mt-sms }default smsc-address-restriction-type

default

Resets the restriction type to the default of both MT and MO types.

mo-mt-sms

Sets the restriction for both types of messages - mobile-originated (MO-SMS) and mobile-terminated (MT-SMS).

mo-sms

Sets the restriction for the mobile-originated (MO-SMS) messages.

mo-mt-sms

Sets the restriction for the mobile-terminated (MT-SMS) messages.

Usage:

Use this command to identify the types of messages that are to be denied to the SMS-C identified in the smsc-address-restriction-type. Both commands must be configured for the SMS-C address denial mechanism to function.

Example:

Restrict MO-SMS messages from being forwarded to the SMS-C listed in the restriction list:

smsc-address-restriction-type
 mo-sms

Reset the restriction to both types of messages:

default smsc-address-restriction-type

smsc-address-selection-prioritization

Define the routing selection priority for the SMSC (short message service center) address to be used for all MO-SMS.

Platform:

ASR 5000

Product:

SGSN

Privilege:

Security Administrator, Administrator

Syntax

smsc-address-selection-prioritization from-ms priority imsi-prefix priority msisdn-prefix  priority

default smsc-address-selection-prioritization

from-ms priority

Configures a priority for the SMSC address send from the MS.

priority : Value must be a single digit, range 1-3.

imsi-prefix priority

Configures a priority for the SMSC address that is based on the IMSI-prefix.

priority : Value must be a single digit, range 1-3.

msisdn-prefix priority

Configures a priority for the SMSC address that is based on the MSISDN-prefix.

priority : Value must be a single digit, range 1-3.

default

By including the default keyword with the command, the SGSN knows to use the encoded default priorities for SMSC address selection for SMSC routing:

from-ms priority 1,
imsi-prefix priority 2,
msisdn-prefix priority 3.

Usage:

Use this command to define SMSC address routing priorities. Priorities must be defined for all parameters, all keywords, but they can be entered in any order. The addresses for the SMSCs are defined with the smsc-routing command.

An operator can use this configuration to prevent subscribers from using unauthorized SMSC addresses, for example, an unauthorized international SMSC.

Example:

The keywords can be entered in any order but all keywords must be included in the command:

smsc-address-selection-prioritization
msisdn-prefix 3 from-ms 1 imsi-prefix 2

smsc-routing

This command configures the routing to the short message service center (SMSC).

Platform:

ASR 5000

Product:

SGSN

Privilege:

Security Administrator, Administrator

Syntax

[ no ] smsc-routing { { any | imsi-starts-with | msisdn-starts-with } { isdn isdn_number | mobile-global-title mgt_number [ max-gt-address-len
 max_gt_length ] | point-code pt_code } }

any

Configures routing according to any IMSI prefix.

imsi-starts-with IMSI_prefix

Defines the IMSI prefix. Enter a string of up to 15 digits.

msisdn-starts-with msisdn_prefix

Defines the MSISDN prefix. Enter a string of up to 15 digits.

isdn isdn_number

Defines the ISDN E.164 number (up to 15 digits) of the SMSC.

mobile-global-title mgt_number [ max-gt-address-len max_gt_length ]

Defines the mobile global title (MGT) E.214 address to be used for IMSI conversion.

Optionally, the maximum length of the GT address can be defined. If the length of the MGT string is greater than the defined max, then the least significant digits will be omitted.

mgt_number is a string of digits, up to 18 digits.

max_gt_address is an integer from 1 to 32.

point-code pt_code

Defines the point code for the SMSC. Enter a string of up to 11 digits in SS7 dotted decimal or decimal format

Usage:

This command defines the address format (IMSI, point code, mobile global title) and the address for SMSC routing.

Example

Example

Use this command to define routing to the SMSC based on any point code.

smsc-routing any point-code 1.222.1

timeout

This command defines the SMS service timers.

Platform:

ASR 5000

Product:

SGSN

Privilege:

Security Administrator, Administrator

Syntax

timeout { tc1n-timertime | tr1n-timer
 time |  tr2n
timer  time }default timeout { tc1n-timer | tr1n-timer | tr2n
timer }

default

Resets the configuration to the default value for the specified timer.

tc1n-timer time

Configures the TC1N timer in seconds.

time: Must an integer from 1 to 255. The default is 5 seconds.

tr1n-timer time

Configures the TR1N timer in seconds.

time: Must an integer from 1 to 255. The default is 30 seconds.

tr2n-timer time

Configures the TR2N timer in seconds.

time: Must an integer from 1 to 255. The default is 30 seconds.

Usage:

Use this command to set SMS service timers. The command can be repeated to set all of the timers, one-at-a-time.

Example:

tr1n-timer 25