linkinfo

This command is used to display the state of a signaling link and to retrieve/clear a specified event log for a signaling link. The signaling link is any valid signaling link provisioned for the card. For IPLIMx cards, the a:a7 - b:b7 signaling links are supported. For IPSG ENET cards, the a:a15 - b:b15 signaling links are supported. For IPSG SLIC cards, the a:a63 - b:b63 signaling links are supported.

For E5-E1T1-B cards, the a:a31 - b:b31 signaling links are supported. For E5-ATM-B cards, the a, a1, b links are supported. E5-E1T1-B and E5-ATM-B cards only support the -c option, the output will display the buffer information and congestion levels information.

Options

Options and option parameters that are underlined indicate that a value must be specified for that option or parameter. For example, the linkinfo command option -i has the parameter event. The event to be included in the report can be specified, as in the command linkinfo a -a -i m2pa. Do not enter the underlined option or parameter; enter a value for the information represented by the underlined option or parameter.

Note:

For E5-E1T1-B and E5-ATM-B cards, -c and -h are the only valid options.

-h

This option provides help information for the command.

port

This option specifies the signaling link port.

Range:: a, A1: A63-B, B1:B63

-a

This option displays the adapter layer interface (ALI) log for the specified signaling link. For M3UA associations the link -a option is used to display the UA event log. This command logs information on an association basis. The link parameter is used to obtain this report on IPSG instead of the association name. This information is currently provided by the ualog command on IPGWx cards.

-c

This option displays congestion tuning parameters for M3UA and M2PA links. The report is enhanced to include card level congestion thresholds and the high-water mark for IPSG cards.

This option also displays congestion levels for E5-E1T1-B and E5-ATM-B cards.

-i event

This option includes (does not filter) a link event in the log. For IPSG cards, this option may be used to include or exclude events for the ali and link logs. Valid events for the ALI event log are ua and service.

Range:: ali, all, data, l2l3, l3l2, m2pa, state, ua, service
all-include all events

-m

This option displays acknowledgment times on an M2PA connection (minimum, maximum, weighted average, last recorded). For IPSG cards, this measurement is supported for only IPSG-M2PA links.

-r

This option resets (clears) the event log for the specified signaling link. This option is valid only with the -a option or -l option.

-s

This option displays the state information for the specified signaling link. For the IPSG cards, this option is enhanced to display M3UA signaling link status.

-v

This option displays the link event filter configuration.

-x event

This option excludes (filters) a link event in the log. For IPSG cards, this option may be used to include or exclude events for the ali and link logs. Valid events for the ALI event log are ua and service.

Range:: ali, all, data, l2l3, l3l2, m2pa, state, ua, service
all-exclude all events

Example

Provide help information for the command.

pass:loc=1301:cmd="linkinfo -h"

Set the filter to include ua events in the ua log report.

pass:loc=1304:cmd="linkinfo a -i ua"

Set the filter to include service events in the ua log report.

pass:loc=1304:cmd="linkinfo a -i service"

Display the ua log report for signaling link a.

pass:loc=1304:cmd="linkinfo a -a"

Display the ALI event log for signaling link a1.

pass:loc=1301:cmd="linkinfo a1 -a"

Reset/clear the link event log for signaling link a1.

pass:loc=1301:cmd="linkinfo a1 -l -r"

Clear the ua log report for signaling link a.

pass:loc=1304:cmd="linkinfo a -a -r"

Display the state information for signaling link a1.

pass:loc=1301:cmd="linkinfo a1 -s"

Display acknowledgement times for an M2PA connection on signaling link b1.

pass:loc=3315:cmd="linkinfo b1 -m"

Display congestion tuning information for an IPSG-M3UA signaling link and Display congestion levels and buffer information for signaling links on E5-E1T1-B and E5-ATM-B cards.

pass:loc=1301:cmd="linkinfo a -c "

Dependencies

None

Notes

None

Output

This example shows the output for the help command on IPSG cards:

pass:loc=1301:cmd="linkinfo" or

pass:loc=1301:cmd="linkinfo -h"


    tekelecstp 16-05-25 12:38:16 EST  EAGLE5 46.4.0.0.0-69.3.1

    PASS: Command sent to card
