show interface composite-link

---

Displays information about composite links.

Syntax: show interface composite-link identifier

show interface composite-link access-list identifier

show interface composite-link identifier members

show interface composite-link identifier statistic {average | delta} sampleperiod

show interface composite-link [extension-counters | inflow-counters]

identifier	Identifies a specific composite link to display.
access-list	The name of a valid access list for the display of relevant statistics.
members	Displays information about the member links of the specified composite link.
extension-counters	Displays the extension counters for a specific composite-link.
inflow counters	Displays the inflow counters for a specific composite link.
sampleperiod	The length of the statistical sample in seconds. Range: 5 to 300 seconds. Default: none.

Description: Composite links are a number of individual links operating over SONET/SDH interfaces that collectively form a single virtual interface.

Use the show interface composite-link identifier syntax to display the specified composite link.

Use the show interface composite-link access-list identifier syntax to display the specified access list statistics.

Use the show interface composite-link identifier members syntax to display information about the member links of the specified composite link.

Use the show interface composite-link identifier statistic syntax to display statistics for the specified composite link. This command displays interface statistics taken over a specified period of time in seconds. The interface counters are collected at 5 second intervals in real time. The collection of statistics spans a time period of up to the last 5 minutes of traffic history. The show interface composite-link statistic command applies the specified statistic over the requested period of time and returns the result immediately.

The show interface composite-link statistic command uses two sample types: delta and average.

Use the delta sample type to display the change in value for each statistic during the specified sample period.

Use the average keyword to display the average change in statistic value per second over the sample period. This is calculated by dividing the delay by the sample period. For example, if the sample period is 15 seconds and the delta during the sample period is 1500, the average value is 1500/15=100.

The show interface composite-link statistic command will not return any data if the specified sample period has not been collected, i.e., shortly after reboot. An error messages of the form: "showSonetStatistics(): Error, can't get interface data for pos x/y/z" will be reported. The user may then re-issue the command after sufficient time has elapsed for the interface to have a complete set of data. This is done to prevent misleading output data. The data collection process starts approximately 30 seconds after the module is up.

Use the show interface composite-link extension-counters identifier command to display the extension counters for the specified composite link.

Use the show interface composite-link inflow-counters identifier command to display the inflow counters for the specified composite link.

Factory Default: None.

Command Mode: Executive and privileged.

Example 1: In the following example, the show interface composite-link identifier syntax is used to display information about the specified composite link:

router# show interface composite-link lowerCL1 Composite-link lowerCL1 is administratively down MPLS: administratively down MTU 4470 bytes Payload BW: configured 0 Mbit/Sec, available 0 Mbit/Sec Total BW: configured 0 Mbit/Sec, available 0 Mbit/Sec Member links: 0 configured, 0 up Thresholds: up 0 Mbit/Sec, down 0 Mbit/Sec Received: 0 bytes 0 directed packets, 0 multicast packets, 0 broadcast packets 0 discards, 0 errors, 0 unknown protocols 0 Bytes/Sec averaged, Bandwidth Utilized < 1% Transmitted: 0 bytes 0 directed packets, 0 multicast packets, 0 broadcast packets 0 discards, 0 errors 0 Bytes/Sec averaged, Bandwidth Utilized < 1%

The following table describes the fields in the display:

Table 4-4. Fields Displayed by show interface composite-link 

Field	Description
MPLS	Indicates the administrative status of MPLS.
MTU	Maximum Transmission Unit size for packets transmitted on the composite link.
Payload BW	Bandwidth of this interface computed by subtracting the bandwidth used for SONET overhead information from the total bandwidth. Valid values are: Configured: Aggregate bandwidth configured for this composite link. Available: Bandwidth not in use on the composite link.
Member links	Configured: Number of interfaces configured as part of the composite link. Up: Number of member links up.
Thresholds	Up: Bandwidth threshold for bringing up a composite link. Threshold is set using the open-threshold command. Down: Bandwidth threshold for taking down a composite link. Threshold is set using the close-threshold command.
Received:
bytes	The total number of bytes received over member links of this composite link.
directed packets	The number of unicast packets received on the composite link.
multicast packets	The number of multicast packets received on this composite link.
broadcast packets	The number of broadcast packets received on this composite link.
discards	The number of received packets purposely dropped during reception on this composite link.
errors	The number of errored packets received on this composite link.
unknown protocols	The number of packets received with an unknown protocol.
bytes/sec averaged	Bytes per second. Value is an Exponential Weighted Moving Average (EWMA) sampled over a period of 300 seconds (five minutes). EWMA puts more weight on recent data and less on past data.
% Bandwidth utilized	Percentage of the total available bandwidth of the composite link currently in use.
Transmitted:
bytes	The total number of bytes sent over member links of this composite link.
directed packets	The number of unicast packets sent on this composite link.
multicast packets	The number of multicast packets sent on this composite link.
broadcast packets	The number of broadcast packets sent on this composite link.
discards	The number of packets purposely dropped during transmission on this composite link.
errors	The number of packets sent in error on this composite link.
bytes/sec averaged	Bytes per second. Value is an Exponential Weighted Moving Average (EWMA) sampled over a period of 300 seconds (five minutes). EWMA puts more weight on recent data and less on past data.
% Bandwidth utilized	Percentage of the total available bandwidth of the composite link currently in use.

