1. Database Administration - IP7 User's Guide
  2. IETF M3UA and SUA Configuration Procedures
  3. Removing an IPGWx Signaling Link

Removing an IPGWx Signaling Link

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

:loc – The card location of the IP 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    SAALTALI
2205 A    lsnip1       1  IPLIM    M2PA
2204 B    lsnlp2       0  IPLIM    M2PA
2213 A    lsnip5       0  IPLIMI   M2PA
2215 A    lsnlp2       1  IPLIM    SAALTALI

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=lsnlp3

    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
lsnlp3        002-009-003   scr2 1   1   no  a   1    on  off on  no    off

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

           IPSG  IPGWAPC  GTTMODE           CGGTMOD
           no    yes      CdPA                no

           MATELSN    IPTPS   LSUSEALM  SLKUSEALM
           ---------- 32000   100%      80%

           LOC  LINK SLC TYPE
           1201 A    0   SS7IPGW

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 inCommands 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. Any in-service IP connections on the signaling link being removed in this procedure must be placed out of service.

    Have the far-end node for the signaling link being removed place the M3UA or SUA associations in either the ASP-INACTIVE or ASP-DOWN state.

  6. 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 this command.

    rtrv-ip-lnk:loc=2207

    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
2207  A    192.1.1.10      255.255.255.128 HALF    10    802.3   NO   NO
2207  B    --------------- --------------- HALF    10    DIX     NO   NO
  7. Display the IP host information associated with the IP link by entering the rtrv-ip-host command with the IP address shown in 6. 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_2207

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

    rtrv-assoc:lhost=ipnode1_2207

    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          2207 A     A    M3UA    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 = 2207
  9. 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. For this example, enter this command.

    Note:

    If there is no association shown in7, or theopen andalw parameter values of the association shown in7areno, continue the procedure with10.

    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;
  10. 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=2207: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
  11. 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 10. For this example, enter these commands.

    rept-stat-slk:loc=2207: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
2207,A   ls04      ls04clli    OOS-MT       Unavail   ----
  ALARM STATUS       = *   0235 REPT-LNK-MGTINH: local inhibited
  UNAVAIL REASON     = LI
  12. Place the card that contains the signaling link shown in 11 out of service by entering the rmv-card command specifying the card location shown in 11. For this example, enter this command.

    rmv-card:loc=2207

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

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

    rept-stat-card:loc=2207

    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
2207   114-001-000  DCM       SS7IPGW    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.
  14. 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 this command.

    dlt-slk:loc=2207: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 theOAMHCMEAS value in thertrv-measopts output is on, the scheduled UI measurement reports will be enabled.
  15. Verify the changes using the rtrv-slk command, with the card location and link values specified in 14. For this example, enter this command.

    rtrv-slk:loc=2207:link=a

    When the rtrv-slk command has completed, no entry is displayed showing that the signaling link has been removed. 

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



Sheet 1 of 2



Sheet 2 of 2