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

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

Examples

# Display the local OAM connection information.

<Sysname> display oam local

Port : Ethernet1/0/1

Link Status : Up

EnableStatus : Enable

Local_oam_mode : Active Local_pdu : ANY

Local_mux_action : FWD Local_par_action : DISCARD

Port : Ethernet1/0/2

Link Status : Down

EnableStatus : Enable

Local_oam_mode : Active Local_pdu : LF_INFO

Local_mux_action : FWD Local_par_action : FWD

Table 1-1 Description on the fields of the display oam local command

Field	Description
Port	Port index
Link Status	Link status
EnableStatus	OAM state (enabled or disabled)
Local_oam_mode	Local OAM mode, which can be: l Active, indicating the port operates in the active OAM mode l Passive, indicating the port operates in the passive OAM mode
Local_pdu	The way in which OAMPDUs of different types are processed locally. This field can be: l RX_INFO, indicating the port only receives Information OAMPDUs and does not send OAMPDUs. l LF_INFO, indicating the port only sends the Information OAMPDUs without Information TLV triplets and with their link error flag bits being set l INFO, indicating the port only sends and receives Information OAMPDUs l ANY, indicating the port sends and receives OAMPDUs of any types
Local_mux_action	Local sending mode, which can be: l FWD, indicating the port can send any packets l DISCARD, indicating the port only sends OAMPDUs
Local_par_action	Local receiving mode, which can be: l FWD, indicating the port can receive any packets l DISCARD, indicating the port only receives OAMPDUs l LB, indicating OAM loopback testing is enabled on the port. In this case, all the non-OAMPDU packets received are returned to their sources along the ways they come.

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

<Sysname> display oam local interface ethernet 1/0/1

Port : Ethernet1/0/1

Link Status : Up

EnableStatus : Enable

Local_oam_mode : Active Local_pdu : ANY

Local_mux_action : FWD Local_par_action : FWD

OAMLocalFlagsField :

--------------------------------------------------------------------------

Link Fault : 0 Dying Gasp : 0

Critical Event : 0 Local Evaluating : COMPLETE

Remote Evaluating : COMPLETE

Packets statistic :

Packets Send Receive

--------------------------------------------------------------------------

OAMPDU 645 648

OAMInformation 645 648

OAMEventNotification 0 --

OAMUniqueEventNotification -- 0

OAMDuplicateEventNotification -- 0

Table 1-2 Description on the fields of the display oam local interface command

Field	Description
Port	Port index
Link Status	Link status
EnableStatus	OAM state (enabled or disabled)
Local_oam_mode	Local OAM mode. Refer to Table 1-1 for more.
Local_pdu	The way in which OAMPDUs of different types are processed locally. Refer to Table 1-1 for more.
Local_mux_action	Local sending mode. Refer to Table 1-1 for more.
Local_par_action	Local receiving mode. Refer to Table 1-1 for more.
OAMLocalFlagsField	Local flags inserted in the local flag fields of the OAMPDUs sent
Link Fault	Indicates whether OAM link error events occurred. A value of 0 indicates no OAM error event occurs; a value of 1 indicates OAM error event occurrences.
Dying Gasp	Indicate whether Dying Gasp events occurred. A value of 0 indicates no Dying Gasp event occurs; a value of 1 indicates Dying Gasp event occurrences.
Critical Event	Indicates whether Critical Events occurred. A value of 0 indicates no Critical event occurs; a value of 1 indicates Critical event occurrences.
Local Evaluating	Indicates whether the local-to-remote configuration negotiation is complete.
Remote Evaluating	Indicates whether the remote-to-local configuration negotiation is complete.
Packets statistic	Statistics on OAM packets sent and received
OAMPDU	Total number of the 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 about the peer OAM information.

<Sysname> display oam remote

Port :Ethernet1/0/1

Link Status :Up

Information of the latest received OAM packet:

OAMRemoteMACAddress : 00e0fc003552

OAMRemotePDUConfiguration : 1500

