display oam

Use display oam to display the information about an Ethernet OAM connection, including connection status, information contained in Ethernet OAM packet header, and Ethernet OAM packet statistics.

Syntax

display oam { local | remote } [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

local: Displays the Ethernet OAM connection information of the local end.

remote: Displays the Ethernet OAM connection information of the remote end.

interface interface-type interface-number: Specifies a port by its type and number.

Usage guidelines

If you do not specify the interface keyword, this command displays information about all the Ethernet OAM connections.

Examples

# Display information about the Ethernet OAM connection established on all local ports.

<Sysname> display oam local
----------- [Ten-GigabitEthernet1/0/1] -----------
 Enable status     : Enable
 Loopback status   : No loopback
 Link status       : UP
 OAM mode          : Active
 PDU               : ANY
 Mux action        : FWD
 Par action        : FWD

# Display information about the Ethernet OAM connection established on the local port Ten-GigabitEthernet 1/0/1.

<Sysname> display oam local interface ten-gigabitethernet 1/0/1
 Enable status     : Enable
 Loopback status   : No loopback
 Link status       : UP
 OAM mode          : Active
 PDU               : ANY
 Mux action        : FWD
 Par action        : FWD
 Flags
   Link fault        : Not occurred
   Dying gasp        : Not occurred
   Critical event    : Not occurred
   Local evaluating  : COMPLETE
   Remote evaluating : COMPLETE
 Packets statistics
   Packet type                       Sent                   Received
   -----------------------------------------------------------------
   OAMPDU                            100                    80
   OAMInformation                    64                     60
   OAMEventNotification              36                     20
   OAMUniqueEventNotification        36                     10
   OAMDuplicateEventNotification     0                      10

Table 1: Command output

Field

Description

Ten-GigabitEthernet1/0/1

Information on Ten-GigabitEthernet 1/0/1.

Enable status

Ethernet OAM state (enabled or disabled).

Loopback status

Ethernet OAM loopback state:

  • No loopback.

  • Remote loopback.

  • Local loopback.

Link status

Link state (UP or DOWN).

OAM mode

Local Ethernet OAM mode:

  • ActiveThe port is operating in active Ethernet OAM mode.

  • PassiveThe port is operating in passive Ethernet OAM mode.

PDU

The way in which the local end processes Ethernet OAMPDUs:

  • RX_INFOThe port only receives Information OAMPDUs and does not send any Ethernet OAMPDUs.

  • LF_INFOThe port only sends the Information OAMPDUs without Information TLV triplets and with their link error flag bits being set.

  • INFOThe port sends and receives only Information OAMPDUs.

  • ANYThe port sends and receives Ethernet OAMPDUs of any type.

Mux action

Operating mode of the local transmitter:

  • FWDThe port can send any packets.

  • DISCARDThe port only sends Ethernet OAMPDUs.

Par action

Operating mode of the local receiver:

  • FWDThe port can receive any packets.

  • DISCARDThe port only receives Ethernet OAMPDUs.

Flags

Local flags inserted in the local flag fields of the Ethernet OAMPDUs sent.

Link fault

Indicates whether an Ethernet OAM link error is present.

Dying gasp

Indicates whether a fatal error is present.

Critical event

Indicates whether a critical error is present.

Local evaluating

Indicates whether the local-to-remote configuration negotiation is complete:

  • COMPLETEThe negotiation is completed.

  • NOTCOMPLETEThe negotiation is uncompleted.

Remote evaluating

Indicates whether the remote-to-local configuration negotiation is complete:

  • COMPLETEThe negotiation is completed.

  • NOTCOMPLETEThe negotiation is uncompleted.

  • RESERVEDThe field is reserved and the negotiation is uncompleted.

  • UNSATISFIEDThe remote end is not satisfied with the local configuration and the negotiation is uncompleted.

Packets statistics

Statistics about Ethernet OAMPDUs sent and received.

OAMPDU

Total number of the Ethernet OAMPDUs sent and received.

OAMInformation

Number of the Information OAMPDUs sent and received.

OAMEventNotification

Number of the Event notification OAMPDUs sent and received.

OAMUniqueEventNotification

Number of the unduplicated Event notification OAMPDUs sent or received uniquely.

OAMDuplicateEventNotification

Number of the duplicate Event notification OAMPDUs sent or received.

# Display the Ethernet OAM information about all remote ports.

<Sysname> display oam remote
----------- [Ten-GigabitEthernet1/0/1] -----------
 OAM mode          : Active
 MAC address       : 3822-d6a2-a800
 MTU size          : 1500
 Mux action        : FWD
 Par action        : FWD

# Display the Ethernet OAM information about the peer port Ten-GigabitEthernet 1/0/1.

<Sysname> display oam remote interface ten-gigabitethernet 1/0/1
 OAM mode          : Active
 MAC address       : 3822-d6a2-a800
 MTU size          : 1500
 Mux action        : FWD
 Par action        : FWD
 Configuration
   Unidirectional    : Not supported
   Remote loopback   : Supported
   Link events       : Supported
   MIB retrieval     : Not supported
 Flags
   Link fault        : Not occurred
   Dying gasp        : Not occurred
   Critical event    : Not occurred
   Local evaluating  : COMPLETE
   Remote evaluating : COMPLETE

Table 2: Command output

Field

Description

Ten-GigabitEthernet1/0/1

Information on Ten-GigabitEthernet 1/0/1.

OAM mode

Local Ethernet OAM mode:

  • ActiveThe port operates in the active Ethernet OAM mode.

  • PassiveThe port operates in the passive Ethernet OAM mode.

MAC address

MAC address of the remote end.

MTU size

MTU size, in bytes.

Mux action

Operating mode of the remote transmitter:

  • FWDThe port can send any packets.

  • DISCARDThe port only sends Ethernet OAMPDUs.

Par action

Operating mode of the remote receiver:

  • FWDThe port can receive any packets.

  • DISCARDThe port only receives Ethernet OAMPDUs.

  • LBThe local receiver is in loopback state. All the packets, other than Ethernet OAMPDUs, received on the local receiver are returned to their sources along their original routes.

Configuration

Configuration of the remote Ethernet OAM entity.

Unidirectional

Indicates whether unidirectional transmission is supported.

Remote loopback

Indicates whether Ethernet OAM remote loopback is supported.

Link events

Indicates whether Ethernet OAM link error events are supported.

MIB retrieval

Indicates whether MIB variable retrieval is supported.

Flags

Values of the peer Ethernet OAM flag fields in OAM packets.

Link fault

Indicates whether an Ethernet OAM link error is present.

Dying gasp

Indicates whether a fatal error is present.

Critical event

Indicates whether a critical error is present.

Local evaluating

Indicates whether the local-to-remote configuration negotiation is complete:

  • COMPLETEThe negotiation is completed.

  • NOTCOMPLETE—The negotiation is uncompleted.

  • RESERVEDThe field is reserved and the negotiation is uncompleted.

  • UNSATISFIED—The remote end is not satisfied with the local configuration and the negotiation is uncompleted.

Remote evaluating

Indicates whether the remote-to-local configuration negotiation is complete:

  • COMPLETEThe negotiation is completed.

  • NOTCOMPLETEThe negotiation is uncompleted.

  • UNSATISFIED—The remote end is not satisfied with the local configuration and the negotiation is uncompleted.

Related commands

reset oam