show ports txerrors

show ports {port_list | stack-ports stacking-port-list} txerrors {no-refresh | refresh}

Description

Displays real-time transmit error statistics. The switch automatically refreshes the output unless otherwise specified.

Syntax Description

port_list Specifies one or more ports or slots and ports.
stacking-port-list Specifies one or more stacking slot ports for display. Applies to SummitStack and Summit family switches only.
no-refresh Specifies that auto-refresh is disabled. The output provides a real-time snapshot of the transmit errors at the time the command is issued. This setting is not saved.
refresh Specifies a continuous refresh of output.

Default

The switch automatically refreshes the output.

Usage Guidelines

If you do not specify a port number or range of ports, error statistics are displayed for all ports.

If you do not specify the no-refresh parameter, the switch automatically refreshes the output (this is the default behavior).

If you specify the no-refresh parameter, the output provides a snapshot of the real-time transmit error statistics at the time you issue the command and displays the output in page-by-page mode (this was the default behavior in ExtremeXOS 11.2 and earlier). This setting is not saved; therefore, you must specify the no-refresh parameter each time you want a snapshot of the port transmit errors.

This status information may be useful for your technical support representative if you have a network problem.

Collected Port Transmit Error Information

The switch collects the following port transmit error information:
  • Port Number.

  • Link State—The current state of the link. Options are:
    • Active (A)—The link is present at this port.

    • Ready (R)—The port is ready to accept a link.

    • Not Present (NP)—The port is configured, but the module is not installed in the slot (modular switches only).

    • Loopback (L)—The port is in Loopback mode.

  • Transmit Collisions (TX Coll)—The total number of collisions seen by the port, regardless of whether a device connected to the port participated in any of the collisions.

  • Transmit Late Collisions (TX Late Coll)—The total number of collisions that have occurred after the port‘s transmit window has expired.

  • Transmit Deferred Frames (TX Deferred)—The total number of frames that were transmitted by the port after the first transmission attempt was deferred by other network traffic.

  • Transmit Errored Frames (TX Errors)—The total number of frames that were not completely transmitted by the port because of network errors (such as late collisions or excessive collisions).

  • Transmit Lost Frames (TX Lost)—The total number of transmit frames that do not get completely transmitted because of buffer problems (FIFO underflow).

  • Transmit Parity Frames (TX Parity)—The bit summation has a parity mismatch.

Port Monitoring Display Keys

For information about the available port monitoring display keys, see the show ports statistics command.

Example

The following command displays transmit error statistics for slot 5, ports 4 through 7 on a modular switch with auto-refresh disabled:

show ports 5:4-5:7 txerrors no-refresh

The following is sample output from this command:

Port Transmission errors
Port         Link    Tx      Tx          Tx          Tx        Tx     Tx
State   Coll    Late coll   Deferred    Errors    Lost   Parity
================================================================================
5:4         R        0        0          0         0        0       0
5:5         R        0        0          0         0        0       0
5:6         R        0        0          0         0        0       0
5:7         R        0        0          0         0        0       0
================================================================================
Link State: A-Active, R-Ready, NP-Port not present, L-Loopback

The following command displays transmit error statistics for all ports on a Summit switch:

show ports txerrors

The following is a truncated sample output from this command:

Port Tx Error Monitor                               Tue Jul  5 15:07:13 UTC 2005
Port       Link     Tx        Tx          Tx          Tx       Tx       Tx
State   Coll      Late coll   Deferred    Errors   Lost     Parity
===========================================================================
1       R         0            0           0         0         0         0
2       R         0            0           0         0         0         0
3       R         0            0           0         0         0         0
4       R         0            0           0         0         0         0
5       R         0            0           0         0         0         0
6       R         0            0           0         0         0         0
7       R         0            0           0         0         0         0
8       R         0            0           0         0         0         0
9       R         0            0           0         0         0         0
10      R         0            0           0         0         0         0
11      R         0            0           0         0         0         0
12      R         0            0           0         0         0         0
13      R         0            0           0         0         0         0
14      R         0            0           0         0         0         0
15      R         0            0           0         0         0         0
16      R         0            0           0         0         0         0
17      R         0            0           0         0         0         0
===========================================================================
Link State: A-Active, R-Ready, NP-Port Not Present, L-Loopback
0->Clear Counters  U->page up  D->page down ESC->exitPort Tx Error

History

This command was first available in ExtremeXOS 10.1.

The link state information was updated to include NP-Port not present in ExtremeXOS 11.2.

Support for the auto-refresh functionality and the no-refresh parameter were added in ExtremeXOS 11.3. Auto-refresh continually updates the display. The no-refresh parameter takes a real-time snapshot of the display at the time you issue the command.

The refresh keyword was added in ExtremeXOS 16.1.

Platform Availability

This command is available on all platforms.