Remote_mux_action : FWD Remote_par_action : FWD

Table 1-3 Description on the fields of the display oam remote command

Field	Description
Port	Port index
Link Status	Link status
Information of the latest received OAM packet	Information about the latest received OAM packet
OAMRemoteMACAddress	MAC address of the OAM peer
OAMRemotePDUConfiguration	Maximum OAMPDU size allowed
Remote_mux_action	Peer sending mode. Refer to Table 1-1 for more.
Remote_par_action	Peer receiving mode. Refer to Table 1-1 for more.

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

<Sysname> display oam remote interface ethernet 1/0/1

Port : Ethernet1/0/1

Link Status : Up

Information of the latest received OAM packet:

OAMRemoteMACAddress : 00e0-fd73-6502

OAMRemotePDUConfiguration : 1500

OAMRemoteState :

--------------------------------------------------------------------------

Remote_mux_action : FWD Remote_par_action : FWD

OAMRemoteConfiguration :

--------------------------------------------------------------------------

OAM Mode : Active Unidirectional Support : YES

Loopback Support : YES Link Events : YES

Variable Retrieval : NO

OAMRemoteFlagsField :

--------------------------------------------------------------------------

Link Fault : 0 Dying Gasp : 0

Critical Event : 0 Local Evaluating : COMPLETE

Remote Evaluating : COMPLETE

Table 1-4 Description on the fields of the display oam remote interface command

Field	Description
Port	Port index
Link Status	Link status
Information of the latest received OAM packet	Information about the latest received OAM packet
OAMRemoteMACAddress	MAC address of the OAM peer
OAMRemotePDUConfiguration	Maximum OAMPDU size allowed
OAMRemoteState	State of the peer OAM peer
Remote_mux_action	Peer sending mode. Refer to Table 1-1 for more.
Remote_par_action	Peer receiving mode. Refer to Table 1-1 for more.
OAMRemoteConfiguration	Configuration of the peer OAM entity
OAM Mode	OAM mode
Unidirectional Support	Indicates whether unidirectional transmission is supported (YES or NO)
Loopback Support	Indicates whether OAM loopback testing is supported (YES or NO)
Link Events	Indicates whether OAM link error events are supported (YES or NO)
Variable Retrieval	Indicates whether MIB variable retrieval is supported (YES or NO)
OAMRemoteFlagsField	Values of the peer OAM flag fields in OAM packets
Link Fault	Indicates whether OAM link error events occurred. Refer to Table 1-2 for more.
Dying Gasp	Indicate whether Dying Gasp events occurred. Refer to Table 1-2 for more.
Critical Event	Indicate whether Critical events occurred. Refer to Table 1-2 for more.
Local Evaluating	Indicates whether the local-to-remote configuration negotiation is complete.
Remote Evaluating	Indicates whether the remote-to-local configuration negotiation is complete.

1.1.2 display oam configuration

Syntax

display oam configuration

View

Any view

Parameters

None

Description

Use the display oam configuration command to display global OAM global, including the periods and thresholds for OAM link error event detection.

Related commands: oam errored-symbol period, oam errored-symbol threshold, oam errored-frame period, oam errored-frame threshold, oam errored-frame-period period, oam errored-frame-period threshold, oam errored-frame-seconds period, oam errored-frame-seconds threshold.

Examples

# Display global OAM configuration.

<Sysname> display oam configuration

Configuration of the errored symbol/frame event window/threshold :

--------------------------------------------------------------------------

Errored-symbol Event period : 1

Errored-symbol Event threshold : 1

Errored-frame Event period : 1

Errored-frame Event threshold : 1

Errored-frame-period Event period : 1000

Errored-frame-period Event threshold : 1

Errored-frame-seconds Event period : 60

Errored-frame-seconds Event threshold : 1

Table 1-5 Description on the fields of the display oam configuration command

