1. Database Administration - IP7 User's Guide
  2. IETF M3UA and SUA Configuration Procedures
  3. Changing the Attributes of a M3UA or SUA Association

Changing the Attributes of a M3UA or SUA Association

This procedure is used to change the values of the attributes of a M3UA or SUA association, assigned to cards that are running the SS7IPGW or IPGWI applications, using the chg-assoc command and the following parameters.

Table 4-16 Change M3UA and SUA Association Parameters

aname lport rhost rport open alw
rmode rmin rmax rtimes cwmin istrms
ostrms uaps rtxthr rhosttype rhostval

If you wish to change the attributes of M3UA associations assigned to cards that are running the IPSG application, perform.

The chg-assoc command contains other parameters that are not used in this procedure. To change these parameters, perform these procedures.

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

:adapter – The adapter layer for this association, either m3ua or sua. The adapter parameter is optional. The default value for the adapter parameter in this procedure is m3ua.

: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 M3UA or SUA 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 M3UA or SUA 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.

:uaps – The UA parameter set value being assigned to either an M3UA or SUA 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 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 adapter parameter value cannot be changed if the association is assigned to an application server. This can be verified with the rtrv-as command. If the association is assigned to any application servers, perform Removing an Association from an Application Server to remove the association from the application servers.

The value of the rmin parameter must be less than or equal to the rmax parameter value.

If the card’s application is either SS7IPGW or IPGWI, the signaling link being assigned to the association must be in service. This state is shown in the rept-stat-slk output with the entries IS-NR in the PST field and Avail in the SST field.

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 the rtrv-assoc or rtrv-as commands were entered.
  • Enter the canc-cmd without the trm parameter at the terminal where the rtrv-assoc or rtrv-as commands were entered.
  • Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-assoc or rtrv-as commands were entered, from another terminal other that the terminal where the rtrv-assoc or rtrv-as commands were 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 08-04-28 09:12:36 GMT EAGLE5 38.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    M3UA    2048  2048  YES  YES
assoc3          1205 A     A    M3UA    3000  3000  YES  YES
assoc5          1205 A     A    M3UA    1500  3000  YES  YES

    Select an association whose adapter value is M3UA or SUA. If the card shown in the CARD LOC column contains any SUA associations, continue the procedure with 3. If the card contains only M3UA associations, continue the procedure with 2.

  2. Enter the rtrv-card command with the location of the card that is hosting the M3UA 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       SS7IPGW  e5e6a       A    0

    If the application assigned to the card is IPSG, perform Changing the Attributes of an IPSG Association.

    If the application assigned to the card is SS7IPGW or IPGWI, continue the procedure with 3.

  3. Continue the procedure by performing one of these actions.
    If the application assigned to the card is SS7IPGW or IPGWI, shown in the APPL column, and the values of any of these parameters are being changed: lport, rhost, rport, adapter, rmode, rmin, rmax, rtimes, cwmin, istrms, ostrms, or uaps, continue the procedure by performing one of these actions.
    • If the open parameter value for the association is yes, continue the procedure with 5.
    • If the open parameter value for the association is no, continue the procedure with 6.
    If the application assigned to the card is SS7IPGW or IPGWI, shown in the APPL column, and only the values of the alw, open, or rtxthr parameters are being changed, continue the procedure by performing one of these actions.
    • If only the values of the alw parameter is being changed, or the open parameter value is being changed to no, continue the procedure with 12.
    • If the value of the rtxthr parameter is being changed, continue the procedure with 6.
    • If the value of the open parameter value is being changed to yes, a signaling link must be assigned to the card shown in this step. If 2 was performed, perform one of these actions.
      • If a signaling links is assigned to the card, entries area shown in the LSET NAME and LINK columns of the rtrv-card output in 2. If a signaling link is assigned to the card, perform one of these actions.
        • If only the alw parameter is being specified with the open=yes parameter, continue the procedure with 12.
        • If the value of the rtxthr parameter is being changed, continue the procedure with 6.
      • If the value of the open parameter value is being changed to yes and a signaling link is not assigned to the card, performAdding an IPGWx Signaling Link to assign an IPGWx signaling link to the card. After the signaling link has been added, perform one of these actions.
        • If only the alw parameter is being specified with the open=yes parameter, continue the procedure with 12.
        • If the value of the rtxthr parameter is being changed, continue the procedure with 6.
    • If the value of the open parameter value is being changed to yes, and 2 was not performed, continue the procedure with 4.
  4. Display the signaling link that is assigned to the card containing the association that is being changed by entering the rtrv-slk command with the location of the card. For this example, enter this command.

    rtrv-slk:loc=1205

    This is an example of possible output. 

    rlghncxa03w 08-04-25 14:02:39 EST  38.0.0
