The expected bandwidth of an interface affects the link costs of IS-IS, OSPF, and OSPFv3. For more information, see Layer 3—IP Routing Configuration Guides.

Examples

# Set the expected bandwidth of Virtual-Ethernet 2/4/1 to 50 kbps.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/1

[Sysname-Virtual-Ethernet2/4/1] bandwidth 50

broadcast

Use broadcast to enable the broadcast attribute for a PVC or PVC group.

Use undo broadcast to disable the broadcast attribute for a PVC or PVC group.

Syntax

broadcast

undo broadcast

Default

The broadcast attribute is disabled.

Views

PVC view

PVC group view

Predefined user roles

network-admin

Usage guidelines

On an ATM interface, multicast or broadcast packets are sent through all PVCs or PVC groups with the broadcast attribute enabled.

You must configure this command on a PVC or PVC group where broadcast or multicast packets must be sent. For example, to establish PIM neighbors between two routers on an ATM link through exchanging IP multicast packets, you must enable the broadcast attribute for PVCs on the ATM interfaces of both ends on the link.

This command is not applicable to PVCs in a PVC group.

Examples

# Enable the broadcast attribute for PVC 0/100.

<Sysname> system-view

[Sysname] interface atm 2/4/1.1

[Sysname-ATM2/4/1.1] pvc 0/100

[Sysname-ATM2/4/1.1-pvc-0/100] broadcast

default

Use default to restore the default settings for an interface.

Syntax

default

Views

VEth interface view

VEth subinterface view

VEB interface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you use it on a live network.

This command might fail to restore the default settings for some commands for reasons such as command dependencies or system restrictions. Use the display this command in interface view to identify these commands, and then use their undo forms or follow the command reference to individually restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.

Examples

# Restore the default settings of Virtual-Ethernet 2/4/1.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/1

[Sysname-Virtual-Ethernet2/4/1] default

description

Use description to configure the description of an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description for an interface is interface name Interface, for example, Virtual-Ethernet 2/4/1 Interface.

Views

VEth interface view

VEth subinterface view

VEB interface view

Predefined user roles

network-admin

Parameters

text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.

Examples

# Set the description for Virtual-Ethernet 2/4/1 to Virtual-Ethernet.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/1

[Sysname-Virtual-Ethernet2/4/1] description Virtual-Ethernet

display atm map-info

Use display atm map-info to display mapping information about PVCs or PVC groups.

Syntax

