Configuring an ITU Linkset with a Secondary Adjacent Point Code (SAPC)

This procedure is used to configure a secondary adjacent point code for SS7 ITU linksets using the lsn, sapci, sapcn, sapcn24, and action parameters of the chg-ls command. Only these parameters can be specified in this procedure. The chg-ls command contains other parameters.

These parameters are discussed in more detail in Commands User's Guide or in these sections.

Changing an SS7 Linkset
The "Configuring a Linkset for the GSM MAP Screening Feature" procedure in Database Administration - Features User's Guide.
These procedures in Database Administration - IP7 User's Guide.
- Configuring an IPGWx Linkset
- Adding a Mate IPGWx Linkset to another IPGWx Linkset
- Removing a Mate IPGWx Linkset from another IPGWx Linkset
- Adding an IPSG M3UA Linkset
- Addingn IPSG M2PA Linkset

Note:

A secondary adjacent point code cannot be assigned to a proxy linkset. A proxy linkset is a linkset whose linkset type is PRX. A secondary adjacent point code cannot be assigned to a linkset that contains an IPSG-M3UA linkset. An IPSG-M3UA linkset is a linkset that contains the ipsg=yes and adapter=m3ua parameter values.

The secondary adjacent point code is used to enhance the network management in the ITU international and ITU national nodes when messages from different countries to be routed over the same linkset.

The lsn parameter specifies the name of the linkset being changed.

The sapci parameter specifies the ITU international secondary adjacent point code.

The sapcn parameter specifies a 14-bit ITU national secondary adjacent point code.

The sapcn24 parameter specifies a 24-bit ITU national secondary adjacent point code.

The action parameter specifies whether the secondary adjacent point code (sacpi, sapcn, or sapcn24) is being added (action=add) to the linkset or removed (action=delete) from the linkset.

While the multgc parameter is not specified with the chg-ls command in this procedure, in addition to specifying whether or not multiple group codes are supported for the linkset, its value does help determine how secondary adjacent point codes are configured in the linkset.

When this parameter value is yes, and the APC of the linkset is a 14-bit ITU national point code, the linkset can contain one 14-bit ITU national secondary adjacent point code for each group code in the EAGLE, and one ITU international secondary adjacent point code. If the APC of the linkset is ITU international, the linkset can contain either one 14-bit ITU national secondary adjacent point code for each group code in the EAGLE, or only one 24-bit ITU national secondary adjacent point code, but no ITU international secondary adjacent point codes.

If the APC of the linkset is a 24-bit ITU national point code, the linkset contains only one ITU international secondary adjacent point code.

If the multgc parameter value is no, the linkset can contain only one secondary adjacent point code. An ITU international linkset can contain either a 14-bit ITU-N point code or a 24-bit ITU-N point code. An ITU national linkset, a linkset containing either a 14-bit APC or a 24-bit APC, can contain only an ITU international secondary adjacent point code.

The secondary adjacent point codes must be defined in the destination point code table and can be assigned only to linksets with ITU international or ITU national adjacent point codes, except linksets containing E1 ATM signaling links cannot contain 24-bit ITU national secondary adjacent point codes. Secondary adjacent point codes can be non-spare, spare, private, or private spare point codes. Private and private spare point codes can be specified only for IPGWI linksets (linksets containing IPGWI signaling links).

The secondary adjacent point code parameters (sacpi, sapcn, or sapcn24) and the action parameter must be specified together.

You cannot delete an SAPC with the action parameter when routes exist for its SS7 domain.

The values of the multgc, sapci, sapcn, and sapcn24 parameters are only displayed in the rtrv-ls command output when a specific linkset is being displayed with the rtrv-ls:lsn=<linkset name> command.

This examples used in this procedure are based on the information shown in Table 3-13.

Table 3-13 Secondary Adjacent Point Code Configuration Table

Linkset Names	SAPCI	SAPCN	ACTION
lsi3	N/A	11212-ge	add
lsn5	4-75-7	N/A	add
lsn3	3-150-5	N/A	delete

Canceling the RTRV-LS and RTRV-DSTN Commands

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

