1. Database Administration - IP7 User's Guide
  2. IETF M3UA and SUA Configuration Procedures
  3. Changing the Buffer Size of a M3UA or SUA Association

Changing the Buffer Size of a M3UA or SUA Association

This procedure is used to change the buffer size of a M3UA or a SUA association, assigned to cards that are running the SS7IPGW or IPGWI applications, using the chg-assoc command. If you wish to change the attributes of M3UA associations assigned to cards that are running the IPSG application, perform the Changing the Buffer Size 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.

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

:bufsize – The size, in kilobytes, of the buffer used by the association. The values for this parameter are 8 kilobytes to 400 kilobytes. The maximum size of the buffers on the IP cards are shown in the following list:

  • E5-ENET Card - 3200 KB.

The size of the buffers assigned to each association that is assigned to the IP card cannot exceed the maximum buffer size for that card. If the bufsize parameter value causes the total buffer size for all the associations on the IP card to exceed the maximum buffer size for that IP card, the chg-assoc command will be rejected. The available size of the buffers on the IP card can be verified by entering this command.

rtrv-assoc:lhost=<local host name assigned to the association being changed>

The alhost parameter can also be used with the rtrv-assoc command to display the available size of the buffers on the IP card.

The aname parameter can be used with the rtrv-assoc command to display the available size of the buffers on the IP card and the size of the buffer assigned to the association.

If you wish to increase the buffer size for this association to a value that is greater than available buffer size for the card, the buffer size of the other associations assigned to the card must be decreased.

The chg-assoc command contains other parameters that are not used this procedure. To change these parameters, perform these procedures.

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 08-04-28 09:12:36 GMT EAGLE5 38.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    M3UA    2048  2048  YES  YES
assoc3          1205 A     A    M3UA    3000  3000  YES  YES
assoc5          1205 A     A    M3UA    1500  3000  YES  YES

    Select an association whose adapter value is M3UA or SUA. If the card shown in the CARD LOC column contains any SUA associations, and the open parameter value of the association is no, continue the procedure with 4. If the open parameter value of the association is yes, continue the procedure with 3

    If the card contains only M3UA associations, continue the procedure with 2.

  2. Enter the rtrv-card command with the location of the card that is hosting the M3UA 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       SS7IPGW  e5e6a       A    0
    If the application assigned to the card is SS7IPGW or IPGWI, 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 Buffer Size 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 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD;
  4. Display the association being changed by entering the rtrv-assoc command with the aname parameter specified in 3 or the association selected in 1.
    For this example, enter this command.

    rtrv-assoc:aname=assoc2

    This is an example of the possible output. 

    
rlghncxa03w 09-05-28 21:14:37 GMT EAGLE5 41.0.0
 ANAME assoc2
       LOC      1205          IPLNK PORT  A          LINK  A
       ADAPTER  M3UA          VER         M3UA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    remotehost1
       ARHOST   ---
       LPORT    2048          RPORT       2048
       ISTRMS   2             OSTRMS      2          BUFSIZE  200
       RMODE    LIN           RMIN        120        RMAX     800
       RTIMES   10            CWMIN       3000       UAPS     10
       OPEN     No            ALW         YES        RTXTHR   2000
       RHOSTVAL RELAXED

      ASNAMES
      as1              as4              as6

IP Appl Sock/Assoc table is (8 of 4000) 1% full
Assoc Buffer Space Used (800 KB of 800 KB) on LOC = 1205
  5. If the bufsize parameter value causes the total buffer size for all the associations on the IP card to exceed the maximum buffer size for that IP card, the chg-assoc command will be rejected.
    If you wish to increase the buffer size for this association to a value that is greater than available buffer size for the card, the buffer size of the other associations assigned to the card must be decreased. Perform this step and 6, 7, and 8.

    If the buffers on the other associations assigned to the card do not need to be changed, continue the procedure with 9.

    Display the associations assigned to the IP card (and its corresponding local host) by entering the rtrv-assoc command with the local host name assigned to the association being changed. For this example, enter this command.

    rtrv-assoc:lhost="IPNODE2-1205"

    This is an example of the possible output. 

    
rlghncxa03w 08-04-28 21:14:37 GMT EAGLE5 38.0.0
                CARD IPLNK
ANAME           LOC  PORT  LINK ADAPTER LPORT RPORT OPEN ALW
assoc2          1205 A     A    M3UA    2048  2048  YES  YES
assoc3          1205 A     A    M3UA    3000  3000  YES  YES
assoc5          1205 A     A    M3UA    1500  3000  YES  YES

