4.455 rtrv-assoc

Use this command to retrieve the configuration data from the IP Socket/Association (IPAPSOCK) table.

Parameters

adapter (optional)
The adapter layer for this association.
Range:
diam
m2pa
m3ua
sua
Default:
Retrieve all
alhost (optional)
Alternate local host name as defined in the IP Host table.
Range:
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz,

Any string of characters beginning with a letter and comprising up to 60 characters in length. Valid characters are a–z, A–Z, 0–9, - (dash), . (period)

Default:
Retrieve all
aname (optional)
Name assigned to this association (in IPAPSOCK table).
Range:
ayyyyyyyyyyyyyy

Up to 15 alphanumeric characters; the first character must be a letter

Default:
Retrieve all
display (optional)
An optional display parameter can be specified in order to display either all or brief reports for associations.  The default mode is “brief” if this parameter is not entered at the command line.
Range:
brief
all
lhost (optional)
The local host name as defined in the IP Host table.
Range:
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz,

Any string of characters beginning with a letter and comprising up to 60 characters in length. Valid characters are a–z, A–Z, 0–9, - (dash), . (period).

Default:
Retrieve all
link (optional)
The signaling link for this association.
Range:
a, b, a1-a63, b1-b63

Not all card types support all link parameter values.

See Table A-1 for valid link parameter range values for each type of card that can have assigned signaling links.

loc (optional)
Card location that is stenciled on the shelf of the system.
Range:
1101 - 1108, 1111 - 1112, 1201 - 1208, 1211 - 1218, 1301 - 1308, 1311 - 1318, 2101 - 2108, 2111 - 2118, 2201 - 2208, 2211 - 2218, 2301 - 2308, 2311 - 2318, 3101 - 3108, 3111 - 3118, 3201 - 3208, 3211 - 3218, 3301 - 3308, 3311 - 3318, 4101 - 4108, 4111 - 4118, 4201 - 4208, 4211 - 4218, 4301 - 4308, 4311 - 4318, 5101 - 5108, 5111 - 5118, 5201 - 5208, 5211 - 5218, 5301 - 5308, 5311 - 5318, 6101 - 6108, 6111 - 6118
rhost (optional)
Name of Remote Host as defined in the IP Host table.
Range:
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz,

Any string of characters beginning with a letter and comprising up to 60 characters in length. Valid characters are a–z, A–Z, 0–9, - (dash), . (period).

Default:
Retrieve all
rhosttype (optional)

Remote host type. This parameter retrieves associations with a configured primary remote host or with configured primary and alternate remote hosts.

Range:
primary
retrieve associations with only a primary remote host
alternate
retrieve associations with primary and alternate remote hosts
Default:
retrieve all associations
rhostval (optional)
Remote host validation mode. This parameter retrieves associations with the specified validation mode.
Range:
relaxed
match
Default:
retrieve all associations

Example

rtrv-assoc

rtrv-assoc:aname=swbel32

rtrv-assoc:lhost=gw105.nc.tekelec.com:adapter=sua

rtrv-assoc:rhosttype=alternate:display=all

rtrv-assoc:lhost=gw105.nc.tekelec.com:adapter=diam

Dependencies

A valid value must be specified for the host parameter. If the host name contains a hyphen, then the host name must be enclosed within quotation marks.

Notes

This command can be canceled using the F9 function key or the canc-cmd command. See canc-cmd for more information.

The IPAPSOCK table is used to associate the Local Host/Local Port to a Remote Host/Remote Port.

When the command is entered with the aname, lhost, or alhost parameters, the output displays SCTP buffer usage information (used and total buffer space on the card).

Heartbeat timer value is in milliseconds.

Output

AS names are displayed for IPGWx-M3UA and SUA linksets.

LS names are displayed for IPSG linksets.

This example shows buffer usage (used and total buffer space) and card location information:

