Changing MRN Entries with the ESWT Parameter

This procedure is used to change the weight values of all the entries in an existing Mated Relay Node (MRN) group or MRN set using the eswt parameter of the chg-mrn command.

The chg-mrn command can also be used to add point code entries to an existing MRN group or MRN set. This action is not covered in this procedure. If you wish to add point code entries to an existing MRN group or MRN set, perform Provisioning MRN Entries .

If the MRN entries being changed do not have weight and threshold values assigned to them, perform Changing the Relative Cost Values of MRN Entries.

If you wish to change individual weight values for MRN entries with the wt/wt1/wt2/wt3/wt4 parameters, the weight values for an RC group with the grpwt parameter, the threshold values for an MRN group or MRN set with the thr parameter, or the relative cost and weight values for an MRN group or MRN set with the force=yes parameter, perform Changing the Weight and Threshold Values of MRN Entries. The wt/wt1/wt2/wt3/wt4, grpwt, thr, and force=yes parameters cannot be used in this procedure.

If you wish to change the MAP set, MAP point code, and MAP SSN values assigned to an MRN set, using the mapset, mappc/mappca/mappci/mappcn/mappcn24, and mapssn parameters, perform Changing the MAPSET, MAP Point Code, and MAP SSN Values of MRN Entries. The mapset, mappc/mappca/mappci/mappcn/mappcn24, and mapssn parameters cannot be used in this procedure.

An MRN group or MRN set contains alternate point codes, up to 32, that are used for load sharing between multiple nodes when the EAGLE is performing intermediate global title translation. This load sharing is performed after intermediate global title translation is performed on the message. The point code in the message is changed to the selected point code in the MRN table. If the translated point code is not found in the MRN table, the translated point code in the message is not changed, the message is routed using route for the translated point code.

These parameters are used with the chg-mrn command in this procedure.

:pc/pca/pci/pcn/pcn24 – The point code in the message after intermediate global title translation has been performed.

:rc – The relative cost value of point code in the message

:pc1/pca1/pci1/pcn1/pcn241 – The first alternate point code value

:rc1 – The relative cost value of the first alternate point code

:pc2/pca2/pci2/pcn2/pcn242 – The second alternate point code value

:rc2 – The relative cost value of the second alternate point code

:pc3/pca3/pci3/pcn3/pcn243 – The third alternate point code value

:rc3 – The relative cost value of the third alternate point code

:pc4/pca4/pci4/pcn4/pcn244 – The fourth alternate point code value

:rc4 – The relative cost value of the fourth alternate point code

Note:

Refer to Chapter 2, Configuring Destination Tables in Database Administration - SS7 User's Guide for a definition of the point code types that are used on the EAGLE and for a definition of the different formats that can be used for ITU national point codes.

:mrnset – The MRN set ID that the MRN is assigned to, shown in the rtrv-mrn output. MRN set IDs are shown only if the Flexible GTT Load Sharing feature is enabled. The mrnset parameter value cannot be changed in this procedure. For more information on the Flexible GTT Load Sharing feature, refer to Flexible GTT Load Sharing.

:eswt – The entity set weight value. When this parameter is specified, the same weight value is assigned to all entries in the MRN group or MRN set that contain the point code value specified in the chg-mrn command. A MRN group or MRN set can also be referred to as an entity set. The value of this parameter is from 1 - 99.

:thr – The in-service threshold assigned to the MRN group or MRN set. The in-service threshold is the minimum percentage (from 1 - 100) of weight that must be available for an RC group (a group of entries in the MRN group or MRN set that have the same RC value assigned) to be considered available to carry traffic. If the percentage of the available weight is less than the in-service threshold, then the entire RC group is considered unavailable for traffic. If the percentage of the available weight is equal to or greater than the in-service threshold, then the RC group is considered available, and traffic can be sent to any available entity in the RC group. When the thr parameter is specified with the eswt parameter in this procedure, the in-service threshold value is assigned to all the entries of the MRN group or MRN set.

