Table Of Contents
ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping
Configuring an Individual PVC Within a PVC Range
Deactivating an Individual PVC Within a PVC Range
ATM PVC Range on a Multipoint Subinterface Example
RBE Subinterface Grouping by PVC Range Example
Individual PVC Within a PVC Range Configuration Example
ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping
First Published: November 27, 2000Last Updated: February 28, 2006History for the ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping Feature
Release Modification12.1(5)T
This feature was introduced.
12.2(28)SB
This feature was integrated into Cisco IOS Release 12.2(28)SB.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.
Contents
Feature Overview
In a digital subscriber line (DSL) environment, many applications require the configuration of a large number of ATM permanent virtual circuits (PVCs). The ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping feature enables you to group a number of PVCs together into a PVC range in order to configure them all at once.
For applications that use multipoint subinterfaces, such as PPP over Ethernet and PPP over ATM, the PVC range is on a single multipoint subinterface. For applications that use point-to-point subinterfaces, such as routed bridge encapsulation (RBE), a point-to-point subinterface is created for each PVC in the range.
A PVC range is defined by two VPI-VCI pairs. The two virtual path identifiers (VPIs) define a VPI range, and the two virtual channel identifiers (VCIs) define a VCI range. The number of PVCs in the PVC range equals the number of VPIs in the VPI range multiplied by the number of VCIs in the VCI range.
Once the PVC range is defined, you can configure the range by using the existing interface-ATM-VC configuration commands that are also supported in PVC range configuration mode. The shutdown PVC range command can be used to deactivate the range without deleting the configuration.
The ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping feature also introduces the pvc-in-range command, which allows you to explicitly configure an individual PVC within the defined range of PVCs on a multipoint subinterface. The shutdown PVC-in-range command allows you to deactivate an individual PVC within a range.
Note
You cannot explicitly configure the individual point-to-point subinterfaces created by the PVC range on a point-to-point subinterface. All of the point-to-point subinterfaces in the range share the same configuration as the subinterface on which the PVC range is configured.
Benefits
Saving Time
Configuring a range of PVCs is faster than configuring each PVC individually.
Saving NVRAM
A range of PVCs takes up less NVRAM on network service routers than a large number of individually configured PVCs.
Speeding Boot-Up
The parser can parse one configuration command instead of many, thus speeding boot-up time.
Restrictions
You cannot explicitly configure the individual point-to-point subinterfaces created by the PVC range on a point-to-point subinterface. All of the point-to-point subinterfaces in the range share the same configuration as the subinterface on which the PVC range is configured.
Configuration Tasks
See the following sections for configuration tasks for the ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping feature. Each task in the list is identified as optional or required.
•
Configuring an ATM PVC Range (Required)
•
Deactivating a PVC Range (Optional)
•
Configuring an Individual PVC Within a PVC Range (Optional)
•
Deactivating an Individual PVC Within a PVC Range (Optional)
•
Verifying an ATM PVC Range (Optional)
Configuring an ATM PVC Range
To configure an ATM PVC range, use following commands beginning in global configuration mode:
The number of PVCs in a range can be calculated using the following formula:
number of PVCs = (end-vpi - start-vpi + 1) x (end-vci - start-vci +1).
The start-vpi argument may be omitted if it is zero. The end_vpi argument may be omitted, but if it is omitted, it is assigned the value of start-vpi. The end-vpi and end-vci arguments are always greater than or equal to start-vpi and start-vci, respectively.
Note
For point-to-point subinterfaces, subinterface numbering begins with the subinterface on which the PVC range is configured and increases sequentially through the range.
Deactivating a PVC Range
To deactivate a PVC range, use the following command in PVC range configuration mode:
Configuring an Individual PVC Within a PVC Range
To configure an individual PVC within a PVC range on a multipoint subinterface, use the following commands beginning in global configuration mode:
Deactivating an Individual PVC Within a PVC Range
To deactivate an individual PVC within a range, use the following command in PVC-in-range configuration mode:
Command PurposeRouter(cfg-if-atm-range-pvc)#
shutdownDeactivates an individual PVC within a range.
Verifying an ATM PVC Range
To verify ATM PVC range configuration, use the following EXEC command:
Command PurposeRouter# show atm pvc [vpi/vci | name | interface atm interface-number]
Displays ATM PVCs and traffic information.
Configuration Examples
This section provides the following configuration examples:
•
ATM PVC Range on a Multipoint Subinterface Example
•
RBE Subinterface Grouping by PVC Range Example
•
Individual PVC Within a PVC Range Configuration Example
ATM PVC Range on a Multipoint Subinterface Example
In the following example, a PVC range called "range-pppoa-1" is created with a total of 500 PVCs in the range. PVC parameters are configured for the range, including the assignment of a VC class called "classA."
router(config)# interface atm 6/0.110 multipointrouter(config-subif)# range range-pppoa-1 pvc 100 4/199router(config-if-atm-range)# class-range classArouter(config-if-atm-range)# ubr 1000router(config-if-atm-range)# encapsulation aal5snaprouter(config-if-atm-range)# protocol ppp virtual-template 2RBE Subinterface Grouping by PVC Range Example
In the following example, a PVC range called "range1" is created with a total of 100 PVCs in the range. A point-to-point subinterface will be created for each PVC in the range.
Router(config)# interface atm 6/0.200 point-to-pointRouter(config-subif)# ip unnumbered loopback 1Router(config-subif)# atm route-bridged ipRouter(config-subif)# range range1 pvc 1/200 1/299Router(config-if-atm-range)# endIndividual PVC Within a PVC Range Configuration Example
In the following example, "pvc1" within the PVC range called "range1" is deactivated.
router(config)# interface atm 6/0.110 multipointrouter(config-subif)# range range1 pvc 100 4/199router(config-if-atm-range)# class-range classArouter(config-if-atm-range)# pvc-in-range pvc1 3/104router(cfg-if-atm-range-pvc)# shutdownAdditional References
The following sections provide references related to ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping.
Related Documents
Related Topic Document TitleConfiguring ATM
"Configuring ATM" chapter in the Cisco IOS Wide-Area Networking Configuration Guide, Release 12.2
Standards
MIBs
MIB MIBs LinkNone
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
RFCs
Technical Assistance
Command Reference
This section documents modified commands only.
class-range
To assign a virtual circuit (VC) class to an ATM permanent virtual circuit (PVC) range, use the class-range command in PVC range configuration mode. To remove the VC class, use the no form of this command.
class-range class-name
no class-range class-name
Syntax Description
Defaults
No VC class is assigned to the PVC range.
Command Modes
PVC range configuration
Command History
Release Modification12.1(5)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
When you create a VC class for an ATM PVC range, you can use the following commands to define your parameters: abr, broadcast, cbr, encapsulation aal5, ilmi manage, inarp, oam-pvc, oam retry, protocol, ubr, ubr+, vbr-nrt, and vbr-rt.
Parameters that are configured for a PVC range through discrete commands entered in PVC range configuration mode supersede VC class parameters assigned to an ATM PVC range using the class-range command.
Examples
In the following example, a class called "classA" is created and then applied to an ATM PVC range called "range-pppoa-1":
! The following commands create the class classA:vc-class atm classAubr 10000encapsulation aal5snap! The following commands apply classA to an ATM PVC range:interface atm 6/0.110 multipointrange range-pppoa-1 pvc 0/102 0/199class-range classARelated Commands
Command Descriptionshutdown (PVC-in-range)
Deactivates an individual PVC within a PVC range.
shutdown (PVC range)
Deactivates an ATM PVC range.
oam-range
To enable end-to-end F5 Operation, Administration, and Maintenance (OAM) loopback cell generation and OAM management for an ATM permanent virtual circuit (PVC) range, use the oam-range command in PVC range configuration mode. To disable generation of OAM loopback cells and OAM management, use the no form of this command.
oam-range [manage] [frequency]
no oam-range [manage] [frequency]
Syntax Description
manage
(Optional) Enables OAM management.
frequency
(Optional) Time delay (0 to 600 seconds) between transmissions of OAM loopback cells.
Defaults
10 seconds
Command Modes
PVC range configuration
Command History
Release Modification12.1(5)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
If OAM management is enabled, further control of OAM management is configured using the oam retry command.
If the oam-range command is not explicitly configured for an ATM PVC range, the range inherits the following default configuration (listed in order of precedence):
•
Configuration of the oam-range command in a VC class assigned to the range.
•
Configuration of the oam-range command in a VC class assigned to the ATM subinterface for the range.
•
Configuration of the oam-range command in a VC class assigned to the ATM main interface for the range.
•
Global default: End-to-end F5 OAM loopback cell generation and OAM management are disabled, but if OAM cells are received, they are looped back. The default value for the frequency argument is 10 seconds.
Examples
The following example enables end-to-end F5 OAM loopback cell transmission and OAM management on an ATM PVC range called "range1" with a transmission frequency of 11 seconds:
interface atm 6/0.1range range1 pvc 7/101 7/103oam-range manage 11oam retry 8 9 10Related Commands
pvc-in-range
To configure an individual permanent virtual circuit (PVC) within a PVC range, use the pvc-in-range command in PVC range configuration mode. To delete the individual PVC configuration, use the no form of this command.
pvc-in-range [pvc-name] [vpi/vci]
no pvc-in-range [pvc-name] [vpi/vci]
Syntax Description
Defaults
No default behavior or values
Command Modes
PVC range configuration
Command History
Release Modification12.1(5)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
The pvc-in-range command defines an individual PVC within a PVC range and enables PVC-in-range configuration mode.
Examples
In the following example, a PVC called "pppoa" is deactivated. The PVC "pppoa" is an individual PVC within a configured PVC range.
pvc-in-range pppoa 0/130shutdownRelated Commands
range pvc
To define a range of ATM permanent virtual circuits (PVCs), use the range pvc command in subinterface configuration mode. To delete the range of ATM PVCs, use the no form of this command.
range [range-name] pvc start-vpi/start-vci end-vpi/end-vci
no range [range-name] pvc
Syntax Description
Defaults
An ATM PVC range is not configured.
Command Modes
Subinterface configuration
Command History
Release Modification12.1(5)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
The range pvc command defines a range of PVCs and enables PVC range configuration mode.
The number of PVCs in a range can be calculated using the following formula:
number of PVCs = (end-vpi - start-vpi + 1) x (end-vci - start-vci +1).
The start-vpi argument may be omitted if it is zero. The end-vpi argument may be omitted, but if it is omitted, it is assigned the value of start-vpi. The end-vpi and end-vci arguments are always greater than or equal to start-vpi and start-vci respectively.
When applied to multipoint subinterfaces, the range pvc command creates a range of ATM PVCs. When applied to point-to-point subinterfaces, the range pvc command creates range of PVCs and a corresponding range of point-to-point subinterfaces.
For point-to-point subinterfaces, subinterface numbering begins with the subinterface on which the PVC range is configured and increases sequentially through the range.
Examples
ATM PVC Range Example
In the following example, 100 PVCs with VCI values from 100 to 199 for each VPI value from 0 to 4 are created for a PVC range called "range-pppoa-1". This configuration creates a total of 500 PVCs in the range. PVC parameters are then configured for the range.
interface atm 6/0.110 multipointrange range-pppoa-1 pvc 100 4/199class-range class-pppoa-1ubr 1000encapsulation aal5snapprotocol ppp virtual-Template 2Subinterface Grouping by PVC Range for Routed Bridge Encapsulation Example
In the following example, a PVC range called "range1" is created with a total of 100 PVCs in the range. A point-to-point subinterface will be created for each PVC in the range. ATM routed bridge encapsulation is also configured.
interface atm 6/0.200 point-to-pointip unnumbered loopback 1atm route-bridged iprange range1 pvc 1/200 1/299# endRelated Commands
shutdown (PVC-in-range)
To deactivate an individual permanent virtual circuit (PVC) within a PVC range, use the shutdown command in PVC-in-range configuration mode. To reactivate an individual PVC within PVC range, use the no form of this command.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
The PVC is active.
Command Modes
PVC-in-range configuration
Command History
Release Modification12.1(5)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Examples
In the following example, "pvc1" within the PVC range called "range1" is deactivated:
interface atm 6/0.110 multipointrange range1 pvc 100 4/199pvc-in-range pvc1 7/104shutdownRelated Commands
Command Descriptionpvc-in-range
Configures an individual PVC within a PVC range.
shutdown (PVC range)
Deactivates a PVC range.
shutdown (PVC range)
To deactivate a permanent virtual circuit (PVC) range, use the shutdown command in PVC range configuration mode. To reactivate a PVC range, use the no form of this command.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
PVC range is active.
Command Modes
PVC range configuration
Command History
Release Modification12.1(5)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Examples
In the following example, a PVC range called "range1" is deactivated:
interface atm 6/0.110 multipointrange range1 pvc 100 4/199shutdownRelated Commands
Command Descriptionrange pvc
Defines a range of ATM PVCs.
show pppatm summary
Deactivates an individual PVC within a PVC range.
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2000, 2005-2006 Cisco Systems, Inc. All rights reserved.