rtrv-assoc:aname=ipsgm3ua05

    eagle10212 10-02-10 17:21:29 EST  EAGLE 46.0.0

    ANAME ipsgm3ua05
          LOC      1305          IPLNK PORT A           LINK     A
          ADAPTER  M3UA          VER        M3UA RFC
          LHOST    e1021201.1305a
          ALHOST   ---
          RHOST    e1021301.1305a
          ARHOST   ---
          LPORT    2005          RPORT      2005
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     NO            ALW        NO          RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500

          LSN
          ls1305a

    IP Appl Sock/Assoc table is (7 of 4000) 1% full
    Assoc Buffer Space Used (320 KB of 3200 KB) on LOC = 1307 

;

This example shows buffer usage (used and total buffer space) and card location information:

rtrv-assoc:lhost=e1021201.1311a

    eagle10212 10-02-10 17:21:29 EST  EAGLE 46.0.0

        ANAME ipl1311a
          LOC      1311          IPLNK PORT A           LINK     A
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    e1021201.1311a
          ALHOST   ---
          RHOST    e1021301.1311a
          ARHOST   ---
          LPORT    1311          RPORT      1311
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     1
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1

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

;
rtrv-assoc:display=brief or rtrv-assoc

                    CARD  IPLNK
    ANAME           LOC   PORT  LINK ADAPTER LPORT RPORT OPEN ALW
    a23456789012345 1305  A     A    M3UA    20000 30000 YES  YES
    b23456789012345 1305  B     A    M3UA    20001 30001 NO   NO
    c23456789012345 1307  A     A    SUA     20002 30002 YES  YES
    d23456789012345 1307  B     A    M3UA    20003 30003 NO   NO
    e23456789012345 1315  A     A    SUA     20004 30004 YES  YES
    f23456789012345 1315  A,B   A    M3UA    20005 30005 YES  YES
    g23456789012345 1317  B,A   A    SUA     20006 30006 YES  YES
    m2pa1105b3      1105  A     B3   M2PA    31105 31105 YES  YES   
    m2pa1107a0      1107  A     --   M2PA    1107  1107  NO   NO    
    m2pa1107a1      1107  A     --   M2PA    11107 11107 NO   NO    
    m3ua1211a0      1211  A     A    M3UA    1211  1213  YES  YES   
    m3ua1211a1      1211  A     **   M3UA    11211 11213 YES  YES   
    m3ua1211a2      1211  A     B1   M3UA    21211 21213 YES  YES   
    m3ua1211a3      1211  A     A3   M3UA    31211 31213 YES  YES   
    m3ua1213a0      1213  A     A    M3UA    1213  1211  YES  YES   
    m3ua1213a1      1213  A     A1   M3UA    11213 11211 YES  YES   
    m3ua1213a2      1213  A     A2   M3UA    21213 21211 YES  YES   
    m3ua1213a3      1213  A     A3   M3UA    31213 31211 YES  YES   
    ipg1215a01      1215  A     **   M3UA    11215 1111  YES  YES   
    ipg1215a02      1215  A     **   M3UA    11215 1112  YES  YES   
    ipg1215a03      1215  A     --   M3UA    11215 1113  NO   NO    
    ipg1215a04      1215  A     --   M3UA    11215 1114  NO   NO    
    ipg1215a05      1215  A     --   M3UA    11215 1115  NO   NO    
    ipg1215a06      1215  A     --   M3UA    11215 1116  NO   NO   
 
    IP Appl Sock/Assoc table is (24 of 4000) 1% full
     