The relative cost parameter values (rc/rc1/rc2/rc3/rc4) determine how the global title translation load is to be shared among the alternate point codes. There are three types of load sharing that can be performed: dominant, load shared, or combined dominant/load shared.

All the point codes in a dominant MRN group or MRN set have different relative cost values. The translated point code in the message is the preferred point code that the message is routed on. The relative cost value assigned to the preferred point code does not have to be the lowest value in the MRN group or MRN set. All traffic is routed to the preferred point code, if it is available. If the preferred point code becomes unavailable, the traffic is routed to highest priority alternate point code that is available. When the preferred point code becomes available again, the traffic is then routed back to the preferred point code. For example, the MRN table contains the following entries.

PC             RC
   005-005-005    10
   006-001-001    20
   006-001-002    30
   006-001-003    40
   006-001-004    50
   006-001-005    60
   006-001-006    70
   006-001-007    80

If the preferred point code is 006-001-001 and it becomes unavailable, the traffic will be routed to point code 006-001-002.

All the point codes in a load shared MRN group have the same relative cost value. Traffic is shared equally between the point codes in this MRN group.

A combined dominant/load shared MRN group or MRN set is a combination of the dominant and load sharing MRN groups or MRN sets. A combined dominant/load shared MRN group or MRN set must contain a minimum of two entries with the same relative cost value and a minimum of one entry with a different relative cost value. Traffic is routed to the point code or point codes with the lowest relative cost value. If more than one point code has the lowest relative cost value, the traffic is shared between these point codes. If the point code or point codes with the lowest relative cost value become unavailable, traffic is routed to the the point code or point codes with the next higher relative cost value. If more than one point code has this relative cost value, the traffic is shared between these point codes. For example, the MRN table contains the following entries.

PC             RC
   005-005-005    10
   006-001-001    10
   006-001-002    10
   006-001-003    20
   006-001-004    20
   006-001-005    20
   006-001-006    20
   006-001-007    20

If the preferred point code is 006-001-001, the traffic is shared equally between point codes 005-005-005, 006-001-001, and 006-001-002. If point codes 005-005-005, 006-001-001, and 006-001-002 become unavailable, the traffic will be shared equally between point codes, 006-001-003, 006-001-004, 006-001-005, 006-001-006, and 006-001-007.

The eswt and thr parameters can be used only:

If the MRN group or MRN set is either a load shared or combined dominant/load shared MRN group or MRN set.
If the Weighted GTT Load Sharing feature is enabled and turned on.

The status of the Weighted GTT Load Sharing feature can be verified by entering the rtrv-ctrl-feat command. If the Weighted GTT Load Sharing feature is not enabled or not turned on, perform Activating the Weighted GTT Load Sharing Feature to enable and turn on the Weighted GTT Load Sharing feature.

The eswt parameter assigns same weight value to all the entries in the MRN group or MRN set that contains the point code value specified in the chg-mrn command.

The eswt and thr parameters can be specified with the chg-mrn command only with the pc/pca/pci/pcn/pcn24 parameter and without the alternate point code, relative cost (rc, rc1, rc2, rc3, rc4), group weight (grpwt), and individual weight (wt, wt1, wt2, wt3, wt4) parameters.

The weight values assigned to the entires in the MRN group or MRN set are shown in the WT column in the rtrv-mrn output.

The in-service threshold values assigned to the entires in the MRN group or MRN set are shown in the THR column in the rtrv-mrn output.

The %WT column in the rtrv-mrn output shows the percentage of the traffic the particular entry in the entity set will handle.

The WT, %WT, and THR columns are shown in the rtrv-mrn output only if the Weighted GTT Load Sharing feature is enabled and turned on.

For more information on the Weighted GTT Load Sharing feature, refer to Weighted GTT Load Sharing.

Canceling the RTRV-MRN Command

Because the rtrv-mrn command used in this procedure can output information for a long period of time, the rtrv-mrn command can be canceled and the output to the terminal stopped. There are three ways that the rtrv-mrn command can be canceled.

