Activating the 15 Minute Measurements Controlled Feature

This procedure is used to enable and turn on the 15 Minute Measurements controlled feature, using the feature’s part number and a feature access key. This feature allows EAGLE measurements to be collected every 15 minutes.

To enable and turn on the 15 Minute Measurements controlled feature, the following requirements must be met:

The Measurements Platform feature must be on, or the Integrated Measurements feature must be enabled and turned on.
The EAGLE must be configured to use the Measurements Platform, or the Integrated Measurements feature.
If the Measurements Platform is being used, MCPMs must be provisioned in the database, and the state of all these MCPMs must be IS-NR.

The enable-ctrl-feat, ent-serial-num, and chg-ctrl-feat commands are used to enable and turn on the 15 Minute Measurements controlled feature using the feature’s part number and a feature access key.

The feature access key for the 15 Minute Measurements controlled 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 by Oracle. The feature access key contains 13 alphanumeric characters and is not case sensitive.

:partnum – The Oracle-issued part number of the 15 Minute Measurements controlled feature, 893012101.

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

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

Once this feature has been enabled, the feature must be turned on with the chg-ctrl-feat command. The chg-ctrl-feat command uses these parameters:

:partnum – The Oracle-issued part number of the 15 Minute Measurements controlled feature, 893027701.

:status=on – used to turn the 15 Minute Measurements controlled feature on.

Once the 15 Minute Measurements controlled feature has been turned on, it be cannot be turned off.

The status of the features in the EAGLE is shown with the rtrv-ctrl-feat command.

After the 15 Minute Measurements controlled feature is enabled and turned on, the 15 minute measurement collection option in the measurement options table must be turned on.

Display the status of the 15 Minute Measurements controlled features by entering the rtrv-ctrl-feat command.

The following is an example of the possible output.

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

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  off     ----
LNP Short Message Service 893006601  on      ----
Intermed GTT Load Sharing 893006901  off     ----
XGTT Table Expansion      893006101  off     ----
XMAP Table Expansion      893007710  on      3000
Large System # Links      893005910  on      2000
Routesets                 893006401  on      6000
15 Minute Measurements    893012101  off     ----

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 rtrv-ctrl-feat output shows that the 15 Minute Measurements controlled feature is enabled, and its status is on, no further action is necessary.

If the 15 Minute Measurements controlled feature is enabled, and its status is off, continue the procedure with 7.

Note:

If the rtrv-ctrl-feat output in 1 shows any controlled features, continue the procedure with 6. If the rtrv-ctrl-feat output shows only the HC-MIM SLK Capacity feature with a quantity of 64, 2 through 5 must be performed.

Display the serial number in the database with the rtrv-serial-num command.
This is an example of the possible output.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
System serial number = ntxxxxxxxxxxxxx

System serial number is not locked.

rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
Command Completed
```
Note:
If the serial number is correct and locked, continue the procedure with 6. If the serial number is correct but not locked, continue the procedure with 5. 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).
Enter the correct serial number into the database using the ent-serial-num command with the serial parameter.
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-01 21:15:37 GMT EAGLE5 36.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
```
Verify that the serial number entered into 3 was entered correctly using the rtrv-serial-num command.
This is an example of the possible output.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
System serial number = nt00001231

System serial number is not locked.

rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
Command Completed
```
If the serial number was not entered correctly, repeat 3 and 4 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 2 , if the serial number shown in 2 is correct, or with the serial number shown in 4 , if the serial number was changed in 3 , 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-01 21:15:37 GMT EAGLE5 36.0.0
ENT-SERIAL-NUM:  MASP A - COMPLTD
```
Enable the 15 Minute Measurements controlled feature by entering the enable-ctrl-feat command.
For this example, enter this command.

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

This feature cannot be enabled with a temporary feature access key.

Note:
The values for the feature access key (the fak parameter) are provided by Oracle. If you do not have the controlled feature part number or the feature access key for the feature you wish to enable, contact your Oracle Sales Representative or Account Representative.

When the enable-ctrl-feat command has successfully completed, this message should appear.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
ENABLE-CTRL-FEAT: MASP B - COMPLTD
```
Display the quantity of signaling links that are provisioned in the EAGLE by entering the rtrv-tbl-capacity command.
This is an example of the possible output.
```
rlghncxa03w 10-04-19 21:16:37 GMT EAGLE5 42.0.0
SLK      table is (        7 of      1200)   1% full
```
Note:
The rtrv-tbl-capacity command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-tbl-capacity command, refer to the rtrv-tbl-capacity command description in Commands User's Guide.
To enable the 15 Minute Measurements controlled feature, either the Measurements Platform feature must be on and the Measurements Platform option (PLATFORMENABLE) must be on, or the Integrated Measurements feature must be enabled and turned on and the measurement collection option for the E5-MCAP card (OAMHCMEAS) must be on. If the EAGLE contains more than 1200 signaling links, shown in 7, the Measurements Platform feature must be used. If the EAGLE contains 1200 signaling links or less, either the Measurements Platform feature or the Integrated Measurements feature can be used. Verify whether or nor the Measurements Platform option is enabled (PLATFORMENABLE = on), or the measurement collection option for the E5-MCAP card (OAMHCMEAS) must be on using the rtrv-measopts command.
The following is an example of the possible output.
```
rlghncxa03w 10-04-01 16:02:05 GMT  EAGLE5 42.0.0

