Commands

3.1 Introduction

This chapter describes the EAGLE commands used to administer the MO SMS related feature. The command descriptions include parameters that are used with the MO SMS related feature. Refer to Commands User's Guide for complete command descriptions including parameter names, valid parameter values, examples, and dependencies.

3.2 EAGLE STP System Options Commands

The STP system options commands (stpopts) change and display the STP node level processing options in the EAGLE database. The following sections describe the two variations: chg-stpopts and rtrv-stpopts.

chg-stpopts

Change STP System Options Command – The chg-stpopts command changes STP system options in the database. This command updates the STPOPTS table. The defcc and defndc parameters are used to convert non-international numbers received in the MSU to an international number. The defcc and defndc parameters can be specified only if the ATINP, G-Port, MO SMS IS41-to-GSM Migration, MO-based GSM SMS NP, MO-based IS41 SMS NP, Prepaid IDP Query Relay (IDPR), Prepaid Short Message Service Intercept (PPSMS), or V-Flex feature is enabled or if the AINPQ, G-Flex, or INP feature is turned on.

Note:

If the MT-Based GSM SMS NP or ATINP feature is turned on, the defcc parameter cannot be set to none.

Table 3-1 chg-stpopts Parameters - Class = DATABASE

Parameter	Range	Description
defcc	1-3 digits, none	Default country code
defndc	1-5 digits, none	Default network destination code

Command example:

chg-stpopts:defcc=33:defndc=22345

rtrv-stpopts

Retrieve STP System Options Command – The rtrv-stpopts command is used to retrieve all STP options from the database. The options that appear in the output vary, depending on the features that are enabled or turned on.

3.3 EAGLE GSM System Options Commands

The GSM system options (gsmopts) commands change and display GSM system options in the EAGLE database. The following sections describe the two variations: chg-gsmopts and rtrv-gsmopts.

chg-gsmopts

Change GSM System Options Command – The chg-gsmopts command changes GSM system options in the database. This command updates the GSMOPTS table. The default parameters are always overwritten when specified.

Table 3-2 chg-gsmopts Parameters - Class = DATABASE

Parameter	Range	Description
defmapvr	1-3	Default MAP version
is412gsm	1-15 digits, none	IS41 to GSM migration prefix

Command example:

chg-gsmopts:defmapvr=2

rtrv-gsmopts

Retrieve GSM System Options Command

The rtrv-gsmopts command displays all GSM system options from the database. The G-Port, EIR, IGM, MO-based GSM SMS NP, MO SMS IS41-to-GSM Migration, MO SMS ASD, MO SMS GRN, MO SMS B-Party Routing, Prepaid SMS Intercept, or V-Flex feature must be enabled, or the G-Flex feature must be turned on before the command output is displayed.

3.4 EAGLE GSM SMS Options Commands

The GSM SMS options (gsmsmsopts) commands change and display specific SMS options in the EAGLE database for the MO SMS ASD, MO SMS GRN, MO-based GSM SMS NP, Prepaid SMS Intercept, and Portability Check for MO SMS features. The following sections describe the two variations: chg-gsmsmsopts and rtrv-gsmsmsopts.

The MO SMS ASD, MO SMS GRN, or MO-based GSM SMS NP feature must be enabled to specify the parameters: mosmsfwd, mosmsgta, mosmssa, mosmstype.

The MO-based GSM SMS NP or Portability Check for MO SMS feature must be enabled to specify the mosmsdigmat parameter.

The MO-based GSM SMS NP or Portability Check for MO SMS feature must be turned on to specify the mosmstcapseg parameter.

The MO SMS ASD, MO SMS GRN, MO-based GSM SMS NP, or PPSMS feature must be enabled to specify the parameters: mosmsaclen, mosmsnai.

The MO-based GSM SMS NP feature must be enabled to specify the parameters: defrn, spfill.

The Service Portability feature must be enabled to specify the sporttype parameter.

chg-gsmsmsopts

Change GSM SMS Options Command – The chg-gsmsmsopts command changes GSM SMS system options in the database. This command updates the GSMSMSOPTS table. The default parameters are always overwritten when specified.

Table 3-3 chg-gsmsmsopts Parameters - Class = DATABASE