rtrv-slk:loc=1101
Command entered at terminal #4.

LOC  LINK LSN         SLC TYPE
1205 A    e5e6a       0   SS7IPGW

    If a signaling link is shown in this step, perform one of these actions.

    • If only the alw parameter is being specified with the open=yes parameter, continue the procedure with 12.
    • If the value of the rtxthr parameter is being changed, continue the procedure with 6.
    If a signaling link is not shown in this step, perform Adding an IPGWx Signaling Link to assign an IPGWx signaling link to the card. After the signaling link has been added, perform one of these actions.
    • If only the alw parameter is being specified with the open=yes parameter, continue the procedure with 12.
    • If the value of the rtxthr parameter is being changed, continue the procedure with 6.
  5. 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 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD;
  6. Display the association being changed by entering the rtrv-assoc command with the aname parameter specified in 5 or selected in 1.
    For this example, enter this command.

    rtrv-assoc:aname=assoc2

    This is an example of the possible output. 

    
rlghncxa03w 09-05-28 21:14:37 GMT EAGLE5 41.0.0
 ANAME assoc2
       LOC      1205          IPLNK PORT  A          LINK  A
       ADAPTER  M3UA          VER         M3UA RFC
       LHOST    IPNODE2-1205
       ALHOST   ---
       RHOST    remotehost1
       ARHOST   ---
       LPORT    2048          RPORT       2048
       ISTRMS   2             OSTRMS      2          BUFSIZE  200
       RMODE    LIN           RMIN        120        RMAX     800
       RTIMES   10            CWMIN       3000       UAPS     10
       OPEN     No            ALW         YES        RTXTHR   2000
       RHOSTVAL RELAXED

      ASNAMES
      as1              as4              as6

IP Appl Sock/Assoc table is (8 of 4000) 1% full
Assoc Buffer Space Used (800 KB of 800 KB) on LOC = 1205
    Continue the procedure by performing one of these steps.
    • If only the rtxthr parameter value is being changed, continue the procedure with 12.
    • If the adapter, uaps, or cwmin parameter values are not being changed, continue the procedure with 10 .
    • If the adapter parameter value is being changed, continue the procedure with 7.
    • If the uaps parameter value is being changed, but the adapter parameter value is not being changed, continue the procedure with 8.
    • If the cwmin parameter value is being changed, but the adapter and uaps parameter values are not being changed, continue the procedure with 9.
  7. Display the application servers referencing the association being changed using the rtrv-as command with the name of the association being changed in this procedure.

    For this example, enter this command.

    rtrv-as:aname=assoc2

    This is an example of possible output. 

    
rlghncxa03w 08-04-28 21:14:37 GMT EAGLE5 38.0.0
AS Name           Mode        Tr ms   Association Names
as1               LOADSHARE   2000    assoc2

as4               LOADSHARE   2000    assoc2

as6               LOADSHARE   2000    assoc2

