Changing the Attributes of an M2PA Association
This procedure is used to change the values of the attributes of an M2PA association, assigned to cards that are running the IPLIM or IPLIMI applications, using the chg-assoc
command and the following parameters.
Table 3-7 Change M2PA Association Parameters
aname | lport | rhost | rport | open | alw |
rmode | rmin | rmax | rtimes | cwmin | istrms |
ostrms | m2patset | ver | rtxthr | rhosttype | rhostval |
An M2PA association that is assigned to an IPLIMx signaling link can contain a UA parameter set value (the uaps
parameter). While the uaps
parameter value can be changed with the chg-assoc
command, the uaps
parameter value has no impact on the traffic carried by an M2PA association that is assigned to an IPLIMx signaling link.The uaps
parameter value impacts M3UA or SUA associations that are assigned to IPGWx signaling links and M2PA and M3UA associations that are assigned to IPSG cards. The uaps
parameter value is shown in the UAPS
field in the rtrv-assoc
output for an M2PA associations that is assigned to an IPLIMx signaling link.
If you wish to change the attributes of M2PA associations assigned to cards that are running the IPSG application, perform Changing the Attributes of an IPSG Association.
The chg-assoc
command contains other parameters that are not used in this procedure. To change these parameters, perform these procedures.
lhost
andalhost
- Changing the Host Values of a M2PA Associationlink
- Changing the Link Value of a M2PA Association to another Link Value on the Same IPLIMx Cardbufsize
- Changing the Buffer Size of a M2PA Association
:aname
– The name assigned to the association, shown in the rtrv-assoc
output.
:lport
– The SCTP port number for the local host.
:rhost
– The host name for the remote host, rhost
can be any string of characters starting with a letter and comprising these characters ['a'..'z', 'A'..'Z', '0'..'9', '-', '.']. Hostnames are not case-sensitive and can contain up to 60 characters. The default value of this optional parameter is empty (null string).
:rport
– The SCTP port number for the remote host.
: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.
:alw
– The connection state for this association. Valid values are yes
or no
. When the alw=yes
parameter is specified, the connection manager allows the association to carry SS7 traffic. When the alw=no
parameter is specified, the connection manager prohibits the association from carrying SS7 traffic.
:rmode
– The retransmission policy used when packet loss is detected. The values are rfc
or lin
.
rfc
– Standard RFC 2960 algorithm in the retransmission delay doubles after each retransmission. The RFC 2960 standard for congestion control is also used.lin
– Oracle's linear retransmission policy where each retransmission timeout value is the same as the initial transmission timeout and only the slow start algorithm is used for congestion control.
:rmin
– The minimum value of the calculated retransmission timeout in milliseconds, from 10 - 1000.
:rmax
– The maximum value of the calculated retransmission timeout in milliseconds, from 10 - 1000.
:rtimes
– The number of times a data retransmission will occur before closing the association from 3 - 12.
:cwmin
– The minimum size in bytes of the association's congestion window and the initial size in bytes of the congestion window, from 1500 - 409600. The cwmin
parameter value must be less than or equal to the size of the buffer used by the association, shown by the bufsize
parameter value. If the buffer size for the association needs to be changed, perform Changing the Buffer Size of a M2PA Association.
The rmode
, rmin
, rmax
, rtimes
, and cwmin
parameters are used to configure the SCTP retransmission controls for an association, in addition to other commands. Perform Configuring SCTP Retransmission Control for a M2PA Association to configure the SCTP retransmission controls for an association.
:istrms
– The number of inbound streams (1 or 2) advertised by the SCTP layer for the association.
:ostrms
– The number of outbound streams (1 or 2) advertised by the SCTP layer for the association.
:m2patset
– The M2PA timer set assigned to the association. The m2patset
parameter can be specified only with the adapter=m2pa
parameter, or if the association already has the adapter=m2pa
parameter assigned and the adapter
parameter value is not being changed. If the adapter
parameter value is being changed to m2pa
, and the m2patset
parameter is not specified, the default value for the m2patset
parameter (1 - M2PA timer set 1) is assigned to the association. If the adapter
parameter value for the association is m2pa
, is not being changed, and the m2patset
parameter is not specified with the chg-assoc
command, the m2patset
parameter value is not changed.
:ver
– The M2PA version assigned to the M2PA association, either the RFC version (ver=rfc
), or the Draft 6 version (ver=d6
). The ver
parameter can be specified only if, when this procedure is completed, the adapter
parameter value is m2pa
. If the adapter
parameter value is being changed to m2pa
, and the ver
parameter is not specified, the default M2PA version of RFC is assigned to the association. To change the ver
parameter value, the open
parameter value for the association must be no
.
:rtxthr
–The retransmission threshold for the association. The RTXTHR parameter value indicates the number of packet re-transmissions that can occur on the association (per monitoring time period of 2 seconds). Alarm "IP Connection Excess Retransmits" (UAM 536) will be raised if the number of packets re-transmitted is greater than the configured RTXTHR parameter value, during 5 such consecutive monitoring periods. Once alarm is raised, it may require up to 12 consecutive monitoring periods with the number of re-transmissions < RTXTHR to clear the alarm. The design allows the alarm to come on at low error rates, and not come for occasional errors.
The value of this parameter is 0 to 65,535. The value of this parameter is shown in the RTXTHR field of the rtrv-assoc:aname=<association name>
output. The rtxthr parameter value can be changed if the open parameter value is either "yes" or "no". It is possible to configure the RTXTHR so that UAM 536 alarms if the error rate on association is above the recommended maximum packet loss of 0.025%. If the error rate is more than 0.025%, investigate to determine if this can be improved in the network.
:rhosttype
– The type of remote host assigned to the association, primary
or alternate
. The primary remote host is shown in the RHOST
field of the rtrv-assoc:aname=<association name>
output. The alternate remote host is shown in the ARHOST
field of the rtrv-assoc:aname=<association name>
output.
An alternate remote host can be configured for multi-homed associations using the rhost
and rhosttype
parameters of the chg-assoc
command. The rhost
parameter value with the rhostype=primary
parameter represents an IP address that corresponds to one of the network interfaces at the remote end while the rhost
parameter value with the rhostype=alternate
parameter represents an IP address that corresponds to the other network interface at the remote end.
:rhostval
– The validation mode used for the association when an SCTP INIT/INIT-ACK message is received. The value of this parameter is shown in the RHOSTVAL
field of the rtrv-assoc:aname=<association name>
output. This parameter has two values.
relaxed
- accept the message if the IP address for the primary or alternate remote host matches the IP address, source IP address, or the host name in the message.match
- accept the message if the message contains the primary remote host value and the alternate remote host value (if the alternate remote host is provisioned). If the alternate remote host is not provisioned, then accept the message if the message contains the primary remote host value. Reject the message if it contains any IP address other than that of the primary or alternate remote host.Refer to the
chg-assoc
command description in Commands User's Guide for more information about this parameter.
If the value of the open
parameter is yes
, only the value of the alw
, and rtxthr
parameters can be changed. To change the values of other parameters, the value of the open
parameter must be no
.
To set the open
parameter value to yes
, the association specified by the aname
parameter must contain values for the lhost
, lport
, rhost
, and rport
parameters. The lhost
parameter value must have a signaling link assigned to it.
At least one optional parameter is required.
The command input is limited to 150 characters, including the hostnames.
The value of the rmin
parameter must be less than or equal to the rmax
parameter value.
The ipliml2
parameter value of the signaling link assigned to the association must be m2pa
. The adapter
parameter value of the association must match the ipliml2
parameter value.
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 the association is being opened in this procedure with the chg-assoc
command and the open=yes
parameter, the signaling link assigned to the association must be in the database and the ipliml2
parameter value of the signaling link assigned to the association must be m2pa
.
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 thertrv-assoc
command was entered. - Enter the
canc-cmd
without thetrm
parameter at the terminal where thertrv-assoc
command was entered. - Enter the
canc-cmd:trm=<xx>
, where<xx>
is the terminal where thertrv-assoc
command was entered, from another terminal other that the terminal where thertrv-assoc
command was entered. To enter thecanc-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 thertrv-secu-trm
command. The user’s permissions can be verified with thertrv-user
orrtrv-secu-user
commands.
For more information about the canc-cmd
command, go to Commands User's Guide.
Figure 3-17 Changing the Attributes of an M2PA Association
Sheet 1 of 4
Sheet 2 of 4
Sheet 3 of 4
Sheet 4 of 4