Press the F9 function key on the keyboard at the terminal where the rtrv-mrn command was entered.
Enter the canc-cmd without the trm parameter at the terminal where the rtrv-mrn command was entered.
Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-mrn command was entered, from another terminal other that the terminal where the rtrv-mrn command was entered. To enter the canc-cmd:trm=<xx> command, the terminal must allow Security Administration commands to be entered from it and the user must be allowed to enter Security Administration commands. The terminal’s permissions can be verified with the rtrv-secu-trm command. The user’s permissions can be verified with the rtrv-user or rtrv-secu-user commands.

For more information about the canc-cmd command, refer to Commands User's Guide.

Display the mated relay node groups in the database using the rtrv-mrn command. This is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   PC             RC
   005-005-005    10
   006-001-001    20
   006-001-002    30
   006-001-003    40
   006-001-004    50
   006-001-005    60
   006-001-006    70
   006-001-007    80

   PC             RC
   007-007-007    10
   008-001-001    20
   008-001-002    30
   008-001-003    40
   008-001-004    50
   008-001-005    60
   008-001-006    70

MRN table is (15 of 5990) 1% full

If the Flexible GTT Load Sharing feature is enabled, this is an example of the possible output.

MRNSET    PC             RC
   DFLT      007-007-007    10
             008-001-001    20
             008-001-002    30
             008-001-003    40
             008-001-004    50
             008-001-005    60
             008-001-006    70

   MRNSET    PC             RC
   1         005-005-005    10
             006-001-001    20
             006-001-002    30
             006-001-003    40
             006-001-004    50
             006-001-005    60
             006-001-006    70
             006-001-007    80

MRN table is (15 of 5990) 1% full

If the Weighted GTT Load Sharing feature is enabled and turned on, and the Flexible GTT Load Sharing feature is not enabled, this is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   PC             RC WT %WT THR
   008-005-005    10 10  50  30
   008-001-001    10 10  50  30
   008-001-002    30 20 100  30
   008-001-003    40 20 100  30
   008-001-004    50 20 100  30

   PC             RC WT %WT THR
   009-005-005    10 10   4   1
   009-001-001    10 10   4   1
   009-001-002    10 30  12   1
   009-001-003    10 40  15   1
   009-001-005    10 40  15   1
   009-001-006    10 40  15   1
   009-001-007    10 40  15   1
   009-001-004    10 50  19   1
   009-001-008    20 20  25   1
   009-001-009    20 30  37   1
   009-001-010    20 30  37   1

MRN table is (16 of 5990) 1% full

If the Weighted GTT Load Sharing feature is enabled and turned on, and the Flexible GTT Load Sharing feature is enabled, this is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   MRNSET    PC             RC WT %WT THR
   DFLT      005-005-005    10 10  50  30
             006-001-001    10 10  50  30
             006-001-002    30 20 100  30
             006-001-003    40 20 100  30
             006-001-004    50 20 100  30

   MRNSET    PC             RC WT %WT THR
   1         005-005-005    10 10   4   1
             006-001-001    10 10   4   1
             006-001-002    10 30  12   1
             006-001-003    10 40  15   1
             006-001-005    10 40  15   1
             006-001-006    10 40  15   1
             006-001-007    10 40  15   1
             006-001-004    10 50  19   1
             006-001-008    20 20  25   1
             006-001-009    20 30  37   1
             006-001-010    20 30  37   1

MRN table is (16 of 5990) 1% full

If you wish to assign weight and in-service threshold values to the MRN entries in the MRN group or MRN set, and the WT, %WT, and THR columns are shown in the rtrv-mrn output in step 1, then the Weighted GTT Load Sharing feature is enabled and turned on. Go to step 3.

Note:
If weight and threshold values are assigned to the MRN group or MRN set, skip this step and go to step 3.

Note:
If weight and threshold values are assigned to the MRN group or MRN set, and the weight and threshold values are being removed from the MRN group or MRN set, skip steps 2 and 3 and go to step 4.
If the WT, %WT, and THR columns are not shown in the rtrv-mrn output in step 1, perform Activating the Weighted GTT Load Sharing Feature to enable and turn on the Weighted GTT Load Sharing feature. After the Weighted GTT Load Sharing feature is enabled and turned on, go to step 3.
To assign weight and in-service threshold values to a dominant MRN group or MRN set, the dominant MRN group or MRN set must be changed to either a load shared or combined dominant/load shared MRN group or MRN set.