AS Table is (6 of 250) 1% full

    If the association is assigned to any application servers, performRemoving an Association from an Application Server to remove the association from the application servers.

    Continue the procedure by performing one of these steps.
    • If the uaps or cwmin parameter values are not being changed, continue the procedure with 10 .
    • If the uaps parameter value is being changed, continue the procedure with 8.
    • If the cwmin parameter value is being changed, but the uaps parameter value is not being changed, continue the procedure with 9.
  8. Verify the values of the UA parameter set you wish to assign to the association by entering the rtrv-uaps command with the desired parameter set.

    Note:

    If theuaps parameter will not be specified with thechg-assoc command, and the adapter parameter value is being changed to eitherm3ua orsua, theUA parameter set 10 will be assigned to the association.

    For this example, enter this command.

    rtrv-uaps:set=3

    This is an example of possible output. 

    
rlghncxa03w 10-07-28 09:12:36 GMT EAGLE5 42.0.0
SET  TIMER      TVALUE  PARM      PVALUE
 3       1          10     1           3
 3       2        3000     2           0
 3       3       10000     3           1
 3       4        5000     4           0
 3       5           0     5           0
 3       6           0     6           0
 3       7           0     7           0
 3       8           0     8           0
 3       9           0     9           0
 3      10           0    10           0

TIMER 2: False IP Connection Congestion Timer, max time an
         association can be congested before failing due to false
         congestion. SS7IPGW and IPGWI applications enforce
         0-30000(ms). Not supported on IPSG application.
TVALUE : Valid range = 32-bits

TIMER 3: UA HeartBeat Period Timer T(beat), time (ms) between sending
         of BEAT msgs by NE. IPSG, SS7IPGW and IPGWI applications
         enforce 100(ms)-60000(ms).
TVALUE : Valid range = 32-bits

TIMER 4: UA HeartBeat Received Timer T(beat ack), timeout period for
         response BEAT ACK msgs by NE. IPSG, SS7IPGW and IPGWI
         applications enforce 100(ms)-10000(ms).
TVALUE : Valid range = 32-bits

PARM  1: ASP SNM options.  Each bit is used as an enabled/disabled
         flag for a particular ASP SNM option. Not supported on IPSG
         application.
PVALUE : Valid range = 32-bits
         BIT                                  BIT VALUE
         0=Broadcast                          0=Disabled , 1=Enabled
         1=Response Method                    0=Disabled , 1=Enabled
         2-5=Reserved
         6=Broadcast Congestion Status Change 0=Disabled , 1=Enabled
         7-31=Reserved

PARM  2: ASP/AS Notification options.  Each bit is used as an
         enabled/disabled flag for a particular ASP/AS
         Notification option.  Not supported on IPSG application.
PVALUE : Valid range = 32-bits
         BIT                                  BIT VALUE
         0=ASP Active Notifications           0=Disabled , 1=Enabled
         1=ASP Inactive Notifications         0=Disabled , 1=Enabled
         2=ASP AS State Query                 0=Disabled , 1=Enabled
         3-31=Reserved

PARM  3: UA Serviceability Options.  Each bit is used as an
         enabled/disabled flag for a particular UA Serviceability
         option. Supported on IPSG, SS7IPGW, and IPGWI applications.
         UA Graceful Shutdown supported on IPSG for M3UA only.
PVALUE : Valid range = 32-bits
         BIT                                  BIT VALUE
         0=UA Heartbeats                      0=Disabled , 1=Enabled
         1=UA Graceful Shutdown               0=Disabled , 1=Enabled 
         2-31=Reserved

PARM  4: SCTP Payload Protocol Indicator byte order option. Bit indicates 
         PPI value is RCV/TX in Big Endian or Little Endian byte format.  
         Supported on IPSG-M2PA associations only.
