Changing the Mated Application Type

This procedure is used to change the mated application type of an existing mated application (MAP) group or MAP set using the chg-map command with the rc parameter.

There are four types of mated applications.

Solitary - A solitary mated application contains only one entry.
Dominant - A dominant mated application contains more than one entry and the RC (relative cost) values of these entries are unique.
Load Shared - A load shared mated application contains more than one entry and the RC values of these entries are equal.
Combined Dominant/Load Shared - A combined dominant/load shared mated application contains more than one entry and must contain a minimum of two entries whose RC values are equal and one entry whose RC value is different.

The chg-map command contains other parameters that are not used in this procedure. Perform these procedures as applicable to change the other parameter values.

To change the weights or in-service thresholds of the mated application, perform the Changing the Weight and In-Service Threshold Values of a Mated Application procedure.
To change the MRNSET and MRN point code values assigned to the mated application, perform the Changing the MRNSET and MRN Point Code Values of MAP Entries procedure.
To change other attributes of the mated application, perform the Changing the Attributes of a Mated Application procedure.

The chg-map command can also be used to add point code/SSN entries to an existing MAP group or MAP set. This action is not covered in this procedure. If you wish to add point code/SSN entries to an existing MAP group or MAP set, perform one of these procedures.

The chg-map command in this procedure uses these parameters.

:pc/pca/pci/pcn/pcn24 – The point code of the primary signaling point that is to receive the message.

Note:

The point codes can be either an ANSI point code (pc/pca), ITU-I or ITU-I spare point code (pci), a 14-bit ITU-N or 14-bit ITU-N spare point code (pcn), or a 24-bit ITU-N (pcn24) point code.

Note:

Refer to Chapter 2, Configuring Destination Tables, in the 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.

:ssn – Subsystem number – the subsystem address of the primary point code that is to receive the message.

:rc – The relative cost value of the primary point code and subsystem, defined by the pc/pca/pci/pcn/pcn24 and ssn parameters. The rc parameter has a range of values from 0 to 99.

:mapset – The MAP set ID that the mated applications are assigned to, shown in the rtrv-map output. MAP set IDs are shown only if the Flexible GTT Load Sharing feature is enabled. The mapset parameter value cannot be changed in this procedure. If the rtrv-map output shows the MAPSET field, the mapset parameter must be specified with the chg-map command. If the rtrv-map output does not show the MAPSET field, the Flexible GTT Load Sharing feature is not enabled. The mapset parameter cannot be specified with the chg-map command. The mapset parameter has two values.

dflt – to change the mated application in the default MAP set. The EAGLE’s true point code (shown in the rtrv-sid output) and subsystem can be assigned only to the default MAP set.
the specific number of an existing MAP set if you are changing the mated application in an existing MAP set.

The mated application to be changed must be in the database.

If an existing dominant, load shared, or combined dominant/load shared mated application is being changed to a solitary mated application, the existing mated application must be removed from the database, and the new solitary mated application, containing the primary point code and subsystem from the mated application that was removed, must be added to the database.

If the mated application contains the EAGLE’s true point code, the relative cost value assigned to this point code must be the lowest value in the mated application.

Canceling the RTRV-MAP Command

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

Press the F9 function key on the keyboard at the terminal where the rtrv-map command was entered.
Enter the canc-cmd without the trm parameter at the terminal where the rtrv-map command was entered.
Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-map command was entered, from another terminal other that the terminal where the rtrv-map 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 applications in the database using the rtrv-map command.

This is an example of the possible output.

rlghncxa03w 09-07-07 00:34:31 GMT EAGLE5 41.1.0

MAPSET ID=DFLT
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
002-002-002               250 10  SHR *Y  *Y  grp15    ON  10  33  20
             100-130-079  250 10  SHR *Y  *Y  grp15    ON  10  33  20
             068-135-094  251 10  SHR *Y  *Y  grp05    OFF 10  33  20

MAPSET ID=10
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
003-003-003               254 10  DOM YES YES grp10    ON  -- ---  --
             040-040-040  254 20  DOM YES YES grp10    ON  -- ---  --

MAPSET ID=11
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
004-004-004               254 10  SHR *Y  *Y  grp10    OFF -- ---  --
             100-100-100  254 10  SHR *Y  *Y  grp10    OFF -- ---  --

MAPSET ID=DFLT
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
005-005-005               250 10  DOM YES YES grp15    OFF -- ---  --
             060-060-060  250 20  DOM YES YES grp15    OFF -- ---  --
             070-070-070  251 30  DOM YES YES grp05    ON  -- ---  --

MAPSET ID=9
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
006-006-006               250 10  SOL *Y  *Y  grp15    OFF -- ---  --

MAPSET ID=DFLT
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
007-007-007               251 10  SOL *Y  *Y  grp05    ON  -- ---  --

MAPSET ID=12
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
008-008-008               254 10  COM YES *Y  grp10    ON  10  33  20
             200-147-100  254 10  COM YES *Y  grp10    ON  10  33  20
             179-183-050  250 10  COM YES *Y  grp15    OFF 10  33  20
             031-049-100  250 20  COM YES *Y  grp15    ON  10  50  20
             056-113-200  251 20  COM YES *Y  grp05    OFF 10  50  20

