ATM commands -- bandwidth

Use bandwidth to configure the expected bandwidth for an interface.

Use undo bandwidth to restore the default.

Syntax

bandwidth bandwidth-value

undo bandwidth

Default

The expected bandwidth (in kbps) is the interface baud rate divided by 1000.

Views

VE interface view

VE subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.

Usage guidelines

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 Guide s.

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

ATM commands -- 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

mdc-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

ATM commands -- default

Use default to restore the default settings for an interface.

Syntax

default

Views

VE interface view

VE subinterface view

Predefined user roles

network-admin

mdc-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

ATM commands -- 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

VE interface view

VE subinterface view

Predefined user roles

network-admin

mdc-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

ATM commands -- 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

mdc-admin

mdc-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 8. 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 VE 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 VE interface is down, or both the PVC (PVC group) and the VE interface are down.
Interval | Interval (in minutes) at which InARP packets are sent.
Interface | VE interface that carries PPPoA or EoA.

ATM commands -- 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

mdc-admin

mdc-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: ?span style='font:7.0pt "Times New Roman"'> The interface is administratively up but physically down (probably because no physical link is available or the link has failed). ?span style='font:7.0pt "Times New Roman"'> 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: ?span style='font:7.0pt "Times New Roman"'> State of the ATM interface to which the PVC belongs. ?span style='font:7.0pt "Times New Roman"'> Shutdown state. ?span style='font:7.0pt "Times New Roman"'> OAM state. · DOWN—One or more of the following states is down: ?span style='font:7.0pt "Times New Roman"'> State of the ATM interface to which the PVC belongs. ?span style='font:7.0pt "Times New Roman"'> Shutdown state. ?span style='font:7.0pt "Times New Roman"'> 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: ?span style='font:7.0pt "Times New Roman"'> The interface is administratively up and physically down (probably because no physical link is available or the link has failed). ?span style='font:7.0pt "Times New Roman"'> 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: ?span style='font:7.0pt "Times New Roman"'> State of the ATM interface to which the PVC belongs. ?span style='font:7.0pt "Times New Roman"'> Shutdown state. ?span style='font:7.0pt "Times New Roman"'> OAM state. · DOWN—One or more of the following states is down: ?span style='font:7.0pt "Times New Roman"'> State of the ATM interface to which the PVC belongs. ?span style='font:7.0pt "Times New Roman"'> Shutdown state. ?span style='font:7.0pt "Times New Roman"'> 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.

ATM commands -- 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

mdc-admin

mdc-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.

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 8. 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.

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: ?span style='font:7.0pt "Times New Roman"'> State of the ATM interface to which the PVC belongs. ?span style='font:7.0pt "Times New Roman"'> Shutdown state. ?span style='font:7.0pt "Times New Roman"'> OAM state. · DOWN—One or more of the following states is down: ?span style='font:7.0pt "Times New Roman"'> State of the ATM interface to which the PVC belongs. ?span style='font:7.0pt "Times New Roman"'> Shutdown state. ?span style='font:7.0pt "Times New Roman"'> 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: ?span style='font:7.0pt "Times New Roman"'> The interface is administratively up and physically down (probably because no physical link is available or the link has failed). ?span style='font:7.0pt "Times New Roman"'> 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: ?span style='font:7.0pt "Times New Roman"'> State of the ATM interface to which the PVC belongs. ?span style='font:7.0pt "Times New Roman"'> Shutdown state. ?span style='font:7.0pt "Times New Roman"'> OAM state. · DOWN—One or more of the following states is down: ?span style='font:7.0pt "Times New Roman"'> State of the ATM interface to which the PVC belongs. ?span style='font:7.0pt "Times New Roman"'> Shutdown state. ?span style='font:7.0pt "Times New Roman"'> 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.

ATM commands -- display interface virtual-ethernet

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

virtual-ethernet [ interface-number ]: Specifies a VE interface by its number. If you do not specify the virtual-ethernet keyword, this command displays information about all 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 VE 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 interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

VE1 DOWN DOWN --

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

<Sysname> display interface virtual-ethernet brief down

Brief information on interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Interface Link Cause

VE2/4/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.
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 is 192.168.1.200/24 Primary | IP address of the interface. The primary attribute indicates that the address is the primary IP address.
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 interface(s) under 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.
Main 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).

ATM commands -- 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

mdc-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, IPoEoA, PPPoA, and PPPoEoA mappings.

· aal5mux encapsulation supports IPoA, IPoEoA, 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, IPoEoA, 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

ATM commands -- interface virtual-ethernet

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

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

Syntax

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

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

Default

No VE interface or VE subinterfaces exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

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

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

Usage guidelines

The baud rate of the VE interface is 10000000 bps.

Examples

# Create VE 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 VE 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]

ATM commands -- mac-address

Use mac-address to specify the MAC address for a VE interface.

Use undo mac-address to restore the default.

Syntax

mac-address mac-address

undo mac-address

Default

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

Views

VE interface view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

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

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

· The VE 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

ATM commands -- map bridge

Use map bridge to create an IPoEoA mapping or 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

Default

No IPoEoA mappings or PPPoEoA mappings exist.

Views

PVC view

PVC group view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

aal5snap and aal5mux encapsulations support IPoEoA and PPPoEoA mappings.

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

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

A VE interface can only be bound to the PVC or PVC group on the same interface card. Before you bind a VE interface, check its interface number to make sure the VE 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 IPoEoA or PPPoEoA, you must specify a VE interface.

Examples

The following example demonstrates a complete process of IPoEoA configuration.

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

<Sysname> system-view

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

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

[Sysname-Virtual-Ethernet2/4/1] ip address 10.1.1.1 255.255.0.0

