1. Database Administration - IP7 User's Guide
  2. IPSG M2PA and M3UA Configuration Procedures
  3. Changing the Buffer Size of an IPSG Association

Changing the Buffer Size of an IPSG Association

This procedure is used to change the buffer size of an IPSG association, assigned to E5-ENET cards that are running the IPSG application, IPSG cards, using the chg-assoc command.

If you wish to change the buffer size of M2PA associations assigned to cards that are running the IPLIM or IPLIMI applications, perform the Changing the Buffer Size of a M2PA Association procedure.

If you wish to change the buffer size of M3UA associations assigned to cards that are running the SS7IPGW or IPGWI applications, perform the Changing the Buffer Size of a M3UA or SUA 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. If the open=no parameter is specified for an established IPSG M3UA association, and the UA Graceful Shutdown option is enabled (refer to Changing a UA Parameter Set for more information), the IPSG M3UA connection will be gracefully shutdown.

: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 an IPSG card is 6400 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 IPSG card to exceed the maximum buffer size for that IPSG card, the chg-assoc command will be rejected. The available size of the buffers on the IPSG 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 in 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 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
assoc5          1205 A     A3   M2PA    1500  3000  YES  YES
  2. Enter the rtrv-card command with the location of the card that is hosting the 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   ENET      IPSG     e5e6a       A    0   e5e6a       B2   1
                          e5e6a       A3   2

    rtrv-card:loc=1201

    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
1201   ENET      IPSG     ipsgm3ua1   A    0
    If the application assigned to the card is IPSG, 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 IPLIM or IPLIMI, perform the Changing the Buffer Size of a M2PA Association procedure.

    If the application assigned to the card is SS7IPGW or IPGWI, perform the Changing the Buffer Size of a M3UA or SUA 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 these commands.

    chg-assoc:aname=assoc2:open=no

    chg-assoc:aname=assoc1:open=no

    When these commands have successfully completed, this message should appear. 

    
rlghncxa03w 06-10-28 09:12:36 GMT EAGLE5 36.0.0
CHG-ASSOC: MASP A - COMPLTD;
  4. Display the association that is being changed by entering the rtrv-assoc command with the aname parameter and the name of the association specified in 3.

    For this example, enter this command.

    rtrv-assoc:aname=assoc2

    This is an example of the 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    remotehost1
       ARHOST   ---
       LPORT    2048          RPORT       2048
       ISTRMS   2             OSTRMS      2          BUFSIZE  300
       RMODE    LIN           RMIN        120        RMAX     800
       RTIMES   10            CWMIN       3000       UAPS     10
       OPEN     NO            ALW         YES        RTXTHR   2000
       RHOSTVAL RELAXED       M2PATSET    1
     
       LSN
       e5e6a

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

    rtrv-assoc:aname=assoc1

    This is an example of the possible output. 

    
rlghncxa03w 09-05-28 21:14:37 GMT EAGLE5 41.0.0

ANAME assoc1
      LOC      1201          IPLNK PORT A           LINK     A
      ADAPTER  M3UA          VER        M3UA RFC
      LHOST    m3ua1
      ALHOST   ---
      RHOST    remote1
      ARHOST   ---
      LPORT    2000          RPORT      1030
      ISTRMS   2             OSTRMS     2           BUFSIZE  200
      RMODE    LIN           RMIN       120         RMAX     800
      RTIMES   10            CWMIN      3000        UAPS     10
      OPEN     NO            ALW        YES         RTXTHR   0
      RHOSTVAL RELAXED

      LSN
      ipsgm3ua1

IP Appl Sock/Assoc table is (7 of 4000) 1% full
Assoc Buffer Space Used (400 KB of 6400 KB) on LOC = 1201
  5. If the bufsize parameter value causes the total buffer size for all the associations on the IPSG card to exceed the maximum buffer size for that IPSG 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, 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 these commands.

    rtrv-assoc:lhost=IPNODE2-1205

    This is an example of the possible output. 

    
rlghncxa03w 06-10-28 21:14:37 GMT EAGLE5 36.0.0
                CARD IPLNK
ANAME           LOC  PORT  LINK ADAPTER LPORT RPORT OPEN ALW
assoc2          1205 A     A    M2PA    2048  2048  YES  YES
assoc3          1205 A     B2   M2PA    3000  3000  YES  YES
assoc5          1205 A     A3   M2PA    1500  3000  YES  YES

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

    rtrv-assoc:lhost=m3ua1

    This is an example of the 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
assoc1          1201 A     A    M3UA    2000  1030  YES  YES