;

    tekelecstp 16-05-25 12:38:16 EST  EAGLE5 46.4.0.0.0-69.3.1

    Usage: LINKINFO port [-a [-r]] [-h] [-l [-r]] 
               [-m [-r]] [-s] [-v] [-x event]
    Options:
        link      Signaling link port: a, b, a1, b1,………………a63, b63
        -a        Display the ALI event log for a signaling link
        -c        Display Congestion Tuning Information for a signaling link
        -h        Displays this message
        -i event  Include (do not filter) a link event type in the log
        -l        Displays the event log for a signaling link
        -m        Display Link Measurements
        -r        Resets the specified event log for a signaling link
        -s        Displays the state information for a signaling link
        -v        View the link event filter configuration
        -x event  Exclude (filter) a link event type from the log

    Valid 'event' for link event log is ali, all, data, 1213, 1312, m2pa, state
                     
;

   rlghncxa03w 04-07-29 11:31:09 EST  EAGLE5 31.6.0

   LINKINFO command complete

;

This example shows the output for the help command on E5-E1T1-B and E5-ATM-B cards:

pass:loc=1101:cmd="linkinfo" or

pass:loc=1101:cmd="linkinfo -h"


    tekelecstp 02-01-25 05:31:18 MST  46.0.0-65.11.0
    PASS: Command sent to card
;

Command Accepted - Processing
tekelecstp 02-01-25 05:31:19 MST  46.0.0-65.11.0
LINKINFO: command complete

;

Command Executed
tekelecstp 02-01-25 05:31:18 MST  46.0.0-65.11.0
Usage: LINKINFO link [-c ]
    Options:
        link      Signaling link: a, b, a1..a31, b1..b31
        -c        Display Congestion Tuning Information,RTB,TB and L3-L2 buffer counts for a signaling link

;

This example resets/clears the link event log for signaling link A1:

pass:loc=1301:cmd="linkinfo a1 -l
                -r"


    rlghncxa03w 04-07-29 11:31:09 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

    rlghncxa03w 04-07-29 11:31:09 EST  EAGLE5 31.6.0

    LINKINFO command being processed

;

    rlghncxa03w 04-07-29 11:31:09 EST  EAGLE5 31.6.0
    LINKINFO command complete

;

This example shows acknowledgment times for an IPLIMx M2PA connection on signaling link B1:

pass:loc=1301:cmd="linkinfo b1
                -m"


    rlghncxa03w 04-07-29 11:31:09 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

    rlghncxa03w 04-07-29 11:31:09 EST  EAGLE5 31.6.0

    LINKINFO: Command In Progress

;
    rlghncxa03w 04-07-29 11:31:09 EST  EAGLE5 31.6.0
    IPLIMx M2PA Measurements Information for Port B1


    Measured M2PA Traffic Acknowledgement Times

        Minimum acknowledge time         : 14
        Maximum acknowledge time         : 35
        Weighted Average acknowledge time: 17
        Last recorded acknowledge time   : 20

    end of report

;

    rlghncxa03w 04-07-29 11:31:09 EST  EAGLE5 31.6.0
;

This example shows state information for signaling link A1:

pass:loc=1301:cmd="linkinfo a1
                -s"

   rlghncxa03w 03-07-29 11:31:09 EST  EAGLE5 30.0.0
    PASS: Command sent to card
;

    rlghncxa03w 03-07-29 11:31:09 EST  EAGLE5 30.0.0

    LINKINFO command being processed

;

    rlghncxa03w 03-07-29 11:31:09 EST  EAGLE5 30.0.0
    SLK      LINKINFO STATE
    1301,A1  OOS      CONNECTING

    
    end of report
;
    rlghncxa03w 03-07-29 11:31:09 EST  EAGLE5 30.0.0
    LINKINFO command complete

;

Output for IPSG Card

This example shows the signaling link event log for an IPSG-M3UA link:

pass:loc=1304:cmd="linkinfo a
                -l"

    Command Accepted - Processing

    eagle10110 08-01-16 16:52:59 EST  EAGLE 38.0.0
    pass:loc=1304:cmd="linkinfo a  -l"
    Command entered at terminal #3.
