Go to primary content
Oracle® Communications EAGLE Database Administration - GTT User's Guide
Release 46.8
F11880-02
Go To Table Of Contents
Contents

Previous
Previous
Next
Next

Adding a Translation Type

This procedure is used to add a translation type to the database using the ent-tt command.

The ent-tt command uses these parameters.

:type/typea/typei/typeis/typen/typens/typen24 – The translation type and network type of that translation type. The translation type indicates which global title translation table is to be used to determine the routing to a particular service database. The value of this parameter is from 0 to 255.
  • :type or ::typea – an ANSI network
  • :typei – an ITU international network
  • :typeis – an ITU international spare network
  • :typen - a 14-bit ITU national network.
  • :typens - a 14-bit ITU national spare network.
  • :typen24– a 24-bit ITU national network.

:ttn – The name of the global title translation type, containing one alphabetic character and up to eight alphanumeric characters.

:ndgt – The number of digits, 1 to 21 digits, contained in the global title translation.

:alias – The alias of the global title translation type. The value of this parameter is from 0 to 255.

The translation type value, for example 10, can be specified as a value for each translation type parameter (typea=10, typei=10, typeis=10, typen=10, typens=10, typen24=10). The translation type value can appear in the rtrv-tt output only once for each network type of translation types.

An alias translation type value cannot be specified if the value is shown in the TYPE column of the rtrv-tt output for the network type defined by the specified translation type parameter. For example, the alias translation type value 10 cannot be specified as an alias of an ITU-I translation type if a TYPEI value in the rtrv-tt output is 10. However, if the TYPEIS column does not contain the value 10, the value 10 can be specified as an alias translation type of an ITU-I spare translation type. The alias translation type value can appear in the rtrv-tt output only once for each network type of translation types.

When adding an alias translation type, the translation type must be specified with the ent-tt command. The translation type must be shown in the rtrv-tt output.

Either the ndgt parameter or the alias parameter can be specified with the ent-tt command, but not both at the same time.

The translation type name value specified with the ent-tt command cannot be shown in the rtrv-tt output.

This procedure can be performed if the EGTT feature is turned on. Only the CDGTA GTT sets and selectors (with the default values for the advanced parameters) are created. Adding a translation type when the EGTT feature is turned on creates a CDGTA GTT set. If the type/typea parameter is specified with the ent-tt command, the NETDOM value of the GTT set is ANSI. If the typei, typeis, typen, typens, or typen24 parameter is specified with the ent-tt command, the NETDOM value of the GTT set is ITU. The ttn parameter value of the ent-tt command defines the name of the GTT set. if the ttn parameter is not specified with the ent-tt command, a default name for the GTT set is created. These are examples of the default GTT set names.
  • If the ANSI translation type 10 is added, the GTT set name is setans010.
  • If the ITU-I translation type 20 is added, the GTT set name is setint020.
  • If the ITU-I spare translation type 5 is added, the GTT set name is setins005.
  • If the ITU-N translation type 100 is added, the GTT set name is setnat100.
  • If the ITU-N spare translation type 30 is added, the GTT set name is setnas030.
  • If the ITU-N24 translation type 40 is added, the GTT set name is set24n040.
If the translation type is an ANSI translation type, one GTT selector associated with the CDGTA GTT set that contains the global title indicator value 2 and the translation type value is created. If the If the translation type is an ITU-I, ITU-I spare, ITU-N, ITU-N spare, or ITU-N24 translation type, two GTT selectors associated with the CDGTA GTT set are created. One GTT selector contains the global title indicator value 2 and the translation type value. The other GTT selector contains the global title indicator value 4 and the translation type value. The advanced GTT parameter values for these GTT selectors are set to these default values.
  • NP - dflt - for ITU GTT selectors only. ANSI GTT selectors can only contain dashes in this column.
  • NAI - dflt - for ITU GTT selectors only. ANSI GTT selectors can only contain dashes in this column.
  • CGSSN - dashes
  • SELID - none
  • LSN - any

If a GTT set is in the database with the same name as the ttn parameter value or the default GTT set name, the translation type will not be added to the database.

The global title translation feature must be turned on. Verify this by entering the rtrv-feat command. If the global title translation feature is off, it can be turned on by entering the chg-feat:gtt=on command.