Note:
If existing MRN group or MRN set that the weight and in-service threshold values are being assigned to is a load shared or combined dominant/load shared MRN group or MRN set, skip step 3 and go to step 4.

If you wish to change the dominant MRN group or MRN set to a load shared or combined dominant/load shared MRN group or MRN set by adding additional entries to the MRN group or MRN set, perform Provisioning MRN Entries .

To change the dominant MRN group or MRN set to a load shared or combined dominant/load shared MRN group or MRN set without adding any additional entries to the MRN group or MRN set, enter the chg-mrn command specifying the point codes in the MRN group or MRN set with the point codes corresponding RC parameters with the new RC values.

To create a load shared MRN group or MRN set, the new RC values for all the entries in the MRN group or MRN set must be equal.

To create a combined dominant/load shared MRN group or MRN set, a minimum of two the new RC values must be equal and a minimum of one other RC value must be different.

If the MRNSET column is not shown in the rtrv-mrn output in step 1, the mrnset parameter cannot be specified with the chg-mrn command.

For this example, enter this command.

chg-mrn:pca=007-007-007:rc=10:pca1=008-001-001:rc1=10 :pca2=008-001-002:rc2=10:pca3=008-001-003:rc3=10 :pca4=008-001-004:rc4=10

If the MRNSET column is shown in the rtrv-mrn output in step 1, the mrnset=<MRN Set ID> parameter, specifying the MRN set containing the point code specified in this step, must be specified with the chg-mrn command. To change the RC values in an MRN set, for this example enter this command.

chg-mrn:pca=007-007-007:rc=10:pca1=008-001-001:rc1=10 :pca2=008-001-002:rc2=10:pca3=008-001-003:rc3=10 :pca4=008-001-004:rc4=10:mrnset=dflt

This step must be repeated until the RC values for all the entries in the MRN group or MRN set have been changed.

After this step is performed, skip steps 4, 5, and 6, and go to step 7.
Change the weight and in-service threshold values of the load shared or combined dominant/load shared MRN group or MRN set.
Enter the chg-mrn command with the eswt and thr parameters to make these changes:
- Assign weight and threshold values to a non-weighted MRN group or MRN set.
- Change the existing weight values of a weighted MRN group or MRN set to the same weight value. The threshold can also be changed.
The eswt parameter assigns the same weight value to all the entries in the MRN group or MRN set. The thr parameter assigns the same threshold value to all the entries in the MRN group or MRN set.

If you wish to remove all the weight and threshold values from the MRN group or MRN set, enter the chg-mrn command with the eswt=none parameter. The thr parameter cannot be specified with the eswt=none parameter.

For this example, enter one of these commands.

To assign only weight values to all entries in the MRN group without the Flexible GTT Load Sharing feature enabled, enter this command.

chg-mrn:pca=007-007-007:eswt=30

To change the weight and in-service threshold values of all the entries in the MRN group without the Flexible GTT Load Sharing feature enabled, enter this command.

chg-mrn:pca=007-007-007:eswt=20:thr=30

To change only weight values of all the entries in the MRN set with the Flexible GTT Load Sharing feature enabled, enter this command.
chg-mrn:pca=007-007-007:eswt=30:mrnset=dflt
To change the weight and in-service threshold values of all the entries in the MRN set with the Flexible GTT Load Sharing feature enabled, enter this command.

chg-mrn:pca=007-007-007:eswt=20:thr=30:mrnset=dflt

To remove the weight and in-service threshold values from all the entries in the MRN set without the Flexible GTT Load Sharing feature enabled, enter this command.

chg-mrn:pca=007-007-007:eswt=none

To remove the weight and in-service threshold values from all the entries in the MRN set with the Flexible GTT Load Sharing feature enabled, enter this command.