;
rtrv-assoc:adapter=m2pa

    eagle10212 10-02-10 11:54:01 EST  EAGLE 46.0.0
                    CARD  IPLNK
    ANAME           LOC   PORT  LINK ADAPTER LPORT RPORT OPEN ALW
    ipl1301a        1301  A     A    M2PA    1301  1301  YES  YES
    ipl1301b        1301  A     B    M2PA    1302  1302  YES  YES
    sgm2pa1         1305  A     A15  M2PA    1305  1305  NO   NO
    sgm2pa7         1303  A     A15  M2PA    1306  1306  YES  YES
    ipl1311a        1311  A     A    M2PA    1311  1311  YES  YES
    ipl1313a        1313  A     A    M2PA    1313  1313  YES  YES

    IP Appl Sock/Assoc (  11 of 4000) 1%

This example shows command output for all configured associations:

rtrv-assoc:display=all

    eagle10212 10-02-02 17:00:42 EST  EAGLE 46.0.0
    ANAME ipl1301a
          LOC      1301          IPLNK PORT A           LINK     A
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    e1021201.1301a
          ALHOST   ---
          RHOST    e1021301.1301a
          ARHOST   ---
          LPORT    1301          RPORT      1301
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1

    ANAME ipl1301b
          LOC      1301          IPLNK PORT A           LINK     B
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    e1021201.1301a
          ALHOST   ---
          RHOST    e1021301.1301a
          ARHOST   ---
          LPORT    1302          RPORT      1302
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1             

    ANAME sg1303a
          LOC      1303          IPLNK PORT A           LINK     A
          ADAPTER  M3UA          VER        M3UA RFC
          LHOST    e1021201.1303a
          ALHOST   ---
          RHOST    e1021301.1303a
          ARHOST   ---
          LPORT    2003          RPORT      2003
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500

    ANAME sg1305a
          LOC      1305          IPLNK PORT A           LINK     A
          ADAPTER  M3UA          VER        M3UA RFC
          LHOST    e1021201.1305a
          ALHOST   ---
          RHOST    e1021301.1305a
          ARHOST   ---
          LPORT    2005          RPORT      2005
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500

    ANAME sg1305i
          LOC      1305          IPLNK PORT A           LINK     B
          ADAPTER  M3UA          VER        M3UA RFC
          LHOST    e1021201.1305a
          ALHOST   ---
          RHOST    e1021301.1305a
          ARHOST   ---
          LPORT    2006          RPORT      2006
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     NO            ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500

    ANAME ipg1307a1
          LOC      1307          IPLNK PORT A           LINK     A
          ADAPTER  M3UA          VER        M3UA RFC
          LHOST    e1021201.1307a
          ALHOST   ---
          RHOST    e1021301.1307a
          ARHOST   ---
          LPORT    4001          RPORT      4001
          ISTRMS   2             OSTRMS     2           BUFSIZE  16
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500

    ANAME ipl1311a
          LOC      1311          IPLNK PORT A           LINK     A
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    e1021201.1311a
          ALHOST   ---
          RHOST    e1021301.1311a
          ARHOST   ---
          LPORT    1311          RPORT      1311
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     NO            ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1

    ANAME ipl1313a
          LOC      1313          IPLNK PORT A           LINK     A
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    e1021201.1313a
          ALHOST   ---
          RHOST    e1021301.1313a
          ARHOST   ---
          LPORT    1313          RPORT      1313
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     3
          OPEN     NO            ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1

    ANAME ipg1315a1
          LOC      1315          IPLNK PORT A           LINK     A
          ADAPTER  M3UA          VER        M3UA RFC
          LHOST    e1021201.1315a
          ALHOST   ---
          RHOST    e1021301.1315a
          ARHOST   ---
          LPORT    1315          RPORT      1315
          ISTRMS   2             OSTRMS     2           BUFSIZE  16
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     NO            ALW        NO          RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500

    ANAME ipg1317a1
          LOC      1317          IPLNK PORT A           LINK     A
          ADAPTER  M3UA          VER        M3UA RFC
          LHOST    e1021201.1317a
          ALHOST   ---
          RHOST    e1021301.1317a
          ARHOST   ---
          LPORT    1317          RPORT      1317
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500

    ANAME sg1305m
          LOC      1303          IPLNK PORT A           LINK     A1
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    e1021201.1303a
          ALHOST   ---
          RHOST    e1021301.1303a
          ARHOST   ---
          LPORT    1305          RPORT      1305
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1

    IP Appl Sock/Assoc table is (11 of 4000) 1% full 
