Activating the Advanced GT Modification Feature

This procedure is used to enable and turn on the Advanced GT Modification feature using the feature’s part number and a feature access key.

The feature access key for the Advanced GT Modification feature is based on the feature’s part number and the serial number of the EAGLE, making the feature access key site-specific.

The enable-ctrl-feat command enables the feature by inputting the feature’s access key and the feature’s part number with these parameters:

:fak – The feature access key provided. The feature access key contains 13 alphanumeric characters and is not case sensitive.

:partnum – The issued part number of the Advanced GT Modification feature. There are three part numbers associated with the Advanced GT Modification feature.

893021801 - AMGTT - provides GT modification to both the called party address and the calling party address of SCCP messages. This part number can be specified only if no Advanced GT Modification feature is currently enabled.
893021802 - AMGTT CdPA Only - provides GT modification to the called party address of SCCP messages only. This feature and its part number is shown in the rtrv-ctrl-feat output only if the MGTT feature from previous releases was turned on when the EAGLE was upgraded to the release containing the Advanced GT Modification feature. This part number cannot be specified with the enable-ctrl-feat command.
893021803 - AMGTT CgPA Upgrade - provides GT modification to the calling party address and called party address of SCCP messages. This part number can be specified only if the AMGTT CdPA Only feature (part number 893021802) is enabled.

For more information on the Advanced GT Modification feature, refer to the Advanced GT Modification Feature section.

The enable-ctrl-feat command requires that the database contain a valid serial number for the EAGLE, and that this serial number is locked. This can be verified with the rtrv-serial-num command. The EAGLE is shipped with a serial number in the database, but the serial number is not locked. The serial number can be changed, if necessary, and locked once the EAGLE is on-site, with the ent-serial-num command. The ent-serial-num command uses these parameters.

:serial – The serial number assigned to the EAGLE. The serial number is not case sensitive.

:lock – Specifies whether or not the serial number is locked. This parameter has only one value, yes, which locks the serial number. Once the serial number is locked, it cannot be changed.

Note:

To enter and lock the EAGLE’s serial number, the ent-serial-num command must be entered twice, once to add the correct serial number to the database with the serial parameter, then again with the serial and the lock=yes parameters to lock the serial number. You should verify that the serial number in the database is correct before locking the serial number. The serial number can be found on a label affixed to the control shelf (shelf 1100).

These features cannot be temporarily enabled (with the temporary feature access key).

Once any of these features are enabled, they are also activated. The chg-ctrl-feat command cannot be used to turn these features on. Once any of these features are enabled, they cannot be turned off.

The status of the Advanced GT Modification features is shown in the rtrv-ctrl-feat command output.

Before the Advanced GT Modification feature can be enabled, the GTT feature must be turned on. The state of the GTT feature can be verified using the rtrv-feat command.

Display the status of the Advanced GT Modification feature by entering the rtrv-ctrl-feat command.
The following is an example of the possible output.
```
rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.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.
```
If the AMGTT or AMGTT CgPA Upgrade feature is enabled, no further action is necessary. This procedure does not need to be performed.

If the AMGTT CdPA Only feature is enabled, and you do not wish to enable the AMGTT CgPA Upgrade feature, no further action is necessary.

If the AMGTT CdPA Only feature is enabled, and you wish to enable the AMGTT CgPA Upgrade feature, continue the procedure with 8.

If none of the Advanced GT Modification features are enabled, continue the procedure with 2.
Verify 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, see the rtrv-feat command description in Commands User's Guide.

If the GTT feature is not on, perform Adding a Service Module to turn the GTT feature on and add the appropriate service modules to the EAGLE. After the GTT feature is turned on and the service modules have been added, continue the procedure with 4.

If the GTT feature is on, continue the procedure with 3.

Display the cards in the EAGLE using the rtrv-card command. The Advanced GT Modification feature requires that service modules are in the database. This is an example of the possible output.