Press the F9 function key on the keyboard at the terminal where the rtrv-ls or rtrv-dstn commands were entered.
Enter the canc-cmd without the trm parameter at the terminal where the rtrv-ls or rtrv-dstn commands were entered.
Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-ls or rtrv-dstn commands were entered, from another terminal other that the terminal where the rtrv-ls or rtrv-dstn commands were 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, go to Commands User's Guide.

Display the current linkset configuration using the rtrv-ls command.

This is an example of the possible output.

rlghncxa03w 06-10-10 11:43:04 GMT EAGLE5 36.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCA   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
e1e2          001-207-000   none 1   1   no  B   6    off off off no    off
ls1305        000-005-000   none 1   1   no  A   1    off off off no    off
ls1307        000-007-000   none 1   1   no  A   1    off off off no    off
e1m1s1        001-001-001   none 1   1   no  A   7    off off off no    off
e1m1s2        001-001-002   none 1   1   no  A   7    off off off no    off

                                 L3T SLT              GWS GWS GWS
LSN           APCI   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
e1e2i         1-207-0       none 1   1   no  B   4    off off off ---   on
ls1315        0-015-0       none 1   1   no  A   1    off off off ---   off
ls1317        0-017-0       none 1   1   no  A   1    off off off ---   on
e1m2s1        1-011-1       none 1   1   no  A   7    off off off ---   off
e1m2s2        1-011-2       none 1   1   no  A   7    off off off ---   off
lsi3          1-111-3       scr3 1   3   yes c   1    off off off ---   ---

                                 L3T SLT              GWS GWS GWS
LSN           APCN   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsn3          11113-ge      scr3 1   3   yes c   1    on  off off ---   off
lsn5          10685-fr      scr1 1   3   yes a   1    off off off ---   off

Link set table is (10 of 1024) 1% full.

Note:

A secondary adjacent point code cannot be assigned to a proxy linkset. A proxy linkset is a linkset whose linkset type is PRX. Choose a linkset whose linkset type is not PRX and continue the procedure with 2.

Display the current linkset configuration of the linkset to be changed using the rtrv-ls command with the linkset name.

For this example, enter this command.

rtrv-ls:lsn=lsi3

This is an example of the possible output.

rlghncxa03w 06-10-17 11:43:04 GMT  EAGLE5 36.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCI   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsi3          1-111-3       scr3 1   3   yes c   1    off off off ---   ---

           CLLI         TFATCABMLQ MTPRSE ASL8 SLSOCBIT SLSRSB MULTGC
           -----------  1          no     ---  none     7      yes

           ITUTFR RANDSLS
           off    all

           IPGWAPC MATELSN    IPTPS LSUSEALM SLKUSEALM GTTMODE
           yes     ---------- 100   100    % 80      % CdPA

          LOC   LINK SLC TYPE
          1317  A    0   IPGWI

          SAPCN
          11211-uk
Link set table is ( 13 of 255)  5% full

rtrv-ls:lsn=lsn3

This is an example of the possible output.

rlghncxa03w 06-10-17 11:43:04 GMT  EAGLE5 36.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCN   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsn3          11113-ge      scr3 1   3   yes c   1    on  off off ---   off

          CLLI         TFATCABMLQ MTPRSE ASL8 SLSOCBIT SLSRSB MULTGC
          -----------  1          no     ---  none     7      yes

          ITUTFR RANDSLS
          off    off

          IPGWAPC MATELSN    IPTPS LSUSEALM SLKUSEALM GTTMODE
          no      ---------- ---   ---      ---       CdPA

          LOC   LINK SLC TYPE     IPLIML2
          1301  A    0   IPLIMI   M2PA

          SAPCI
          3-150-5
          SAPCN
          11213-de
Link set table is ( 13 of 255)  5% full

rtrv-ls:lsn=lsn5

This is an example of the possible output.

