1. Database Administration - IP7 User's Guide
  2. IETF M2PA Configuration Procedures
  3. Removing an IPLIMx Signaling Link

Removing an IPLIMx Signaling Link

This procedure is used to remove an IPLIMx signaling link from the database using the dlt-slk command. The dlt-slk command uses these parameters.

:loc – The card location of the IPLIMx card that the IP signaling link is assigned to.

:link – The signaling link on the card specified in the loc parameter.

:force – This parameter must be used to remove the last link in a linkset without having to remove all of the routes that referenced the linkset.

The tfatcabmlq parameter (TFA/TCA Broadcast Minimum Link Quantity), assigned to linksets, shows the minimum number of links in the given linkset (or in the combined link set in which it resides) that must be available for traffic. When the number of signaling links in the specified linkset is equal to or greater than the value of the tfatcabmlq parameter, the status of the routes that use the specified linkset is set to allowed and can carry traffic. Otherwise, these routes are restricted. The value of the tfatcabmlq parameter cannot exceed the total number of signaling links contained in the linkset.

If the linkset type of the linkset that contains the signaling link that is being removed is either A, B, D, E, or PRX, the signaling link can be removed regardless of the tfatcabmlq parameter value of the linkset and regardless of the LSRESTRICT option value. When a signaling link in one of these types of linksets is removed, the tfatcabmlq parameter value of the linkset is decreased automatically.

If the linkset type of the linkset that contains the signaling link that is being removed is C, the signaling link can be removed only:
  • If the LSRESTRICT option is off. The LSRESTRICT option value is shown in the rtrv-ss7opts output.
  • If the LSRESTRICT option is on and the number of signaling links assigned to the linkset will be equal to or greater than the value of the tfatcabmlq parameter value of the linkset after the signaling link is removed.

    The tfatcabmlq parameter value of the linkset is shown in the TFATCABMLQ column of the rtrv-ls:lsn=<linkset name> output. The tfatcabmlq parameter value can be a fixed value (1 to 16) or 0. If the tfatcabmlq parameter value of the linkset is a fixed value, the number of signaling links that are in the linkset after the signaling link is removed must be equal to or greater than the tfatcabmlq parameter value of the linkset.

    If the tfatcabmlq parameter value is 0, the signaling link can be removed. When the tfatcabmlq parameter value is 0, the value displayed in the TFATCABMLQ column of the rtrv-ls output is 1/2 of the number of signaling links contained in the linkset. If the number of signaling links in the linkset is an odd number, the tfatcabmlq parameter value is rounded up to the next whole number. As the signaling links are removed, the tfatcabmlq parameter value of the linkset is decreased automatically.

Canceling the RTRV-SLK Command

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

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

  1. Display the current link configuration using the rtrv-slk command.

    This is an example of the possible output. 

    
rlghncxa03w 09-07-19 21:16:37 GMT EAGLE5 41.1.0
                                    L2T              PCR  PCR
LOC   LINK LSN          SLC TYPE    SET BPS    ECM   N1   N2
1201  A    ls01          0  LIMDS0  1   56000  BASIC ---  -----
1201  B    lsa1          0  LIMDS0  1   56000  BASIC ---  -----
1203  A    ls03          0  LIMDS0  3   56000  BASIC ---  -----
1203  B    lsa2          0  LIMDS0  1   56000  BASIC ---  -----
1204  B    ls01          1  LIMDS0  1   56000  BASIC ---  -----
1207  A    lsn1207a      0  LIMDS0  1   56000  BASIC ---  -----
1207  B    lsn1207b      0  LIMDS0  1   56000  BASIC ---  -----
1208  B    ls03          1  LIMDS0  3   56000  BASIC ---  -----
1213  B    ls05          0  LIMDS0  5   56000  BASIC ---  -----
1215  A    ls05          1  LIMDS0  5   56000  BASIC ---  -----
1311  A    ls01          2  LIMDS0  1   56000  BASIC ---  -----
1311  A1   ls05          2  LIMDS0  5   56000  BASIC ---  -----
1311  B    ls03          2  LIMDS0  3   56000  BASIC ---  -----
1311  B1   ls07          1  LIMDS0  7   56000  BASIC ---  -----
1313  A    ls07          0  LIMDS0  7   56000  BASIC ---  -----

                                    LP           ATM