Example 2: In the following example, the show interface composite-link identifier members syntax is used to display the administrative status of member links:

router# show interface composite-link LA2Bos members Members of composite-link LA2Bos POS 1/1/1 member-link is up POS 1/1/2 member-link is administratively down POS 1/1/3 member-link is administratively down POS 1/1/4 member-link is administratively down

Example 3: In the following example, the show interface composite-link extension-counters identifier syntax is used to display the extension counters for the specified composite-link:

router#show interface composite-link extension-counters LA2Bos Bad Control Field: 0 CRC Error: 0 Bad IPv4 Header Checksum: 0 Maximum Packet Length Exceeded: 0 IPv4 Packets Truncated: 0 IPv6 Packets Truncated: 0 IPv4 Packet Header Length Error: 0 IP Version Error: 0 Me FIFO Packets Discarded: 0 Runt Packet: 0 Page Allocation Error: 0 Packet Descriptors Discarded: 0 Non-IP Packets(PPP/ISIS): 40 IPv4 Packets: 0 IPv6 Packets: 0 Allocated Packet Descriptors Discarded: 0 IPv6 Packets Too Short: 0 IPv4 Packets Too Short: 0 Page Reply Parity Errors: 0 Octets Received: 576 Transmit Packet Descriptors Received: 40 Pings Received: 0 Autotunnelled Packets Received: 0 Octets Transmitted: 600 Packets Transmitted: 40 Packet Underflow: 0 Packets Discarded: 0

Refer to show interface pos for a description of the fields in the display.

Example 4: In the following example, the show interface statistic displays delta input and output statistics for the composite-link interface named rbw:

router#show interface composite-link rbw statistic delta 30 Statistics for composite-link rbw: Delta over 30 seconds Input: Octets 1200 bytes UnicastPkts 0 packets MulticastPkts 0 packets BroadcastPkts 0 packets Discards 0 Errors 0 Output: Octets 0 bytes UnicastPkts 0 packets MulticastPkts 0 packets BroadcastPkts 0 packets Discards 0 Errors 0

The following table describes the fields in the display

Table 4-5. Fields Displayed by show interface statistics 

Field	Description
Input
Octets	The number of octets received on this interface over the specified sample period.
UnicastPkts	The number of unicast packets received on this interface over the specified sample period.
MulticastPkts	The number of multicast packets received on this interface over the specified sample period.
BroadcastPkts	The number of broadcast packets received on this interface over the specified sample period.
Discards	The number of discarded packets received on this interface over the specified sample period.
Errors	The number of errors received on this interface over the specified sample period.
Output
Octets	The number of octets sent by this interface over the specified sample period.
UnicastPkts	The number of unicast packets sent by this interface over the specified sample period.
MulticastPkts	The number of multicast packets sent by this interface over the specified sample period.
BroadcastPkts	The number of broadcast packets sent by this interface over the specified sample period.
Discards	The number of discarded packets received on this interface over the specified sample period.
Errors	The number of errors received on this interface over the specified sample period.

.

Related Commands: interface
show interface loopback
show interface pos

Copyright © 2005 Avici Systems Inc.
Avici® and TSR® is a registered trademark of Avici Systems Inc.
IPriori™, Composite Links™, SSR™, QSR, and NSR® are trademarks of Avici Systems Inc.

   Source File Name: Interface_Cmd.fm
    HTML File Name: Interface_Cmd34.html
    Last Updated: 02/25/05 at 14:28:34

Please email suggestions and comments to: doc@avici.com