rlghncxa03w 06-10-17 11:43:04 GMT  EAGLE5 36.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCN   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsn5          10685-fr      scr1 1   3   yes a   1    off off off ---   off

          CLLI         TFATCABMLQ MTPRSE ASL8 SLSOCBIT SLSRSB MULTGC
          -----------  1          no     ---  none     7      no

          ITUTFR RANDSLS
          off    off

          IPGWAPC MATELSN    IPTPS LSUSEALM SLKUSEALM GTTMODE
          no      ---------- ---   ---      ---       CdPA

          LOC   LINK SLC TYPE     IPLIML2
          1201  A    0   IPLIMI   M2PA

Link set table is ( 13 of 255)  5% full

If 24-bit ITU-N secondary adjacent point codes are being added to the linkset, and the linkset specified in this step contains E1 ATM signaling links, choose another linkset from 1 and repeat this step. Linksets containing E1 ATM signaling links cannot have 24-bit ITU-N secondary adjacent point codes.

If the desired linkset is an IPSG-M3UA linkset, choose another linkset from 1 and repeat this step. Secondary adjacent point codes cannot be assigned to IPSG-M3UA linksets.

Note:

If you are not adding any secondary adjacent point codes to the linkset, continue the procedure with 5.

Display the point code and capability point code of the EAGLE by using the rtrv-sid command.

This is an example of the possible output.

rlghncxa03w 06-10-10 11:43:04 GMT  EAGLE5 36.0.0
   PCA             PCI          PCN                CLLI              PCTYPE
   001-001-001     3-150-4      12345-uk           rlghncxa03w       OTHER

   CPCA
   002-002-002       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       144-212-003

   CPCI
   1-001-1           1-001-2           1-001-3          1-001-4

   CPCN
   02091-uk          02092-uk          02094-uk          02097-uk
   02191-uk          02192-uk          11177-uk

Display the point codes in the destination point code table by using the rtrv-dstn command.

This is an example of the possible output.

rlghncxa03w 10-12-10 11:43:04 GMT EAGLE5 43.0.0
Extended Processing Time may be Required

   DPCA          CLLI        BEI ELEI   ALIASI          ALIASN/N24    DMN
   001-002-003   ls04clli    yes --- ----------      --------------   SS7
   001-002-003   ls04clli    yes --- ----------      --------------   SS7
   002-002-100   ls01clli    no  --- ----------      --------------   SS7
   002-007-008   ls06clli    yes --- ----------      --------------   SS7
   002-009-003   --------    no  --- ----------      --------------   SS7
   002-250-010   --------    no  --- ----------      --------------   SS7
   003-003-003   ls03clli    yes --- ----------      --------------   SS7
   003-020-100   --------    no  --- ----------      --------------   SS7
   004-004-004   ls02clli    yes --- ----------      --------------   SS7
   004-030-200   --------    no  --- ----------      --------------   SS7
   009-002-003   --------    no  --- ----------      --------------   SS7
   179-100-087   --------    yes --- ----------      --------------   SS7
   200-050-176   --------    yes --- ----------      --------------   SS7
   240-007-000   --------    yes --- ----------      --------------   SS7
   240-012--004  rlghncbb001 yes ---    1-111-1         11111         SS7
   240-012-005   rlghncbb002 yes ---    1-112-2         11112         SS7
   240-012-008   --------    yes ---    1-113-5         11114         SS7
 
  DPCI          CLLI        BEI ELEI   ALIASA          ALIASN/N24    DMN
   2-131-1       rlghncbb023 no  ---    222-210-000     12001         SS7
   2-131-2       --------    no  ---    222-211-001     12002         SS7
   2-131-3       --------    no  ---    222-211-002     12003         SS7
   3-150-4       lsi7clli    yes --- --------------  --------------   SS7

   DPCN          CLLI        BEI ELEI   ALIASA          ALIASI        DMN
   10685         lsn5clli    yes --- --------------  ----------       SS7
   11211         rlghncbb013 no  ---    222-200-200     2-121-1       SS7
   11212         rlghncbb013 no  ---    222-200-201     2-121-2       SS7

Destination table is (23 of 2000) 1% full
Alias table is (18 of 8000) 1% full

If a secondary adjacent point code is being added to the linkset, and the secondary adjacent point code is not shown in the rtrv-dstn command output, go to the Adding a Destination Point Code procedure procedures and add the secondary adjacent point code to the destination point code table.