;
rtrv-assoc:aname=sg1305a

    eagle10212 09-03-10 17:00:42 EST  EAGLE 46.0.0

    ANAME sg1305a
          LOC      1305          IPLNK PORT A           LINK     A
          ADAPTER  M3UA          VER        M3UA RFC
          LHOST    e1021201.1305a
          ALHOST   ---
          RHOST    e1021301.1305a
          ARHOST   ---
          LPORT    2005          RPORT      2005
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     YES           ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500

          LSN;

          ls1305a

    IP Appl Sock/Assoc table is (13 of 4000) 1% full
    Assoc Buffer Space Used (600 KB of 3200 KB) on LOC = 1305 
;

This example shows all associations with both primary and alternate remote host values configured:

rtrv-assoc:rhosttype=alternate:display=all

    ipsig 10-02-10 17:58:37 GMT  EAGLE 46.0.0

    ANAME assoc12
          LOC      1111          IPLNK PORT A,B         LINK     A
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    aricent11.com
          ALHOST   aricent12.com
          RHOST    tekelec11.com
          ARHOST   tekelec12.com
          LPORT    10003         RPORT      10001
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     10
          OPEN     NO            ALW        YES         RTXTHR   65535
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1

    ANAME assoc22
          LOC      1201          IPLNK PORT A,B         LINK     A
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    aricent21.com
          ALHOST   aricent22.com
          RHOST    tekelec21.com
          ARHOST   tekelec22.com
          LPORT    10003         RPORT      10001
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     1
          OPEN     NO            ALW        YES         RTXTHR   65535
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1

    IP Appl Sock/Assoc table is (4 of 4000) 1% full 
;

This example shows the associations when a primary remote host is provisioned and an alternate remote host is not provisioned:

rtrv-assoc:rhosttype=primary

    ipsig 10-02-10 17:37:49 GMT  EAGLE 46.0.0
                    CARD  IPLNK
    ANAME           LOC   PORT  LINK ADAPTER LPORT RPORT OPEN ALW
    assoc5          1101  A     A    M2PA    10002 10001 NO   YES
    assoc6          1102  A     A    M3UA    30002 30002 NO   NO
    assoc7          1102  B     A    SUA     20001 29011 NO   NO

    IP Appl Sock/Assoc table is (4 of 4000) 1% full 
;
rtrv-assoc:aname=m2pa1

    ANAME m2pa1
          LOC      1305          IPLNK PORT A           LINK     B1
          ADAPTER  M2PA          VER        M2PA RFC
          LHOST    e1011001.1305a
          ALHOST   ---
          RHOST    e1011501.1305a
          ARHOST   ---
          LPORT    2005          RPORT      2005
          ISTRMS   2             OSTRMS     2           BUFSIZE  200
          RMODE    LIN           RMIN       120         RMAX     800
          RTIMES   10            CWMIN      3000        UAPS     7
          OPEN     NO            ALW        YES         RTXTHR   0
          RHOSTVAL RELAXED       HBTIMER    500         M2PATSET 1

          LSN
          lsm2pa05s

rtrv-assoc

ipsig 16-11-18 17:37:49 GMT  EAGLE 46.5.0
                    CARD  IPLNK
    ANAME           LOC   PORT  LINK ADAPTER LPORT RPORT OPEN ALW BUFSIZE
    assoc5          1101  A     A40  M2PA    10002 10001 NO   YES   200 
    assoc6          1102  A     A50  M3UA    30002 30002 NO   NO    50
    assoc7          1102  B     B60  M3UA    20001 29011 NO   NO    50 

    IP Appl Sock/Assoc table is (4 of 4000) 1% full 
;