Field	Description
Configuration of the errored symbol/frame event window/threshold	Periods and thresholds for OAM link error event detection
Errored-symbol Event period	Period for error signal event detection, which defaults to one second.
Errored-symbol Event threshold	Threshold for error signal event detection, which defaults to 1.
Errored-frame Event period	Period for error frame event detection, which defaults to one second.
Errored-frame Event threshold	Threshold for error frame event detection, which defaults to 1.
Errored-frame-period Event period	Period for frame-percentage error event detection, which defaults to 1000 milliseconds.
Errored-frame-period Event threshold	Threshold for frame-percentage error event detection, which defaults to 1.
Errored-frame-seconds Event period	Period for second-percentage error event detection, which defaults to 60 seconds.
Errored-frame-seconds Event threshold	Threshold for second-percentage error event detection, which defaults to 1.

1.1.3 display oam critical-event

Syntax

display oam critical-event [ interface interface-type interface-number]

View

Any view

Parameters

interface-type: Port type.

interface-number: Port number.

Description

Use the display oam critical-event command to display the statistics on critical OAM link events occurred on a port.

If you do not specify the interface keyword, this command displays the statistics on the critical OAM link events occurred on all the ports of the switch.

Examples

# Display the statistics on critical OAM link events occurred on all the ports.

<Sysname> display oam critical-event

Port : Ethernet1/0/1

Link Status : Up

Event statistic :

-------------------------------------------------------------------------

Link Fault :0 Dying Gasp : 0 Critical Event : 0

Table 1-6 Description on the fields of the display oam critical-event command

Field	Description
Port	Port index
Link Status	Link status
Event statistic	Statistics on critical OAM link events
Link Fault	Indicates whether OAM link error events occurred. Refer to Table 1-2 for more.
Dying Gasp	Indicates whether Dying Gasp events occurred. Refer to Table 1-2 for more.
Critical Event	Indicate whether Critical events occurred. Refer to Table 1-2 for more.

1.1.4 display oam link-event

Syntax

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

View

Any view

Parameters

local: Displays the statistics on the local OAM link error events.

remote: Displays the statistics on the peer OAM link error events.

interface-type: Port type.

interface-number: Port number.

Description

Use the display oam link-event command to display the statistics on OAM link error events occurred on a local port or a peer port. OAM link error events include error signal events, error frame events, frame-percentage error events, and second-percentage error events.

If you do not specify the interface keyword, this command displays the statistics on the OAM link error events occurred on all the local/peer ports.

Related commands: display oam configuration.

Examples

# Display the statistics on OAM link error events occurred on all the local ports.

<Sysname> display oam link-event local

Port : Ethernet1/0/1

Link Status : Up

OAMLocalErrFrameEvent : (ms = milliseconds)

--------------------------------------------------------------------------

Event Time Stamp : 3539 Errored Frame Window : 10(100ms)

Errored Frame Threshold : 5 Errored Frame : 1488111

Error Running Total : 260908758 Event Running Total : 307

OAMLocalErrFramePeriodEvent :

--------------------------------------------------------------------------

Event Time Stamp : 3539 Errored Frame Window : 976500

Errored Frame Threshold : 1 Errored Frame : 1042054

Error Running Total : 260909151 Event Running Total : 471

OAMLocalErrFrameSecsSummaryEvent : (ms = milliseconds)

--------------------------------------------------------------------------

Event Time Stamp : 3389

Errored Frame Second Summary Window : 600(100ms)

Errored Frame Second Summary Threshold : 1

Errored Frame Second Summary : 60

Error Running Total : 292 Event Running Total : 5

Table 1-7 Description on the fields of the display oam link-event local command