PVALUE : Valid range = 32-bits
         BIT                               BIT VALUE
         0=Payload Protocol Indicator      0=Big Endian , 1=Little Endian
         1-31=Reserved

    If the UA parameter set you wish to assign to the association does not contain the desired values, performChanging a UA Parameter Set to change the desired parameter set values.

    Caution:

    Changing aUA parameter set may affect the performance of any associations using the parameter set being changed.
    Continue the procedure by performing one of these steps.
    • If the cwmin parameter value is not being changed, continue the procedure with 10 .
    • If the cwmin parameter value is being changed, continue the procedure with 9.
  9. To change the cwmin value, the new cwmin parameter value must be less than or equal to the bufsize 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 cwmin value is less than or equal to the bufsize value, continue the procedure with 10 .
    • If the new cwmin value is not less than or equal to the bufsize value, either choose another value for the cwmin parameter that is less than or equal to the bufsize value, or performChanging the Buffer Size of a M3UA or SUA Association to change the bufsize value so that the bufsize value is greater than or equal to the cwmin value. After the new cwmin value has been chosen or the bufsize value has been changed, continue the procedure with 10 .
  10. The remote hosts assigned to the association can be changed by specifying the rhost and rhosttype parameters with the chg-assoc command.

    If the primary and alternate remote hosts are not being changed in this procedure, or if only the primary remote host is being changed, continue the procedure with 12.

    To change the alternate remote host value for the association, the association must have a primary remote host assigned to it. If the association has a primary remote host, continue the procedure with 12. If the association does not have a primary remote host, continue the procedure with 10.

  11. Assign a primary remote host to the association by entering the chg-assoc command with the name of the association and the primary remote host name.

    For this example, enter this command.

    chg-assoc:aname=assoc2:rhost=”gw200.nc-Oracle.com”

    The rhosttype=primary parameter can be specified with the chg-assoc command, but is not necessary.

    When this command has successfully completed, this message should appear. 

    
rlghncxa03w 09-05-28 09:12:36 GMT EAGLE5 41.0.0
CHG-ASSOC: MASP A - COMPLTD;
  12. Change the association using the chg-assoc command.
    For this example, enter this command.

    chg-assoc:aname=assoc2:rhost=”gw200.nc-Oracle.com”:rport=3000 :rtxthr=10000:rhostval=match

    If an alternate remote host is being specified for the association, for this example enter this command.

    chg-assoc:aname=assoc2:rhost=”gw210.nc-Oracle.com”:rhosttype=alternate:rport=3000 :rtxthr=10000:rhostval=match

    If only the alw, open, or rtxthr parameter values are being changed in this step, for this example, enter this command.

    chg-assoc:aname=assoc2:alw=no:open=yes:rtxthr=10000

    These are the rules that apply to the chg-assoc command.
    1. If any optional parameters are not specified with the chg-assoc command, those values are not changed.
    2. The value of the rmin parameter must be less than or equal to the rmax parameter value.
    3. The value of the rhost parameter is a text string of up to 60 characters, with the first character being a letter. The command input is limited to 150 characters, including the hostname.
    4. If the value of the open parameter is yes, only the values of the alw and rtxthr parameters can be changed. To change the values of the other parameters, the value of the open parameter must be no.

    When this command has successfully completed, this message should appear. 

    
rlghncxa03w 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD;

    Note:

    If the value of theopen parameter was not changed in3, continue the procedure with14.
  13. 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 08-04-28 09:12:36 GMT EAGLE5 38.0.0
CHG-ASSOC: MASP A - COMPLTD;
  14. Verify the changes using the rtrv-assoc command specifying the association name specified in 12 and 13.
    For this example, enter this command.

    rtrv-assoc:aname=assoc2

    This is an example of possible output.

    Note:

    If theRemoving an Association from an Application Serverprocedure in7was not performed, continue the procedure with16.
  15. Assign the association changed in 12 to all applicable application servers by performing one of these procedures:
  16. 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 lhost, alhost, or bufsize values of the M3UA or SUA association, perform one of these procedures.

    If you do not wish to change the lhost, alhost, or bufsize values of the M3UA or SUA association, this procedure is finished.

Figure 4-36 Changing the Attributes of a M3UA or SUA Association



Sheet 1 of 8



Sheet 2 of 8



Sheet 3 of 8



Sheet 4 of 8



Sheet 5 of 8



Sheet 6 of 8



Sheet 7 of 8



Sheet 8 of 8