chg-mrn:pca=007-007-007:eswt=none:mrnset=dflt

If the MRN group or MRN set did not have weight and in-service threshold values assigned before this step was performed, and the thr parameter is not specified in this step, the in-service threshold value 1 (1%) is assigned to the entries.

When the chg-mrn command has successfully completed, this message should appear.
```
rlghncxa03w 06-10-07  11:44:13  GMT  EAGLE5 36.0.0
CHG-MRN:  MASP A - COMPLTD
```

Verify the changes using the rtrv-mrn command with the point code (pca/pci/pcn/pcn24 parameters) specified in step 4.If the mrnset parameter was specified in step 4, the mrnset parameter and value specified in step 4 must be specified with the rtrv-mrn command in this step.

For this example, enter these commands.

rtrv-mrn:pca=007-007-007

If only the weight values were changed in step 4, this is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   PC             RC WT %WT THR
   007-007-007    10 30  14   1
   008-001-001    10 30  14   1
   008-001-002    10 30  14   1
   008-001-003    10 30  14   1
   008-001-004    10 30  14   1
   008-001-005    10 30  14   1
   008-001-006    10 30  14   1

MRN table is (15 of 5990) 1% full

If the weight and in-service threshold values were changed in step 4, this is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   PC             RC WT %WT THR
   007-007-007    10 20  14  30
   008-001-001    10 20  14  30
   008-001-002    10 20  14  30
   008-001-003    10 20  14  30
   008-001-004    10 20  14  30
   008-001-005    10 20  14  30
   008-001-006    10 20  14  30

MRN table is (15 of 5990) 1% full

rtrv-mrn:pca=007-007-007:mrnset=dflt

If an MRN set was changed in step 4, this is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   MRNSET    PC             RC WT %WT THR
   DFLT      007-007-007    10 30  14   1
             008-001-001    10 30  14   1
             008-001-002    10 30  14   1
             008-001-003    10 30  14   1
             008-001-004    10 30  14   1
             008-001-005    10 30  14   1
             008-001-006    10 30  14   1

MRN table is (15 of 5990) 1% full

If the weight and in-service threshold values were changed in an MRN set in step 4, this is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   MRNSET    PC             RC WT %WT THR
   DFLT      007-007-007    10 20  14  30
             008-001-001    10 20  14  30
             008-001-002    10 20  14  30
             008-001-003    10 20  14  30
             008-001-004    10 20  14  30
             008-001-005    10 20  14  30
             008-001-006    10 20  14  30

MRN table is (15 of 5990) 1% full

If the weight and in-service threshold values were removed in step 4, and the Flexible GTT Load Sharing feature is not enabled, this is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   PC             RC WT %WT THR
   007-007-007    10 --  --  --
   008-001-001    10 --  --  --
   008-001-002    10 --  --  --
   008-001-003    10 --  --  --
   008-001-004    10 --  --  --
   008-001-005    10 --  --  --
   008-001-006    10 --  --  --

MRN table is (15 of 5990) 1% full

rtrv-mrn:pca=007-007-007:mrnset=dflt

If the weight and in-service threshold values were removed from an MRN set was changed in step 4, this is an example of the possible output.

rlghncxa03w 06-10-07 00:34:31 GMT EAGLE5 36.0.0

   MRNSET    PC             RC WT %WT THR
   DFLT      007-007-007    10 --  --  --
             008-001-001    10 --  --  --
             008-001-002    10 --  --  --
             008-001-003    10 --  --  --
             008-001-004    10 --  --  --
             008-001-005    10 --  --  --
             008-001-006    10 --  --  --

MRN table is (15 of 5990) 1% full

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 2-141 Change MRN Entries with the ESWT Parameter - Sheet 1 of 4

Figure 2-142 Change MRN Entries with the ESWT Parameter - Sheet 2 of 4

Figure 2-143 Change MRN Entries with the ESWT Parameter - Sheet 3 of 4

Figure 2-144 Change MRN Entries with the ESWT Parameter - Sheet 4 of 4