Field	Description
Port	Port index
Link Status	Link status
OAMLocalErrFrameEvent : (ms = milliseconds)	Information about the local error frame events. l Event Time Stamp: Time when an error frame event occurs (in terms of 100 milliseconds) l Errored Frame Window: Period for error frame event detection (in terms of 100 milliseconds) l Errored Frame Threshold: Threshold for error frame event detection l Errored Frame: number of the error frames in specific period l Error Running Total: Total number of the error frames l Event Running Total: Total number of error frame events occurred
OAMLocalErrFramePeriodEvent	Information about the local frame-percentage error events l Event Time Stamp: Time when an error frame event occurs (in terms of 100 milliseconds). l Errored Frame Window: Maximum number of 64-byte frames that can be transmitted through an Ethernet port in the period. This value is obtained by using the following expression:bandwidth * period / (64 * 8 * 1000),where “bandwidth” is the port bandwidth (in bps) and “period” is the configured period (in milliseconds). l Errored Frame Threshold: Threshold for frame-percentage error event detection. l Errored Frame: Number of the error frames occurred in a specific period. l Error Running Total: Total number of the error frames occurred. l Event Running Total: Total number of the frame-percentage error events.
OAMLocalErrFrameSecsSummaryEvent : (ms = milliseconds)	Information about the local second-percentage error events l Event Time Stamp: Time when a second-percentage error occurs (in terms of 100 milliseconds). l Errored Frame Second Summary Window: Period for second-percentage error event detection (in terms of 100 milliseconds). l Errored Frame Second Summary Threshold: Threshold for second-percentage error event detection. l Errored Frame Second Summary: Number of the error seconds in a specific period. l Error Running Total: Total number of the error seconds. l Event Running Total: Total number of second-percentage error events.

1.1.5 oam enable

Syntax

oam enable

undo oam enable

View

Ethernet port view

Parameters

None

Description

Use the oam enable command to enable OAM on a Ethernet port.

Use the undo oam enable command to disable OAM.

By default, OAM is disabled on all ports.

After you enable OAM for an Ethernet port, the port try to establish an OAM connection to the peer in the predetermined mode.

Related commands: oam mode.

Examples

# Enable OAM on Ethernet 1/0/1.

<Sysname> system-view

[Sysname] interface ethernet 1/0/1

[Sysname-Ethernet1/0/1] oam enable

1.1.6 oam errored-frame period

Syntax

oam errored-frame period period-value

undo oam errored-frame period

View

System view

Parameters

period-value: Period for error frame event detection, ranging from 1 to 60 (in seconds).

Description

Use the oam errored-frame period command to set the period for error frame event detection.

Use the undo oam errored-frame period command to restore the default.

By default, the period for error frame event detection is one second.

An error frame event occurs when a period for error frame event detection expires and the number of the frame errors occurred on an Ethernet port is larger than (or equal to) the threshold for error frame event detection.

The period for error frame event detection applies to all the Ethernet ports on which OAM connections are established.

Related commands: oam errored-frame threshold, display oam link-event, display oam configuration.

Examples

# Set the period for error frame event detection to 10 seconds.

<Sysname> system-view

[Sysname] oam errored-frame period 10

1.1.7 oam errored-frame threshold

Syntax

oam errored-frame threshold threshold-value

undo oam errored-frame threshold

View

System view

Parameters

threshold-value: Threshold for error frame event detection, ranging from 0 to 4,294,967,295.

Description

Use the oam errored-frame threshold command to set the threshold for error frame event detection.

Use the undo oam errored-frame threshold command to restore the default.

By default, the threshold for error frame event detection is 1.

The threshold for error frame event detection configured applies to all the Ethernet ports on which OAM connections are established.

Related commands: oam errored-frame period, display oam link-event, display oam configuration.

Examples

# Set the threshold for error frame event detection to 100.

<Sysname> system-view

[Sysname] oam errored-frame threshold 100

1.1.8 oam errored-frame-period period

Syntax

oam errored-frame-period period period-value

undo oam errored-frame-period period

View

System view

Parameters

period-value: Period for frame-percentage error event detection, ranging from 100 to 60,000 (in milliseconds).

Description

Use the oam errored-frame-period period command to set the period for frame-percentage error event detection.

Use the undo oam errored-frame-period period command to restore the default.

By default, the period for frame-percentage error event detection is 1,000 milliseconds.