PLATFORMENABLE = on
COLLECT15MIN   = off
CLLIBASEDNAME  = on
OAMHCMEAS      = off
-------------------------------------
SYSTOTSTP     =on
```
Note:
The rtrv-measopts command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-measopts command, see the rtrv-measopts command description in Commands User's Guide.

If the Measurements Platform option is enabled, continue the procedure with 11.

If the Measurements Platform option is not enabled and the Measurements Platform is required, or you wish to use the Measurements Platform, continue the procedure with 9.
If the Integrated Measurements feature will be used, continue the procedure by performing one of these steps.
- If the measurement collection option for the E5-MCAP card (OAMHCMEAS) is on, continue the procedure with 11.
- If the measurement collection option for the E5-MCAP card (OAMHCMEAS) is off, continue the procedure by performing one of these steps.
  - If the Integrated Measurements feature is not enabled or turned on, shown in the rtrv-ctrl-feat output in 1, perform the Configuring the Integrated Measurements Feature procedure to configure the Integrated Measurements feature. Continue the procedure with 11.
  - If the Integrated Measurements feature is enabled and turned on, continue the procedure with 10.
Verify whether or not the Measurements Platform feature is on by entering the rtrv-feat command.

If the Measurements Platform feature is on, the entry MEASPLAT = on is shown in the rtrv-feat command output:

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 Measurements Platform feature is not on, perform the Adding a Measurement Collection and Polling Module (MCPM) procedure to add the required MCPMs and to turn the Measurements Platform feature on. After the Measurements Platform is turned on, perform the Configuring the Measurements Platform Feature procedure to configure the Measurements Platform feature. Continue the procedure with 11.

If the Measurements Platform is on, perform the Configuring the Measurements Platform Feature procedure to configure Measurements Platform feature and to enable the Measurements Platform option, if required. Continue the procedure with 11..
Turn the measurement collection option for the E5-MCAP card (OAMHCMEAS) on by entering this command.
chg-measopts:oamhcmeas=on

When the chg-measopts command has successfully completed, the following message should appear.
```
rlghncxa03w 10-04-01 21:16:37 GMT EAGLE5 42.0.0
CHG-MEASOPTS: MASP A - COMPLTD
```
Turn the 15 Minute Measurements controlled feature on using the chg-ctrl-feat command, specifying the 15 Minute Measurements controlled feature part number and the status=on parameter.
Note:
If a 30-minute measurement collection is in progress, the chg-ctrl-feat command will be rejected. Wait until the 30-minute measurement collection has finished before executing the chg-ctrl-feat command.

For this example, enter this command.

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

Note:
Once the 15 Minute Measurements feature is turned on, it cannot be turned off.

When the chg-ctrl-feat command has successfully completed, the following message should appear.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CHG-CTRL-FEAT: MASP B - COMPLTD
```

Verify the changes by entering the rtrv-ctrl-feat command with the part number specified in 11 .

rtrv-ctrl-feat:partnum=893012101

The following is an example of the possible output.

rlghncxa03w 06-10-01 21:16:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:
Feature Name              Partnum    Status  Quantity
15 Minute Measurements    893012101  on      ----

Turn the 15 Minute Measurement collection option on by entering this command.
chg-measopts:collect15min=on

When the chg-measopts command has successfully completed, the following message should appear.
```
rlghncxa03w 10-04-01 21:16:37 GMT EAGLE5 42.0.0
CHG-MEASOPTS: MASP A - COMPLTD
```
Verify that the 15 Minute Measurement collection option is on by entering the rtrv-measopts command.
The following is an example of the possible output.
```
rlghncxa03w 10-04-01 16:02:05 GMT  EAGLE5 42.0.0

PLATFORMENABLE = on
COLLECT15MIN   = on
CLLIBASEDNAME  = on
OAMHCMEAS      = off
-------------------------------------
SYSTOTSTP     =on
```
Note:
The rtrv-measopts command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-measopts command, see the rtrv-measopts command description in Commands User's Guide.

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 A-3 Activating the 15 Minute Measurements Controlled Feature

Sheet 1 of 4

Sheet 2 of 4

Sheet 3 of 4

Sheet 4 of 4