1. EAGLE G-Port User's Guide
  2. Commands

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. 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 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 none. The MNP Cicular Route Prevention feature cannot be turned off if this parameter is provisioned to any value other than none. The default value is none.

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 msrndig parameter when an SRI is processed by the G-Port SRI Query for Prepaid feature, an RTDB match is found for an own-network subscriber, and Service Portability is not applied. The default value is none.

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.

  • encdnpsdnnotfound - NPSI for DN not found option

    This option specifies whether the NPSI is included in SRI Ack messages when the DN is not found. The default setting is off.

  • encdnpsptnone - NPSI for PT = none

    This option specifies whether the NPSI is included in SRI Ack messages when the Portability Type = none. The default setting is off.

  • encodecug - Closed User Group (CUG) option

    This option specifies whether the Closed User Group (CUG) Checkinfo from the SRI message is included in the SRI Ack message. The default setting is off.

  • encodenps - Number Portability Status Indicator (NPSI) option

    This option specifies whether the Number Portability Status Indicator (NPSI) is omitted from all SRI Ack messages. The default setting is on.

  • srismgttrtg - SRI_SM Routing option

    This option specifies whether the SRI_SM and ReportSMSDeliveryStatus routing to GTT is on. The default setting is off.

on

encdnpsdnnotfound, encdnpsptnone, encodecug, encodenps, srismgttrtg

This parameter turns on specified options. Up to 8 comma-separated unique options can be specified. Refer to off parameter for option descriptions.

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 none.

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 gtt.

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.
Command examples:
  • 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.
Command example:
  • 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: Enter G-Port Service Selectors Command – The 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.