Note:

If a secondary adjacent point code is being added, and a new point code was added in 4, continue the procedure with 6.

Display the routes using the secondary adjacent point code being added to the linkset or being removed from the linkset with the rtrv-rte command, specifying the secondary adjacent point code as the value of the dpc parameter.

For this example, enter this command.

rtrv-rte:dpci=3-150-5
This is an example of the possible output.
```
rlghncxa03w 06-10-07 11:43:04 GMT  EAGLE5 36.0.0
DPCI       ALIASN/N24       ALIASA      LSN        RC    APC
3-150-5 --------------   -------------- lsn3      10     3-150-5
                                               RTX:No  CLLI=-----------
```
If the secondary adjacent point code is not the DPC of a route, the point code entry is displayed in the rtrv-rte output, but the LSN, RC, and APC columns contain dashes, as shown in the following output example.
```
rlghncxa03w 06-10-10 11:43:04 GMT EAGLE5 36.0.0
   DPCI       ALIASN/N24       ALIASA      LSN        RC    APC
   3-150-5 --------------   -------------- ---------- --    -----------
                                               RTX:No  CLLI=-----------
```
If the point code specified in this step is shown in the DPCA/DPCI/DPCN/ DPCN24 columns in this step, and the secondary adjacent point code is being added to the linkset, the point code value cannot be used as a secondary adjacent point code unless one of two actions are taken:
- Choose another secondary adjacent point code value and repeat 3, 4, and 5.
- Remove all the entries displayed in this step by performing the Removing a Route procedure.
If the point code specified in this step is shown in the DPCA/DPCI/DPCN/ DPCN24 columns in this step, and the secondary adjacent point code is removed from the linkset, the routes shown in this step must be removed from the database. Perform the Removing a Route procedure to remove the routes from the database.

Note:
If you are adding only ITU-I or 24-bit ITU-N secondary adjacent point codes, continue the procedure with 7.

Display the secondary point codes in the destination point code table to verify any group codes that are assigned to 14-bit ITU-N secondary point codes in the database by using the rtrv-spc command.

This is an example of the possible output.

rlghncxa03w 06-10-17 16:02:05 GMT  EAGLE5 36.0.0
SPC (Secondary Point Codes)

SPCA
     001-010-010
     002-010-010
     003-010-010
     010-100-010

SPC-I
         1-253-5
         2-254-6
         3-255-7
         4-100-1

SPC-N
        5175-de
        6744-uk
        7673-ge
        7673-fr
SPC-N24
Secondary Point Code table is (12 of 40) 30% full

Perform one of these steps to configure the linkset with a secondary adjacent point code.
1. To add the secondary adjacent point code to the linkset, enter the chg-ls command with these parameters.
  :lsn=<linkset name being changed>
  :action=add
  :sapci=<ITU-I secondary adjacent point code being added>
  or
  :sapcn=<14-bit ITU-N secondary adjacent point code being added
  or
  :sapcn24=<24-bit ITU-N secondary adjacent point code being added>
  
  If the value of the multgc parameter is yes, and the APC of the linkset is a 14-bit ITU national point code, the linkset can contain one 14-bit ITU national secondary adjacent point code for each group code in the EAGLE, and one ITU international secondary adjacent point code. If the APC of the linkset is an ITU international point code, the linkset can contain either one 14-bit ITU national secondary adjacent point code for each group code in the EAGLE, or one 24-bit ITU national secondary adjacent point code, but no ITU international secondary adjacent point codes. If the APC of the linkset is a 24-bit ITU national point code, the linkset contains only one ITU international secondary adjacent point code. The output of the rtrv-dstn command in 4 and the rtrv-spc command in 5 shows the group codes in the database.
  
  If the value of the multgc parameter is no, the linkset can contain only one secondary adjacent point code. An ITU international linkset can contain either a 14-bit ITU-N point code or a 24-bit ITU-N point code. An ITU national linkset, a linkset containing either a 14-bit APC or a 24-bit APC, can contain only an ITU international secondary adjacent point code.
  
  Secondary adjacent point codes can be non-spare, spare, private, or private spare point codes. Private and private spare point codes can be specified only for IPGWI linksets (linksets containing IPGWI signaling links).