display atm map-info [ interface interface-type { interface-number | interface-number.subnumber } [ pvc { pvc-name | vpi/vci } | pvc-group group-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type { interface-number | interface-number.subnumber }: Specifies an interface by its type and number. Both ATM interfaces and ATM subinterfaces are supported.

pvc: Displays mapping information for a PVC.

pvc-name: Specifies a PVC by its name, a case-sensitive string of 1 to 15 characters excluding slashes (/) and hyphens (-). For example, neither 1/20 nor a-b is a valid PVC name.

vpi/vci: Specifies a PVC by its VPI and VCI values. The value range for the vpi argument is 0 to 255. The value range for the vci argument varies by interface type. For more information, see Table 9. The values of the vpi and vci arguments cannot be 0 at the same time. As a best practice, do not use VCI values 0 through 31 because they are reserved for special purposes.

pvc-group group-number: Specifies a PVC group by its number in the range of 1 to 128.

Usage guidelines

If you do not specify an ATM interface, this command displays mapping information for all PVCs and PVC groups on all ATM interfaces.

If you specify an ATM interface but do not specify a PVC or PVC group, this command displays mapping information for all PVCs and PVC groups on the specified ATM interface.

If you specify an ATM interface and a PVC or PVC group, this command displays mapping information for the specified PVC or PVC group.

Examples

# Display mapping information for all PVCs and PVC groups on all ATM interfaces.

<Sysname> display atm map-info

ATM2/4/0

PVC 1/32:

Protocol: PPP, Interface: Virtual-Template10, State: UP

Protocol: IP, IP address: 100.11.1.1, State: UP

PVC-group 1:

Protocol: IP InARP, IP address: 100.22.22.2, Interval: 2 minutes, State: UP

Protocol: ETH, Interface: Virtual-Ethernet2, State: UP

ATM2/4/1

PVC 2/32:

Protocol: IP InARP, IP address: no IP address, Interval: 3 minutes, State: UP

Table 1 Command output

Field	Description
ATM2/4/0	Interface name.
PVC 1/32	VPI/VCI pair of the PVC.
PVC-group 1	PVC group number.
Protocol	Upper-layer protocol running on the PVC or PVC group: · PPP—PPP protocol. · IP—IP protocol. · IP InARP—IP InARP protocol. · ETH—Ethernet protocol.
State	Mapping state: · UP—In PPP and IP (including InARP) mappings, it means that the PVC or PVC group is up. In Ethernet mapping, it means that the PVC or PVC group and the VEth interface are up. · DOWN—In PPP and IP (including InARP) mappings, it means that the PVC or PVC group is down. In Ethernet mapping, it means that either the PVC (PVC group) or the VEth interface is down, or both the PVC (PVC group) and the VEth interface are down.
Interval	Interval (in minutes) at which InARP packets are sent.
Interface	VEth interface that carries PPPoA or EoA.

display atm pvc-group

Use display atm pvc-group to display PVC group information.

Syntax

display atm pvc-group [ interface interface-type { interface-number | interface-number.subnumber } [ pvc-group group-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type { interface-number | interface-number.subnumber }: Specifies an interface by its type and number. Both ATM interfaces and ATM subinterfaces are supported.

pvc-group group-number: Specifies a PVC group by its number in the range of 1 to 128.

Usage guidelines

If you do not specify an ATM interface, this command displays brief information about all PVC groups on all ATM interfaces.

If you specify an ATM interface but do not specify a PVC group, this command displays brief information about all PVC groups on the specified ATM interface.

If you specify an ATM interface and a PVC group, this command displays detailed information about the specified PVC group.

Examples

# Display brief information about all PVC groups on all ATM interfaces.

<Sysname> display atm pvc-group

ATM2/4/0, State UP

PVC-group: 1

Encapsulation: SNAP, Protocol: IP

VPI/VCI PVC name Precedence State

1/32 aa Default UP

2/32 N/A 2-3 UP

3/32 N/A 5 UP

PVC-group: 3

Encapsulation: SNAP, Protocol: IP

VPI/VCI PVC name Precedence State

3/64 bb 4 UP

4/64 N/A Default UP

ATM2/4/1, State UP

PVC-group: 1

Encapsulation: SNAP, Protocol: IP

VPI/VCI PVC name Precedence State

1/32 aa Default UP

Table 2 Command output

Field	Description
ATM2/4/0, State UP	Name of the interface to which the PVC groups belong, and the physical and administrative states of the interface. State of an interface (not a subinterface): · UP—The interface is both physically and administratively up. · DOWN—The interface is in either of the following states: ¡ The interface is administratively up but physically down (probably because no physical link is available or the link has failed). ¡ The interface is administratively down (shut down by using the shutdown command). State of a subinterface: · UP—The interface is administratively up. The parent interface is both physically and administratively up. · DOWN—The interface or its parent interface was shut down by using the shutdown command, or the parent interface is physically down.
Encapsulation	AAL5 encapsulation type of the PVC group. It can only be SNAP, which is the Logical Link Control (LLC)/Subnet Access Protocol (SNAP) encapsulation type.
Protocol	Upper-layer protocol running on the PVC group: · PPP—PPP protocol. · IP—IP protocol. · ETH—Ethernet protocol. · None—No protocol is configured.
PVC name	PVC name. N/A means no PVC name.
Precedence	Priority of the IP packets carried by the PVC in the PVC group: · Default—Default PVC. IP packets without a priority configured are transmitted through the default PVC. · a-b—Lowest and highest priorities of the IP packets carried by the PVC. The value range for a and b is 0 to 7. a is smaller than b. · c—Priority of the IP packets carried by the PVC, in the range of 0 to 7. · -—No priority is configured for IP packets carried by the PVC.
State	PVC state: · UP—The following states are up: ¡ State of the ATM interface to which the PVC belongs. ¡ Shutdown state. ¡ OAM state. · DOWN—One or more of the following states is down: ¡ State of the ATM interface to which the PVC belongs. ¡ Shutdown state. ¡ OAM state.

# Display detailed information about the specified PVC group.

<Sysname> display atm pvc-group interface atm 2/4/0 pvc-group 1

ATM2/4/0, PVC-group: 1

Encapsulation: SNAP, Protocol: None

PVC VPI/VCI: 0/34

Precedence: default

Service-type: CBR, Output-pcr: 200 kbps, CDVT: 500 us

Transmit-Priority: 0

OAM loopback interval: 0 sec(disabled), OAM loopback retry interval: 1 sec

OAM loopback retry count (up/down): 3/5

OAM AIS-RDI count (up/down): 3/1

Interface State: UP, OAM State: UP, PVC State: UP

Input: 0 packets, 0 bytes, 0 errors

Output: 0 packets, 0 bytes, 0 errors

Output queue: (Urgent queuing : Size/Length/Discards) 0/100/0

Output queue: (Protocol queuing : Size/Length/Discards) 0/500/0

Output queue: (FIFO queuing : Size/Length/Discards) 0/75/0

OAM cells received: 42

F5 Loopback: 0, F5 AIS: 42, F5 RDI: 0

OAM cells sent: 0

F5 Loopback: 0

OAM cell drops: 0

OAM AIS State: No AIS Alarm

OAM RDI State: No RDI Alarm

OAM CC State: No CC Alarm

PVC VPI/VCI: 0/35

Precedence: -

Service-type: UBR, Output-pcr: 200 kbps

Transmit-Priority: 0

OAM loopback interval: 0 sec(disabled), OAM loopback retry interval: 1 sec

OAM loopback retry count (up/down): 3/5

OAM AIS-RDI count (up/down): 3/1

Interface State: UP, OAM State: UP, PVC State: UP

Input: 0 packets, 0 bytes, 0 errors

Output: 0 packets, 0 bytes, 0 errors

Output queue: (Urgent queuing : Size/Length/Discards) 0/100/0

Output queue: (Protocol queuing : Size/Length/Discards) 0/500/0

Output queue: (FIFO queuing : Size/Length/Discards) 0/75/0

OAM cells received: 42

F5 Loopback: 0, F5 AIS: 42, F5 RDI: 0

OAM cells sent: 0

F5 Loopback: 0

OAM cell drops: 0

OAM AIS State: No AIS Alarm

OAM RDI State: No RDI Alarm

OAM CC State: No CC Alarm

Table 3 Command output

Field	Description
Encapsulation	AAL5 encapsulation type of the PVC group. It can only be SNAP, which is the LLC/SNAP encapsulation type.
Protocol	Upper-layer protocol running on the PVC group: · PPP—PPP protocol. · IP—IP protocol. · ETH—Ethernet protocol. · None—No protocol is configured.
Precedence	Priority of the IP packets carried by the PVC in the PVC group: · Default—Default PVC. IP packets without a priority configured are transmitted through the default PVC. · a-b—Lowest and highest priorities of the IP packets carried by the PVC. The value range for a and b is 0 to 7. a is smaller than b. · c—Priority of the IP packets carried by the PVC, in the range of 0 to 7. · -—No priority is configured for IP packets carried by the PVC.
Service-type	Service type: · CBR—Constant bit rate. · UBR—Unspecified bit rate. · VBR-NRT—Variable bit rate-non real time. · VBR-RT—Variable bit rate-real time.
Output-pcr	Peak output rate of ATM cells.
CDVT	Cell delay variation tolerance in microseconds.
Transmit-Priority	Transmission priority.
OAM loopback interval	Interval (in seconds) at which OAM F5 Loopback cells are sent.
OAM loopback retry interval	Interval (in seconds) at which OAM F5 Loopback retransmission detection cells are sent.
OAM loopback retry count (up/down)	Number of cells that are detected as up and down in OAM detection.
OAM AIS-RDI count (up/down)	Number of seconds that are detected as up in OAM AIS-RDI detection. Number of cells that are detected as down in OAM AIS-RDI detection.
Interface State	Name of the interface to which the PVC belongs, and the physical and administrative states of the interface. State of an interface (not a subinterface): · UP—The interface is both physically and administratively up. · DOWN—The interface is in either of the following states: ¡ The interface is administratively up and physically down (probably because no physical link is available or the link has failed). ¡ The interface is administratively down (shut down by using the shutdown command). State of a subinterface: · UP—The interface is administratively up. The parent interface is both physically and administratively up. · DOWN—The interface or its parent interface was shut down by using the shutdown command, or the parent interface is physically down.
OAM State	OAM protocol state: UP or DOWN.
PVC State	PVC state: · UP—The following states are up: ¡ State of the ATM interface to which the PVC belongs. ¡ Shutdown state. ¡ OAM state. · DOWN—One or more of the following states is down: ¡ State of the ATM interface to which the PVC belongs. ¡ Shutdown state. ¡ OAM state.
Input: 0 packets, 0 bytes, 0 errors	Counts of received packets, bytes, and packet errors.
Output: 0 packets, 0 bytes, 0 errors	Counts of transmitted packets, bytes, and packet errors.
Output queue	QoS packet output queue information of the PVC.
OAM cells received	Number of received OAM cells.
F5 Loopback	Number of received F5 Loopback cells.
F5 AIS	Number of received AIS cells. If the AIS alarm state is not supported, this command displays only the number of AIS cells, rather than the AIS alarm state in the OAM AIS State field.
F5 RDI	Number of received RDI cells. If the RDI alarm state is not supported, this command displays only the number of RDI cells, rather than the RDI alarm state in the OAM RDI State field.
OAM cells sent	Number of transmitted OAM cells.
F5 Loopback	Number of transmitted F5 Loopback cells.
OAM cell drops	Number of dropped OAM cells.
OAM AIS State	AIS alarm state: · No AIS Alarm—No OAM AIS alarm. · E2E AIS Alarm—End-to-end OAM AIS alarm. If alarm state is supported, this command displays only the alarm state, rather than the number of cells in the F5 AIS field.
OAM RDI State	RDI alarm state: · No RDI Alarm—No OAM RDI alarm. · E2E RDI Alarm—End-to-end OAM RDI alarm. If alarm state is supported, this command displays only the alarm state, rather than the number of cells in the F5 RDI field.
OAM CC State	CC alarm state: · No CC Alarm—No OAM CC alarm. · E2E CC Alarm—End-to-end OAM CC alarm.

display atm pvc-info

Use display atm pvc-info to display PVC information.

Syntax

display atm pvc-info [ interface interface-type { interface-number | interface-number.subnumber } [ pvc { pvc-name | vpi/vci } ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type { interface-number | interface-number.subnumber }: Specifies an interface by its type and number. Both ATM interfaces and ATM subinterfaces are supported.

pvc: Displays information about a PVC.

pvc-name: Specifies a PVC by its name, a case-sensitive string of 1 to 15 characters, excluding slashes (/) and hyphens (-). For example, neither 1/20 nor a-b is a valid PVC name.

Usage guidelines

If you do not specify an ATM interface, this command displays brief information about all PVCs on all ATM interfaces.

If you specify an ATM interface but do not specify a PVC, this command displays brief information about all PVCs on the specified ATM interface.

If you specify an ATM interface and a PVC, this command displays detailed information about the specified PVC.

Examples

# Display brief information about all PVCs on all ATM interfaces.

<Sysname> display atm pvc-info

VPI/VCI State PVC name Encap Protocol Interface

1/32 UP aa SNAP IP ATM2/4/0

1/33 UP Sysname MUX None ATM2/4/0

1/55 UP datacomm SNAP PPP ATM2/4/0.1

2/66 UP N/A SNAP IP ATM2/4/0.4

2/101 UP beijing SNAP ETH ATM2/4/0.2

Table 4 Command output

Field	Description
State	PVC state: · UP—The following states are up: ¡ State of the ATM interface to which the PVC belongs. ¡ Shutdown state. ¡ OAM state. · DOWN—One or more of the following states is down: ¡ State of the ATM interface to which the PVC belongs. ¡ Shutdown state. ¡ OAM state.
PVC name	PVC name. N/A means no PVC name.
Encap	AAL5 encapsulation type of the PVC: · SNAP—LLC/SNAP encapsulation. · NLPID—RFC1490 encapsulation. · MUX—MUX multiplexing encapsulation.
Protocol	Upper-layer protocol running on the PVC: · PPP—PPP protocol. · IP—IP protocol. · ETH—Ethernet protocol. · None—No protocol is configured.
Interface	Name of the interface to which the PVC belongs.

# Display detailed information about the specified PVC.

<Sysname> display atm pvc-info interface atm 2/4/1 pvc 1/100

ATM2/4/1, VPI: 1, VCI: 100

Encapsulation: SNAP, Protocol: IP

Service-type: UBR, Output-pcr: 200 kbps

Transmit-Priority: 0

OAM loopback interval: 0 sec(disabled), OAM loopback retry interval: 1 sec

OAM loopback retry count (up/down): 3/5

OAM AIS-RDI count (up/down): 3/1

Interface State: UP, OAM State: UP, PVC State: UP

Input: 0 packets, 0 bytes, 0 errors

Output: 0 packets, 0 bytes, 0 errors

Output queue: (Urgent queuing : Size/Length/Discards) 0/100/0

Output queue: (Protocol queuing : Size/Length/Discards) 0/500/0

Output queue: (FIFO queuing : Size/Length/Discards) 0/75/0

OAM cells received: 42

F5 Loopback: 0, F5 AIS: 42, F5 RDI: 0

OAM cells sent: 0

F5 Loopback: 0

OAM cell drops: 0

OAM AIS State: No AIS Alarm

OAM RDI State: No RDI Alarm

OAM CC State: No CC Alarm

Table 5 Command output

Field	Description
ATM2/4/1	Name of the interface to which the PVC belongs.
Encapsulation	AAL5 encapsulation type of the PVC: · SNAP—LLC/SNAP encapsulation. · NLPID—RFC1490 encapsulation. · MUX—MUX multiplexing encapsulation.
Protocol	Upper-layer protocol running on the PVC: · PPP—PPP protocol. · IP—IP protocol. · ETH—Ethernet protocol. · None—No protocol is configured.
Service-type	Services type: CBR, UBR, VBR-NRT, or VBR-RT.
Output-pcr	Peak output rate of ATM cells.
OAM loopback interval	Interval at which OAM F5 Loopback cells are sent.
OAM loopback retry interval	Interval at which OAM F5 Loopback retransmission detection cells are sent.
OAM loopback retry count (up/down)	Number of cells that are detected as up and down in OAM detection.
OAM AIS-RDI count (up/down)	Number of seconds that are detected as up in OAM AIS-RDI detection. Number of cells that are detected as down in OAM AIS-RDI detection.
Interface State	Name of the interface to which the PVC belongs, and the physical and administrative states of the interface. State of an interface (not a subinterface): · UP—The interface is both physically and administratively up. · DOWN—The interface is in either of the following states: ¡ The interface is administratively up and physically down (probably because no physical link is available or the link has failed). ¡ The interface is administratively down (shut down by using the shutdown command). State of a subinterface: · UP—The interface is administratively up. The parent interface is both physically and administratively up. · DOWN—The interface or its parent interface was shut down by using the shutdown command, or the parent interface is physically down.
OAM State	OAM protocol state: UP or DOWN.
PVC State	PVC state: · UP—The following states are up: ¡ State of the ATM interface to which the PVC belongs. ¡ Shutdown state. ¡ OAM state. · DOWN—One or more of the following states is down: ¡ State of the ATM interface to which the PVC belongs. ¡ Shutdown state. ¡ OAM state.
Input: 0 packets, 0 bytes, 0 errors	Counts of received packets, bytes, and packet errors.
Output: 0 packets, 0 bytes, 0 errors	Counts of transmitted packets, bytes, and packet errors.
Output queue	QoS packet output queue information of the PVC.
OAM cells received	Counts of received OAM cells.
F5 Loopback	Counts of received F5 Loopback cells.
F5 AIS	Number of received AIS cells. If the AIS alarm state is not supported, this command displays only the number of AIS cells, rather than the AIS alarm state in the OAM AIS State field.
F5 RDI	Number of received RDI cells. If the RDI alarm state is not supported, this command displays only the number of RDI cells, rather than the RDI alarm state in the OAM RDI State field.
OAM cells sent	Number of transmitted OAM cells.
F5 Loopback	Number of transmitted F5 Loopback cells.
OAM cell drops	Number of dropped OAM cells.
OAM AIS State	AIS alarm state: · No AIS Alarm—No OAM AIS alarm. · E2E AIS Alarm—End-to-end OAM AIS alarm. If alarm state is supported, this command displays only the alarm state, rather than the number of cells in the F5 AIS field.
OAM RDI State	RDI alarm state: · No AIS Alarm—No OAM RDI alarm. · E2E AIS Alarm—End-to-end OAM RDI alarm. If alarm state is supported, this command displays only the alarm state, rather than the number of cells in the F5 RDI field.
OAM CC State	CC alarm state: · No CC Alarm—No OAM CC alarm. · E2E CC Alarm—End-to-end OAM CC alarm.

display interface ve-b ridge

Use display interface ve-bridge to display virtual Ethernet bridge (VEB) interface information.

Syntax

display interface [ ve-bridge [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ve-bridge [ interface-number ]: Specifies a VEB interface by its number. If you do not specify the ve-bridge keyword, this command displays information about all interfaces except VA interfaces on the device. If you specify the ve-bridge keyword but do not specify the interface-number argument, this command displays information about all existing VEB interfaces.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of interface descriptions.

down: Displays information about interfaces in physically down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.

Examples

# Display information about VE-Bridge 3/0/1 (that supports statistics collection).

<Sysname> display interface ve-bridge 3/0/1

VE-Bridge3/0/1 current state: DOWN

IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 0000-0000-0000

Description: VE-Bridge3/0/1 Interface

PVID: 1

Port link-type: access

Tagged VLAN ID : none

Untagged VLAN ID : 1

Last clearing of counters: Never

Carrier Layer: 1 PVC total, 1 map up, 0 map down

Input: 0 packets, 0 bytes, 0 errors

Output: 0 packets, 0 bytes, 0 errors

# Display information about VE-Bridge 3/0/1 (that does not support statistics collection).

<Sysname> display interface ve-bridge 3/0/1

VE-Bridge3/0/1 current state: DOWN

IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 0000-0000-0000

Description: VE-Bridge3/0/1 Interface

PVID: 1

Port link-type: access

Tagged VLAN ID : none

Untagged VLAN ID : 1

Last clearing of counters: Never

# Display brief information about VE-Bridge 3/0/1.

<Sysname> display interface ve-bridge 3/0/1 brief

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Speed or Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface Link Speed Duplex Type PVID Description

VEB3/0/1 DOWN auto A A 1

# Display information about all VEB interfaces in physically down state and the causes.

<Sysname> display interface ve-bridge brief down

The brief information of interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

VEB3/0/1 DOWN Not connected

Table 6 Command output

Field	Description
current state	Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up.
IP Packet Frame Type	Ethernet frame format.
Hardware Address	MAC address of the interface.
Description	Description of the interface.
PVID	Default VLAN ID of the interface.
Port link-type	Link type of the interface: · access. · trunk. · hybrid.
Tagged VLAN ID	VLANs for which the packets need to be tagged on the interface.
Untagged VLAN ID	VLANs for which the packets do not need to be tagged on the interface.
Last clearing of counters: Never	Time when the reset counters interface command was last used to clear the interface statistics. Never indicates the reset counters interface command has never been used on the interface after the device has started up.
Carrier Layer: 1 PVC total, 1 map up, 0 map down	Data link layer information for the Layer 2 VE interface (displayed only when the interface supports statistics collection): · Number of PVCs bound to the interface. · Number of PVCs in up state. · Number of PVCs in down state.
Input	Input packet statistics (displayed on when the interface supports statistics collection): · packets—Number of packets. · bytes—Total bytes. · errors—Number of error packets.
Output	Output packet statistics (displayed on when the interface supports statistics collection): · packets—Number of packets. · bytes—Total bytes. · errors—Number of error packets.
The brief information of interface(s) under bridge mode:	Brief information about the interface in bridge mode (Layer 2 interface).
Speed or Duplex: (a)/A - auto; H - half; F - full	Speed or duplex of the interface: · Speed—This field displays the (a) flag if the speed is automatically negotiated. · Duplex—Duplex of the interface: ¡ (a)/A—The interface is configured to autonegotiate its duplex mode. ¡ H—Half duplex. ¡ F—Full duplex.
Type: A - access; T - trunk; H - hybrid	Link type of the interface: · A—Access. · H—Hybrid. · T—Trunk.
Speed	Interface speed in bps.
Duplex	Duplex mode of the interface: · A—Autonegotiation. The interface is configured to autonegotiate its duplex mode. · F—Full duplex. · F(a)—Autonegotiated full duplex. · H—Half duplex. · H(a)—Autonegotiated half duplex.
Cause	Cause for the physical link state of an interface to be DOWN (the value for this field varies by device model): · Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty).

display interface virtual-ethernet

Use display interface virtual-ethernet to display VEth interface information.

Syntax

display interface [ virtual-ethernet [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

virtual-ethernet [ interface-number ]: Specifies a VEth interface by its number. If you do not specify the virtual-ethernet keyword, this command displays information about all interfaces except VA interfaces on the device. If you specify the virtual-ethernet keyword but do not specify the interface-number argument, this command displays information about all existing VEth interfaces.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of interface descriptions.

down: Displays information about interfaces in physically down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.

Examples

# Display information about Virtual-Ethernet 2/4/1.

<Sysname> display interface virtual-ethernet 2/4/1

Virtual-Ethernet2/4/1

Current state: UP

Line protocol state: UP

Description: Virtual-Ethernet2/4/1 Interface

Bandwidth: 20000kbps

Maximum Transmit Unit: 1500

Internet protocol processing: disabled

IP Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 00e0-fc0d-9485

IPv6 Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 00e0-fc0d-9485

Last clearing of counters: Never

Last 300 seconds input rate: 0 bytes/sec, 0 packets/sec

Last 300 seconds output rate: 0 bytes/sec, 0 packets/sec

Input: 0 packets, 0 bytes, 0 drops

Output: 0 packets, 0 bytes, 0 drops

# Display brief information about Virtual-Ethernet 2/4/1.

<Sysname> display interface virtual-ethernet 2/4/1 brief

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Primary IP Description

VEth1 DOWN DOWN --

# Display information about all VEth interfaces in physically down state and the causes.

<Sysname> display interface virtual-ethernet brief down

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

VEth2/4/1 DOWN Not connected

Table 7 Command output

Field	Description
Current state	Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up.
Line protocol state	Data link layer state of the interface: UP or DOWN.
Internet protocol processing: Disabled	The interface is not assigned an IP address and cannot process IP packets.
Internet address: ip-address/mask-length (Type)	IP address of the interface and type of the address in parentheses. Possible IP address types include: · Primary—Manually configured primary IP address. · Sub—Manually configured secondary IP address. If the interface has both primary and secondary IP addresses, the primary IP address is displayed. If the interface has only secondary IP addresses, the lowest secondary IP address is displayed. · DHCP-allocated—DHCP allocated IP address. For more information, see DHCP client configuration in Layer 3—IP Services Configuration Guide. · BOOTP-allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3—IP Services Configuration Guide. · PPP-negotiated—IP address assigned by a PPP server during PPP negotiation. For more information, see PPP configuration in Layer 2—WAN Access Configuration Guide. · Unnumbered—IP address borrowed from another interface. · Cellular-allocated—IP address allocated through the modem-manufacturer's proprietary protocol. For more information, see 3G/4G modem management in Layer 2—WAN Access Configuration Guide. · MAD—IP address assigned to an IRF member device for MAD on the interface. For more information, see IRF configuration in Virtual Technologies Configuration Guide. · MTunnel—IP address of the multicast tunnel interface (MTI), which is the same as the IP address of the MVPN source interface. For more information, see multicast VPN configuration in IP Multicast Configuration Guide.
IP Packet Frame Type	IPv4 packet framing format. PKTFMT_ETHNT_2 stands for Ethernet II frame format.
IPv6 Packet Frame Type	IPv6 packet framing format.
Hardware Address	MAC address of the interface.
Last clearing of counters: Never	Time when the reset counters interface command was last used to clear the interface statistics. Never indicates the reset counters interface command has never been used on the interface after the device has started up.
Last 300 seconds input rate	Average packet input rate over the last 300 seconds.
Last 300 seconds output rate	Average packet output rate over the last 300 seconds.
Input	Input packet statistics: · packets—Number of packets. · bytes—Total bytes. · drops—Number of dropped packets.
Output	Output packet statistics: · packets—Number of packets. · bytes—Total bytes. · drops—Number of dropped packets.
Brief information on interfaces in route mode	Brief information about the Layer 3 interface.
Interface	Abbreviation of the interface name.
Link	Physical link state of the interface: · UP—The interface is physically up. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. To see the primary interface, use the display interface-backup state command.
Protocol	Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down. · UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces and loopback interfaces.
Primary IP	Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address.
Description	Description of the interface.
Cause	Cause for the physical link state of an interface to be DOWN: · Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty).

encapsulation

Use encapsulation to configure the ATM AAL5 encapsulation type for a PVC or PVC group.

Use undo encapsulation to restore the default.

Syntax

encapsulation { aal5mux | aal5nlpid | aal5snap }

undo encapsulation

Default

The ATM AAL5 encapsulation type is aal5snap.

Views

PVC view

PVC group view

Predefined user roles

network-admin

Parameters

aal5mux: Specifies the MUX multiplexing encapsulation type.

aal5nlpid: Specifies the RFC1490 encapsulation type.

aal5snap: Specifies the LLC/SNAP encapsulation type.

Usage guidelines

Different encapsulation types support different mappings:

· aal5snap encapsulation supports IPoA, PPPoA, and PPPoEoA mappings.

· aal5mux encapsulation supports IPoA, PPPoA, and PPPoEoA mappings, but can only support one protocol at a time.

· aal5nlpid encapsulation supports only IPoA mappings.

Follow these guidelines when you configure the ATM AAL5 encapsulation type:

· Devices on the two ends must be configured with the same ATM AAL5 encapsulation types.

· Only aal5snap supports InARP. You cannot configure InARP when aal5mux or aal5nlpid is used.

· Although a PVC or PVC group can carry multiple protocols, a specific encapsulation type might not support some of the applications (such as IPoA, PPPoA, and PPPoEoA). In such cases, the system displays error prompts.

· When you change the encapsulation type for a PVC or PVC group, and the mappings that you have configured conflict with the new encapsulation type, the PVC or PVC group deletes the configurations of all conflicting mappings.

· This command is not applicable to PVCs in a PVC group.

Examples

# Set the AAL5 encapsulation for PVC 1/32 on ATM 2/4/0 to aal5snap.

<Sysname>system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/32

[Sysname-ATM2/4/0-pvc-1/32] encapsulation aal5snap

interface ve-bridge

Use interface ve-bridge to create a VEB interface and enter its view, or enter the view of an existing VEB interface.

Use undo interface ve-bridge to remove a VEB interface.

Syntax

interface ve-bridge interface-number

undo interface ve-bridge interface-number

Default

No VEB interface exists.

Views

System view

Predefined user roles

network-admin

Parameters

interface-number: Specifies a VEB interface by its number.

Usage guidelines

You cannot remove a VEB interface that has been associated with a PVC.

Examples

# Create VEB interface VE-Bridge 3/0/1 and enter its view.

<Sysname> system-view

[Sysname] interface ve-bridge 3/0/1

[Sysname-VE-Bridge3/0/1]

interface virtual-ethernet

Use interface virtual-ethernet to create a VEth interface or VEth subinterface and enter its view, or enter the view of an existing VEth interface or VEth subinterface.

Use undo interface virtual-ethernet to remove a VEth interface or subinterface.

Syntax

interface virtual-ethernet { interface-number | interface-number.subnumber }

undo interface virtual-ethernet { interface-number | interface-number.subnumber }

Default

No VEth interface or VEth subinterfaces exist.

Views

System view

Predefined user roles

network-admin

Parameters

interface-number: Specifies a VEth interface by its number.

interface-number.subnumber: Specifies a VEth subinterface by its number. The interface-number argument represents the number of the VEth interface. The subnumber argument represents the number of the subinterface.

Usage guidelines

The baud rate of the VEth interface is 10000000 bps.

Examples

# Create VEth interface Virtual-Ethernet 2/4/1 and enter its view.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/1

[Sysname-Virtual-Ethernet2/4/1]

# Create VEth subinterface Virtual-Ethernet 2/4/1.1 and enter its view.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/1.1

[Sysname-Virtual-Ethernet2/4/1.1]

mac-address

Use mac-address to specify the MAC address for an interface.

Use undo mac-address to restore the default.

Syntax

mac-address mac-address

undo mac-address

Default

The MAC address of the interface is the bridge MAC address of the device.

Views

VEth interface view

VEth subinterface view

VEB interface view

Predefined user roles

network-admin

Parameters

mac-address: Specifies the MAC address in the format of H-H-H.

Usage guidelines

A VEth interface uses the bridge MAC address of the device as its MAC address. As a result, all VEth interfaces share the same MAC address. You must use the mac-address command to specify a MAC address for each VEth interface in the following condition:

· The VEth interfaces are connected to a DHCP server through different PVCs.

· The VEth interfaces need to obtain IP addresses from the DHCP server through static allocation.

Examples

# Set the MAC address of Virtual-Ethernet 2/4/1 to 0001-0001-0001.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/1

[Sysname-Virtual-Ethernet2/4/1] mac-address 1-1-1

map bridge

Use map bridge to create a PPPoEoA mapping for a PVC or PVC group.

Use undo map bridge to delete the mapping.

Syntax

map bridge virtual-ethernet interface-number

undo map bridge

Create an EoA mapping:

map bridge ve-bridge interface-number

undo map bridge

Default

No IPoEoA mappings or PPPoEoA mappings exist.

Views

PVC view

PVC group view

Predefined user roles

network-admin

Parameters

virtual-ethernet interface-number: Specifies a VEth interface by its number. The interface must have already been created.

Usage guidelines

aal5snap and aal5mux encapsulations support PPPoEoA mappings.

You can create a maximum of 512 mappings on a VEth interface.

A PVC or PVC group can be mapped to only one VEth interface.

A VEth interface can only be bound to the PVC or PVC group on the same interface card. Before you bind a VEth interface, check its interface number to make sure the VEth interface is on the same card as the ATM interface to which the PVC or PVC group belongs.

This command is not applicable to PVCs in a PVC group.

Before you configure PPPoEoA, you must specify a VEth interface.

Before you configure EoA, you must specify a VEB interface.

Examples

The following example demonstrates a complete process of PPPoEoA configuration.

# Create VEth interface Virtual-Ethernet 2/4/1.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/1

# Set the IP address of the VEth interface to 10.1.1.1/16.

[Sysname-Virtual-Ethernet2/4/1] pppoe-server bind virtual-template 10

[Sysname-Virtual-Ethernet2/4/1] quit

# Create PVC 1/102 on ATM 2/4/0.

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/102

# Create an PPPoEoA mapping using the created VEth interface in PVC view.

[Sysname-ATM2/4/0-pvc-1/102] map bridge virtual-ethernet 2/4/1

Related commands

encapsulation

map ip

Use map ip to create an IPoA mapping for a PVC or PVC group.

Use undo map ip to delete the mapping.

Syntax

map ip { ip-address | default | inarp [ minutes ] }

undo map ip [ ip-address | default | inarp ]

Default

No IPoA mappings for a PVC or PVC group exist.

Views

PVC view

PVC group view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the remote IP address mapped to the PVC or PVC group.

default: Sets the default PVC mapping. If no PVC mapping can be found for the next hop address of a packet, the packet is sent through the default PVC or PVC group.

inarp: Enables InARP on the PVC.

minutes: Specifies the interval for sending InARP packets, in the range of 1 to 600 minutes. The default is 15 minutes.

Usage guidelines

All encapsulations support IPoA. Only aal5snap supports InARP. You cannot configure InARP when aal5mux or aal5nlpid is used.

Multiple IP addresses can be mapped to the same PVC or PVC group. Supported mappings are static IP mapping, default mapping, and InARP mapping. You can configure them at the same time.

Different PVCs or PVC groups on the same interface cannot be mapped to the same IP address.

The PVCs or PVC groups on the same interface can be configured with only one default mapping.

If you do not specify any arguments or keywords, the undo map ip command deletes all static IP address mappings, default mappings, and InARP mappings on the PVC or PVC group.

This command is not applicable to PVCs in a PVC group.

Examples

# Create a static IP address mapping on PVC 1/32, and set the IP address of the remote end to 61.123.30.169.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/32

[Sysname-ATM2/4/0-pvc-1/32] map ip 61.123.30.169

# Enable InARP mapping on PVC 1/33, and set the InARP packet sending interval to 10 minutes.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/33

[Sysname-ATM2/4/0-pvc-1/33] map ip inarp 10

# Delete all IP address mappings on PVC 1/33.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/33

[Sysname-ATM2/4/0-pvc-1/33] undo map ip

Related commands

encapsulation

map ppp

Use map ppp to create a PPPoA mapping for a PVC or PVC group.

Use undo map ppp to delete the PPPoA mapping.

Syntax

map ppp virtual-template vt-number

undo map ppp

Default

No PPPoA mappings for a PVC or PVC group exist.

Views

PVC view

PVC group view

Predefined user roles

network-admin

Parameters

vt-number: Specifies the number of the VT interface corresponding to a PPPoA mapping. The VT interface must have already been created.

Usage guidelines

aal5snap and aal5mux encapsulations support PPPoA mapping.

A PVC or PVC group can be mapped to only one VT interface.

This command is not applicable to PVCs in a PVC group.

Examples

The following example demonstrates a complete process of PPPoA configuration.

# Create VT interface Virtual-Template 10, and configure an IP address for it.

<Sysname> system-view

[Sysname] interface virtual-template 10

[Sysname-Virtual-Template10] ip address 202.38.160.1 255.255.255.0

[Sysname-Virtual-Template10] quit

# Create PVC 1/101 on ATM 2/4/0.

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/101

# Create a PPPoA mapping using the created VT interface.

[Sysname-ATM2/4/0-pvc-1/101] map ppp virtual-template 10

Related commands

encapsulation

mtu

Use mtu to configure the MTU for an ATM interface.

Use undo mtu to restore the default.

Syntax

mtu size

undo mtu

Default

The MTU of an ATM interface is 1500 bytes.

Views

VEth interface view

VEth subinterface view

Predefined user roles

network-admin

Parameters

size: Specifies the MTU in bytes. The value range for this argument is 46 to 1500.

Usage guidelines

The MTU setting can affect IP packet fragmentation and reassembly on the interface.

To validate the MTU setting for an interface, execute the shutdown command and then the undo shutdown command on the interface.

Examples

# Set the MTU for VEth 2/4/0 to 200 bytes.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/0

[Sysname- Virtual-Ethernet2/4/0] mtu 200

oam ais-rdi

Use oam ais-rdi to configure the parameters related to AIS/RDI alarm cell detection.

Use undo oam ais-rdi to restore the default.

Syntax

oam ais-rdi up up-seconds down down-seconds

undo oam ais-rdi

Default

A PVC comes up if no AIS/RDI alarm cells are received in the last three seconds, and it goes down if it receives successive AIS/RDI alarm cells in one second.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

Parameters

up up-seconds: Specifies the time (in seconds) within which the PVC comes up if no AIS/RDI alarm cells are received. The value range for the up-seconds argument is 3 to 60 seconds.

down down-seconds: Specifies the time (in seconds) within which the PVC goes down if it receives successive AIS/RDI alarm cells. The value range for the down-seconds argument is 1 to 60 seconds.

Usage guidelines

The system uses a 1-second timer to detect AIS/RDI alarm cells.

· A PVC goes down if it receives successive AIS/RDI alarm cells in the time period specified by the down-seconds argument.

· A PVC comes up if no AIS/RDI alarm cells are received in the time period specified by the up-seconds argument.

Examples

# Configure the AIS/RDI alarm detection parameters for PVC 1/32, setting up-seconds to 5 and down-seconds to 5.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/32

[Sysname-ATM2/4/0-pvc-1/32] oam ais-rdi up 5 down 5

# Configure the AIS/RDI alarm detection parameters for PVC 1/33 of PVC group 2, setting up-seconds to 5 and down-seconds to 5.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 2

[Sysname-ATM2/4/0-pvc-group-2] pvc 1/33

[Sysname-ATM2/4/0-pvc-group-2-pvc-1/33] oam ais-rdi up 5 down 5

oam loopback

Use oam loopback to enable OAM F5 Loopback cell transmission and retransmission detection and modify related parameters.

Use undo oam loopback to disable OAM F5 Loopback cell transmission and retransmission detection.

Syntax

oam loopback interval [ up up-count down down-count retry retries ]

undo oam loopback

Default

OAM F5 Loopback cell transmission is disabled. Responses are sent if OAM F5 Loopback cells are received.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for sending OAM F5 Loopback cells, in the range of 1 to 600 seconds.

up up-count: Specifies the number of successive OAM F5 Loopback cells received before the PVC comes up. The value range for the up-count argument is 1 to 600, and the default is 3.

down down-count: Specifies the number of successive OAM F5 Loopback cells not received before the PVC goes down. The value range for the down-count argument is 1 to 600, and the default is 5.

retry retries: Specifies the interval for sending retransmission detection cells before PVC state change. The value range for the retries argument is 1 to 1000 seconds, and the default is 1 second.

Usage guidelines

After you enable OAM F5 Loopback cell transmission and retransmission detection on a PVC, the PVC sends OAM F5 Loopback cells at the interval specified by the interval argument. If the PVC receives no responses after a time period specified by the retries argument, it immediately sends OAM F5 Loopback cells again.

The PVC state is updated during the OAM F5 Loopback cell transmission and retransmission detection process.

· If the PVC is down, it comes up when the number of successive OAM F5 Loopback cells received reaches the value specified by the up-count argument.

· If the PVC is up, it goes down when the number of successive OAM F5 Loopback cells not received reaches the value specified by the down-count argument.

Examples

# Enable OAM F5 Loopback detection on PVC 1/32 of ATM 2/4/0, and set the interval, up-count, down-count, and retries arguments to 12, 4, 4, and 1, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/32

[Sysname-ATM2/4/0-pvc-1/32] oam loopback 12 up 4 down 4 retry 1

# Enable OAM F5 Loopback detection on PVC 1/33 of PVC group 2, and set the interval, up-count, down-count, and retries arguments to 12, 4, 3, and 2, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 2

[Sysname-ATM2/4/0-pvc-group-2] pvc 1/33

[Sysname-ATM2/4/0-pvc-group-2-pvc-1/33] oam loopback 12 up 4 down 3 retry 2

oam ping

Use oam ping to send OAM F5 end-to-end cells through the specified PVC on an ATM interface to check the link state.

Syntax

oam ping interface interface-type { interface-number | interface-number.subnumber } pvc { pvc-name | vpi/vci } [ number timeout ]

Views

Any view

Predefined user roles

network-admin

Parameters

interface interface-type { interface-number | interface-number.subnumber }: Specifies an interface by its type and number. Both ATM interfaces and ATM subinterfaces are supported.

pvc: Sends OAM F5 end-to-end cells through the specified PVC.

pvc-name: Specifies a PVC by its name, a case-sensitive string of 1 to 15 characters, excluding slashes (/) and hyphens (-). For example, neither 1/20 nor a-b is a valid PVC name.

number: Specifies the number of OAM F5 end-to-end cells to be transmitted, in the range of 1 to 1000. The default is 5.

timeout: Specifies the OAM F5 end-to-end response timeout period in the range of 1 to 30 seconds. The default is 2 seconds.

Usage guidelines

Use this command to send OAM F5 end-to-end cells through the specified PVC on the specified ATM interface, and check the link state according to the response condition.

After you configure the oam ping command, the system sends an OAM F5 end-to-end cell. If the system receives a response within the time specified by the timeout argument, it immediately sends another OAM F5 end-to-end cell. If the system does not receive a response within the time specified by the timeout argument, the system sends an OAM F5 end-to-end cell again. In an oam ping process, the number of OAM F5 end-to-end cells transmitted is specified by the number argument. If no response is received, a link failure or link congestion might occur.

Examples

# Check the link state of PVC 1/32 on ATM 2/4/0 by sending three cells and setting the timeout period to 1 second.

<Sysname> oam ping interface atm 2/4/0 pvc 1/32 3 1

PING interface ATM2/4/0 pvc 1/32 with 3 of 53 bytes of oam F5 end-to-end cell(s),

timeout is 1 second(s), press CTRL_C to break

Receive reply from pvc 1/32: time=1 ms

oam ping statistics:

Cells: Sent = 3, Received = 3, Lost = 0 (0.00% loss)

# Check the link state of PVC 5/100 on ATM 2/4/0 by sending three cells and setting the timeout period to 1 second.

<Sysname> oam ping interface atm 2/4/0 pvc 5/100 3 1

PING interface ATM2/4/0 pvc 5/100 with 3 of 53 bytes of oam F5 end-to-end cell(s),

timeout is 1 second(s), press CTRL_C to break

Request time out!

oam ping statistics:

Cells: Sent = 3, Received = 0, Lost = 3 (100.00% loss)

Table 8 Command output

Field	Description
PING interface ATM2/4/0 pvc 1/32	Check if the link of PVC 1/32 on ATM 2/4/0 is available.
53 bytes	Number of bytes in each cell.
timeout is 1 second(s)	Response timeout period.
Receive reply from pvc 1/32: time=1 ms	A response is received within the specified time.
Request time out	No response is received within the specified timeout period.
Sent = 3	Number of transmitted cells.
Received = 0	Number of received responses.
Lost = 3(100.00% loss)	Cell loss rate (percentage of the number of unresponded cells to the total number of cells transmitted).

precedence

Use precedence to configure the priority of IP packets carried by the PVC of a PVC group.

Use undo precedence to restore the default.

Syntax

precedence { min-number [ to max-number ] | default }

undo precedence

Default

No priority is configured for IP packets.

Views

PVC view in a PVC group

Predefined user roles

network-admin

Parameters

min-number: Specifies the lowest priority of IP packets carried by the PVC, in the range of 0 to 7.

max-number: Specifies the highest priority of IP packets carried by the PVC, in the range of 0 to 7. The max value must be equal to or larger than the min value.

default: Specifies the PVC as the default PVC. IP packets with priorities not specified for any PVC are sent through the default PVC.

Usage guidelines

This command is applicable only to the PVCs in a PVC group.

If no default PVC exists in a PVC group, IP packets with priorities not specified for any PVC are distributed across all PVCs that are not configured with priorities on a per-packet basis.

If no PVC is specified as the default PVC and all PVCs are configured with transmission priorities, IP packets with priorities not specified for any PVC are dropped.

This command cannot change the priority of an IP packet.

Examples

# Configure PVC aa with a VPI/VCI value of 1/32 to carry IP packets with priorities from 0 to 3.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1] pvc aa 1/32

[Sysname-ATM2/4/0-pvc-group-1-pvc-aa-1/32] precedence 0 to 3

pvc

In ATM interface view or ATM subinterface view:

Use pvc to create a PVC and enter its view, or enter the view of an existing PVC.

Use undo pvc to delete a PVC.

In PVC group view:

Use pvc to create a PVC for a PVC group and enter PVC view, or enter the view of an existing PVC.

Use undo pvc to remove a PVC from a PVC group and delete the PVC.

Syntax

pvc { pvc-name [ vpi/vci ] | vpi/vci }

undo pvc { pvc-name | vpi/vci }

Default

No PVCs exist.

Views

ATM interface view

ATM subinterface view

PVC group view

Predefined user roles

network-admin

Parameters

pvc-name: Specifies a PVC by its name, a case-sensitive string of 1 to 15 characters, excluding slashes (/) and hyphens (-). For example, neither 1/20 nor a-b is a valid PVC name.

Table 9 VCI value ranges for different interface types

Interface type	VCI value range
ATM ADSL2+	0 to 255
ATM SHDSL_4WIRE	0 to 255
ATM SHDSL_8WIRE_BIS	0 to 255
ATM OC-3c/STM-1	0 to 1023
ATM subinterface	Same as that of the ATM interface to which the ATM subinterface belongs.
PVC group	Same as that of the ATM interface to which the PVC group belongs.

Usage guidelines

When you create a PVC, you must specify the VPI/VCI value for it. The VPI/VCI value of a PVC is unique on an interface (including interface, PVC group, and subinterface).

If you have specified the PVC name when creating the PVC, you can enter the PVC view by using the pvc pvc-name [ vpi/vci ] command, and delete the PVC by using the undo pvc pvc-name [ vpi/vci ] or undo pvc vpi/vci command.

You can configure only one PVC on an ATM P2P subinterface.

You can create a maximum of eight PVCs in a PVC group.

You cannot delete a PVC from a PVC group in ATM interface view or ATM subinterface view.

Examples

# Create a PVC named aa on ATM 2/4/0, and set its VPI/VCI value to 1/101.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-aa-1/101]

# Create a PVC named bb for PVC group 1, and set its VPI/VCI value to 1/102.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1] pvc bb 1/102

[Sysname-ATM2/4/0-pvc-group-1-pvc-bb-1/102]

Related commands

display atm pvc-info

pvc-group

Use pvc-group to create a PVC group and enter its view, or enter the view of an existing PVC group.

Use undo pvc-group to delete a PVC group.

Syntax

pvc-group group-number

undo pvc-group group-number

Default

No PVC groups exist.

Views

ATM interface view

ATM subinterface view

Predefined user roles

network-admin

Parameters

group-number: Specifies a PVC group by its number in the range of 1 to 128.

Usage guidelines

A PVC group can share traffic load among PVCs in it by transmitting IP packets of different priorities through different PVCs.

You can configure the priority of IP packets carried by each PVC. IP packets are transmitted through the PVC corresponding to the priority of the IP packets.

· If no corresponding PVC is found, the IP packets are transmitted through the default PVC.

· If no default PVC is configured, the IP packets are distributed across the PVCs that are not configured with priorities on a per-packet basis.

· If all PVCs are configured with priorities, the IP packets are dropped.

Data packets that are not IP packets are distributed across all PVCs in the PVC group on a per-packet basis.

All PVCs in a PVC group obtain the encapsulation type and protocol type from the PVC group.

A PVC belongs to one PVC group.

This command is applicable to ATM P2MP subinterfaces, but not to ATM P2P subinterfaces.

The number of a PVC group is unique on an interface (including interface and subinterface).

Examples

# Create PVC group 1.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1]

Related commands

display atm pvc-group

precedence

remark atm-clp

Use remark atm-clp to re-mark the cell loss priority (CLP) flag value of ATM cells.

Use undo remark atm-clp to restore the default.

Syntax

remark [ green | red | yellow ] atm-clp atm-clp-value

undo remark [ green | red | yellow ] atm-clp

Default

The CLP flag value of ATM cells is not re-marked.

Views

Traffic behavior view

Predefined user roles

network-admin

Parameters

green: Re-marks the CLP flag value of a green packet.

red: Re-marks the CLP flag value of a red packet.

yellow: Re-marks the CLP flag value of a yellow packet.

atm-clp-value: Sets the CLP flag value to 0 or 1. The cells with a CLP flag value of 1 are dropped first when network congestion occurs.

Usage guidelines

This command is applicable only to outbound PVCs.

Examples

# Set the CLP flag value of ATM cells to 1.

<Sysname> system-view

[Sysname] traffic behavior database

[Sysname-behavior-database] remark atm-clp 1

reset atm interface

Use reset atm interface to clear PVC statistics.

Syntax

reset atm interface [ interface-type { interface-number | interface-number.subnumber } ]

Views

User view

Predefined user roles

network-admin

Parameters

interface-type { interface-number | interface-number.subnumber }: Clears statistics about all PVCs (including PVCs on the interface and PVCs of the PVC groups) for the specified interface. Both ATM interfaces and ATM subinterfaces are supported. If you do not specify an interface, this command clears statistics about all PVCs for all interfaces.

Usage guidelines

This command clears statistics only about PVCs. To clear statistics about interfaces, use the reset counters interface command.

Examples

# Clear statistics about all PVCs for ATM 2/4/0.

<Sysname> reset atm interface atm 2/4/0

reset counters interface ve-bridge

Use reset counters interface ve-bridge to clear VEB interface statistics.

Syntax

reset counters interface [ ve-bridge [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

ve-bridge [ interface-number ]: Specifies a VEB interface by its number. If you do not specify the ve-bridge keyword, this command clears statistics for all interfaces except VA interfaces. If you specify the ve-bridge keyword but do not specify the interface-number argument, this command clears statistics for all VEB interfaces. If you specify both the ve-bridge keyword and the interface-number argument, this command clears statistics for the specified VEB interface.

Usage guidelines

Before you collect traffic statistics within a specific time period on an interface, clear the existing statistics for the interface.

Examples

# Clear statistics for VE-Bridge 3/0/1.

<Sysname> reset counters interface ve-bridge 3/0/1

reset counters interface virtual-ethernet

Use reset counters interface virtual-ethernet to clear VEth interface statistics.

Syntax

reset counters interface [ virtual-ethernet [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

Parameters

virtual-ethernet [ interface-number ]: Specifies a VEth interface by its number. If you do not specify the virtual-ethernet keyword, this command clears statistics for all interfaces except VA interfaces. If you specify the virtual-ethernet keyword but do not specify the interface-number argument, this command clears statistics for all VEth interfaces. If you specify both the virtual-ethernet keyword and the interface-number argument, this command clears statistics for the specified VEth interface.

Usage guidelines

Before you collect traffic statistics within a specific time period on an interface, clear the existing statistics for the interface.

Examples

# Clear statistics for Virtual-Ethernet 2/4/2.

<Sysname> reset counters interface virtual-ethernet 2/4/2

service cbr

Use service cbr to set the PVC service type to CBR and set the related parameters.

Use undo service to restore the default.

Syntax

service cbr output-pcr [ cdvt cdvt_value ]

undo service

Default

The service type of a PVC is UBR. The peak output rate of ATM cells equals the maximum bandwidth of the interface to which the PVC belongs.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

Parameters

output-pcr: Specifies the peak output rate of ATM cells in kbps. Table 10 shows the value ranges for the output-pcr argument on different interfaces.

Table 10 Peak output rate value ranges

Interface type	Peak output rate value range
ATM ADSL2+	64 to 640
ATM SHDSL_4WIRE	128 to 4624
ATM SHDSL_8WIRE_BIS	256 to 22784
ATM OC-3c/STM-1	64 to 155000
ATM subinterface	Same as that of the ATM interface to which the ATM subinterface belongs.
PVC group	Same as that of the ATM interface to which the PVC group belongs.

cdvt cdvt_value: Specifies the cell delay variation tolerance in the range of 0 to 10000 μs. The default is 500 μs, which means that the maximum cell delay is 500 μs.

Usage guidelines

When the peak output rate is exceeded, the system allocates caches based on the specified CDVT value to ensure service stability. A smaller CDVT value requires more hardware resources and is harder to configure. If the configuration fails, the following message appears: "Failed to set service parameter. Please adjust cdvt value." In this situation, configure a larger CDVT value.

You can use this command as well as the service ubr, service vbr-nrt, and service vbr-rt commands to set the service type and parameters of a PVC. If you execute this command multiple times, the most recent configuration takes effect.

Each PVC occupies a separate bandwidth. As a best practice, configure PVCs requiring more bandwidths first.

Examples

# Create a PVC named aa on ATM 2/4/0, and set the VPI/VCI, service type, output-pcr, and cdvt_value to 1/101, CBR, 50000, and 1000, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-aa-1/101] service cbr 50000 cdvt 1000

# Create a PVC named aa in PVC group 1, and set the VPI/VCI, service type, output-pcr, and cdvt_value to 1/101, CBR, 50000, and 1000, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-group-1-pvc-aa-1/101] service cbr 50000 cdvt 1000

Related commands

service ubr

service vbr-nrt

service vbr-rt

service ubr

Use service ubr to set the PVC service type to UBR and set the related parameters.

Use undo service to restore the default.

Syntax

service ubr output-pcr

undo service

Default

The service type of a PVC is UBR. The peak output rate of ATM cells equals the maximum bandwidth of the interface to which the PVC belongs.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

Parameters

output-pcr: Specifies the peak output rate of ATM cells in kbps. For more information about the value range, see Table 10.

Usage guidelines

You can use this command as well as the service cbr, service vbr-nrt, and service vbr-rt commands to set the service type and parameters of a PVC. If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Create a PVC named aa on ATM 2/4/0, and set the VPI/VCI, service type, and output-pcr to 1/101, UBR, and 100000, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-aa-1/101] service ubr 100000

# Create a PVC named aa in PVC group 1, and set the VPI/VCI, service type, and output-pcr to 1/101, UBR, and 100000, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-group-1-pvc-aa-1/101] service ubr 100000

Related commands

service cbr

service vbr-nrt

service vbr-rt

service vbr-nrt

Use service vbr-nrt to set the PVC service type to VBR-NRT and set the related parameters.

Use undo service to restore the default.

Syntax

service vbr-nrt output-pcr output-scr output-mbs

undo service

Default

The service type of a PVC is UBR. The peak output rate of ATM cells equals the maximum bandwidth of the interface to which the PVC belongs.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

Parameters

output-pcr: Specifies the peak output rate of ATM cells in kbps. For more information about the value range, see Table 10.

output-scr: Specifies the sustainable output rate of ATM cells in kbps. Its value ranges are the same as those of the output-pcr argument, and its value is equal to or smaller than the value of the output-pcr argument.

output-mbs: Specifies the maximum burst size for ATM cells (maximum number of ATM cells that the output interface can cache). The value range for this argument is 1 to 512.

Usage guidelines

You can use this command as well as the service cbr, service ubr, and service vbr-rt commands to set the service type and parameters of a PVC. If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Create a PVC named aa on ATM 2/4/0, and set the VPI/VCI, service type, output-pcr, output-scr, and output-mbs to 1/101, VBR-NRT, 100000, 50000, and 320, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-aa-1/101] service vbr-nrt 100000 50000 320

# Create a PVC named aa in PVC group 1, and set the VPI/VCI, service type, output-pcr, output-scr, and output-mbs to 1/101, VBR-NRT, 100000, 50000, and 320, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-group-1-pvc-aa-1/101] service vbr-nrt 100000 50000 320

Related commands

service cbr

service ubr

service vbr-rt

Use service vbr-rt to set the PVC service type to VBR-RT and set the related parameters.

Use undo service to restore the default.

Syntax

service vbr-rt output-pcr output-scr output-mbs

undo service

Default

The service type of a PVC is UBR. The peak output rate of ATM cells equals the maximum bandwidth of the interface to which the PVC belongs.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

Parameters

output-pcr: Specifies the peak output rate of ATM cells in kbps. For more information about the value range, see Table 10.

output-mbs: Specifies the maximum burst size of ATM cells (maximum number of ATM cells that the output interface can cache). The value range for this argument is 1 to 512.

Usage guidelines

You can use this command as well as the service cbr, service ubr, and service vbr-nrt commands to set the service type and parameters of a PVC. If you execute this command multiple times, the most recent configuration takes effect.

This command is not applicable to ATM E1 interfaces.

Examples

# Create a PVC named aa on ATM 2/4/0, and set the VPI/VCI, service type, output-pcr, output-scr, and output-mbs to 1/101, VBR-RT, 100000, 50000, and 320, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-aa-1/101] service vbr-rt 100000 50000 320

# Create a PVC named aa in PVC group 1, and set the VPI/VCI, service type, output-pcr, output-scr, and output-mbs to 1/101, VBR-RT, 100000, 50000, and 320, respectively.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-group-1-pvc-aa-1/101] service vbr-rt 100000 50000 320

Related commands

service cbr

service ubr

service vbr-nrt

shutdown (VEth interface view/VEth subinterface view/VEB interface view)

Use shutdown to shut down an interface.

Use undo shutdown to bring up an interface.

Syntax

shutdown

undo shutdown

Default

An interface is up.

Views

VEth interface view

VEth subinterface view

VEB interface view

Predefined user roles

network-admin

Usage guidelines

The shutdown command might cause unavailability of ATM functions on the interface. Before executing this command, make sure you fully understand its potential impact on the network.

Examples

# Shut down Virtual-Ethernet 2/4/1.

<Sysname> system-view

[Sysname] interface virtual-ethernet 2/4/1

[Sysname-Virtual-Ethernet2/4/1] shutdown

shutdown (PVC view/PVC view in a PVC group)

Use shutdown to shut down a PVC.

Use undo shutdown to bring up a PVC.

Syntax

shutdown

undo shutdown

Default

A PVC is up.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

Usage guidelines

The shutdown command might cause unavailability of ATM functions on the PVC. Before executing this command, make sure you fully understand its potential impact on the network.

Examples

# Bring up PVC 0/100 on ATM 2/4/0.1.

<Sysname> system-view

[Sysname] interface Atm 2/4/0.1

[Sysname-ATM2/4/0.1] pvc 0/100

[Sysname-ATM2/4/0.1-pvc-0/100] undo shutdown

# Bring up PVC 1/101 in PVC group 1.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-group-1-pvc-aa-1/101] undo shutdown

transmit-priority

Use transmit-priority to configure the transmission priority for a PVC associated with the UBR, VBR-NRT, or VBR-RT service.

Use undo transmit-priority to restore the default.

Syntax

transmit-priority priority

undo transmit-priority

Default

The transmission priorities of the UBR service, VBR-NRT service, and VBR-RT service are 0, 5, and 8, respectively.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

Parameters

priority: Specifies the transmission priority in the range of 0 to 9. A higher value indicates a higher priority. Priorities 0 to 4 are for the UBR service, 5 to 7 are for the VBR-NRT service, and 8 to 9 are for the VBR-RT service.

Usage guidelines

PVCs with higher priorities occupy more bandwidths. PVCs with the same priority occupy the same bandwidth.

If you change the service type of a PVC, the transmission priority of the PVC is restored to the default.

Examples

# Set the transmission priority for PVC 1/32 of ATM 2/4/0 to 3.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc 1/32

[Sysname-ATM2/4/0-pvc-1/32] transmit-priority 3

# Set the transmission priority for PVC 1/101 in PVC group 1 to 4.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] pvc-group 1

[Sysname-ATM2/4/0-pvc-group-1] pvc aa 1/101

[Sysname-ATM2/4/0-pvc-group-1-pvc-aa-1/101] transmit-priority 4

vp limit

Use vp limit to configure parameters for VP policing.

Use undo vp limit to restore the default.

Syntax

vp limit vpi scr

undo vp limit vpi

Default

VP policing is disabled.

Views

ATM interface view

Predefined user roles

network-admin

Parameters

vpi: Specifies the VPI value in the range of 0 to 255.

scr: Specifies the sustainable cell rate in kbps. For more information about the value range, see Table 10.

Usage guidelines

A VP is the collection of all PVCs with the same VPI value. VP policing is used to manage the maximum bandwidth of the VP, and monitor the traffic of the inbound and outbound directions of the VP on a physical interface. When the maximum transmission rate of the VP exceeds the specified value, the exceeded flows are dropped.

When VP policing is applied, the parameters of PVC are still valid. Packets can be transmitted or received only when the parameters of PVC and VP policing are met. In calculating the traffic, the LLC/SNAP, MUX, and NLPID headers are included, but the ATM cell header is not included.

Examples

# Set the flow of the VP with a VPI value of 1 to 2 Mbps.

<Sysname> system-view

[Sysname] interface atm 2/4/0

[Sysname-ATM2/4/0] vp limit 1 2000

Related commands

service cbr

service ubr

service vbr-nrt

service vbr-rt

05-Layer 2—WAN Access Command Reference

ATM commands

description

display interface virtual-ethernet

mac-address

map ip

oam loopback

reset atm interface

service cbr

shutdown (VEth interface view/VEth subinterface view/VEB interface view)

shutdown (PVC view/PVC view in a PVC group)

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