Changing the Buffer Size of a M2PA Association

This procedure is used to change the buffer size of a M2PA association, assigned to cards that are running the IPLIM or IPLIMI applications, using the chg-assoc command. If you wish to change the buffer size of M2PA 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 E5-ENET 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.

lhost and alhost - Changing the Host Values of a M2PA Association
link - Changing the Link Value of a M2PA Association to another Link Value on the Same IPLIMx Card
Other attributes of the M2PA Association - Changing the Attributes of an M2PA Association

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.

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

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 Buffer Size of an IPSG Association procedure.
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;
```

Display the association being changed by entering the rtrv-assoc command with the aname parameter specified in 3 or the name of the association assigned to the card displayed in 1.

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  400
       RMODE    LIN           RMIN        120         RMAX     800
       RTIMES   10            CWMIN       3000        UAPS     10
       OPEN     NO            ALW         YES         RTXTHR   2000
       RHOSTVAL RELAXED       M2PATSET    1

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

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 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 (8 of 4000) 1% full
Assoc Buffer Space Used (1600 KB of 1600 KB) on LOC = 1205
```

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.


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  400
       RMODE    LIN           RMIN        120         RMAX     800
       RTIMES   10            CWMIN       3000        UAPS     10
       OPEN     NO            ALW         YES         RTXTHR   2000
       RHOSTVAL RELAXED       M2PATSET    1

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

rtrv-assoc:aname=assoc3

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  B2
       ADAPTER  M2PA          VER         M2PA 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   2000
       RHOSTVAL RELAXED       M2PATSET    1

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

rtrv-assoc:aname=assoc5

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  A3
       ADAPTER  M2PA          VER         M2PA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    remotehost3
       ARHOST   ---
       LPORT    1500          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   2000
       RHOSTVAL RELAXED       M2PATSET    1

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

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 M2PA 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.
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=400

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;
```
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 M2PA 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.
Change the association using the chg-assoc command.
For this example, enter this command.

chg-assoc:aname=assoc2:bufsize=500

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

If the value of the open parameter was changed in 3, continue the procedure with 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 06-10-28 09:12:36 GMT EAGLE5 36.0.0
CHG-ASSOC: MASP A - COMPLTD;
```

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 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  500
       RMODE    LIN           RMIN        120         RMAX     800
       RTIMES   10            CWMIN       3000        UAPS     10
       OPEN     YES           ALW         YES         RTXTHR   2000
       RHOSTVAL RELAXED       M2PATSET    1

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

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.
- lhost and alhost - Changing the Host Values of a M2PA Association
- link - Changing the Link Value of a M2PA Association to another Link Value on the Same IPLIMx Card
- Other attributes of the M2PA Association - Changing the Attributes of an M2PA Association
If you do not wish to change the other attributes of the M2PA association, this procedure is finished.

Figure 3-18 Changing the Buffer Size of a M2PA Association

Sheet 1 of 4

Sheet 2 of 4

Sheet 3 of 4

Sheet 4 of 4