IP Appl Sock/Assoc table is (7 of 4000) 1% full
Assoc Buffer Space Used (400 KB of 6400 KB) on LOC = 1201
  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  M2PA          VER         M2PA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    remotehost1
       ARHOST   ---
       LPORT    2048          RPORT       2048
       ISTRMS   2             OSTRMS      2          BUFSIZE  300
       RMODE    LIN           RMIN        120        RMAX     800
       RTIMES   10            CWMIN       3000       UAPS     10
       OPEN     NO            ALW         YES        RTXTHR   2000
       RHOSTVAL RELAXED       M2PATSET    1

       LSN
       e5e6a

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

    rtrv-assoc:aname=assoc3

    This is an example of the possible output. 

    
 ANAME assoc3
       LOC      1205          IPLNK PORT  A          LINK  B2
       ADAPTER  M2PA          VER         M2PA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    remotehost3
       ARHOST   ---
       LPORT    3000          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   2000
       RHOSTVAL RELAXED       M2PATSET    1

       LSN
       e5e6a

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

    rtrv-assoc:aname=assoc5

    This is an example of the possible output. 

    
 ANAME assoc5
       LOC      1205          IPLNK PORT  A          LINK  A3
       ADAPTER  M2PA          VER         M2PA 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   2000
       RHOSTVAL RELAXED       M2PATSET    1

       LSN
       e5e6a

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

    rtrv-assoc:aname=assoc1

    This is an example of the possible output. 

    
rlghncxa03w 09-05-28 21:14:37 GMT EAGLE5 41.0.0

ANAME assoc1
      LOC      1201          IPLNK PORT A           LINK     A
      ADAPTER  M3UA          VER        M3UA RFC
      LHOST    m3ua1
      ALHOST   ---
      RHOST    remote1
      ARHOST   ---
      LPORT    2000          RPORT      1030
      ISTRMS   2             OSTRMS     2           BUFSIZE  200
      RMODE    LIN           RMIN       120         RMAX     800
      RTIMES   10            CWMIN      3000        UAPS     10
      OPEN     NO            ALW        YES         RTXTHR   0
      RHOSTVAL RELAXED

      LSN
      ipsgm3ua1

IP Appl Sock/Assoc table is (7 of 4000) 1% full
Assoc Buffer Space Used (400 KB of 6400 KB) on LOC = 1201

    rtrv-assoc:aname=swbel32

    This is an example of the possible output. 

    
rlghncxa03w 09-05-28 21:14:37 GMT EAGLE5 41.0.0

ANAME swbel32
      LOC      1201          IPLNK PORT A           LINK     A
      ADAPTER  M3UA          VER        M3UA RFC
      LHOST    m3ua1
      ALHOST   ---
      RHOST    remote1
      ARHOST   ---
      LPORT    1030          RPORT      2345
      ISTRMS   2             OSTRMS     2           BUFSIZE  200
      RMODE    LIN           RMIN       120         RMAX     800
      RTIMES   10            CWMIN      3000        UAPS     10
      OPEN     NO            ALW        YES         RTXTHR   0
      RHOSTVAL RELAXED

      LSN
      ipsgm3ua1

IP Appl Sock/Assoc table is (7 of 4000) 1% full
Assoc Buffer Space Used (400 KB of 6400 KB) on LOC = 1201
  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 an IPSG 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=100

    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. 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 an IPSG 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 these commands.

    chg-assoc:aname=assoc2:bufsize=400

    chg-assoc:aname=assoc1:bufsize=400

    When these commands have 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 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

    chg-assoc:aname=assoc1: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;
  12. Verify the changes using the rtrv-assoc command specifying the association name specified in 10 and 11.

    For this example, enter these commands.

    rtrv-assoc:aname=assoc2

    This is an example of possible output. 

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

       LSN
       e5e6a

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

    For this example, enter these commands.

    rtrv-assoc:aname=assoc1

    
rlghncxa03w 09-05-28 21:14:37 GMT EAGLE5 41.0.0

ANAME assoc1
      LOC      1201          IPLNK PORT A           LINK     A
      ADAPTER  M3UA          VER        M3UA RFC
      LHOST    m3ua1
      ALHOST   ---
      RHOST    remote1
      ARHOST   ---
      LPORT    2000          RPORT      1030
      ISTRMS   2             OSTRMS     2           BUFSIZE  400
      RMODE    LIN           RMIN       120         RMAX     800
      RTIMES   10            CWMIN      3000        UAPS     10
      OPEN     YES           ALW        YES         RTXTHR   0
      RHOSTVAL RELAXED

      LSN
      ipsgm3ua1

IP Appl Sock/Assoc table is (7 of 4000) 1% full
Assoc Buffer Space Used (600 KB of 6400 KB) on LOC = 1201
  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 IPSG association, perform one of these procedures.

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

Figure 6-28 Changing the Buffer Size of an IPSG Association



Sheet 1 of 4



Sheet 2 of 4



Sheet 3 of 4



Sheet 4 of 4