1. EAGLE A-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 A-Port feature and the MT-Based IS 41 SMS NP feature.

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 IS41 Options Commands

The A-Port system options (is41opts) commands are used to change and report on the values of one or more of the STP node level processing option indicators maintained in the IS41option tables. All values are assigned initially to system defaults at STP installation time. The values can be updated later using the chg-is41opts command.

  • chg-is41opts: Change IS41 Options Command – The chg-is41opts command changes IS41-specific options in the database. This command updates the IS41OPTS table. The default parameter values are always overwritten when specified.

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

    Parameter Range Description
    dfltrn 1-15 hexadecimal digits (0-9, a-f, A-F), none Default Routing Number. This parameter specifies the routing digits when Service Portabilty is not applicable. This parameter can be modified only when the LOCREQ Query Response feature is enabled. Default value is none.
    esnmfg 0-255, none TCAP LOCREQ ESN Manufacturer Code. This parameter specifies the value to be encoded in the TCAP LOCREQ ESN parameter in manufacturer code section.
    esnsn 0-16777215 TCAP LOCREQ ESN Serial Number. This parameter specifies the value to be encoded in the TCAP LOCREQ ESN parameter in serial number section.
    iec digit string 1-5 digits, none International Escape Code
    locreqdn tcap, sccp LOCREQ DN. This parameter specifies whether to obtain the Called Party, used for database lookup, from the SCCP layer or the TCAP layer of a received LOCREQ message.
    locreqrmhrn yes, no LOCREQ Remove HomeRN. This parameter specifies whether to remove the HomeRN from the TCAP Outgoing Called party for a relayed LOCREQ message. This parameter cannot be specified in the same command entry as the on and off parameters.
    mscmktid 0-65535 LOCREQ MSCID Market ID. This parameter specifies the value to be encoded in LOCREQ MSCID parameter for Market ID.
    mscswitch 0-255

    LOCREQ MSCID Market ID Switch. This parameter specifies the value to be encoded in LOCREQ MSCID parameter in the market id switch section.
    mtplocreqlen 5-15 The parameter specifies the number of terminating called party digits to extract from the LOCREQ message.
    mtplocreqnai ccrndn, frmsg, intl, natl, rnidn, rnndn, rnsdn, sub}, none Message Translation Part LOCREQ Nature of Address Indicator. This parameter defines how Called Party obtained from the TCAP layer of a received MTP-routed LOCREQ message is interpreted.
    nec digit string 1-5 digits, none National Escape Code
    off locreqrmhrn, locreqrspnd, smsreqbypass This parameter turns off the specified options. Up to 8 comma-separated unique options can be specified.

    • locreqrmhrn - LOCREQ Remove HomeRN. This option specifies whether to remove the HomeRN from the TCAP Outgoing Called party for a relayed LOCREQ message. Option default is off.

    • locreqrspnd - LOCREQ Query Response. This option specifies whether to always respond to a LOCREQ query. This option can be changed only if the LOCREQ Query Response feature is turned on. Option default is off.

    • smsreqbypass - SMSREQ Bypass. This option specifies whether a received SMSREQ message that passes the MNP Service Selector (serv=mnp parameter of chg-sccp-serv) will undergo A-Port message processing. Option default is off.

    This parameter cannot be specified in the same command entry as the locreqrmhrn and smsreqbypass parameters.

    on locreqrmhrn, locreqrspnd, smsreqbypass This parameter turns on the specified options. Up to 8 comma-separated unique options can be specified. See off parameter for option descriptions. This parameter cannot be specified in the same command entry as the locreqrmhrn and smsreqbypass parameters.
    rspcdpapcp off, on, frmsg Response Called Party Point Present. This parameter specifies the point code present bit that will encode the SCCP CdPA GTA of a LOCREQ response message.
    rspcdpari frmsg, gt, ssn Response Called Party Routing Indicator. This parameter specifies the value of the Routing Indicator bit to encode the SCCP CdPA GTA of a returned LOCREQ message.
    rspcgpanai ccrndn, frmsg, intl, natl, rnidn, rnndn, rnsdn, sub}, none Response Calling Party Nature of Address Indicator (NAI). This parameter specifies a new NAI value to override the NAI value specified in the SCCP CdPA of a received LOCREQ/SMSREQ if the message is to be relayed after database lookup.
    rspcgpanp 0-15, none Response Calling Party Numbering Plan. This parameter specifies a new Numbering Plan value to override the Numbering Plan value specified in the SCCP CdPA of a received LOCREQ/SMSREQ if the message is to be relayed after database lookup.
    rspcgpapcp frmsg, included, notincluded Response Calling Party Point Code Present. This parameter specifies the value of the Point Code Present bit to encode the SCCP CgPA GTA of a returned LOCREQ message.
    rspcgpari frmsg, gt, ssn Response Calling Party Routing Indicator. This parameter specifies the value of the Routing Indicator bit to encode the SCCP CgPA GTA of a returned LOCREQ message.
    rspcgpatt 0-255, none Response Calling Party Translation Type (TT). This parameter specifies a new TT value to override the TT value specified in the SCCP CdPA of a received LOCREQ/SMSREQ if the message is to be relayed after database lookup.
    rspdig ccrndn, hrnrndn, rn, rndn Routing Number. This parameter specifies the digit encoding format of the TCAP Outgoing Called Party parameter for a LOCREQ response message on a per EAGLE node basis.
    rspdigtype 0-255 Response Digit Type. This parameter specifies the value that will encode the DigitType field in the TCAP Outgoing Called Party parameter of a LOCREQ response message.
    rspmin homern, nothomern, tendelhomern, tenhomern, tenzero Response LOCREQ MIN Parameter Encoding. This parameter specifies how the digits of the LOCREQ MIN parameter will be encoded.
    rspnon 0-255, none MSRN Nature of Number. This parameter specifies the Nature of Number value of the TCAP Outgoing Called Party parameter.
    rspnp 0-15, none MSRN Numbering Plan. This parameter specifies the Numbering Plan values of the TCAP Outgoing Called Party parameter.
    rspparm ddigit, rtdigit, tlist Response Parameter. This parameter specifies which TCAP LOCREQ parameter (TCAP Outgoing Called Party) will encode the RN and/or DN information.
    smsreqbypass yes, no

    SMSREQ Bypass. This parameter specifies whether a received SMSREQ message that passes the MNP Service Selector (serv=mnp parameter of chg-sccp-serv) will undergo A-Port message processing. This parameter cannot be specified in the same command entry as the on and off parameters.

    The MT-Based IS41 SMS NP feature does not consider the value of this parameter. If smsreqbypass has a value of yes, the A-Port processing will not be applied but the message will be considered for MT-Based IS41 SMS NP processing.

    sporttype none, gsm, is41, all Service Portability Type. This parameter specifies the application of Service Portability that is applied to the associated feature. This parameter can be modified only when the Service Portability and LOCREQ Query Response features are enabled. Deafult value is none.
    tcapsnai ccrndn, frmsg, intl, natl, rnidn, rnndn, rnsdn, sub}, none This parameter specifies how the Called Party from the TCAP layer of a received LOCREQ message is interpreted.

  • rtrv-is41opts: Retrieve IS41 Options Command The rtrv-is41opts command displays the IS41 option indicators maintained in the IS41OPTS table.