;

    eagle10110 08-01-16 16:52:59 EST  EAGLE 38.0.0
    PASS: Command sent to card
;

    eagle10110 08-01-16 16:52:59 EST  EAGLE 38.0.0

    IP7 Layer 2 Link Events for Link A

    08-01-16 15:03:37.080 LINK_STATE_INHIBITED
    08-01-16 15:05:23.510 L3_L2_EMERGENCY_CEASE
    08-01-16 15:05:23.510 L3_L2_START
    08-01-16 15:05:23.510 LINK_STATE_NOT_ALIGNED
    08-01-16 15:53:02.660 ASP_UP
    08-01-16 15:53:02.660 LINK_STATE_ALIGNED_READY
    08-01-16 16:19:45.755 ASP_ACTIVE
    08-01-16 16:19:45.755 LINK_STATE_INS
    08-01-16 16:19:45.755 L2_L3_IN_SERVICE
    08-01-16 16:19:45.780 L3_L2_LINKSET_ALLOWED


    end of report

;

This example shows the signaling link event for an IPSG-M2PA link:

pass:loc=1314:cmd="linkinfo b2
                -l"

    eagle10110 08-01-16 16:46:05 EST  EAGLE 38.0.0
 
    IP7 Layer 2 Link Events for Link B2

    08-01-16 16:45:26.050 L3_L2_START
    08-01-16 16:45:26.050 L2_L3_OUT_OF_SERVICE
    08-01-16 16:45:26.060 RETRIEVAL_COMPLETE
    08-01-16 16:45:26.860 L3_L2_EMERGENCY
    08-01-16 16:45:26.860 L3_L2_START
    08-01-16 16:45:26.860 L2_L3_OUT_OF_SERVICE
    08-01-16 16:45:26.870 RETRIEVAL_COMPLETE
    08-01-16 16:45:27.215 IP_CONN_OPENED
    08-01-16 16:45:27.215 LINK_STATE_CONNECTING
    08-01-16 16:45:27.215 IP_CONN_ALLOWED
    08-01-16 16:45:27.225 IP_CONN_CONNECTED
    08-01-16 16:45:27.225 M2PA_LSO_TRANSMITTED
    08-01-16 16:45:27.225 LINK_STATE_CONNECTED
    08-01-16 16:45:27.230 M2PA_LSO_RECEIVED
    08-01-16 16:45:27.670 L3_L2_EMERGENCY
    08-01-16 16:45:27.670 L3_L2_START
    08-01-16 16:45:27.670 M2PA_LSA_TRANSMITTED
    08-01-16 16:45:27.670 LINK_STATE_NOT_ALIGNED
    08-01-16 16:45:27.680 M2PA_LSA_RECEIVED
    08-01-16 16:45:27.680 M2PA_LSPE_TRANSMITTED
    08-01-16 16:45:27.680 LINK_STATE_ALIGNED
    08-01-16 16:45:27.685 M2PA_LSPE_RECEIVED
    08-01-16 16:45:27.685 LINK_STATE_PROVING
    08-01-16 16:45:27.890 M2PA_T16_EXPIRED
    08-01-16 16:45:28.085 M2PA_T16_EXPIRED
    08-01-16 16:45:28.185 M2PA_T4_EXPIRED
    08-01-16 16:45:28.185 M2PA_LSR_TRANSMITTED
    08-01-16 16:45:28.185 LINK_STATE_ALIGNED_READY
    08-01-16 16:45:28.195 M2PA_LSR_RECEIVED
    08-01-16 16:45:28.195 L2_L3_IN_SERVICE
    08-01-16 16:45:28.195 M2PA_LSR_TRANSMITTED
    08-01-16 16:45:28.195 LINK_STATE_INS
    08-01-16 16:45:28.200 M2PA_LSR_RECEIVED


    end of report

;

    eagle10110 08-01-16 16:46:05 EST  EAGLE 38.0.0

    LINKINFO: Command Complete
;

This example shows sets the filter to include UA events in the UA log report for signaling link A:

pass:loc=1304:cmd="linkinfo
                a -i
                ua"

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0

    Link event type (ua) is logged for link A

    end of report

;

This example sets the filter to include service events in the UA log report for signaling link A:

