You must configure this command on a PVC 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.

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

display atm map-info

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

Syntax

display atm map-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 mapping information for a PVC.

pvc-name: Specifies a PVC by its name, a case-sensitive string of 1 to 15 characters excluding quotation marks ("), slashes (/), and hyphens (-). For example, 1", 1/20, and a-b are invalid PVC names.

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 5. 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 mapping information for all PVCs on all ATM interfaces.

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

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

Examples

# Display mapping information for all PVCs on all ATM interfaces.

<Sysname> display atm map-info

ATM2/4/1

PVC 1/32:

Protocol: IP, IP address: 100.11.1.1, 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/1	Interface name.
PVC 1/32	VPI/VCI pair of the PVC.
Protocol	Upper-layer protocol running on the PVC: · IP—IP protocol. · IP InARP—IP InARP protocol.
State	Mapping state: · UP—In IP (including InARP) mappings, it means that the PVC is up. · DOWN—In IP (including InARP) mappings, it means that the PVC is down.
Interval	Interval (in minutes) at which InARP packets are sent.

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 quotation marks ("), slashes (/), and hyphens (-). For example, 1", 1/20, and a-b are invalid PVC names.

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/1

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

Table 2 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 indicates LLC/SNAP encapsulation.
Protocol	Upper-layer protocol running on the PVC: · IP—IP 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

OAM cells received: 42

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

OAM cells sent: 0

F5 Loopback: 0

OAM cell drops: 0

Table 3 Command output

Field	Description
ATM2/4/1	Name of the interface to which the PVC belongs.
Encapsulation	AAL5 encapsulation type of the PVC. SNAP indicates LLC/SNAP encapsulation.
Protocol	Upper-layer protocol running on the PVC: · IP—IP 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.
OAM cells received	Counts of received OAM cells.
F5 Loopback	Counts of received F5 Loopback cells.
F5 AIS	Number of received AIS cells.
F5 RDI	Number of received RDI cells.
OAM cells sent	Number of transmitted OAM cells.
F5 Loopback	Number of transmitted F5 Loopback cells.
OAM cell drops	Number of dropped OAM cells.

map ip

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

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

Views

PVC view

Predefined user roles

network-admin

Parameters

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

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.

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

A PVC can be configured with only one IP address mapping, that is, the static IP address mapping, default mapping, or InARP mapping.

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

The PVCs 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.

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/1

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

[Sysname-ATM2/4/1-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/1

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

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

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

<Sysname> system-view

[Sysname] interface atm 2/4/1

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

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

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

Predefined user roles

network-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/1.

<Sysname> system-view

[Sysname] interface atm 2/4/1

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

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

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

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/1, 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/1

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

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

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.

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/1 by sending three cells and setting the timeout period to 1 second.

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

PING interface ATM2/4/1 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/1 by sending three cells and setting the timeout period to 1 second.

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

PING interface ATM2/4/1 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 4 Command output

Field	Description
PING interface ATM2/4/1 pvc 1/32	Check if the link of PVC 1/32 on ATM 2/4/1 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).

pvc

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.

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

Predefined user roles

network-admin

Parameters

Table 5 VCI value ranges for different interface types

Interface type	VCI value range
ATM OC-3c/STM-1	0 to 1023
ATM OC-12c/STM-4	0 to 1023
ATM subinterface	Same as that of the ATM interface to which the ATM subinterface 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.

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.

Examples

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

<Sysname> system-view

[Sysname] interface atm 2/4/1

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

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

Related commands

display atm pvc-info

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 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/1.

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

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

Predefined user roles

network-admin

Parameters

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

Table 6 Peak output rate value ranges

Interface type	Peak output rate value range
ATM OC-3c/STM-1	64 to 155000
ATM OC-12c/STM-4	64 to 622000
ATM subinterface	Same as that of the ATM interface to which the ATM subinterface 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/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/1

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

[Sysname-ATM2/4/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

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

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/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/1

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

[Sysname-ATM2/4/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

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

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/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/1

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

[Sysname-ATM2/4/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

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

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.

Examples

# Create a PVC named aa on ATM 2/4/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/1

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

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

Related commands

service cbr

service ubr

service vbr-nrt

shutdown

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

Predefined user roles

network-admin

Examples

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

<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] undo shutdown

05-Layer 2 - WAN Access Command Reference

ATM commands

broadcast

display atm map-info

display atm pvc-info

map ip

oam cc

oam loopback

oam ping

pvc

reset atm interface

service cbr

service ubr

service vbr-nrt

service vbr-rt

shutdown

Cloud & AI

InterConnect

Intelligent Computing

Security

SMB Products

Intelligent Terminal Products

Industry Solutions

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Training & Certification

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Online Exhibition Center

Contact Us