IP Appl Sock/Assoc table is (8 of 4000) 1% full
Assoc Buffer Space Used (800 KB of 3200 KB) on LOC = 1205
  6. Display each association shown in 5 by entering the rtrv-assoc command with the name of each association shown in 5.

    For this example, enter these commands.

    rtrv-assoc:aname=assoc2

    This is an example of the possible output. 

    
 ANAME assoc2
       LOC      1205          IPLNK PORT  A          LINK  A
       ADAPTER  M3UA          VER         M3UA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    remotehost1
       ARHOST   ---
       LPORT    2048          RPORT       2048
       ISTRMS   2             OSTRMS      2          BUFSIZE  200
       RMODE    LIN           RMIN        120        RMAX     800
       RTIMES   10            CWMIN       3000       UAPS     10
       OPEN     YES           ALW         YES        RTXTHR   2000
       RHOSTVAL RELAXED

      ASNAMES
      as1              as4              as6

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

    rtrv-assoc:aname=assoc3

    This is an example of the possible output. 

    
 ANAME assoc3
       LOC      1205          IPLNK PORT  A          LINK  A
       ADAPTER  M3UA          VER         M3UA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    remotehost3
       ARHOST   ---
       LPORT    3000          RPORT    3000
       ISTRMS   2             OSTRMS   2             BUFSIZE  400
       RMODE    LIN           RMIN     120           RMAX     800
       RTIMES   10            CWMIN    3000          UAPS     10
       OPEN     YES           ALW      YES           RTXTHR   10000
       RHOSTVAL RELAXED

      ASNAMES
      as2              as3              as5

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

    rtrv-assoc:aname=assoc5

    This is an example of the possible output. 

    
 ANAME assoc5
       LOC      1205          IPLNK PORT  A          LINK  A
       ADAPTER  M3UA          VER         M3UA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    remotehost3
       ARHOST   ---
       LPORT    1500          RPORT    3000
       ISTRMS   2             OSTRMS   2             BUFSIZE  200
       RMODE    LIN           RMIN     120           RMAX     800
       RTIMES   10            CWMIN    3000          UAPS     10
       OPEN     YES           ALW      YES           RTXTHR   10000
       RHOSTVAL RELAXED

      ASNAMES
      as2              as3              as5

IP Appl Sock/Assoc table is (8 of 4000) 1% full
Assoc Buffer Space Used (800 KB of 800 KB) on LOC = 1205
  7. To change the bufsize value for the associations shown in 6, the new bufsize parameter value must be greater than or equal to the cwmin parameter value.
    The cwmin parameter is the number if bytes specified for the association's congestion window. The bufsize is the number of kilobytes specified for the size of the association's buffer. To determine whether or not the cwmin value is less than or equal to the bufsize value, perform one of these actions.
    • Multiply the bufsize value by 1024.
    • Divide the cwmin value by 1024.
    Continue the procedure by performing one of these actions.
    • If the new bufsize value is greater than or equal to the cwmin value, continue the procedure with 8.
    • If the new bufsize value is not greater than or equal to the cwmin value, either choose another value for the bufsize parameter that is greater than or equal to the cwmin value, or perform the Changing the Attributes of a M3UA or SUA Association procedure to change the bufsize value so that the bufsize value is greater than or equal to the cwmin value. After the new bufsize value has been chosen or the cwmin value has been changed, continue the procedure with 8.
  8. Change the size of the buffers for one or more of the associations displayed in 6 to allow the buffer of the association displayed in 4 to be changed.
    Enter the chg-assoc command with the bufsize parameter. For this example, enter this command.

    chg-assoc:aname=assoc3:bufsize=200

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

    
rlghncxa03w 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD;
  9. To change the bufsize value for the association shown in 4, the new bufsize parameter value must be greater than or equal to the cwmin parameter value.
    The cwmin parameter is the number if bytes specified for the association's congestion window. The bufsize is the number of kilobytes specified for the size of the association's buffer. To determine whether or not the cwmin value is less than or equal to the bufsize value, perform one of these actions.
    • Multiply the bufsize value by 1024.
    • Divide the cwmin value by 1024.
    Continue the procedure by performing one of these actions.
    • If the new bufsize value is greater than or equal to the cwmin value, continue the procedure with 10.
    • If the new bufsize value is not greater than or equal to the cwmin value, either choose another value for the bufsize parameter that is greater than or equal to the cwmin value, or perform the Changing the Attributes of a M3UA or SUA Association procedure to change the bufsize value so that the bufsize value is greater than or equal to the cwmin value. After the new bufsize value has been chosen or the cwmin value has been changed, continue the procedure with 10.
  10. Change the association using the chg-assoc command.

    For this example, enter this command.

    chg-assoc:aname=assoc2:bufsize=250

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

    
rlghncxa03w 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD;

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

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

  11. 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 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD;
  12. Verify the changes using the rtrv-assoc command specifying the association name specified in 10 and 11.

    For this example, enter this command.

    rtrv-assoc:aname=assoc2

    This is an example of possible output. 

    
rlghncxa03w 09-05-28 09:12:36 GMT EAGLE5 41.0.0
 ANAME assoc2
       LOC      1205          IPLNK PORT  A          LINK  A
       ADAPTER  M3UA          VER         M3UA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    gw200.nc-tekelec.com
       ARHOST   ---
       LPORT    2048          RPORT       3000
       ISTRMS   2             OSTRMS      2          BUFSIZE  250
       RMODE    LIN           RMIN        120        RMAX     800
       RTIMES   10            CWMIN       3000       UAPS     10
       OPEN     YES           ALW         YES        RTXTHR   10000
       RHOSTVAL RELAXED

      ASNAMES
      as1              as4              as6

IP Appl Sock table is (8 of 4000) 1% full
Assoc Buffer Space Used (650 KB of 800 KB) on LOC = 1205
  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 other attributes of the M3UA or SUA association, perform one of these procedures.

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

Figure 4-37 Changing the Buffer Size of an M3UA or SUA Association



Sheet 1 of 4



Sheet 2 of 4



Sheet 3 of 4



Sheet 4 of 4