pass:loc=1304:cmd="linkinfo
                a -i
                service"

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0

    Link event type (service) is logged for link A

    end of report

;

This example shows the UA log report for signaling link A:

pass:loc=1304:cmd="linkinfo a
                -a"

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0 


    Adapter Layer Events for Link A

    UALOG:  UA event history log
            UA Version: 01
            ASP ID: undefined
            User Adapter Implemented: M3UA RFC
            Current settings: -i service ua

    Date      Time           Event
    -----------------------------------------------
    08-01-16  15:51:45.890   IP Conn Established
    08-01-16  15:51:45.890   Transition to SERVER_DOWN
                             (RC=0000000004)
    08-01-16  15:53:02.660   ASPUP PDU Received (ASP ID=undefined)
    08-01-16  15:53:02.660   Transition to SERVER_INACTIVE
                             (RC=0000000004)
    08-01-16  15:53:02.660   ASP to SLK Up
    08-01-16  15:53:02.660   Link Activated
    08-01-16  15:53:02.660   ASPUPACK PDU Transmitted
    08-01-16  15:53:02.660   AS INACTIVE NTFY PDU Transmitted (RC=0000000004)
    08-01-16  16:19:45.755   ASPACTIVE PDU Received (RC=none)
    08-01-16  16:19:45.755   ASPACTIVEACK PDU Transmitted (RC=0000000004)
    08-01-16  16:19:45.755   Transition to SERVER_ACTIVE    LOADSHARE
                             (RC=0000000004)
    08-01-16  16:19:45.755   ASP to SLK Active
    08-01-16  16:19:45.780   AS Active
    08-01-16  16:19:45.780   AS ACTIVE NTFY PDU Transmitted (RC=0000000004)


    end of report

;

This example clears the UA log report for signaling link A:

pass:loc=1304:cmd="linkinfo a -a
                -r"

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0 

    LINKINFO: Command Complete

;

This example shows link measurement information for an IPSG-M2PA signaling link:

pass:loc=1301:cmd="linkinfo b2 -m
                "

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE5 38.0.0
    M2PA Measurements Information for Link B2


    Measured M2PA Traffic Acknowledgement Times

        Minimum acknowledge time         : 16
        Maximum acknowledge time         : 44
        Weighted Average acknowledge time: 16
        Last recorded acknowledge time   : 16


    end of report

;

This example shows state information for an IPSG-M3UA signaling link:

pass:loc=1301:cmd="linkinfo a -s
                "

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0  
   
    IP7 Layer 2 Link State Information for Link A

    LINK_STATE_ALIGNED             ASP_STATE_SERVER_DOWN


    end of report

;

This example shows state information for an IPSG-M2PA signaling link:

pass:loc=1314:cmd="linkinfo b2
                -s"

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0  

    IP7 Layer 2 Link State Information for Link B2

    LINK_STATE_INS                 IP_CONN_STATE_ESTABLISHED


    end of report

;

This example shows congestion tuning information for an IPSG-M3UA signaling link:

pass:loc=1301:cmd="linkinfo a -c
                "

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0
   
    Congestion Tuning Information for Link A

    High-Water Mark             : 0

    High-Water Mark Date & Time : 00-00-00 00:00:00.000


    HMCG SLK Congestion Threshold Values

        Danger of Congestion Onset : 240
        Abatement Level-1          : 241
        Onset Level-1              : 480
        Abatement Level-2          : 481
        Discard Level-1            : 600
        Onset Level-2              : 605
        Abatement Level-3          : 606
        Discard Level-2            : 720
        Onset Level-3              : 725
        Discard Level-3            : 840
        Maximum Buffers for L2     : 960


    HMCG Card-Level Congestion Threshold Values

        Danger of Congestion Onset : 2500
        Abatement Level-1          : 2501
        Onset Level-1              : 5000
        Abatement Level-2          : 5001
        Discard Level-1            : 7601
        Onset Level-2              : 6251
        Abatement Level-3          : 6252
        Discard Level-2            : 7601
        Onset Level-3              : 7501
        Discard Level-3            : 7601
        Maximum Buffers for L2     : 10000
        High Water Mark            : 0


    end of report

;

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0

    LINKINFO: Command Complete