Parameter	Range	Description	Applies to
defrn	1-15 hexadecimal digits, none	Default Routing Number for own-network subscribers	This parameter applies to only messages modified by the MO-based GSM SMS NP feature.
mosmsaclen	0-8	Area Code length. This parameter specifies the number of digits taken from the MO SMS CgPA parameter and used as the Area Code in the MO SMS CdPA parameter.	This parameter applies to only messages modified by the MO SMS ASD, MO SMS GRN, MO-based GSM SMS NP, or PPSMS feature.
mosmsdigmat	exact, bestfit	MO-based SMS HomeSMSC match.	This parameter applies to only messages processed by the MO-based GSM SMS NP feature or the Portability Check for MO SMS feature.
mosmsdnfmt	rn, rndn, ccrndn	MO-based SMS directory number format	This parameter applies to only messages modified by the MO-based GSM SMS NP feature.
mosmsdnnai	0-7, none	MO-based SMS directory number NAI	This parameter applies to only messages modified by the MO-based GSM SMS NP feature.
mosmsfwd	yes, no	MO-based SMS forward	This parameter applies to only messages modified by the MO SMS ASD, MO SMS GRN, or MO-based GSM SMS NP feature.
mosmsgta	5-21 digits, none	MO-based SMS GTA	This parameter applies to only messages modified by the MO SMS ASD, MO SMS GRN, or MO-based GSM SMS NP feature.
mosrnsnai	intl, nai, nat, unknown	MO-based SMS NAI	This parameter applies to only messages modified by the MO SMS ASD, MO SMS GRN, MO-based GSM SMS NP, or PPSMS feature.
mosmssa	yes, no	MO-based SMS sub-address	This parameter applies to only messages modified by the MO SMS ASD, MO SMS GRN, or MO-based GSM SMS NP, or PPSMS feature.
mosmstcapseq	on, off	MO-based SMS TCAP Segmentation for GSM	This parameter applies to only messages that are modified by the Portability Check for MO SMS feature or the MO-based GSM SMS NP feature.
mosmstype	sp, rn, sprn, all	MO-based SMS type	This parameter applies to only messages modified by the MO-based GSM SMS NP feature.
spfill	on, off	Fill SP Formatting Action. This parameter applies to the handling of own-network subscribers, and controls whether NPP populates both SP and RN Formatting Action values.	This parameter applies to only messages modified by the MO-based GSM SMS NP feature.
sporttype	gsm, is41, all, none	Service Portability Type. This parameter indicates which of the own-network subscribers need Service Portability applied.	This parameter applies to only messages modified by the MO-based GSM SMS NP feature.

Command example for setting the GSM SMS options when the MO-based GSM SMS NP feature is enabled:

chg-gsmsmsopts:mosmsnai=intl:mosmstype=sp:mosmssa=no

Command example for setting the GSM SMS options when the MO-based GSM SMS NP or Portability Check for MO SMS feature is enabled and turned on:

chg-gsmsmsopts:mosmsdigmat=bestfit

rtrv-gsmsmsopts

Retrieve GSM SMS Options Command

The rtrv-gsmsmsopts command displays all GSM SMS options from the database when at least one GSM SMS-related feature is enabled.

3.5 EAGLE IS41 SMS Options Commands

The IS41 SMS options (is41smsopts) commands change and display SMS options in the EAGLE database for the MO SMS ASD, MO SMS GRN, MO-based IS41 SMS NP, and MO SMS IS41-to-GSM Migration features. The following sections describe the two variations: chg-is41smsopts and rtrv-is41smsopts.

The MO SMS ASD, MO SMS GRN, MO-based IS41 SMS NP, or MO SMS IS41-to-GSM Migration feature must be enabled to specify the parameters: modaparam, mosmsaclen, mosmsnai.

The MO-based IS41 SMS NP or MO SMS IS41-to-GSM Migration feature must be enabled to specify the mosmsdigmat parameter.

The MO-based IS41 SMS NP feature must be enabled to specify the mosmstype parameter.

The MO SMS IS41-to-GSM Migration feature must be enabled to specify the moigmpfx parameter.

The MO-based IS41 SMS NP feature must be enabled to specify the parameters: defrn, spfill.

The Service Portability feature must be enabled to specify the sporttype parameter.

chg-is41smsopts

Change IS41 SMS Options Command - The chg-is41smsopts command changes the IS41 SMS system options in the database. This command updates the IS41SMSOPTS table. The default parameters are always overwritten when specified.

Table 3-4 chg-is41smsopts Parameters - Class = DATABASE