As for frame-percentage error event detection, the system first uses the following expression to convert the period for frame-percentage error event detection to the maximum number of 64-byte frames that can be transmitted through an Ethernet port in the period:

bandwidth * period / (64 * 8 * 1000),

where “bandwidth” is the port bandwidth (in bps) and “period” is the configured period (in milliseconds).

A frame-percentage error event occurs when a period for frame-percentage error event detection expires and the number of the frame errors occurred on an Ethernet port is larger than (or equal to) the threshold for frame-percentage error event detection.

The period for frame-percentage error event detection configured applies to all the Ethernet ports on which OAM connections are established.

Related commands: oam errored-frame-period threshold, display oam link-event, display oam configuration.

Examples

# Set the period for frame-percentage error event detection to 10 seconds.

<Sysname> system-view

[Sysname] oam errored-frame-period period 10000

1.1.9 oam errored-frame-period threshold

Syntax

oam errored-frame-period threshold threshold-value

undo oam errored-frame-period threshold

View

System view

Parameters

threshold-value: Threshold for frame-percentage error event detection, ranging from 0 to 4,294,967,295.

Description

Use the oam errored-frame-period threshold command to set the threshold for frame-percentage error event detection.

Use the undo oam errored-frame-period threshold command to restore the default.

By default, the threshold for frame-percentage error event detection is 1.

The threshold for frame-percentage error event detection configured applies to all the Ethernet ports on which OAM connections are established.

Related commands: oam errored-frame-period period, display oam link-event, display oam configuration.

Examples

# Set the threshold for frame-percentage error event detection to 100.

<Sysname> system-view

[Sysname] oam errored-frame-period threshold 100

1.1.10 oam errored-frame-seconds period

Syntax

oam errored-frame-seconds period period-value

undo oam errored-frame-seconds period

View

System view

Parameters

period-value: Period for second-percentage error event detection, ranging from 10 to 900 (in seconds).

Description

Use the oam errored-frame-seconds period command to set the period for second-percentage error event detection.

Use the undo oam errored-frame-seconds period command to restore the default.

By default, the period for second-percentage error event detection is 60 seconds.

A second-percentage error event occurs when a period for second-percentage error event detection expires and the number of the error seconds of an Ethernet port is larger than (or equal to) the threshold for second-percentage error event detection. (A second is called an error second if error frames occur in the second.)

The period for second-percentage error event detection configured applies to all the Ethernet ports on which OAM connections are established.

Related commands: oam errored-frame-seconds threshold, display oam link-event, display oam configuration.

Examples

# Set the period for second-percentage error event detection to 100 seconds.

<Sysname> system-view

[Sysname] oam errored-frame-seconds period 100

1.1.11 oam errored-frame-seconds threshold

Syntax

oam errored-frame-seconds threshold threshold-value

undo oam errored-frame-seconds threshold

View

System view

Parameters

threshold-value: Threshold for second-percentage error event detection, ranging from 0 to 900.

Description

Use the oam errored-frame-seconds threshold command to set the threshold for second-percentage error event detection.

Use the undo oam errored-frame-seconds threshold command to restore the default.

By default, the threshold for second-percentage error event detection is 1.

The threshold for second-percentage error event detection configured applies to all the Ethernet ports on which OAM connections are established.

Related commands: oam errored-frame-seconds period, display oam link-event, display oam configuration.

Examples

# Set the threshold for second-percentage error event detection to 100.

<Sysname> system-view

[Sysname] oam errored-frame-seconds threshold 100

1.1.12 oam errored-symbol period

Syntax

oam errored-symbol period period-value

undo oam errored-symbol period

View

System view

Parameters

period-value: Period for error signal event detection, ranging from 1 to 60 (in seconds).

Description

Use the oam errored-symbol period command to set the period for error signal event detection.

Use the undo oam errored-symbol period command to restore the default.

By default, the period for error signal event detection is one second.

An error signal event occurs when a period for error signal event detection expires and the number of the signal errors occurred on an Ethernet port is larger than or (equal to) the threshold for error signal event detection.

