Guest

Cisco IOS Software Releases 12.1 T

ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping

Table Of Contents

ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping

Contents

Feature Overview

Benefits

Restrictions

Configuration Tasks

Configuring an ATM PVC Range

Deactivating a PVC Range

Configuring an Individual PVC Within a PVC Range

Deactivating an Individual PVC Within a PVC Range

Verifying an ATM PVC Range

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

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

class-range

oam-range

pvc-in-range

range pvc

shutdown (PVC-in-range)

shutdown (PVC range)


ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping


First Published: November 27, 2000
Last Updated: February 28, 2006

History for the ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping Feature

Release
Modification

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

Benefits

Restrictions

Configuration Tasks

Configuration Examples

Additional References

Command Reference

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:

 
Command
Purpose

Step 1 

Router(config)# interface atm slot/port.subinterface-number {point-to-point | multipoint}

Configures an ATM subinterface.

Step 2 

Router(config-subif)# range [range-name] pvc start-vpi/start-vci end-vpi/end-vci

Defines a range of PVCs and enables PVC range configuration mode.

Step 3 

Router(config-if-atm-range)# exit

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


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:

Command
Purpose

Router(config-if-atm-range)# shutdown

Deactivates a PVC range.


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:

 
Command
Purpose

Step 1 

Router(config)# interface atm slot/port.subinterface-number multipoint

Configures an ATM interface.

Step 2 

Router(config-subif)# range [range-name] pvc start-vpi/start-vci end-vpi/end-vci

Defines a range of PVCs and enables PVC range configuration mode.

Step 3 

Router(config-if-atm-range)# pvc-in-range [pvc-name] [vpi/vci]

Defines an individual PVC within a PVC range, and enables PVC-in-range configuration mode.

Step 4 

Router(cfg-if-atm-range-pvc)# exit

Exits PVC-in-range 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
Purpose

Router(cfg-if-atm-range-pvc)# shutdown

Deactivates an individual PVC within a range.


Verifying an ATM PVC Range

To verify ATM PVC range configuration, use the following EXEC command:

Command
Purpose

Router# 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 multipoint
router(config-subif)# range range-pppoa-1 pvc 100 4/199
router(config-if-atm-range)# class-range classA
router(config-if-atm-range)# ubr 1000
router(config-if-atm-range)# encapsulation aal5snap
router(config-if-atm-range)# protocol ppp virtual-template 2

RBE 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-point
Router(config-subif)# ip unnumbered loopback 1
Router(config-subif)# atm route-bridged ip
Router(config-subif)# range range1 pvc 1/200 1/299
Router(config-if-atm-range)# end

Individual 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 multipoint
router(config-subif)# range range1 pvc 100 4/199
router(config-if-atm-range)# class-range classA
router(config-if-atm-range)# pvc-in-range pvc1 3/104
router(cfg-if-atm-range-pvc)# shutdown

Additional References

The following sections provide references related to ATM PVC Range and Routed Bridge Encapsulation Subinterface Grouping.

Related Documents

Related Topic
Document Title

Configuring ATM

"Configuring ATM" chapter in the Cisco IOS Wide-Area Networking Configuration Guide, Release 12.2


Standards

Standard
Title

None


MIBs

MIB
MIBs Link

None

To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs


RFCs

RFC
Title

None


Technical Assistance

Description
Link

The Cisco Technical Support & Documentation website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.

http://www.cisco.com/techsupport


Command Reference

This section documents modified commands only.

class-range

oam-range

pvc-in-range

range pvc

shutdown (PVC-in-range)

shutdown (PVC range)

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

class-name

Name of the VC class.


Defaults

No VC class is assigned to the PVC range.

Command Modes

PVC range configuration

Command History

Release
Modification

12.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 classA
 ubr 10000
 encapsulation aal5snap
! The following commands apply classA to an ATM PVC range:
interface atm 6/0.110 multipoint
 range range-pppoa-1 pvc 0/102 0/199
  class-range classA

Related Commands

Command
Description

shutdown (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
Modification

12.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.1
 range range1 pvc 7/101 7/103
  oam-range manage 11
  oam retry 8 9 10

Related Commands

Command
Description

ilmi manage

Enables ILMI management on an ATM PVC.

oam-pvc

Enables end-to-end F5 OAM loopback cell generation and OAM management for an ATM PVC or VC class.

oam retry

Configures parameters related to OAM management for ATM PVC, SVC, or VC class.


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

pvc-name

(Optional) Name given to the PVC. The PVC name can have a maximum of 15 characters.

vpi/

(Optional) ATM network virtual path identifier (VPI) for this PVC. In the absence of the "/" and a vpi value, the vpi value defaults to 0. The vpi value ranges from 0 to 255.

vci

(Optional) ATM network virtual channel identifier (VCI) for this PVC. The vci value ranges from 32 to 2047.


Defaults

No default behavior or values

Command Modes

PVC range configuration

Command History

Release
Modification

12.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/130
 shutdown

Related Commands

Command
Description

range pvc

Defines a range of ATM PVCs.


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

range-name

(Optional) Name of the range. The range name can be a maximum of 15 characters.

start-vpi/

Beginning value for a range of virtual path identifiers (VPIs). In the absence of the "/" and a vpi value, the vpi value defaults to 0. The vpi value ranges from 0 to 255.

start-vci/

Beginning value for a range of virtual channel identifiers (VCIs). The vci value ranges from 32 to 65535.

end-vpi/

End value for a range of virtual path identifiers (VPIs). In the absence of an end-vpi value, the end-vpi value defaults to the start-vpi value.The vpi value ranges from 0 to 255.

end-vci

End value for a range of virtual channel identifiers (VCIs). The vci value ranges from 32 to 65535.


Defaults

An ATM PVC range is not configured.

Command Modes

Subinterface configuration

Command History

Release
Modification

12.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 multipoint
 range range-pppoa-1 pvc 100 4/199
  class-range class-pppoa-1
  ubr 1000
  encapsulation aal5snap
  protocol ppp virtual-Template 2

Subinterface 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-point
 ip unnumbered loopback 1
 atm route-bridged ip
 range range1 pvc 1/200 1/299
  # end

Related Commands

Command
Description

pvc-in-range

Configures an individual PVC within a PVC range.


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
Modification

12.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 multipoint
 range range1 pvc 100 4/199
  pvc-in-range pvc1 7/104
   shutdown

Related Commands

Command
Description

pvc-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
Modification

12.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 multipoint
 range range1 pvc 100 4/199
  shutdown

Related Commands

Command
Description

range pvc

Defines a range of ATM PVCs.

show pppatm summary

Deactivates an individual PVC within a PVC range.