Parameter	Range	Description	Applies to
defrn	1-15 hexadecimal digits, none	Default Routing Number for own-network subscribers	This parameter applies to only messages modified by the MO-based IS41 SMS NP feature.
modaparam	da, oda	Specifies whether the SMS_DestinationAddress or SMS_Original DestinationAddress from the IS41 SMDPP message is used for conditioning, lookup, and modification.	This parameter applies to only messages modified by the MO SMS ASD, MO SMS GRN, MO-based IS41 SMS NP, or MO SMS IS41-to-GSM Migration feature.
moigmpfx	ne, is412gsm	MO SMS IS41-to-GSM Migration prefix. This parameter specifies whether the MO SMS IS41-to-GSM Migration feature uses digits from the RTDB network entity (NE) associated with the B number or the `is412gsm` parameter as a prefix to modify the destination address in the outgoing SMDPP.	This parameter applies to only messages modified by the MO SMS IS41-to-GSM Migration feature.
mosmsaclen	0-8	Area Code length. This parameter specifies the number of digits taken from the MO SMS CgPA parameter and used as the Area Code in the MO SMS CdPA parameter.	This parameter applies to only messages modified by the MO SMS ASD, MO SMS GRN, MO-based IS41 SMS NP, or MO SMS IS41-to-GSM Migration feature.
mosmsdigmat	exact, bestfit, bypass	HomeSMSC Match with Digits search option	This parameter applies to only messages modified by the MO-based IS41 SMS NP or MO SMS IS41-to-GSM Migration feature.
mosmsdnfmt	rn, rndn, ccrndn	MO-based SMS directory number format	This parameter applies to only messages modified by the MO-based IS41 SMS NP or MO SMS IS41-to-GSM Migration feature.
mosmsdnnai	0-15, none	MO-based SMS directory number NAI	This parameter applies to only messages modified by the MO-based IS41 SMS NP or MO SMS IS41-to-GSM Migration feature.
mosmsnai	intl, nai, nat, unknown	MO-based SMS Nature Address Indicator	This parameter applies to only messages modified by the MO SMS ASD, MO SMS GRN, MO-based IS41 SMS NP, or MO SMS IS41-to-GSM Migration feature.
mosmstype	sp, rn, sprn, all	MO-based SMS Type	This parameter applies to only messages modified by the MO-based IS41 SMS NP feature.
spfill	on, off	Fill SP Formatting Action. This parameter applies to the handling of own-network subscribers, and controls whether NPP populates both SP and RN Formatting Action values.	This parameter applies to only messages modified by the MO-based IS41 SMS NP feature.
sporttype	gsm, is41, all, none	Service Portability Type. This parameter indicates which of the own-network subscribers need Service Portability applied.	This parameter applies to only messages modified by the MO-based IS41 SMS NP feature.

Command example for setting the IS41 SMS options when the MO-based IS41 SMS NP feature is enabled:

chg-is41smsopts:mosmstype=sp:mosmsnai=intl:mosmsdigmat=exact:modaparam=da:mosmsaclen=3

rtrv-is41smsopts

Retrieve IS41 SMS Options Command

The rtrv-is41smsopts command displays all IS41 SMS options from the database when at least one IS41 SMS-related feature is enabled.

3.6 EAGLE Prepaid SMS Options Commands

The Prepaid SMS options (ppsopts) commands change and display specific SMS options in the EAGLE database for the Prepaid Short Message Service Intercept (PPSMS) feature. The following sections describe the two variations: chg-ppsopts and rtrv-ppsopts.

The Prepaid Short Message Service Intercept (PPSMS) feature must be enabled to use this command.

chg-ppsopts

Change Prepaid SMS Options Command – The chg-ppsopts command changes Prepaid SMS system options in the database. This command updates the PPSOPTS table with entries that correspond to Intelligent Network (IN) platforms. The default parameters are always overwritten when specified.

Table 3-5 chg-ppsopts Parameters - Class = DATABASE

Parameter	Range	Description
pci	s-. 0-255, none	ITU international point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id).
pcn	s-, 0-16383. aa-zz, none	ITU national point code in the format of a 5-digit number (nnnnn), or two to four numbers (members) separated by dashes (m1-m2-m3-m4) The `prefix` subfield indicates a spare point code.
ppt	1-32	Prepaid portability type. This parameter specifies the IN platform where the incoming message is sent.
ri	gt, ssn	Routing indicator. This parameter specifies the IN platform routing indicator.
setid	1-36000, none, dflt	Set ID. This parameter specifies the MAP set ID if `ri=ssn`, or MRN set ID if `ri=gt`. The Set ID is used by a loadsharing IN platform.
ssn	2-255, none	Subsystem number. This value is used as the CdPA `ssn` when routing the message to a Prepaid server. If `ssn=none` and `ri=ssn`, the subsystem number is populated using the `ssn` value from the incoming message CdPA parameter. If subsystem number value is not in the CdPA, then `ssn=8` is used to route the message. If a value is specfied for `ssn` , then the `pci` or `pcn` must be provisioned for the corresponding Prepaid server.