rlghncxa03w 09-05-25 09:58:31 GMT EAGLE5 41.0.0
CARD   TYPE      APPL      LSET NAME     PORT SLC LSET NAME     PORT SLC
1102   TSM       GLS       
1113   E5MCAP    OAMHC
1114   E5TDM-A
1115   E5MCAP    OAMHC
1116   E5TDM-B
1117   E5MDAL
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

There are two types of service modules, SMs or E5-SM4Gs running the VSCCP application.

SMs and E5-SM4Gs are shown by the entries DSM in the TYPE column and VSCCP in the APPL column.

If no service modules are shown in the rtrv-card output, perform Adding a Service Module to add the appropriate service modules to the EAGLE. After the service modules have been added, continue the procedure with 4.

If service modules are in the EAGLE, continue the procedure with 4.

Display the serial number in the database with the rtrv-serial-num command.
Note:
If the rtrv-ctrl-feat output in 1 shows any controlled features, continue the procedure with 8. If the rtrv-ctrl-feat output shows only the HC-MIM SLK Capacity feature with a quantity of 64, 4 through 7 must be performed.

This is an example of the possible output.
```
rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
Command Completed.
```
Enter the correct serial number into the database using the ent-serial-num command with the serial parameter.
Note:
If the serial number is correct and locked, continue the procedure with 8. If the serial number is correct but not locked, continue the procedure with 7. If the serial number is not correct, but is locked, this feature cannot be enabled and the remainder of this procedure cannot be performed. Contact the Customer Care Center to get an incorrect and locked serial number changed. Refer to My Oracle Support (MOS) for the contact information. The serial number can be found on a label affixed to the control shelf (shelf 1100).

For this example, enter this command.

ent-serial-num:serial=<EAGLE’s correct serial number>

When this command has successfully completed, the following message should appear.
```
rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
```
Verify that the serial number entered in 5 was entered correctly using the rtrv-serial-num command.
This is an example of the possible output.
```
rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
Command Completed.
```
If the serial number was not entered correctly, repeat 5 and 6 and re-enter the correct serial number.
Lock the serial number in the database by entering the ent-serial-num command with the serial number shown in 4, if the serial number shown in 4 is correct, or with the serial number shown in 6, if the serial number was changed in 5, and with the lock=yes parameter.
For this example, enter this command.

ent-serial-num:serial=<EAGLE’s serial number>:lock=yes

When this command has successfully completed, the following message should appear.
```
rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
```
Enable the Advanced GT Modification feature with the enable-ctrl-feat command specifying the part number for the Advanced GT Modification feature and the feature access key.
If the AMGTT feature is being enabled, enter this command.

enable-ctrl-feat:partnum=893021801:fak=<AMGTT feature access key>

If the AMGTT CgPA Upgrade feature is being enabled, enter this command.

enable-ctrl-feat:partnum=893021803:fak=<AMGTT CgPA Upgrade feature access key>

Note:
Neither the AMGTT nor the AMGTT CgPA Upgrade feature can be enabled with a temporary feature access key.

Note:
The values for the feature access key (the fak parameter) are provided. If you do not have the feature access key for the AMGTT or the AMGTT CgPA Upgrade feature, contact your Sales Representative or Account Representative.

When the enable-crtl-feat command has successfully completed, this message should appear.
```
rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
ENABLE-CTRL-FEAT: MASP B - COMPLTD
```

Verify the changes by entering the rtrv-ctrl-featcommand with the part number used in 8.

If the AMGTT feature was enabled in 8, enter this command.

rtrv-ctrl-feat:partnum=893021801

The following is an example of the possible output.

rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
AMGTT                     893021801  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 AMGTT CgPA Upgrade feature was enabled in 8, enter this command.

rtrv-ctrl-feat:partnum=893021803

The following is an example of the possible output.

rlghncxa03w 06-10-28 21:15:37 GMT EAGLE5 38.0.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
AMGTT CgPA Upgrade        893021803  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.

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 5-49 Activate the Advanced GT Modification Feature - Sheet 1 of 3

Figure 5-50 Activate the Advanced GT Modification Feature - Sheet 2 of 3

Figure 5-51 Activate the Advanced GT Modification Feature - Sheet 3 of 3