1. Database Administration - IP7 User's Guide
  2. IETF M2PA Configuration Procedures
  3. Changing the Link Value of a M2PA Association to another Link Value on the Same IPLIMx Card

Changing the Link Value of a M2PA Association to another Link Value on the Same IPLIMx Card

This procedure is used to change the link value of an M2PA association, assigned to cards that are running the IPLIM or IPLIMI applications (IPLIMx cards), to another link value that is assigned to the same IPLIMx card that is hosting the M2PA association. The chg-assoc command is used to change the link value for the association. If you wish to change the attributes of M2PA associations assigned to cards that are running the IPSG application, perform the Changing the Attributes of an IPSG Association procedure.

These parameters of the chg-assoc command are used in this procedure:

:aname – The name assigned to the association, shown in the rtrv-assoc output.

:link – The signaling link on the IPLIMx card. If the card is a single-slot EDCM, the values for the link parameter can be a, a1, a2, a3, b, b1, b2, or b3.

If the card is a E5-ENET card, the values for the link parameter can be a, a1, a2, a3, a4, a5, a6, a7, b, b1, b2, b3, b4, b5, b6, or b7.

Note:

The port parameter can be used in place of the link parameter to specify the signaling link on the card.

:open – The connection state for this association. Valid values are yes or no. When the open=yes parameter is specified, the connection manager opens the association if the association is operational. When the open=no parameter is specified, the connection manager will not open the association.

IPLIMx cards can have one association for each signaling link on the card. The single-slot EDCM can contain a maximum of eight signaling links, resulting in a maximum of eight associations for this card. The E5-ENET card can contain a maximum of 16 signaling links, resulting in a maximum of 16 associations for this card.

The signaling link being assigned to the association must be out of service. This state is shown in the rept-stat-slk output with the entries OOS-MT in the PST field and Unavail in the SST field.

If you wish to change the lhost, alhost, bufsize, or link values of the M2PA association, perform one of these procedures.

If you do not wish to change the lhost, alhost, bufsize, or link values of the M2PA association, this procedure is finished.

Canceling the RTRV-ASSOC Command

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

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

    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
swbel32         1201 A     A    M3UA    1030  2345  YES  YES
a2              1305 A     A    SUA     1030  2345  YES  YES
a3              1307 A     A    SUA     1030  2346  YES  YES
assoc1          1201 A     A    M3UA    2000  1030  YES  YES
assoc2          1205 A     A    M2PA    2048  2048  YES  YES
assoc3          1205 A     B2   M2PA    3000  3000  YES  YES
  2. Enter the rtrv-card command with the location of the card that is hosting the M2PA association that will be changed in this procedure. For this example, enter this command.

    rtrv-card:loc=1205

    This is an example of possible output. 

    
rlghncxa03w 08-04-06 15:17:20 EST EAGLE5 38.0.0
CARD   TYPE      APPL     LSET NAME   LINK SLC LSET NAME   LINK SLC
1205   DCM       IPLIM    e5e6a       A    0   e5e6a       B2   1
                          e5e6a       A3   2
    If the application assigned to the card is IPLIM or IPLIMI, shown in the APPL column, continue the procedure by performing one of these steps.
    • If the open parameter value for the association being changed is yes, continue the procedure with 3.
    • If the open parameter value for the association being changed is no, continue the procedure with 4.

    If the application assigned to the card is IPSG, perform the Changing the Attributes of an IPSG Association procedure.

  3. Change the value of the open parameter to no by specifying the chg-assoc command with the open=no parameter.

    For this example, enter this command.

    chg-assoc:aname=assoc2:open=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;
  4. Perform one of these actions.
    • If the new link value is not shown in the rtrv-card output in 2, perform the Adding an IPLIMx Signaling Link procedure to provision the signaling link with the card location specified in 2 and the new link value. After the new signaling link has been provisioned, continue the procedure with 8.
    • If the new link value is shown in the rtrv-card output in 2 and in the rtrv-assoc output in 1, this link value cannot be used. Perform the Adding an IPLIMx Signaling Link procedure to provision the signaling link with the card location specified in 2 and the new link value. After the new signaling link has been provisioned, continue the procedure with 8.
    • If the new link value is shown in the rtrv-card output in 2 but not in the rtrv-assoc output in 1, continue the procedure with 5.
  5. Display the status of the signaling link that will be the new link value for the association shown in 2 (using the values in the LOC and LINK columns in the rtrv-card output) by entering the rept-stat-slk command specifying the card location and signaling link.

    For example, enter this command.

    rept-stat-slk:loc=1205:link=a3

    This is an example of the possible output. 

    
rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
SLK      LSN         CLLI        PST          SST       AST
1205,A3  e5e6a       ----------- IS-NR        Avail     ----
Command Completed.

    If the primary state (PST) of the signaling link not is OOS-MT and the secondary state (SST) is Unavail, continue the procedure with 6.

    If the primary state (PST) of the signaling link is OOS-MT and the secondary state (SST) is Unavail, continue the procedure with 8.

  6. Deactivate the signaling link shown in 5 using the dact-slk command.

    For example, enter this command.

    dact-slk:loc=1205:link=a3

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

    
rlghncxa03w 06-10-07 11:11:28 GMT EAGLE5 36.0.0
Deactivate Link message sent to card
  7. Verify the status of the signaling link using the rept-stat-slk command.

    For example, enter this command.

    rept-stat-slk:loc=1205:link=a3

    This is an example of the possible output. 

    
rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
SLK      LSN         CLLI        PST          SST       AST
1205,A3  e5e6a       ----------- OOS-MT       Unavail   ----
Command Completed.
  8. Change the association using the chg-assoc command.

    For this example, enter this command.

    chg-assoc:aname=assoc2:link=a3

    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;

    If the value of the open parameter was not changed in 3, continue the procedure with 10.

    If the value of the open parameter was changed in 3, continue the procedure with 9.

  9. Change the value of the open parameter to yes by specifying the chg-assoc command with the open=yes parameter.

    For this example, enter this command.

    chg-assoc:aname=assoc2:open=yes

    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. Verify the changes using the rtrv-assoc command specifying the association name specified in 8 and 9.

    For this example, enter this command.

    rtrv-assoc:aname=assoc2

    This is an example of possible output. 

    
rlghncxa03w 10-07-28 21:14:37 GMT EAGLE5 42.0.0
 ANAME assoc2
       LOC      1205          IPLNK PORT  A          LINK  A
       ADAPTER  M2PA          VER         M2PA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    gw200.nc-tekelec.com
       ARHOST   ---
       LPORT    2048          RPORT       3000
       ISTRMS   2             OSTRMS      2           BUFSIZE  500
       RMODE    LIN           RMIN        120         RMAX     800
       RTIMES   10            CWMIN       3000        UAPS     10
       OPEN     YES           ALW         NO          RTXTHR   10000
       RHOSTVAL MATCH         M2PATSET    1

IP Appl Sock/Assoc table is (8 of 4000) 1% full
Assoc Buffer Space Used (1300 KB of 1600 KB) on LOC = 1205

    If the state of the signaling link was changed in 6, continue the procedure with 11.

    If the state of the signaling link was not changed in 6, continue the procedure with 13.

  11. Activate the signaling link assigned to the association using the act-slk command.

    For example, enter this command.

    act-slk:loc=1205:link=a3

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

    
rlghncxa03w 06-10-07 11:11:28 GMT EAGLE5 36.0.0
Activate Link message sent to card
  12. Verify the status of the signaling link using the rept-stat-slk command.

    For example, enter this command.

    rept-stat-slk:loc=1205:link=a3

    This is an example of the possible output. 

    
rlghncxa03w 06-10-28 21:16:37 GMT EAGLE5 36.0.0
SLK      LSN         CLLI        PST          SST       AST
1205,A3  e5e6a       ----------- IS-NR        Avail     ----
Command Completed.
  13. 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.
    If you wish to change the other attributes of the M2PA association, perform one of these procedures.

    If you do not wish to change the other attributes of the M2PA association, this procedure is finished.

Figure 3-20 Changing the Link Value of a M2PA Association to another Link Value on the Same IPLIMx Card



Sheet 1 of 4



Sheet 2 of 4



Sheet 3 of 4



Sheet 4 of 4