LOC   LINK LSN          SLC TYPE    SET BPS      TSEL      VCI  VPI   LL
1302  A    atmansi0      0  LIMATM  3   1544000  EXTERNAL  35   15    0
1305  A    atmansi1      0  LIMATM  4   1544000  INTERNAL  100  20    2
1318  A    atmansi0      1  LIMATM  9   1544000  LINE      150  25    4

                                   LP         ATM                    E1ATM
LOC  LINK LSN         SLC TYPE     SET BPS    TSEL     VCI   VPI  CRC4 SI SN
2101 A    atmitu1      0  LIME1ATM 5   2.048M LINE     150   2    ON   1  20
2105 A    atmitu1      1  LIME1ATM 5   2.048M LINE     35    15   ON   2  15

LOC  LINK LSN         SLC TYPE     IPLIML2
2202 A    lsnlp1       0  IPLIM    M2PA
2205 A    lsnip1       0  IPLIM    M2PA
2204 B    lsnlp2       0  IPLIM    M2PA
2213 A    lsnip5       0  IPLIMI   M2PA
2215 A    lsnlp2       1  IPLIM    M2PA

LOC  LINK LSN         SLC TYPE
2207  A    lsnlp3      0  SS7IPGW
2211  A    lsnlp4      0  IPGWI

SLK table is (27 of 1200) 2% full
  2. Display the linkset that contains the signaling link that is being removed by entering the rtrv-ls command with the name of the linkset shown in the LSN column of the rtrv-slk output.

    For this example, enter these commands.

    rtrv-ls:lsn=lsnip1

    This is an example of the possible output. 

    
rlghncxa03w 10-07-17 11:43:04 GMT EAGLE5 42.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCA   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsnip1        002-009-003   scr2 1   1   no  a   1    on  off on  no    off

              SPCA          CLLI         TFATCABMLQ MTPRSE ASL8
           ---------------- -----------  1          no     no
       
           RANDSLS
           off

           ISLSRSB RSLS8
           1       no

           IPSG  IPGWAPC  GTTMODE           CGGTMOD
           no    no       CdPA               no

           LOC  LINK SLC TYPE     IPLIML2
           2205 A    0   IPLIM    M2PA

Link set table is ( 20 of 1024)  2% full

    rtrv-ls:lsn=lsnlp2

    This is an example of the possible output. 

    
rlghncxa03w 10-07-17 11:43:04 GMT EAGLE5 42.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCA   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsnlp2        002-009-003   scr2 1   1   no  a   2    on  off on  no    off

              SPCA          CLLI         TFATCABMLQ MTPRSE ASL8
           ---------------- -----------  1          no     no
       
           RANDSLS
           off

           ISLSRSB RSLS8
           1       no

           IPSG  IPGWAPC  GTTMODE           CGGTMOD
           no    no       CdPA               no

           LOC  LINK SLC TYPE     IPLIML2
           2204 B    0   IPLIM    M2PA
           2215 A    1   IPLIM    M2PA

Link set table is ( 20 of 1024)  2% full

    If the linkset type of the linkset is A, B, D, E, or PRX, continue the procedure with 5.

    If the linkset type of the linkset is C, continue the procedure with 3.

  3. Display the LSRESTRICT option value by entering the rtrv-ss7opts command.

    This is an example of the possible output. 

    
rlghncxa03w 10-07-30 15:09:00 GMT  42.0.0

SS7 OPTIONS
-----------------------
LSRESTRICT     on

    Note:

    Thertrv-feat command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by thertrv-feat command, refer to the rtrv-feat command description in Commands User's Guide.

    The signaling link cannot be removed, if the LSRESTRICT option is on and the number of signaling links assigned to the linkset will be less than the value of the tfatcabmlq parameter value of the linkset if the signaling link is removed.

    If the LSRESTRICT option is on and the number of signaling links assigned to the linkset will be equal to or greater than the value of the tfatcabmlq parameter value of the linkset if the signaling link is removed, continue the procedure with 5.

    If the LSRESTRICT option is on and the number of signaling links assigned to the linkset will be less than the value of the tfatcabmlq parameter value of the linkset if the signaling link is removed, the signaling link cannot be removed unless the tfatcabmlq parameter value of the linkset is changed to 0. Continue the procedure with 4.

    If the LSRESTRICT value is off, continue the procedure with 5.

  4. Change the tfatcabmlq parameter value of the linkset to 0 by entering the chg-ls command with the name of the linkset that contains the signaling link that is being removed and the tfatcabmlq parameters. For this example, enter this command.

    chg-ls:lsn=ls17:tfatcabmlq=0

    When this command has successfully completed, this message should appear. 

    