2. To remove the secondary adjacent point code from the linkset, enter the chg-ls command with these parameters.
  :lsn=<linkset name being changed>
  :action=delete
  :sapci=<ITU-I secondary adjacent point code being removed>
  or
  :sapcn=<14-bit ITU-N secondary adjacent point code being added>
  or
  :sapcn24=<24-bit ITU-N secondary adjacent point code being added>
3. If only one secondary adjacent point code can be assigned to the linkset, and that secondary adjacent point code is being replaced, perform step b to remove the existing secondary adjacent point code, then perform step a to add the new secondary adjacent point code.
  
  For this example, enter these commands.
  
  chg-ls:lsn=lsi3:sapcn=11212-ge:action=add
  
  chg-ls:lsn=lsn3:sapci=4-75-7:action=add
  
  chg-ls:lsn=lsn5:sapci=3-150-5:action=delete
  When the chg-ls command has successfully completed, this message should appear.
```
rlghncxa03w 06-10-17 16:23:21 GMT  EAGLE5 36.0.0
Link set table is ( 13 of 255)  5% full
CHG-LS: MASP A - COMPLTD
```

Verify the changes using the rtrv-ls command specifying the linkset name specified in 7 with the lsn parameter.

For this example, enter these commands.

rtrv-ls:lsn=lsi3

This is an example of the possible output.

rlghncxa03w 06-10-17 11:43:04 GMT  EAGLE5 36.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCI   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsi3          1-111-3       scr3 1   3   yes c   1    off off off ---   ---

          CLLI         TFATCABMLQ MTPRSE ASL8 SLSOCBIT SLSRSB MULTGC
          -----------  1          no     ---  none     7      yes

           ITUTFR RANDSLS
           off    all

          IPGWAPC MATELSN    IPTPS LSUSEALM SLKUSEALM GTTMODE
          yes     ---------- 100   100    % 80      % CdPA

          LOC   LINK SLC TYPE
          1317  A    0   IPGWI

          SAPCN
          11211-uk
          11212-ge
Link set table is ( 13 of 255)  5% full

rtrv-ls:lsn=lsn3

This is an example of the possible output.

rlghncxa03w 06-10-17 11:43:04 GMT  EAGLE5 36.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCN   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsn3          11113-ge      scr3 1   3   yes c   1    on  off off ---   off

          CLLI         TFATCABMLQ MTPRSE ASL8 SLSOCBIT SLSRSB MULTGC
          -----------  1          no     ---  none     7      yes

          ITUTFR RANDSLS
          off    off

          IPGWAPC MATELSN    IPTPS LSUSEALM SLKUSEALM GTTMODE
          no      ---------- ---   ---      ---       CdPA

          LOC   LINK SLC TYPE     IPLIML2
          1301  A    0   IPLIMI   M2PA

          SAPCN
          11213-de
Link set table is ( 13 of 255)  5% full

rtrv-ls:lsn=lsn5

This is an example of the possible output.

rlghncxa03w 06-10-17 11:43:04 GMT  EAGLE5 36.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCN   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsn5          10685-fr      scr1 1   3   yes a   1    off off off  ---  off

          CLLI         TFATCABMLQ MTPRSE ASL8 SLSOCBIT SLSRSB MULTGC
          -----------  1          no     ---  none     7      no

          ITUTFR RANDSLS
          off    off

          IPGWAPC MATELSN    IPTPS LSUSEALM SLKUSEALM GTTMODE
          no      ---------- ---   ---      ---       CdPA

          LOC   LINK SLC TYPE     IPLIML2
          1201  A    0   IPLIMI   M2PA

          SAPCI
          4-75-7
Link set table is ( 13 of 255)  5% full

Back up 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-15 Configuring an ITU Linkset with a Secondary Adjacent Point Code (SAPC)

Sheet 1 of 6

Sheet 2 of 6

Sheet 3 of 6

Sheet 4 of 6

Sheet 5 of 6

Sheet 6 of 6