The period for error signal event detection configured applies to all the Ethernet ports on which OAM connections are established.

Related commands: oam errored-symbol threshold, display oam link-event, display oam configuration.

Examples

# Set the period for error signal event detection to 10 seconds.

<Sysname> system-view

[Sysname] oam errored-symbol period 10

1.1.13 oam errored-symbol threshold

Syntax

oam errored-symbol threshold threshold-value

undo oam errored-symbol threshold

View

System view

Parameters

threshold-value: Threshold for error signal event detection, ranging from 0 to 4,294,967,295.

Description

Use the oam errored-symbol threshold command to set the threshold for error signal event detection.

Use the undo oam errored-symbol threshold command to restore the default.

By default, the threshold for error signal event detection is 1.

The threshold for error signal event detection configured applies to all the Ethernet ports on which OAM connections are established.

Related commands: oam errored-symbol period, display oam link-event, display oam configuration.

Examples

# Set the threshold for error signal event detection to 100.

<Sysname> system-view

[Sysname] oam errored-symbol threshold 100

1.1.14 oam loopback

Syntax

oam loopback

undo oam loopback

View

Ethernet port view

Parameters

None

Description

Use the oam loopback command to enable OAM loopback testing on an Ethernet port.

Use the undo loopback command to disable OAM loopback testing.

By default, OAM loopback testing is disabled.

Note that:

l OAM loopback testing is available only after the OAM connection is established.

l OAM loopback testing can be performed by OAM entities operating in the active OAM mode only.

l OAM loopback testing is available only when it is supported on both the local port and the peer port.

l Enabling OAM loopback testing results in all the data communications being stopped. After OAM loopback testing is disabled, all the ports involved will be shut down and then brought up.

l OAM loopback testing is disabled when you execute the undo oam enable command to disable OAM; when you execute the undo oam loopback command to disable OAM loopback testing; or when the OAM connection is timed out.

Related commands: oam enable, oam mode.

Examples

# Enable OAM loopback testing on GigabitEthernet1/1/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/1/1

[Sysname-GigabitEthernet1/1/1] oam mode active

[Sysname-GigabitEthernet1/1/1] oam enable

[Sysname-GigabitEthernet1/1/1] oam loopback

1.1.15 oam mode

Syntax

oam mode { active | passive }

View

Ethernet port view

Parameters

active: Specifies the active OAM mode.

passive: Specifies the passive OAM mode.

Description

Use the oam mode command to set the OAM operating mode for an Ethernet port. By default, an OAM-enabled Ethernet port operates in the active OAM mode.

Note that:

l No OAM connection can be established between two Ethernet ports operating in the passive OAM mode.

l For an OAM-enabled Ethernet port, the OAM operating mode cannot be changed. To do this, you need to disable OAM on the port first.

Related commands: oam enable.

Examples

# Configure Ethernet 1/0/1 to operate in the active OAM mode.

<Sysname> system-view

[Sysname] interface ethernet 1/0/1

[Sysname-Ethernet1/0/1] oam mode active

1.1.16 reset oam

Syntax

reset oam [ interface interface-type interface-number ]

View

User view

Parameters

interface-type: Port type.

interface-number: Port number.

Description

Use the reset oam command to clear the statistics on OAM packets and OAM link error events of an Ethernet port.

If you do not specify the interface keyword, this command clears the statistics on OAM packets and OAM link error events of all the ports.

Examples

# Clear the statistics on OAM packets and OAM link error events of all the ports.

<Sysname> reset oam

H3C S3610[S5510] Series Ethernet Switches Command Manual-Release 5303(V1.01)

Chapter 1 OAM Configuration Commands

1.1.3 display oam critical-event

1.1.5 oam enable

1.1.6 oam errored-frame period

1.1.7 oam errored-frame threshold

1.1.10 oam errored-frame-seconds period

1.1.11 oam errored-frame-seconds threshold

1.1.15 oam mode

1.1.16 reset oam

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us