Command example for setting the Prepaid SMS options when the Prepaid SMS Intercept feature is enabled:

chg-ppsopts:ppt=1:pci=1-1-1:ssn=1:ri=gt

rtrv-ppsopts

Retrieve Prepaid SMS Options Command

The rtrv-ppsopts command displays all Prepaid SMS options from the database.

3.7 EAGLE Feature Control Commands

These commands are used to enable, update, view, and control features. A feature must be purchased to have access to the Feature Access Key (FAK). Two steps are required to activate a feature.

A Feature Access Key and feature part number are used to enable a feature with the enable-ctrl-feat command.
The feature part number is used to turn on a feature with the chg-ctrl-feat command.

chg-ctrl-feat

Change Controlled Feature command - The chg-ctrl-feat command is used with controlled features that have been purchased and enabled with the enable-ctrl-feat command. The chg-ctrl-feat command requires a feature to be enabled as a prerequisite. The chg-ctrl-feat command is used to:

Turn on or turn off On/Off features
Turn on Permanently On features, which are features that cannot be turned off after being turned on
Clear an expired temporary key alarm without purchasing a permanent Feature Access Key

Command example:

chg-ctrl-feat:partnum=893016601:status=on

enable-ctrl-feat

Enable Controlled Feature command - The enable-ctrl-feat command is used to enable a purchased feature. Additional verifications are performed before enabling certain features. These checks include verifying that GTT is turned on before enabling the MO-Based GSM SMS NP, MO-Based IS41 SMS NP, MO SMS IS41-to-GSM Migration, Portability Check for MO SMS, Prepaid SMS Intercept, MO SMS ASD, or MO SMS GRN feature.

Command example:

enable-ctrl-feat:partnum=893009301:fak=<Feature Access Key>

rtrv-ctrl-feat:

Retrieve Controlled Feature Command - The rtrv-ctrl-feat command is used display the on/off status of the features and to show the remaining trial period if features are temporarily enabled.

3.8 EAGLE Numbering Plan Processor Commands

The Numbering Plan Processor (NPP) commands enter, change, delete, and display specific NPP components and options in the EAGLE database. Numbering Plan Processor for MO SMS Features and the following sections describe the NPP command parameters and values specific to the MO SMS features.

Refer to Numbering Plan Processor (NPP) User's Guide for comprehensive descriptions of NPP components: Service Actions, Conditioning Actions, Formatting Actions, Action Sets, Rules, and Service Rule Sets.

ent/chg/dlt/rtrv-npp-as

These commands are used to enter, change, delete, and display Numbering Plan Processor (NPP) Actions Sets that contain Service Actions, Conditioning Actions, and Formatting Actions. An Action Set is used by NPP to assist with digit string filtering, conditioning, and encoding. The default parameters are overwritten when specified.

Table 3-6 NPP Action Set Parameters for MO SMS NPP - Class = DATABASE

Parameter	Range	Description
fa1 through fa12	rnospodn, rnospozn, rnosposn	Formatting Action
sa1 through sa8	asdlkup, cdial, cdpnnp, cgpnasdrqd, cgpngrnrqd, fraudchk, grnlkup, migrate, pprelay	Service Action

ent/chg/dlt/rtrv-npp-serv

These commands are used to enter, change, delete, and display a Numbering Plan Procesor (NPP) Service entry. An NPP Service is any EAGLE application that uses NPP to assist with processing of digit strings.

Table 3-7 NPP Service Entries for MO SMS NPP

Parameter	Range	Description
srvn	mosmsgcdpn, mosmsgcgpn, mosmigcdpn, mosmigcgpn	NPP Service name

ent/chg/dlt/rtrv-npp-srs

These commands are used to enter, change, delete, and display a Numbering Plan Procesor (NPP) Service Rules Set. A Service Rules Set is a collection of NPP Rules associated with an NPP Service. An NPP Rule is an association between a single NPP filter and a single NPP Action Set.

Table 3-8 NPP Service Rules Set

Parameter	Range	Description
srvn	mosmsgcdpn, mosmsgcgpn, mosmigcdpn, mosmigcgpn	NPP Service name