rlghncxa03w 10-07-07 08:41:12 GMT  EAGLE5 42.0.0

Link set table is (20 of 1024) 2% full.

CHG-LS: MASP A - COMPLTD
  5. Display the IP link associated with the card that the signaling link being removed the database is assigned to.
    Enter the rtrv-ip-lnk command with the card location of the signaling link being removed shown in 1. For this example, enter these commands.

    rtrv-ip-lnk:loc=2205

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-28 21:14:37 GMT EAGLE5 36.0.0
LOC   PORT IPADDR          SUBMASK         DUPLEX  SPEED MACTYPE AUTO MCAST
2205  A    192.3.1.10      255.255.255.128 HALF    10    802.3   NO   NO
2205  B    --------------- --------------- HALF    10    DIX     NO   NO

    rtrv-ip-lnk:loc=2204

    The following is an example of the possible output. 

    
rlghncxa03w 06-10-28 21:14:37 GMT EAGLE5 36.0.0
LOC   PORT IPADDR          SUBMASK         DUPLEX  SPEED MACTYPE AUTO MCAST
2204  A    192.1.1.10      255.255.255.128 HALF    10    802.3   NO   NO
2204  B    --------------- --------------- HALF    10    DIX     NO   NO
  6. Display the IP host information associated with the IP link by entering the rtrv-ip-host command with the IP address shown in 5.
    For this example, enter these commands.

    rtrv-ip-host:ipaddr=192.001.001.010

    The following is an example of the possible output. 

    
rlghncxa03w 08-12-28 21:17:37 GMT EAGLE5 40.0.0

LOCAL IPADDR    LOCAL HOST
192.1.1.10      IPNODE1_2204

IP Host table is (11 of 4096) .26% full

    rtrv-ip-host:ipaddr=192.003.001.010

    The following is an example of the possible output. 

    
rlghncxa03w 08-12-28 21:17:37 GMT EAGLE5 40.0.0

LOCAL IPADDR    LOCAL HOST
192.3.1.10      IPNODE1_2205

IP Host table is (11 of 4096) .26% full
  7. Display the association associated with the local host name shown in 6 by entering the rtrv-assoc command.
    For this example, enter this command.

    rtrv-assoc:lhost=ipnode1_2204

    This is an example of possible output. 

    
rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0
                CARD IPLNK
ANAME           LOC  PORT  LINK ADAPTER LPORT RPORT OPEN ALW
assoc1          2204 A     A    M2PA    1030  1030  YES  YES

IP Appl Sock/Assoc table is (4 of 4000) 1% full
Assoc Buffer Space Used (16 KB of 3200 KB) on LOC = 2204

    rtrv-assoc:lhost=ipnode1_2205

    This is an example of possible output. 

    
rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0

IP Appl Sock/Assoc table is (4 of 4000) 1% full

    Note:

    If there are no associations assigned to the specified local host name, thertrv-assoc output shows no association information as shown above.
  8. Change the value of the open and alw parameters to no by specifying the chg-assoc command with the open=no and alw=no parameters, as necessary.

    Note:

    If there is no association shown in 7, or the open and alw parameter values of the association shown in7 are no, continue the procedure with 9.

    For this example, enter this command.

    chg-assoc:aname=assoc1:open=no:alw=no

    When this command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0
CHG-ASSOC: MASP A - COMPLTD;
  9. Deactivate the link to be removed using the dact-slk command, using the output from 1 to obtain the card location and link parameter value of the signaling link to be removed.
    For this example, enter these commands.

    dact-slk:loc=2205:link=a

    dact-slk:loc=2204:link=a

    When each of these command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-07 08:41:12 GMT  EAGLE5 36.0.0
Deactivate Link message sent to card
  10. Verify that the link is out of service - maintenance disabled (OOS-MT-DSBLD) using the rept-stat-slk command with the card location and link parameter values specified in 9.
    For this example, enter these commands.

    rept-stat-slk:loc=2205:link=a

    This is an example of the possible output. 

    
