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

Removing an IPSG M2PA Signaling Link

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

:loc  – The card location of the IPSG card that the IPSG M2PA 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 IPSG signaling links by entering this command.

    rtrv-slk:type=ipsg

    This is an example of the possible output. 

    
rlghncxa03w 06-10-19 21:16:37 GMT EAGLE5 36.0.0

LOC  LINK LSN         SLC TYPE     ANAME           SLKTPS
2202 A    lsnlp1      0   IPSG     assoc2          500
2205 A    lsnip1      1   IPSG     assoc3          500
2204 A    ls04        0   IPSG     assoc1          500
2213 A    lsnip5      0   IPSG     assoc4          750
2215 A    lsnlp2      1   IPSG     assoc5          1000
  2. Display the associations assigned to the IPSG card containing the signaling link that will be removed by entering the rtrv-assoc command and specifying the card location of the IPSG card. For this example, enter this command.

    For this example, enter this command.

    rtrv-assoc:loc=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

    If the ADAPTER value of the associations shown in this step is M2PA, continue the procedure with 3.

    If the ADAPTER value for the associations is M3UA, perform one of these actions.
    • If you wish to remove the signaling link assigned to this card, perform the Removing an IPSG M3UA Signaling Link.
    • If you do not wish to remove the signaling link assigned to this card, select another card from 1 and repeat this step.
  3. 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=ls04

    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
ls04          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
           yes   no       CdPA               no

           ADAPTER    RSVDSLKTPS  MAXSLKTPS
           m2pa       1000        4000

           TPSALM     LSUSEALM    SLKUSEALM
           rsvdslktps 100%         100%

           LOC  LINK SLC TYPE     ANAME
           2204 A    0   IPSG     m2pa2

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 by performing one of these steps.
    • If the OPEN or ALW values for the associations is YES, continue the procedure with 6.
    • If the OPEN and ALW values for the associations is NO, continue the procedure with 7.

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

  4. 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 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 5.

    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, the "Configuring the Restricted Linkset Option" procedure has been performed, or if the LSRESTRICT value is off, continue the procedure by performing one of these steps.
    • If the OPEN or ALW values for the associations is YES, continue the procedure with 6.
    • If the OPEN and ALW values for the associations is NO, continue the procedure with 7.
  5. 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
    Continue the procedure by performing one of these steps.
    • If the OPEN or ALW values for the associations is YES, continue the procedure with 6.
    • If the OPEN and ALW values for the associations is NO, continue the procedure with 7.
  6. 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.

    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;
  7. 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=2204:link=a

    When this 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
  8. 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 7.

    For this example, enter this command.

    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
  9. 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 11.

    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 8.

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

    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.
  10. Verify that the card has been inhibited by entering the rept-stat-card command with the card location specified in 9. For this example, enter this command.

    rept-stat-card:loc=2204

    This is an example of the possible output. 

    
rlghncxa03w 10-12-01 09:12:36 GMT EAGLE5 43.0.0
CARD   VERSION      TYPE      GPL        PST            SST        AST
2204   133-003-000  E5ENET    IPSG       OOS-MT-DSBLD   Isolated   -----
  ALARM STATUS       =  No Alarms.
  BLIXP   GPL version = 133-003-000
  IMT BUS A           = Disc
  IMT BUS B           = Disc
  CURRENT TEMPERATURE   =  32C ( 90F)     [ALARM TEMP:  60C (140F)]
  PEAK TEMPERATURE:     =  39C (103F)     [06-05-02 13:40]
  SIGNALING LINK STATUS
      SLK    PST                LS            CLLI
      A      OOS-MT             lsnlp2        -----------

Command Completed.
  11. 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 in 10. For this example, enter this command.

    rtrv-ls:lsn=ls04

    This is an example of the possible output. 

    rlghncxa03w 08-05-27 16:43:42 GMT EAGLE5 38.0.0

                                 L3T SLT              GWS GWS GWS
LSN           APCA   (SS7)  SCRN SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
ls04          001-001-003   none 1   1   no  A   1    off off off no    off

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

           IPSG  IPGWAPC  GTTMODE           CGGTMOD
           yes   no       CdPA               no

           ADAPTER    SLKTPS  LSUSEALM  SLKUSEALM  RCONTEXT   ASNOTIF
           m2pa       500     100%      80%        none       no

           LOC  LINK SLC TYPE     ANAME
           1102 A    2   IPSG     assoc1


Link set table is (22 of 1024) 2% full.
  12. Remove the signaling link from the EAGLE using the dlt-slk command.

    If there is only one signaling link in the linkset, shown in 11, 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=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 theOAMHCMEAS value in thertrv-measopts output is on, the scheduled UI measurement reports will be enabled.
  13. Verify the changes using the rtrv-slk command with the card location and link values specified in 12. For this example, enter this command.

    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
  14. 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 6-19 Removing an IPSG M2PA Signaling Link



Sheet 1 of 2



Sheet 2 of 2