[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 IPoEoA mapping using the created VE interface in PVC view.

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

Related commands

encapsulation

ATM commands -- 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

mdc-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.

A PVC or PVC group can be configured with multiple IP address mappings, including static IP address mapping, default mapping, and InARP mapping.

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

ATM commands -- 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

mdc-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

ATM commands -- 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

VE interface view

VE subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

size: Specifies the MTU in bytes. The value range for this argument varies by device model.

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 VE 2/4/0 to 200 bytes.

<Sysname> system-view

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

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

ATM commands -- 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

mdc-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

ATM commands -- oam cc

Use oam cc to enable OAM CC on the PVC.

Use undo oam cc to disable OAM CC on the PVC.

Syntax

oam cc { both | sink | source }

undo oam cc

Default

OAM CC is disabled.

Views

PVC view

PVC view in a PVC group

Predefined user roles

network-admin

mdc-admin

Parameters

both: Enables the PVC as both the CC cell source and the CC cell sink (receiver).

sink: Enables the PVC as the CC cell sink to receive and process CC cells.

source: Enables the PVC as the CC cell source to generate CC cells.

Usage guidelines

When you configure OAM CC on a PVC, configure one end of the PVC as the CC cell source and the other end as the CC cell sink.

After you enable OAM CC on a PVC, if the detecting end fails to receive CC cells within 3 seconds, the state of the PVC changes to down. The PVC state changes to up only after CC cells are received again.

Examples

# Enable OAM CC on PVC 1/32 of ATM 2/4/0.

<Sysname> system-view

[Sysname] interface atm 2/4/0

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

[Sysname-ATM2/4/0-pvc-1/32] oam cc sink

# Enable OAM CC on PVC 1/33 of PVC group 2.

<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 cc both

ATM commands -- 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

mdc-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

ATM commands -- 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

mdc-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.

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 8. 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.

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

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

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!

Request time out!

Request time out!

oam ping statistics:

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

Table 7 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).

ATM commands -- 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

mdc-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

ATM commands -- 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

mdc-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.

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 8. 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.

Table 8 VCI value ranges for different interface types

Interface type | VCI value range
ATM ADSL | 0 to 255
ATM ADSL2+ | 0 to 255
ATM G.SHDSL | 0 to 255
ATM SHDSL_4WIRE | 0 to 255
ATM SHDSL_4WIRE_BIS | 0 to 255
ATM SHDSL_8WIRE_BIS | 0 to 255
ATM E1 | 0 to 511
ATM T1 | 0 to 511
ATM E3 | 0 to 1023
ATM T3 | 0 to 1023
ATM OC-3c/STM-1 | 0 to 1023
ATM OC-12c/STM-4 | 0 to 1023
ATM 25M | 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, subinterface, and PVC group).

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.

The number of PVCs that you can create varies by device model.

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

ATM commands -- 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

mdc-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

ATM commands -- 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

mdc-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

ATM commands -- 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

mdc-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

ATM commands -- reset counters interface virtual-ethernet

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

Syntax

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

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

virtual-ethernet [ interface-number ]: Specifies a VE interface by its number. If you do not specify the virtual-ethernet keyword, this command clears statistics for all interfaces. If you specify the virtual-ethernet keyword but do not specify the interface-number argument, this command clears statistics for all VE interfaces. If you specify both the virtual-ethernet keyword and the interface-number argument, this command clears statistics for the specified VE 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

ATM commands -- 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

mdc-admin

Parameters

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

Table 9 Peak output rate value range s

Interface type | Peak output rate value range
ATM ADSL | 64 to 640
ATM ADSL2+ | 64 to 640
ATM G.SHDSL | 64 to 2312
ATM SHDSL_4WIRE | 128 to 4624
ATM SHDSL_4WIRE_BIS | 128 to 11392
ATM SHDSL_8WIRE_BIS | 256 to 22784
ATM E1 | 64 to 1920
ATM T1 | 64 to 1536
ATM E3 | 64 to 34000
ATM T3 | 64 to 44000
ATM OC-3c/STM-1 | 64 to 155000
ATM OC-12c/STM-4 | Not supported
ATM 25M | Not supported
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.

This command is not applicable to ATM E1 and ATM E3 interfaces.

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

ATM commands -- 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

mdc-admin

Parameters

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

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

ATM commands -- 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

mdc-admin

Parameters

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

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

ATM commands -- 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

mdc-admin

Parameters

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

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 of ATM cells (maximum number of ATM cells that the output interface can cache). The value range for this argument is 1 to 512. For ATM E3 interfaces, 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

ATM commands -- shutdown

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

VE interface view

VE subinterface view

Predefined user roles

network-admin

mdc-admin

Examples

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

<Sysname> system-view

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

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

ATM commands -- shutdown

| NOTE: Support for this command depends on the device model.

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

mdc-admin

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

ATM commands -- sub-interface rate-statistic

| CAUTION: This command is resource intensive. When you use this command, make sure you fully understand its impact on system performance.

| NOTE: Support for this command depends on the device model.

Use sub-interface rate-statistic to enable subinterface rate statistics collection for a VE interface.

Use undo sub-interface rate-statistic to disable subinterface rate statistics collection for a VE interface.

Syntax

sub-interface rate-statistic

undo sub-interface rate-statistic

Default

Subinterface rate statistics collection is disabled for a VE interface.

Views

VE interface view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable subinterface rate statistics collection for VE 2/4/0.

<Sysname> system-view

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

[Sysname-Virtual-Ethernet2/4/0] sub-interface rate-statistic

ATM commands -- 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

mdc-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

ATM commands -- 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

mdc-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 9.

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