MAPSET ID=DFLT
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-000               250 10  SOL *Y  *Y  grp01    ON  -- ---  --

MAPSET ID=1
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-000               251 10  SHR *Y  *Y  grp01    OFF -- ---  --
             253-001-002  254 10  SHR *Y  *Y  grp01    OFF -- ---  --

MAPSET ID=2
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-000               252 10  SOL *Y  *Y  grp01    ON  -- ---  --

MAPSET ID=DFLT
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-000               253 10  SHR *Y  *Y  grp01    OFF -- ---  --
             253-001-004  254 10  SHR *Y  *Y  grp01    OFF -- ---  --
MAPSET ID=3
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-001               255 10  DOM YES YES grp01    ON  -- ---  --
             253-001-005  254 20  DOM YES YES grp01    ON  -- ---  --
MAPSET ID=4
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-001               250 10  DOM NO  NO  grp01    OFF -- ---  --
             253-001-001  254 20  DOM NO  NO  grp01    OFF -- ---  --

MAPSET ID=DFLT
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-002               251 10  SHR *Y  *Y  grp01    OFF -- ---  --
             255-001-002  254 10  SHR *Y  *Y  grp01    OFF -- ---  --

MAPSET ID=5
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-002               252 10  DOM YES YES grp01    ON  -- ---  --
             255-001-003  254 20  DOM YES YES grp01    ON  -- ---  --

MAPSET ID=6
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
255-001-002               253 10  SHR *Y  *Y  grp01    ON  -- ---  --
             255-001-004  254 10  SHR *Y  *Y  grp01    ON  -- ---  --

MAPSET ID=7
PCI          Mate PCI     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
2-001-2                   255 10  DOM YES YES grp03    OFF -- ---  --
             2-001-1      254 20  DOM YES YES grp03    OFF -- ---  --

MAPSET ID=8
PCN          Mate PCN     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
00347                     253 10  SHR *N  *N  grp05    OFF -- ---  --
             01387        254 10  SHR *N  *N  grp05    OFF -- ---  --

MAP TABLE IS  (37 of 36000)  1 % FULL

If any of the following items are not shown in the rtrv-map output, then the feature corresponding to these items is not enabled, or turned on if required.

The MAPSET field - the Flexible GTT Load Sharing feature is not enabled.
The MRNSET and MRNPC fields - the GTT Load Sharing with Alternate Routing Indicator feature is not enabled.
The WT, %WT, THR columns - the Weighted GTT Load Sharing feature is not enabled and turned on.

If a solitary mated application is being changed to a dominant, load shared, or combined dominant/load shared mated application, perform one of these procedures.

If you wish to change a dominant, load shared, or combined dominant/load shared mated application to a solitary mated application, record the data for the mated application. Remove the mated application by performing the Removing a Mated Application procedure. Add the solitary mated application with the point code and SSN from the previous mated application by performing the Provisioning a Solitary Mated Application procedure.

If the mated application being changed is not a solitary mated application, continue the procedure by performing one of these steps.

If the mated application is being changed to a dominant mated application, continue the procedure with 3.
Note:
If the mated application contains weight and in-service threshold values, when this mated application is changed to a dominant mated application, the weight and in-service threshold values will be removed from the mated application.
If the mated application is being changed to a load shared mated application or a combined dominant/load Shared mated application, continue the procedure with 2.

Display the EAGLE's point code by entering the rtrv-sid command. A load shared or combined dominant/load shared mated application cannot contain the EAGLE’s point code.
The EAGLE’s point code is shown in the PCA, PCI, PCN, and PCN24 fields. This is an example of the possible output.
```
rlghncxa03w 09-07-10 11:43:04 GMT EAGLE5 41.1.0
   PCA             PCI          PCN                CLLI              PCTYPE
   010-020-030     1-023-1      12-0-14-1          rlghncxa03w       OTHER
                 s-1-023-1    s-12-0-14-1

   CPCA
   001-001-001       002-002-003       002-002-004      002-002-005
   002-002-006       002-002-007       002-002-008      002-002-009
   004-002-001       004-003-003       050-060-070
   
   CPCI
   1-001-1           1-001-2           1-001-3          1-001-4
   1-002-1           1-002-2           1-002-3          1-002-4
   2-001-1           7-222-7
   
   CPCN
   2-0-10-3          2-0-11-0          2-0-11-2          2-0-12-1
   2-2-3-3           2-2-4-0           10-14-10-1
```
If the EAGLE's point code is shown in the mated application that is being changed, record the mated application data. Remove the mated application by performing the Removing a Mated Application procedure. Add the new mated application by performing the Provisioning a Load Shared Mated Application or Provisioning a Combined Dominant/Load Shared Mated Application procedures.