;

This example shows congestion tuning information for an IPSG-M2PA signaling link:

pass:loc=1301:cmd="linkinfo b2 -c
                "

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0
       Congestion Tuning Information for Link B2


    RETX Queue Depth threshold : 240

    High-Water Mark             : 0

    High-Water Mark Date & Time : 00-00-00 00:00:00.000


    HMCG SLK Congestion Threshold Values

        Danger of Congestion Onset : 120
        Abatement Level-1          : 121
        Onset Level-1              : 240
        Abatement Level-2          : 241
        Discard Level-1            : 300
        Onset Level-2              : 305
        Abatement Level-3          : 306
        Discard Level-2            : 360
        Onset Level-3              : 365
        Discard Level-3            : 420
        Maximum Buffers for L2     : 480


    HMCG Card-Level Congestion Threshold Values

        Danger of Congestion Onset : 2500
        Abatement Level-1          : 2501
        Onset Level-1              : 5000
        Abatement Level-2          : 5001
        Discard Level-1            : 7601
        Onset Level-2              : 6251
        Abatement Level-3          : 6252
        Discard Level-2            : 7601
        Onset Level-3              : 7501
        Discard Level-3            : 7601
        Maximum Buffers for L2     : 10000
        High Water Mark            : 2


    end of report

;

    rlghncxa03w 08-01-29 11:31:09 EST  EAGLE 38.0.0


    LINKINFO: Command Complete

;

This example shows congestion levels for signaling links on E5-E1T1-B and E5-ATM-B cards:

For SS7HC:


Command Executed
    tekelecstp 02-01-24 00:38:06 MST  46.0.0-65.11.0
    Congestion Tuning Information for Link A
    HMCG SLK Congestion Threshold Values
        Danger of Congestion Onset : 59
        Abatement Level-1          : 60
        Onset Level-1              : 80
        Discard Level-1            : 99
        Abatement Level-2          : 81
        Onset Level-2              : 101
        Discard Level-2            : 109
        Abatement Level-3          : 102
        Onset Level-3              : 111
        Discard Level-3            : 120
        Maximum Buffers for L2     : 130

    TB count                   : 0

    RTB count                  : 0

    L3 L2 MSU count            : 0
;
    tekelecstp 02-01-24 00:38:06 MST  46.0.0-65.11.0
    LINKINFO: Command Complete

For ATMHC:


Command Executed
    tekelecstp 02-01-24 00:36:45 MST  46.0.0-65.11.0
    Congestion Tuning Information for Link A
    HMCG SLK Congestion Threshold Values
        Danger of Congestion Onset : 885
        Abatement Level-1          : 900
        Onset Level-1              : 1200
        Discard Level-1            : 1800
        Abatement Level-2          : 1215
        Onset Level-2              : 1515
        Discard Level-2            : 1800
        Abatement Level-3          : 1530
        Onset Level-3              : 1665
        Discard Level-3            : 1800
        Maximum Buffers for L2     : 1950

    TB count                   : 0

    RTB count                  : 10

    L3 L2 MSU count            : 0
;
    tekelecstp 02-01-24 00:36:45 MST  46.0.0-65.11.0
    LINKINFO: Command Complete

This example shows state information when graceful shutdown has occurred:

pass:loc=1305:cmd="linkinfo -a
            a"

    rlghncxa03w 09-04-29 11:31:09 EST  EAGLE 41.0.0 

    Adapter Layer Events for Link A

    UALOG:  UA event history log
            UA Version: 01
            ASP ID: undefined
            User Adapter Implemented: M3UA RFC
            Current settings: -i ua
                              -x service

    Date      Time           Event
    -----------------------------------------------
    08-10-08  09:29:15.705   Management IP Conn Close
    08-10-08  09:29:15.705   Transition to SERVER_SHUTDOWN
                             (RC=0000000002)
    08-10-08  09:29:15.705   ASP to SLK Down
    08-10-08  09:29:15.705   Link Not Aligned
    08-10-08  09:29:15.705   UA Graceful Shutdown
    08-10-08  09:29:15.710   UA Shutdown Complete
    08-10-08  09:29:15.710   Transition to IDLE
                             (RC=0000000002)

    end of report