Changing the Attributes of an IPSG Association
This procedure is used to change the values of the attributes of an IPSG association, assigned to cards that are running the IPSG application, IPSG cards, using the chg-assoc
command and the following parameters.
Table 6-12 Change IPSG Association Parameters
aname | lport | rhost | rport | open | alw |
rmode | rmin | rmax | rtimes | cwmin | istrms |
ostrms | m2patset | ver | rtxthr | uaps | rhosttype |
rhostval |
If you wish to change the attributes of M2PA associations assigned to cards that are running the IPLIM or IPLIMI applications, perform Changing the Attributes of an M2PA Association.
If you wish to change the attributes of M3UA associations assigned to cards that are running the SS7IPGW or IPGWI applications, perform Changing the Attributes of a M3UA or SUA 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 an IPSG Association.bufsize
- Changing the Buffer Size of an IPSG 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. 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.
: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.
Note:
If theadapter
parameter value for the association is M3UA, the alw
parameter cannot be specified.
: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
.
:uaps
– The UA parameter set value being assigned to an M2PA or an M3UA association.
:rtxthr
– The retransmission threshold for the association. The rtxthr
parameter value indicates the number of retransmissions that can occur on the association that when exceeded will generate UAM 0537, Ethernet Error Threshold Exceeded. 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
.
: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 association must be assigned to a signaling link.
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 m2patset
and ver
parameters can be specified only for IPSG M2PA associations.
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 6-27 Changing the Attributes of an IPSG Association
Sheet 1 of 5
Sheet 2 of 5
Sheet 3 of 5
Sheet 4 of 5
Sheet 5 of 5