3 Commands
This chapter contains brief descriptions of the EAGLE commands that are used for the configuration, control, maintenance, and measurements of the G-Port, MT-Based GSM SMS NP, and MT-Based GSM MMS NP features.
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 Options Commands
The STP system options commands (stpopts
) change and display STP-wide options in the EAGLE database. The following sections describe the commands: chg-stpopts
and rtrv-stpopts
. For details about these commands, refer to Commands User's Guide.
-
chg-stpopts: Change STP System Options Command – The
chg-stpopts
command changes STP system options in the database. This command updates the STPOPTS table. Thedefcc
anddefndc
parameters are used to convert non-international numbers received in the MSU to an international number. Thedefcc
anddefndc
parameters can be specified only if the G-Port, Prepaid IDP Query Relay (IDPR), Prepaid SMS Intercept (PPSMS), V-Flex, or ATINP feature is enabled, or if the G-Flex, INP, or AINPQ feature is turned on.Command example:
chg-stpopts:defcc=333:defndc=22345
Where:- defcc={1-3 digits, none} Default country code
- defndc={1-5digits, none} Default network destination code
-
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 Options Commands
The gsmopts
commands change and display Global System for Mobile Telecommunications (GSM) options in the EAGLE database. The following sections describe the two variations: chg-gsmopts
and rtrv-gsmopts
. For details about these commands, refer to Commands User's Guide.
chg-gsmopts
Change GSM Options Command – The chg-gsmopts
command changes G-Port-specific system options in the database. This command updates the GSMOPTS table. The default parameters are always overwritten when specified.
Table 3-1 chg-gsmopts Parameters - Class = DATABASE
Parameter | Range | Description |
---|---|---|
crptt |
0-255, none |
Circular Route Prevention Translation Type The MNP Cicular Route Prevention feature must be turned on before this parameter can be provisioned to any value other than |
defmapvr |
1-3 |
Default MAP version |
defmcc |
1-3 digits, none |
E212 default mobile country code |
dfltrn |
1-15 digits, none |
Default Routing Number This parameter specifies the default routing number to use as the routing number portion of the |
gsm2is41 |
1-15 digits, none |
GSM to IS41 migration prefix |
is412gsm |
1-15 digits, none |
IS-41 to GSM migration prefix |
migrpfx |
multiple, single |
Migration Prefix |
msisdntrunc |
1 digit (0-5) |
Number of MSISDN digits to delete from the MISISDN before formulating the MSRN for the SRI Ack message |
msrndig |
rn, rndn, ccrndn, rnccdn, rnasd, asdrn, rnasddn, asdrndn, ccrnasddn, ccasdrndn, rnasdccdn, asdrnccdn, rngrn, grnrn, rngrndn, grnrndn, ccrngrndn, ccgrnrndn, rngrnccdn, grnrnccdn |
RN used as is or with MSISDN |
msrnlen |
1-30 |
Number of digits in the MAP Routing Info portion of the returned SRI Ack message. Default value is 30. |
msrnnai |
0-7 |
Nature of Address Indicator Value (NAIV) for the MSRN |
msrnnp |
0-15 |
Numbering plan for the MSRN |
multcc |
1 to 3 digits (0-9, a-f, A-F) |
Multiple Country Code |
nmultcc |
1 to 3 digits (0-9, a-f, A-F), none |
New Multiple Country Code |
off |
encdnpsdnnotfound, encdnpsptnone, encodecug, encodenps, srismgttrtg |
This parameter turns off specified options. Up to 8 comma-separated unique options can be specified.
|
on |
encdnpsdnnotfound, encdnpsptnone, encodecug, encodenps, srismgttrtg |
This parameter turns on specified options. Up to 8 comma-separated unique options can be specified. Refer to |
serverpfx |
1-4 digits, none |
Server SRI prefix |
sporttype |
gsm, is41, all, none |
Service Portability Type This parameter specifies whether Service Portability applies to G-Port SRI Query for Prepaid for own-network subscribers. Default value is |
srfaddr |
1-15 digits, none |
Entity address of MNP_SRF node |
srfnai |
0-127 |
NAIV of the MNP_SRF |
srfnp |
0-15 |
Numbering plan value of the MNP_SRF Network Code |
sridn |
tcap, sccp |
SRIDN location |
sridnnotfound |
gtt, srinack |
When G-Port encounters an RTDB query result that indicates that the given DN is not known, the SRIDNNOTFOUND parameter value determines further processing. The default value is |
srirdctent |
grn, sp |
This parameter indicates whether the Intra Network Number Portability feature (grn) or the MAP SRI Redirect to Serving HLR feature (sp) is used to match Vendor Type of CgPA GTA. |
ownnetworksetname |
none |
Enables screening on SRI_ACK CDPA. Default value of this parameter is none.
|
-
chg-gsmopts:srfnai=4:srfnp=2:srfaddr=331111111111
-
chg-gsmopts:srfaddr=333221234567890:msrndig=rn:srfnai=1:srfnp=1:msrnnai=4 :msrnnp=10
-
chg-gsmopts:sridn=tcap
-
chg-gsmopts:is412gsm=0123456789abcde
-
chg-gsmopts:srirdctent=grn
rtrv-gsmopts
Retrieve G-Port System Options Command
The rtrv-gsmopts
command displays all GSM-specific system options from the database.
3.4 EAGLE GSM SMS Options Commands
The GSM SMS options (gsmsmsopts
) commands change and display specific SMS and MMS options in the EAGLE database for the MT-based GSM SMS NP and MT-based GSM MMS NP features. The following sections describe the two variations: chg-gsmsmsopts
and rtrv-gsmsmsopts
. For details about these commands, refer to Commands User's Guide.
The mtmmsackn
, mtmmsentylen
, mtmmsgta
, mtmmslen
, and mtmmstype
parameters apply to only messages that are modified by the MT-Based GSM MMS NP feature. The MT-Based GSM MMS NP feature must be enabled to specify these parameters.
The mtsmsackn
, mtsmschksrc
, mtsmsdltr
, mtsmsdltrv
, mtsmsimsi
, mtsmsnakerr
, mtsmsnni
, and mtsmstype
parameters apply to only messages that are modified by the MT-Based GSM SMS NP feature. The MT-Based GSM SMS NP feature must be enabled to specify these parameters.
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-2 chg-gsmsmsopts Parameters Class = DATABASE
Parameter | Range | Description |
---|---|---|
mtmmsackn |
ack, nack |
MT-based MMS acknowledgement |
mtmmsentylen | 1-15, none | MT-based MMS entity length |
mtmmsgta |
5-21 digits, none |
MT-based MMS GTA |
mtmmslen | 1-24, none | MT-based MMS length |
mtmmstype |
sp, rn, sprn, all, nonsp |
MT-based MMS type |
mtsmsackn |
ack, nack |
MT-based SMS acknowledgement |
mtsmschksrc |
yes, no |
MT-based SMS check source |
mtsmsdltr |
no, prern, postrn |
MT-based SMS delimiter |
mtsmsdltrv |
1-5 digits |
MT-based SMS delimiter value |
mtsmsimsi |
rn, rndn, ccrndn, dn, srfimsi, mccrndn |
MT-based SMS IMSI |
mtsmsnakerr |
0-255 |
MT-based SMS negative acknowledgement error |
mtsmsnni |
rn, rndn, ccrndn, dn, srfimsi, mccrndn, none |
MT-based SMS network node indicator |
mtsmstype |
sp, rn, sprn, all, nonsp |
MT-based SMS type |
srismdn |
sccp, tcap |
SRI_SM DN location This parameter specifies whether the MT-Based GSM SMS NP feature selects the MSISDN from the SCCP CdPA or TCAP CdPN section of the SRI_SM message. The MT-Based GSM SMS NP feature must be enabled and turned on to specify this parameter. |
-
chg-gsmsmsopts:mtmmsgta=51111:mtmmstype=sp:mtmmsackn=nack:mtmmsentylen=7:mtmmslen=10
rtrv-gsmsmsopts
Retrieve GSM SMS Options Command
The rtrv-gsmsmsopts
command displays all GSM SMS and MMS options from the database.
3.5 EAGLE G-Port Service Selector Commands
The G-Port service selector (srvsel
) commands are used to provision new selectors for the G-Port service, providing greater flexibility when provisioning the type of messages that require G-Port processing. The following sections describe the four variants: ent-srvsel
, chg-srvsel
, dlt-srvsel
, and rtrv-srvsel
. For further details on the EAGLE G-Port service selector commands (such as command rules and output format), refer to Commands User's Guide.
ent-srvsel
command specifies that the applicable G-Port service selectors indicating G-Port processing are required. The available parameters are described in Table 3-3.
Table 3-3 ent-srvsel Parameters - Class = DATABASE
Parameter | Range | Description |
---|---|---|
gti, gtia, gtii, gtin, gtin24 |
2, 4 |
Global Title Indicator |
serv |
eir, gflex, gport, inpq, inpmr, smsmr, idps, idpr, mnp, vflex, atinp |
GSM service |
snai |
1sub, natl, intl, rnidn, rnndn, rnsdn, ccrndn |
Service Nature Of Address Indicator |
snp |
1e164, e212, e214 |
Service Numbering Plan |
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 |
chg-srvsel: Change G-Port Service Selector Command – The chg-srvsel
command specifies the applicable G-Port selectors required to change an existing G-Port selector entry. The available parameters are described in Table 3-4.
Table 3-4 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 GSM service |
nsnai |
sub, natl, intl, rnidn, rnndn, rnsdn, ccrndn |
New Service Nature Of Address Indicator |
nsnp |
e164, e212, e214, none |
New Service Numbering Plan |
dlt-srvsel: Delete G-Port Service Selector Command – The dlt-srvsel
command deletes a G-Port service selector. The available parameters are described inTable 3-5.
Table 3-5 dlt-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 |
rtrv-srvsel: Retrieve G-Port Service Selector Command – The rtrv-srvsel
command displays a list of administered G-Port service selector combinations. All output is sorted first by service, then by global title domain (ANSI first, followed by ITU), GTI, translation type, numbering plan, and by the nature of address indicator. The output can be filtered by specifying any optional parameter. The available parameters are described in Table 3-6
Table 3-6 rtrv-srvsel Parameters - Class = DATABASE
Parameter | Range | Description |
---|---|---|
gti, gtia, gtii, gtin, gtin24 |
2, 4 |
Global Title Indicator |
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 |
serv |
eir, gflex, gport, inpq, inpmr, smsmr, idps, idpr, mnp, vflex, atinp |
GSM service |
snai |
sub, natl, intl, rnidn, rnndn, rnsdn, ccrndn |
Service Nature Of Address Indicator |
snp |
e164, e212, e214 |
Service Numbering Plan |
ssn |
0-255, * |
Subsystem Number |
tt |
0-255 |
Translation Type |
3.6 EAGLE SCCP Service Commands
The sccp-serv
commands allow for services to be taken online and offline and for their processing load to be shifted to other designated nodes. These commands also support the assignment of point codes to service groups used for service re-route assignment. Three variations are described in this section: chg-sccp-serv
, dlt-sccp-serv
, and rtrv-sccp-serv
.
Entries using the chg-sccp-serv
command are provisioned in the SCCP-SERV table, and are shown by the rtrv-sccp-serv
command output. This reduces the maximum number of entries that the MRN table can contain by the number of entries shown in the rtrv-sccp-serv
command output. For information on provisioning MRN tables, refer to Database Administration - GTT User's Guide.
Refer to Commands User's Guide for additional details about the EAGLE SCCP service commands.
chg-sccp-serv: Change SCCP Service Command – The chg-sccp-serv
command is used to add point codes to an existing service group, or to change the Relative Cost (RC) of existing point codes in a group. SCCP Service groups are organized by service and point code network type (ANSI, ITU-I, ITU-I Spare, ITU-N, ITU-N Spare, or ITU-N24). Up to seven point codes may be in a network type grouping for service re-route load sharing. This command allows for additions or modifications of up to four point codes. The point code parameters support the Spare Point Code subtype prefix s-
for ITU-I and ITU-N point codes.
Table 3-7 chg-sccp-serv Parameters - Class = DATABASE
Parameter | Range | Description |
---|---|---|
serv |
gport, gflex, mnp |
Service |
gtt |
no, yes |
Global Title Translation |
pc1, pca1, pci1, pcn1, pcn241 |
Refer to Commands User's Guide |
Post GTT-translated PC |
rc1 |
00-99 |
Relative Cost |
pc2, pca2, pci2, pcn2, pcn242 |
Refer to Commands User's Guide |
Post GTT-translated PC |
rc2 |
00-99 |
Relative Cost |
pc3, pca3, pci3, pcn3, pcn243 |
Refer to Commands User's Guide |
Post GTT-translated PC |
rc3 |
00-99 |
Relative Cost |
pc4, pca4, pci4, pcn4, pcn244 |
Refer to Commands User's Guide |
Post GTT-translated PC |
rc4 |
00-99 |
Relative Cost |
state | offline, online | Service State |
dlt-sccp-serv: Delete G-PortSCCP Service Command – The dlt-sccp-serv
command is used remove entries from the SCCP Service table. A single command may remove either a PCU from a group or the entire group. The available parameters follow:
Table 3-8 dlt-sccp-serv Parameters - Class = DATABASE
Parameter | Range | Description |
---|---|---|
serv |
gport, gflex, mnp |
Service |
pc1, pca1, pci1, pcn1, pcn241 |
Refer to Commands User's Guide |
Post GTT-translated PC |
pc2, pca2, pci2, pcn2, pcn242 |
Refer to Commands User's Guide |
Post GTT-translated PC |
pc3, pca3, pci3, pcn3, pcn243 |
Refer to Commands User's Guide |
Post GTT-translated PC |
pc4, pca4, pci4, pcn4, pcn244 |
Refer to Commands User's Guide |
Post GTT-translated PC |
all |
no, yes |
Yes deletes all point codes from a service |
rtrv-sccp-serv: Retrieve SCCP Service Command – The rtrv-sccp-serv
command is used to display the SCCP Service application relationship information maintained by the EAGLE. Point codes are grouped by service.
3.7 EAGLE Feature Control Commands
These commands are used to enable, turn on, and display the feature status of the G-Port, MNPCRP, MT-Based GSM SMS NP, and MT-Based GSM MMS NP features on the EAGLE. Features must be purchased to have access to a Feature Access Key, which must be used when enabling these features. A separate Feature Access Key is required to enable each feature. You must be entitled to use a feature before it can be enabled. If you are not sure whether you are entitled to use a feature, contact your Oracle Sales Representative or Account Representative.
After the feature G-Port feature is turned on, it cannot be turned off. A temporary Feature Access Key is associated with the G-Port and MNPCRP features.
enable-ctrl-feat: Enable Controlled Feature Command –The enable-ctrl-feat
command is used for temporary and permanent enabling of controlled features. An example of the command using the G-Port part number is:
enable-ctrl-feat:partnum=893017201
:fak=<Feature Access Key>
chg-ctrl-feat: Change Controlled Feature Command –The chg-ctrl-feat
command is used to turn on controlled features: G-Port, MNPCRP, MT-Based GSM SMS NP, and MT-Based GSM MMS NP. The MNPCRP, MT-Based GSM SMS NP, and MT-Based GSM MMS NP features require the G-Port feature to be enabled as a prerequisite. This command is also used to turn off ON/OFF features and to clear the critical alarm caused by an expired temporary key.
Command example using the MNPCRP part number:
chg-ctrl-feat:partnum=893007001:status=on
rtrv-ctrl-feat: Retrieve Controlled Feature Command–The rtrv-ctrl-feat
command is used display the on/off status of controlled features and the trial period remaining for temporary enabled features.