Note:

Once the Global Title Translation (GTT) feature is turned on with the chg-feat command, it cannot be turned off.

The GTT feature must be purchased before turning it on. If you are not sure whether you have purchased the GTT feature, contact your Sales Representative or Account Representative.

If the Variable-length Global Title Translation Feature (VGTT) is on, shown by the entry VGTT = on in the rtrv-feat command output, or the Support for 16 GTT Lengths in VGTT feature is enabled and turned on, shown by the entry VGTT with 16 Lengths in the rtrv-ctrl-feat output, the ndgt parameter cannot be specified with the ent-tt command. The length of the global title address is determined when the global title address is entered with the ent-gtt command. If only the VGTT feature is on, the translation type can contain a maximum of ten different lengths of global title addresses. If the Support for 16 GTT Lengths in VGTT feature is enabled and turned on, the translation type can contain a maximum of 16 different lengths of global title addresses. For more information on the VGTT feature, the Support for 16 GTT Lengths in VGTT feature, and the length of global title addresses, refer to Variable-length Global Title Translation Feature and Adding a Global Title Translation.

If the Variable-length Global Title Translation Feature (VGTT) is on, the NDGT field of the rtrv-tt command shows the different lengths of global title addresses assigned to a translation type, as shown in the following example.

rlghncxa03w 10-07-25 09:57:31 GMT  EAGLE5 42.0.0
TYPEA      TTN        NDGT
1          lidb       6, 12, 15
2          c800       10
3          d700       6

ALIAS      TYPEA
50         3
65         3

TYPEI      TTN        NDGT
105        itudb      8

ALIAS      TYPEI
7          105

TYPEN      TTN        NDGT
120        dbitu      7

ALIAS      TYPEN
8          120

TYPEIS     TTN        NDGT

ALIAS      TYPEIS

TYPENS     TTN        NDGT

ALIAS      TYPENS

In this example of the rtrv-tt command output, the ANSI translation type 1 contains three different length global title addresses; global title addresses containing six digits, 12 digits, and 15 digits.

If the Variable-length Global Title Translation Feature (VGTT) feature is off and you wish to turn it on, enter the chg-feat:vgtt=on command. The GTT feature must be on before the vgtt=on parameter can be specified with the chg-feat command.

Note:

Once the Variable-length Global Title Translation (VGTT) feature is turned on with the chg-feat command, it cannot be disabled.

