Changing the Host Values of a M2PA Association
This procedure is used to change the host values 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 attributes of M2PA associations assigned to cards that are running the IPSG application, perform the Changing the Host Values 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.
:lhost
– The host name for the local host, shown in the rtrv-ip-host
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.
:alhost
– The alternate local host name, shown in the rtrv-ip-host
output.
:link
– The signaling link on the IPLIMx card. If the card is a E5-ENET card, the values for the link
parameter can be a
, a1
, a2
, a3
, a4
, a5
, a6
, a7, b
, b1
, b2
, b3
, b4
, b5
, b6
, or b7
.
Note:
Theport
parameter can be used in place of the link
parameter to specify the signaling link on the card.
:adapter
– The adapter layer for this association, m2pa
.
: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.
: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
.
The chg-assoc
command contains other parameters that are not used this procedure. To change these parameters, perform these procedures.
bufsize
- Changing the Buffer Size of a M2PA Association- Other attributes of the M2PA Association - Changing the Attributes of an M2PA Association
At least one optional parameter is required.
The command input is limited to 150 characters, including the hostnames.
The EAGLE can contain a maximum of 4000 connections (association to application server assignments).
IPLIMx cards can have one association for each signaling link on the card. The E5-ENET card can contain a maximum of 16 signaling links, resulting in a maximum of 16 associations for this card.
The B Ethernet interface of the IP card can be used on E5-ENET cards.
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.
Uni-homed endpoints are associations configured with the lhost
parameter only. The lhost
parameter value represents an IP address that corresponds to either the A or B network interface of the IP card. Multi-homed endpoints are associations configured with both the lhost
and alhost
parameters. The lhost
parameter value represents an IP address corresponding to one of the network interfaces (A or B) of the IP card while the alhost
parameter value represents an IP address corresponding to the other network interface of the same IP card.
The alhost=none
parameter removes the alternate local host from the specified association, which also removes the multi-homed endpoint capability.
Canceling the RTRV-ASSOC
and RTRV-AS
Commands
Because the rtrv-assoc
and rtrv-as
commands used in this procedure can output information for a long period of time, the rtrv-assoc
and rtrv-as
commands can be canceled and the output to the terminal stopped. There are three ways that the rtrv-assoc
and rtrv-as
commands can be canceled.
- Press the
F9
function key on the keyboard at the terminal where thertrv-assoc
orrtrv-as
commands were entered. - Enter the
canc-cmd
without thetrm
parameter at the terminal where thertrv-assoc
orrtrv-as
commands were entered. - Enter the
canc-cmd:trm=<xx>
, where<xx>
is the terminal where thertrv-assoc
orrtrv-as
commands were entered, from another terminal other that the terminal where thertrv-assoc
orrtrv-as
commands were 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-19 Changing the Host Values of a M2PA Association
Sheet 1 of 7
Sheet 2 of 7
Sheet 3 of 7
Sheet 4 of 7
Sheet 5 of 7
Sheet 6 of 7
Sheet 7 of 7