3.9 MO SMS NPP Test Tool Commands

The MO SMS NPP Test Tool is used to send a test message to a specified NPP service to verify the call flow behavior when message information is injected into the call path without permitting an effect on actual traffic. Refer to MO SMS NPP Test Tool for a description of the provisionable table parameters.

The tst-msg command invokes the test for the specified ISUP test message from the TESTMSG table, and displays the results.

chg/rtrv-gsm-msg

These commands are used with the MO SMS NPP Test Tool to change and display provisioned parameters for MO SMS GSM test messages. These messages test the flow of MO SMS GSM feature processing.

chg/rtrv-is41-msg

These commands are used with the MO SMS NPP Test Tool to change and display provisioned parameters for MO SMS IS41 test messages. These messages test the flow of MO SMS IS41 feature processing.

tst-msg

This command invokes the Test Tool to test the feature call flow for the message specified from the TESTMSG table. The command sends the specified message from the TESTMSG table to an EAGLE Service Feature. The test message that is sent does not create a new raw MSU. The test message is used to modify the internal data structures to analyze call flow behavior when a message with the specified parameters is injected into the call path. The test message is not transmitted to the network.

3.10 EAGLE Service Selector Commands

The service selector (srvsel) commands are used to provision service selectors for DSM services. The following sections describe the four variants: chg-srvsel, dlt-srvsel, ent-srvsel and rtrv-srvsel.

The smsmr value for the nserv or serv parameters specifies the features:

MO-based GSM SMS NP
MO-based IS41 SMS NP
MO SMS IS41-to-GSM Migration
Portability Check for Mobile Originated SMS (MNP SMS)
Prepaid Short Message Service Intercept (PPSMS)
Mobile Originated SMS Additional Subscriber Data (MO SMS ASD)
Mobile Originated SMS Generic Routing Number (MO SMS GRN)

chg-srvsel

Change Service Selector Command – The chg-srvsel command command assigns the applicable service selectors required to change a service entry for Service Module card services.

Table 3-9 chg-srvsel Parameters - Class = DATABASE

Parameter	Range	Description
gti, gtia, gtii, gtin, gtin24	2, 4	Global Title Indicator
ssn	0-255, *	Subsystem Number
tt	0-255	Translation Type
nai	sub, rsvd, natl, intl	Nature of Address Indicator
naiv	0-127	NAI Value
np	e164, generic, x121, f69, e210, e212, e214, private	Numbering Plan
npv	0-15	Numbering Plan Value
nserv	eir, gflex, gport, inpq, inpmr, smsmr, idpr, idps, mnp, vflex, atinp	New service
nsnai	sub, natl, intl, rnidn, rnndn, rnsdn, ccrndn, none	New Service Nature of Address Indicator
nsnp	e164, e212, e214, none	New Service Numbering Plan

dlt-srvsel

Delete Service Selector Command – The dlt-srvsel command deletes a service selector.

ent-srvsel

Enter Service Selector command – The ent-srvsel command assigns the applicable service selectors required to specify a service entry for DSM services.

rtrv-srvsel

Retrieve Service Selector Command – The rtrv-srvsel command displays a list of the administered service selectors combinations. Output is sorted first by service, then by global title domain, GTI, translation type, numbering plan, and nature of address indicator. The output can be filtered using various optional parameter combinations.

3.11 EAGLE SCCP Options Commands

The SCCP options commands (sccpopts) change and display the SCCP option indicators in the EAGLE database.

chg-sccpopts

Change SCCP System Options – The chg-sccpopts command changes the value of one or more SCCP option indicators. This command updates the STPOPTS table.

Table 3-10 chg-sccpopts Parameters - Class = DATABASE

Parameter	Range	Description
subdfrn	off, on	S-Port Subscriber Differentiation option off = Do not perform S-Port Subscriber Differentiation (Default) on = Perform S-Port Subscriber Differentiation The S-Port Subscriber Differentiation feature must be enabled and turned on before this parameter can be specified.

Parameter

Range

Description

subdfrn

off, on

S-Port Subscriber Differentiation option

off = Do not perform S-Port Subscriber Differentiation (Default)
on = Perform S-Port Subscriber Differentiation

The S-Port Subscriber Differentiation feature must be enabled and turned on before this parameter can be specified.

Command example:

chg-sccpopts:subdfrn=on

rtrv-sccpopts

Retrieve SCCP Options – The rtrv-sccpopts command is used to display the current value of one or more of the SCCP option indicators in the STPOPTS table.