The VGTT feature must be purchased before turning it on. If you are not sure whether you have purchased the VGTT feature, contact your Sales Representative or Account Representative.

  1. Verify that the GTT feature is on, by entering the rtrv-feat command. If the GTT feature is on, the GTT field should be set to on.

    Note:

    The rtrv-feat command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-feat command, refer to the rtrv-feat command description in Commands User's Guide.

    If the GTT feature is off, perform the Adding a Service Module procedure to turn the GTT feature on and to make sure that the correct hardware is installed. After the Adding a Service Module procedure has been performed, continue the procedure with 11.

    If the GTT feature is on, continue the procedure by performing one of these steps.
    • If the EGTT feature is on, continue the procedure with 3.
    • If the EGTT feature is off, continue the procedure with 2.
  2. Display the translation types in the database using the rtrv-tt command. This is an example of the possible output.
    rlghncxa03w 10-07-25 09:57:31 GMT  EAGLE5 42.0.0
    
    TYPEA      TTN        NDGT
    1          lidb       5
    2          c800       10
    3          d700       6
    
    ALIAS      TYPEA
    50         3
    65         3
    
    TYPEI      TTN        NDGT
    105        itudb      8
    
    ALIAS      TYPEI
    7          105
    
    TYPEN      TTN        NDGT
    120        dbitu      7
    
    ALIAS      TYPEN
    8          120
    
    TYPEIS     TTN        NDGT
    
    ALIAS      TYPEIS
    
    TYPENS     TTN        NDGT
    
    ALIAS      TYPENS

    Continue the procedure with 6.

  3. Display the GTT set by entering the rtrv-gttset command with the TTN value that will be assigned to the translation type for the gttsn parameter value.

    For this example, enter these commands.

    rtrv-gttset:gttsn=scp1

    This is an example of the possible output.

    rlghncxa03w 10-07-25 09:57:31 GMT  EAGLE5 42.0.0
    
    
    GTTSN      NETDOM  NDGT
    scp1       ansi    6
    
    GTT-SET table is (7 of 2000) 1% full.

    rtrv-gttset:gttsn=scp2

    This is an example of the possible output.

    rlghncxa03w 10-07-25 09:57:31 GMT  EAGLE5 42.0.0
    
    
    GTTSN      NETDOM  NDGT
    scp2       ansi    6
    
    GTT-SET table is (7 of 2000) 1% full.

    rtrv-gttset:gttsn=scp3

    This is an example of the possible output.

    rlghncxa03w 10-07-25 09:57:31 GMT  EAGLE5 42.0.0
    
    
    GTTSN      NETDOM  NDGT
    scp3       ansi    6
    
    GTT-SET table is (7 of 2000) 1% full.

    This message is displayed if the specified GTT set is not in the database.

    E3561 Cmd Rej: GTT Set specified by GTT Set Name/index does not exist

    If the TTN value is not the name of a GTT set, only a CDGTA GTT set whose NETDOM value is either ANSI or ITU can be provisioned in this procedure. The advanced GTT parameters for the GTT selector that is created in this procedure will be set to these default values.
    • NP - dflt - for ITU GTT selectors only. ANSI GTT selectors can only contain dashes in this column.
    • NAI - dflt - for ITU GTT selectors only. ANSI GTT selectors can only contain dashes in this column.
    • CGSSN - dashes
    • SELID - none
    • LSN - any

    If you wish to provision a GTT set that has a set type other than CDGTA or whose NETDOM value is CROSS, do not perform the remainder of this procedure. Perform the Adding a GTT Set procedure to add the GTT set.

    If the GTT set will be a CDGTA GTT set whose NETDOM value is either ANSI or ITU, but the GTT selector that will be created will contain values for the advanced GTT parameters other than the default values, do not perform the remainder of this procedure. Perform the Adding a GTT Selector procedure to add the GTT selector.

    If the GTT set will be a CDGTA GTT set whose NETDOM value is either ANSI or ITU, and the GTT selector that will be created will contain the default values for the advanced GTT parameters, continue the procedure with 6.

    If the TTN value is the name of a GTT set, and the SETTYPE column is not shown in the rtrv-gttset output, the Origin-Based SCCP Routing or the Flexible Linkset Optional Based Routing features are not enabled. The GTT set shown in the rtrv-gttset output is a CDGTA GTT set. If the NETDOM value of the GTT set is either ANSI or ITU, continue the procedure with 4.

    If the TTN value is the name of a GTT set, and the SETTYPE column is shown in the rtrv-gttset output, the Origin-Based SCCP Routing or the Flexible Linkset Optional Based Routing features are enabled. If the SETTYPE value of the GTT set is CDGTA and the NETDOM value of the GTT set is either ANSI or ITU, continue the procedure with 4.

    If the SETTYPE value of the GTT set is a value other than CDGTA, or if the NETDOM value of the GTT set is CROSS, the TTN value cannot be used in this procedure. If you wish to use this procedure to add a GTT set, repeat this step with a different TTN value. If you wish to use the TTN value to add a GTT selector, perform the Adding a GTT Selector procedure.

  4. Display the features that are enabled by entering the rtrv-ctrl-feat command.

    The following is an example of the possible output.

    rlghncxa03w 10-07-28 21:15:37 GMT EAGLE5 42.0.0
    The following features have been permanently enabled:
    
    Feature Name              Partnum    Status  Quantity
    Command Class Management  893005801  on      ----
    LNP Short Message Service 893006601  on      ----
    Intermed GTT Load Sharing 893006901  on      ----
    HC-MIM SLK Capacity       893012707  on      64
    
    The following features have been temporarily enabled:
    
    Feature Name              Partnum    Status  Quantity     Trial Period Left
    Zero entries found.
    
    The following features have expired temporary keys:
    
    Feature Name              Partnum
    Zero entries found.
  5. Display the GTT selectors in the database by entering the rtrv-gttsel command with the TTN value associated with the translation type that will be assigned to the global title translation. The TTN value is shown in the rtrv-tt output in 2.

    To specify of the TTN value, the parameters shown in Table 3-1 must be specified with the rtrv-gttsel command. The parameters that can be specified are dependent on the features that are enabled, shown in 4.

    Table 3-1 RTRV-GTTSEL Parameters

    Feature that is Enabled Parameter that must be Specified for the TTN Value
    Neither the Origin Based SCCP Routing nor the Flexible Linkset Optional Based Routing, shown as Flex Lset Optnl Based Rtg in the rtrv-ctrl-feat output, is enabled. gttsn
    Origin Based SCCP Routing cdgtasn, cggtasn
    Flexible Linkset Optional Based Routing cdgttsn, cggttsn

    For this example, enter these commands.

    rtrv-gttsel:gttsn=scp1

    rlghncxa03w 10-07-28 21:15:37 GMT EAGLE5 42.0.0
    
    GTIA    TT     NP      NAI  SELID GTTSN
     2       5     --      ---  none  scp1
    GTII    TT     NP      NAI  SELID GTTSN
    
    GTIN    TT     NP      NAI  SELID GTTSN
    
    GTIN24  TT     NP      NAI  SELID GTTSN
    
    GTIIS   TT     NP      NAI  SELID GTTSN
    
    GTINS   TT     NP      NAI  SELID GTTSN

    rtrv-gttsel:gttsn=scp2

    rlghncxa03w 10-07-28 21:15:37 GMT EAGLE5 42.0.0
    
    GTIA    TT     NP      NAI  SELID GTTSN
     2      10     --      ---  none  scp2
    GTII    TT     NP      NAI  SELID GTTSN
    
    GTIN    TT     NP      NAI  SELID GTTSN
    
    GTIN24  TT     NP      NAI  SELID GTTSN
    
    GTIIS   TT     NP      NAI  SELID GTTSN
    
    GTINS   TT     NP      NAI  SELID GTTSN

    rtrv-gttsel:gttsn=scp1

    rlghncxa03w 10-07-28 21:15:37 GMT EAGLE5 42.0.0
    
    GTIA    TT     NP      NAI  SELID GTTSN
     2      15     --      ---  none  scp3
    GTII    TT     NP      NAI  SELID GTTSN
    
    GTIN    TT     NP      NAI  SELID GTTSN
    
    GTIN24  TT     NP      NAI  SELID GTTSN
    
    GTIIS   TT     NP      NAI  SELID GTTSN
    
    GTINS   TT     NP      NAI  SELID GTTSN

    If no entries are displayed for the TTN value, continue the procedure with 6.

    If any of the entries shown in the rtrv-gttsel output do not have the default values for the advanced GTT parameters, or if a GTT selector entry with the TTN value was removed with the dlt-gttsel command, the remainder of this procedure cannot be performed. Choose another translation type and TTN combination and repeat this procedure from 5.

    If all of the entries shown in the rtrv-gttsel output have the default values for the advanced GTT parameters; none of the GTT selector entries with the TTN value were removed with the dlt-gttsel command; and none of the entries contain the translation type value that will be specified in 11, continue the procedure with 6.

    If any of the entries contain the translation type value that will be specified in 11, and you wish to specify an alias translation type to the translation type entry using this procedure, continue the procedure with 11. If you do not wish to specify an alias translation type to the translation type entry using this procedure, do not perform the remainder of this procedure. Perform the Adding a GTT Selector procedure to add the GTT selector.

  6. Continue the procedure by performing one of these steps.
    • If multiple values are shown in the NDGT column for any translation type entry, the Variable-Length Global Title Translation feature is turned on. If a translation type entry contains 11 - 16 values in the NDGT column, the Support for 16 GTT Lengths in VGTT feature is enabled and turned on.
      • If no more than 10 values are shown in the NDGT column for any translation type, continue the procedure by performing one of these steps.
        • If the new translation type that is being added will contain no more than 10 different length global title addresses, continue the procedure with 11.
        • If the new translation type that is being added will contain more than 10 different length global title addresses, continue the procedure with 10.
      • If more than 10 values are shown in the NDGT column for any translation type, continue the procedure with 11.
    • If only single values are shown in the NDGT column for all the translation type entries, continue the procedure by performing one of these steps.
      • If the new translation type that is being added will contain global title addresses of only one length, continue the procedure with 11.
      • If the new translation type that is being added will contain multiple lengths of global title addresses, continue the procedure with 7.
  7. Verify that the VGTT feature is on, by entering the rtrv-feat command. If the VGTT feature is on, the VGTT field should be set to on.

    Note:

    The rtrv-feat command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-feat command, see the rtrv-feat command description in Commands User's Guide.
    Continue the procedure by performing one of these steps.
    • If the VGTT feature is on, continue the procedure by performing one of these steps.
      • If the new translation type that is being added will contain no more than 10 different length global title addresses, continue the procedure with 11.
      • If the new translation type that is being added will contain more than 10 different length global title addresses, continue the procedure with 10.
    • If the VGTT feature is off, continue the procedure with 8.
  8. Display the cards in the EAGLE 5 using the rtrv-card command. This is an example of the possible output.
    rlghncxa03w 13-05-25 09:58:31 GMT EAGLE5 45.0.0
    CARD   TYPE      APPL      LSET NAME     LINK SLC LSET NAME     LINK SLC
    1102   TSM       GLS       
    1113   E5MCAP    EOAMHC
    1114   E5TDM-A
    1115   E5MCAP    EOAMHC
    1116   E5TDM-B
    1117   E5MDAL
    1118   RESERVED
    1201   LIMDS0    SS7ANSI   sp2           A    0   sp1           B    0
    1203   LIMDS0    SS7ANSI   sp3           A    0   
    1204   LIMDS0    SS7ANSI   sp3           A    1   
    1206   LIMDS0    SS7ANSI   nsp3          A    1   nsp4          B    1
    1216   DCM       STPLAN    
    1308   LIMDS0    SS7ANSI   sp6           A    1   sp7           B    0
    1314   LIMDS0    SS7ANSI   sp7           A    1   sp5           B    1
    1317   DCM       STPLAN

    The correct service modules must be in the EAGLE before the VGTT feature can be turned on, or the Support for 16 GTT Lengths in VGTT feature can be enabled and turned on. See Adding a Service Module to determine the service modules that are required. If any service modules must be replaced, contact the Customer Care Center before replacing any service modules. Refer to unresolvable-reference.htm#GUID-80C5766C-91E6-4233-A061-71F133268BEF for the contact information.

  9. Turn the Variable-length Global Title Translation (VGTT) feature on by entering this command.

    chg-feat:vgtt=on

    Note:

    Once the Variable-length Global Title Translation (VGTT) feature is enabled with the chg-feat command, it cannot be disabled.

    The VGTT feature must be purchased before turning it on. If you are not sure whether you have purchased the VGTT feature, contact your Sales Representative or Account Representative.

    When the chg-feat has successfully completed, this message should appear.

    rlghncxa03w 09-05-25 09:57:41 GMT EAGLE5 41.0.0
    CHG-FEAT: MASP A - COMPLTD
    Continue the procedure by performing one of these steps.
    • If the new translation type that is being added will contain no more than 10 different length global title addresses, continue the procedure with GUID-11FEF01E-847A-430C-8A21-0550E3A7EC34.htm.
    • If the new translation type that is being added will contain more than 10 different length global title addresses, perform Activating the Support for 16 GTT Lengths in VGTT Feature to enable and turn on the Support for 16 GTT Lengths in VGTT feature. After the Support for 16 GTT Lengths in VGTT feature has been enabled and turned on, continue the procedure with 11.
  10. Display the status of the Support for 16 GTT Lengths in VGTT feature by entering this command.

    rtrv-ctrl-feat:partnum=893024801

    rlghncxa03w 09-05-25 09:57:41 GMT EAGLE5 41.0.0
    The following features have been permanently enabled:
    
    Feature Name              Partnum   Status Quantity
    VGTT with 16 GTT lengths  893024801 on     ----
    
    
    The following features have been temporarily enabled:
    
    Feature Name              Partnum   Status Quantity   Trial Period Left
    Zero entries found.
    
    
    The following features have expired temporary keys:
    
    Feature Name              Partnum
    Zero entries found.

    If the Support for 16 GTT Lengths in VGTT feature is enabled and turned on, continue the procedure with 11.

    If the Support for 16 GTT Lengths in VGTT feature is not enabled or turned on, perform Activating the Support for 16 GTT Lengths in VGTT Feature to enable and turn on the Support for 16 GTT Lengths in VGTT feature. After the Support for 16 GTT Lengths in VGTT feature has been enabled and turned on, continue the procedure with 11.

  11. Add the translation type to the database using the ent-tt command. For this example, enter these commands.

    Note:

    If the VGTT feature is on, or the Support for 16 GTT Lengths in VGTT feature is enabled and turned on, the ndgt parameter cannot be specified with the ent-tt command.

    ent-tt:typea=5:ttn=scp1

    ent-tt:typea=10:ttn=scp2

    ent-tt:typea=15:ttn=scp3

    ent-tt:typea=5:ttn=scp1:alias=30

    ent-tt:typea=10:ttn=scp2:alias=40

    Notes:
    1. If the VGTT feature is on, the ndgt parameter cannot be specified with the ent-tt command.
    2. The translation type value, for example 10, can be specified as a value for each translation type parameter (typea=10, typei=10, typeis=10, typen=10, typens=10, typen24=10). The translation type value can appear in the rtrv-tt output only once for each network type of translation types.
    3. An alias translation type value cannot be specified if the value is shown in the TYPE column of the rtrv-tt output for the network type defined by the specified translation type parameter. For example, the alias translation type value 10 cannot be specified as an alias of an ITU-I translation type if a TYPEI value in the rtrv-tt output is 10. However, if the TYPEIS column does not contain the value 10, the value 10 can be specified as an alias translation type of an ITU-I spare translation type. The alias translation type value can appear in the rtrv-tt output only once for each network type of translation types.
    4. When adding an alias translation type, the translation type must be specified with the ent-tt command. The translation type must be shown in the rtrv-tt output.
    5. If the ttn parameter is not specified, the ttn value will be added in the formats shown in this list.
      • If an ANSI translation type 10 is specified, the ttn value will be setans010.
      • If an ITU-I translation type 10 is specified, the ttn value will be setint010.
      • If an ITU-I spare translation type 10 is specified, the ttn value will be setins010.
      • If an ITU-N translation type 10 is specified, the ttn value will be setnat010.
      • If an ITU-N spare translation type 10 is specified, the ttn value will be setnas010.
      • If an ITU-N24 translation type 10 is specified, the ttn value will be set24n010.

    When each of these commands have successfully completed, this message should appear.

    rlghncxa03w 09-05-25 09:57:41 GMT  EAGLE5 41.0.0
    ENT-TT: MASP A - COMPLTD
  12. Verify the changes using the rtrv-tt command with the translation type value specified in 11. For this example, enter these commands.

    rtrv-tt:typea=5

    This is an example of the possible output.

    rlghncxa03w 10-07-25 09:57:51 GMT  EAGLE5 42.0.0
    
    TYPEA      TTN        NDGT
    5          scp1       6
    
    ALIAS      TYPEA
    30         5

    rtrv-tt:typea=10

    This is an example of the possible output.

    rlghncxa03w 10-07-25 09:57:51 GMT  EAGLE5 42.0.0
    
    TYPEA      TTN        NDGT
    10         scp2       6
    
    ALIAS      TYPEA
    40         10

    rtrv-tt:typea=15:ttn=scp3

    This is an example of the possible output.

    rlghncxa03w 10-07-25 09:57:51 GMT  EAGLE5 42.0.0
    
    TYPEA      TTN        NDGT
    15         scp3       3
    
    ALIAS      TYPEA
  13. Backup the new changes using the chg-db:action=backup:dest=fixed command. These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first.
    BACKUP (FIXED) : MASP A - Backup starts on active MASP.
    BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
    BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
    BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure 3-1 Add a Translation Type - Sheet 1 of 6

Figure 3-2 Add a Translation Type - Sheet 2 of 6

Figure 3-3 Add a Translation Type - Sheet 3 of 6

Figure 3-4 Add a Translation Type - Sheet 4 of 6

Figure 3-5 Add a Translation Type - Sheet 5 of 6

Figure 3-6 Add a Translation Type - Sheet 6 of 6