3.3 EAGLE IS41 SMS Options Commands

The IS41 SMS options (is41smsopts) commands change and display SMS options in the EAGLE database for the MT-based IS41 SMS NP feature. The following sections describe the two variations: chg-is41smsopts and rtrv-is41smsopts.

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. 

Command: chg-is41smsopts           Class = DATABASE

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

Parameter Optional/ Mandatory Range Description
mtsmsackn Optional ack, nack MT-based SMS acknowledgement
mtsmschksrc Optional yes, no MT-based SMS check source
mtsmsdigtype Optional 0-255 MT-based SMS digit type
mtsmsdltr Optional no, prern, postrn MT-based SMS delimiter
mtsmsdltrv Optional 1-5 digits MT-based SMS delimiter value
mtsmsdnfmt Optional rn, rndn, ccrndn, dn, srfimsi MT-based SMS DN format
mtsmsesn Optional no, yes MT-based SMS electronic serial number
mtsmsnakerr Optional 0-255 MT-based SMS negative acknowledgement error
mtsmsparm Optional digit, pcssn MT-based SMS parameter
mtsmsssn Optional 2-255 MT-based SMS subsystem number
mtsmstype Optional sp, rn, sprn, all, nonsp MT-based SMS type

The following command examples set the IS41 SMS options when the MT-based IS41 SMS NP feature is enabled.

  • chg-is41smsopts:mtsmsdnfmt=dn:mtsmstype=sp
  • chg-is41smsopts:mtsmsdltr=no:mtsmsparm=digit
  • chg-is41smsopts:mtsmssn=2:mtsmsnakerr=55:mtsmsdigtype=25

rtrv-is41smsopts

Retrieve IS41 SMS Options Command - The rtrv-is41smsopts command displays all IS41 SMS options from the database.

The following IS41 SMS options are displayed if the MT-based IS41 SMS NP feature is enabled.


    tekelecstp 08-04-08 19:38:30 EST  EAGLE 39.0.0
   
    IS41 SMS OPTIONS
    -----------------------
    MTSMSDNFMT    = RNDN
    MTSMSTYPE     = RN
    MTSMSPARM     = DIGIT
    MTSMSDLTR     = NO
    MTSMSDLTRV    = NONE
    MTSMSACKN     = ACK
    MTSMSESN      = NO
    MTSMSSSN      = 6
    MTSMSNAKERR   = 5
    MTSMSDIGTYPE  = 6
    MTSMSSCHKSRC  = NO
;

3.4 EAGLE A-Port Service Selector Commands