rlghncxa03w 06-10-23 13:06:25 GMT EAGLE5 36.0.0
SLK      LSN       CLLI        PST          SST       AST
2205,A   ls05      ls05clli    OOS-MT_DSBLD Unavail   ----
  ALARM STATUS       = *   0235 REPT-LNK-MGTINH: local inhibited
  UNAVAIL REASON     = LI

    rept-stat-slk:loc=2204:link=a

    This is an example of the possible output. 

    
rlghncxa03w 06-10-23 13:06:25 GMT EAGLE5 36.0.0
SLK      LSN       CLLI        PST          SST       AST
2204,A   ls04      ls04clli    OOS-MT       Unavail   ----
  ALARM STATUS       = *   0235 REPT-LNK-MGTINH: local inhibited
  UNAVAIL REASON     = LI
  11. If the signaling link to be removed is the last signaling link on a card, the card must be inhibited before the signaling link is removed.

    Note:

    If the signaling link being removed is not the last signaling link on the card, continue the procedure with 13.

    Before entering the dlt-slk command, enter the rmv-card command and specify the location of the card to be inhibited. The card location is shown in the output of rept-stat-slk command executed in 10.

    In the example used for this procedure, the signaling link is the last signaling link on the card and must be inhibited. Enter these commands.

    rmv-card:loc=2205

    rmv-card:loc=2204

    When each of these command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-07 08:41:12 GMT  EAGLE5 36.0.0
Card has been inhibited.
  12. Verify that the card has been inhibited by entering the rept-stat-card command with the card location specified in 11. For this example, enter these commands.

    rept-stat-card:loc=2205

    This is an example of the possible output. 

    rlghncxa03w 07-05-27 16:43:42 GMT EAGLE5 37.0.0
CARD   VERSION      TYPE      GPL        PST            SST        AST
2205   114-001-000  DCM       IPLIM      OOS-MT-DSBLD   Isolated   -----
  ALARM STATUS        = **  0013 Card is isolated from the system
  BPDCM GPL           = 002-102-000
  IMT BUS A           = Disc
  IMT BUS B           = Disc
  SIGNALING LINK STATUS
      SLK    PST                LS            CLLI          E5IS
      A      OOS-MT             lsnlp1        -----------   INACTIVE

Command Completed.

    rept-stat-card:loc=2204

    This is an example of the possible output. 

    rlghncxa03w 07-05-27 16:43:42 GMT EAGLE5 37.0.0
CARD   VERSION      TYPE      GPL        PST            SST        AST
2204   114-001-000  DCM       IPLIM      OOS-MT-DSBLD   Isolated   -----
  ALARM STATUS        = **  0013 Card is isolated from the system
  BPDCM GPL           = 002-102-000
  IMT BUS A           = Disc
  IMT BUS B           = Disc
  SIGNALING LINK STATUS
      SLK    PST                LS            CLLI          E5IS
      A      OOS-MT             lsnlp2        -----------   INACTIVE

Command Completed.
  13. Remove the signaling link from the EAGLE using the dlt-slk command.
    If there is only one signaling link in the linkset, the force=yes parameter must be specified to remove the signaling link.

    In the example used in this procedure, the signaling link is the last signaling link in the linkset. Enter these commands.

    dlt-slk:loc=2205:link=a:force=yes

    dlt-slk:loc=2204:link=a:force=yes

    When this command has successfully completed, this message should appear. 

    
rlghncxa03w 06-10-07 08:41:17 GMT  EAGLE5 36.0.0
DLT-SLK: MASP A - COMPLTD

    Note:

    If removing the signaling link will result in 700 or less signaling links in the database and the OAMHCMEAS value in the rtrv-measopts output is on, the scheduled UI measurement reports will be enabled.
  14. Verify the changes using the rtrv-slk command with the card location and link values specified in 13. For this example, enter these commands.

    rtrv-slk:loc=2205:link=a

    rtrv-slk:loc=2204:link=a

    When the rtrv-slk command has completed, the specified signaling link is not shown in the rtrv-slk output, as shown in this example. 

    
    rlghncxa03w 09-09-18 13:43:31 GMT EAGLE5 41.1.0
E2373 Cmd Rej: Link is unequipped in the database
  15. 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-13 Removing an IPLIMx Signaling Link



Sheet 1 of 2



Sheet 2 of 2