If the EAGLE's point code is not shown in the mated application that is being changed, continue the procedure with 3.
Change the rc parameter values in the mated application to produce the desired mated application type.
If the MAPSET field is shown in the rtrv-map output in 1, the mapset parameter must be specified with the chg-map command. If the MAPSET field is not shown in the rtrv-map output in 1, the mapset parameter cannot be specified with the chg-map command.

If a dominant mated application is being created, the rc parameter values for this mated application must be unique. If the mated application has weight and in-service threshold values assigned to it, when this mated application is changed to a dominant mated application, the WT, %WT, and THR values are removed from the mated application and are not displayed in the rtrv-map output.

If a load shared mated application is being created, the rc parameter values for this mated application must be equal.

If a combined dominant/load shared mated application is being created, a minimum of 2 entries must contain rc parameter values that are equal and a mi mum of one entry must contain an rc parameter value that is different.
For these examples, these types of changes are being made.
- A dominant mated application is changed to a load shared mated application.
- A load shared mated application is changed to a dominant mated application.
- A combined dominant/load shared mated application is changed to a load shared mated application.
To change a dominant mated application to a load shared mated application, for this example enter these commands.

chg-map:pca=060-060-060:ssn=250:mapset=dflt:rc=10

chg-map:pca=070-070-070:ssn=251:mapset=dflt:rc=10

To change a load shared mated application to a dominant mated application, for this example enter these commands.

chg-map:pca=100-130-079:ssn=250:mapset=dflt:rc=20

chg-map:pca=068-135-094:ssn=251:mapset=dflt:rc=30

To change a combined dominant/load shared mated application to a load shared mated application, for this example enter these commands.

chg-map:pca=031-049-100:ssn=250:mapset=12:rc=10

chg-map:pca=056-113-200:ssn=251:mapset=12:rc=10

Verify the changes using the rtrv-map command with the one of the primary point codes and subsystems specified in 3 for the MAP set or MAP group that was changed. If the mapset parameter was specified in 3, the mapset parameter and value specified in 3 must be specified with the rtrv-map command in this step.

For these examples, enter these commands.

rtrv-map:pca=060-060-060:ssn=250:mapset=dflt

This is an example of the possible output.

rlghncxa03w 09-07-07 00:34:31 GMT EAGLE5 41.1.0

MAPSET ID=DFLT
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
005-005-005               250 10  SHR *Y  *Y  grp15    OFF -- ---  --
             060-060-060  250 10  SHR *Y  *Y  grp15    OFF -- ---  --
             070-070-070  251 10  SHR *Y  *Y  grp05    ON  -- ---  --

MAP TABLE IS  (37 of 36000)  1 % FULL

rtrv-map:pca=100-130-079:ssn=250:mapset=dflt

This is an example of the possible output.

rlghncxa03w 09-07-07 00:34:31 GMT EAGLE5 41.1.0

MAPSET ID=DFLT
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
002-002-002               250 10  DOM YES YES grp15    ON  -- --- ---
             100-130-079  250 20  DOM YES YES grp15    ON  -- --- ---
             068-135-094  251 30  DOM YES YES grp05    OFF -- --- ---

MAP TABLE IS  (37 of 36000)  1 % FULL

rtrv-map:pca=031-049-100:ssn=250:mapset=12

This is an example of the possible output.

rlghncxa03w 09-07-07 00:34:31 GMT EAGLE5 41.1.0

MAPSET ID=12
PCA          Mate PCA     SSN RC MULT SRM MRC GRP NAME SSO WT %WT THR
008-008-008               254 10  SHR *Y  *Y  grp10    ON  10  20  20
             200-147-100  254 10  SHR *Y  *Y  grp10    ON  10  20  20
             179-183-050  250 10  SHR *Y  *Y  grp15    OFF 10  20  20
             031-049-100  250 10  SHR *Y  *Y  grp15    ON  10  20  20
             056-113-200  251 10  SHR *Y  *Y  grp05    OFF 10  20  20

MAP TABLE IS  (37 of 36000)  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.
```
If you do not wish to change the weights or in-service thresholds of the mated application, the MRNSET and MRN point code of the mated application, or other attributes of the mated application, this procedure is finished.
If you wish to change the the weights or in-service thresholds of the mated application, the MRNSET and MRN point code of the mated application, or other attributes of the mated application, perform these procedures as applicable.
- To change the weights or in-service thresholds of the mated application, perform the Changing the Weight and In-Service Threshold Values of a Mated Application procedure.
- To change the MRNSET and MRN point code of the mated application, perform the Changing the MRNSET and MRN Point Code Values of MAP Entries procedure.
- To change other attributes of the mated application, perform the Changing the Attributes of a Mated Application procedure.

Figure 2-112 Change the Mated Application Type - Sheet 1 of 6

Figure 2-113 Change the Mated Application Type - Sheet 2 of 6

Figure 2-114 Change the Mated Application Type - Sheet 3 of 6

Figure 2-115 Change the Mated Application Type - Sheet 4 of 6

Figure 2-116 Change the Mated Application Type - Sheet 5 of 6

Figure 2-117 Change the Mated Application Type - Sheet 6 of 6