The A-Port service selector (srvsel) commands are used to provision, remove, change, and report on the applicable service selectors required to change a service entry for Service Module card services. These commands provide flexibility when provisioning the type of messages that require A-Port processing. Four variants of the service selector commands are described in the following sections: ent-srvsel, chg-srvsel, dlt-srvsel, and rtrv-srvsel.

  • ent-srvsel: Enter A-Port Service Selectors Command

    The ent-srvsel command specifies that the applicable A-Port service selectors indicating A-Port processing are required. The A-Port feature must be enabled before entering this command. The available parameters are:

    Table 3-3 ent-srvsel Parameters - Class = DATABASE

    Parameter Optional/ Mandatory Range Description
    gti, gtia, gtii, gtin, gtin24 Mandatory 2, 4 Global Title Indicator
    serv Mandatory mnp Service Module card service
    ssn Mandatory 0-255, * Subsystem number
    tt Mandatory 0-255 Translation Type
    nai Optional sub, rsvd, natl, intl Nature Of Address Indicator
    naiv Optional 0-127 NAI Value
    np Optional e164, generic, x121, f69, e210, e212, e214, private Numbering Plan
    npv Optional 0-15 Numbering Plan Value
    snai Optional sub, natl, intl, rnidn, rnndn, rnsdn, ccrndn Service Nature of Address Indicator

    snp

    		 Optional e164, e212, e214 Service Numbering Plan

  • chg-srvsel: Change A-Port Service Selector Command

    The chg-srvsel command specifies the applicable A-Port selectors required to change an existing A-Port selector entry. The available parameters are:

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

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

  • dlt-srvsel: Delete A-Port Service Selector Command

    The dlt-srvsel command deletes a A-Port service selector. The available parameters are:

    Table 3-5 dlt-srvsel Parameters - Class = DATABASE

    Parameter Optional/ Mandatory Range Description
    gti, gtia, gtii, gtin, gtin24 Mandatory 2, 4 Global Title Indicator
    tt Mandatory 0-255 Translation Type
    ssn Mandatory 0-255, * Subsystem number
    nai Optional sub, rsvd, natl, intl Nature Of Address Indicator
    naiv Optional 0-127 NAI Value
    np Optional e164, generic, x121, f69, e210, e212, e214, private Numbering Plan
    npv Optional 0-15 Numbering Plan Value

  • rtrv-srvsel: Retrieve A-Port Service Selector Command

    The rtrv-srvsel command displays a list of administered A-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:

    Table 3-6 rtrv-srvsel Parameters - Class = DATABASE

    Parameter Optional/ Mandatory Range Description
    gti, gtia, gtii, gtin, gtin24 Optional 2, 4 Global Title Indicator
    nai Optional sub, rsvd, natl, intl Nature Of Address Indicator
    naiv Optional 0-127 NAI Value
    np Optional e164, generic, x121, f69, e210, e212, e214, private Numbering Plan
    npv Optional 0-15 Numbering Plan Value
    serv Optional mnp Service Module card service
    snai Optional sub, natl, intl, rnidn, rnndn, rnsdn, ccrndn Service Nature of Address Indicator
    snp Optional e164, e212, e214 Service Numbering Plan
    ssn Mandatory 0-255, * Subsystem number
    tt Optional 0-255 Translation Type

3.5 EAGLE Feature Control Commands

The ent/chg/rtrv-ctrl-feat commands are used to enable, turn on, and display the feature status of the A-Port feature. A Feature Access Key is used to enable the A-Port feature. The feature must be purchased to receive a Feature Access Key for the feature. No temporary key is associated with the A-Port feature. After the feature is on, it cannot be turned off.

Additional verifications are performed to ensure that the correct hardware is present in the system.

  • enable-ctrl-feat: Enable Control Feature Command

    The enable-ctrl-feat command is used for the permanent enabling of the A-Port feature.

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

  • chg-ctrl-feat: Change Control Feature Command

    The chg-ctrl-feat command is used to turn on the A-Port feature. The A-Port feature must be enabled before it can be turned on.

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

  • rtrv-ctrl-feat: Retrieve Control Feature Command

    The rtrv-ctrl-feat command is used display the status of the feature.

3.6 EAGLE MNP SCCP Service Commands

The MNP SCCP Service commands (chg/dlt/rtrv-sccp-serv) allow services to be taken online and offline and allow their processing load to be shifted to other designated nodes. These commands also support the assignment of PCs to PC groups used for MNP re-route assignment.

Entries are provisioned in the SCCP-SERV table using the chg-sccp-serv command, and are shown by the rtrv-sccp-serv command output. The maximum number of entries that the MRN table can contain is reduced by the number of entries shown in the rtrv-sccp-serv command output. For more information on provisioning MRN tables, refer to Database Administration - GTT User's Guide.

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 (G-Flex, G-Port, MNP) and point code network type (ANSI, ITU-I, ITU-I Spare, ITU-N, ITU-N, ITU-N Spare, or ITU-N24). Up to seven PCs can be in a network type grouping for service re-route load sharing. The command allows for additions/modifications of up to four PCs at one time. The point code parameters support the Spare Point Code subtype prefix s- for ITU-I and ITU-N point codes. Table 3-7 describes the MNP SCCP Service configuration options that are contained in the SCCP-SERV table.

Table 3-7 MNP SCCP Service Configuration Options

Parameter Range Description
serv gport, gflex, mnp Service
state offline, online Status
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