Cisco 10000 Series Router Line Card Configuration Guide
8-Port E3/DS3 ATM Line Card Configuration

Table Of Contents

8-Port E3/DS3 ATM Line Card Configuration

Software Support

Checking Hardware and Software Compatibility

Default Values

Line Card VC Limitations

Interface Syntax

Line Card Interface Configuration Examples

Creating a Subinterface

Creating a PVC

Creating an ATM VC Class

Applying a VC Class

Enabling ILMI PVC Discovery

Completing a Configuration

Line Card Commands

Global Configuration Commands

ATM Interface and Subinterface Commands

Setting the Line Card to E3 or T3 mode

Changing the Mode of the Line Card

Setting the Line Card Framing

Creating and Entering Subinterfaces

Attaching an ATM VC Class to an Interface or Subinterface

Creating ATM PVPs

Creating a PVC

Enabling ATM ILMI

Activating ATM ILMI PVC Discovery

Specifying the ATM ILMI Keep-Alive Rate

Configuring the ATM Clock

Configuring Cable Length

Controlling ATM Alarm Reporting

Running Loopbacks

ATM PVC Commands

Specifying a Protocol

Configuring a Broadcast

Configuring Inverse ARP

Attaching an ATM VC Class to a PVC

Configuring VBR-NRT

Specifying Encapsulation

Enabling ILMI Management

Configuring OAM Retry

Enabling OAM Loopback Cell Generation and Management

Useful show Commands


8-Port E3/DS3 ATM Line Card Configuration


This chapter describes procedures for configuring the Cisco 10000 series 8-Port E3/DS3 ATM line card, hereafter known as the 8-Port E3/DS3 ATM line card.

The 8-Port E3/DS3 ATM line card has eight E3 or DS3 (T3) copper interface terminations that provide Asynchronous Transfer Mode (ATM) serial interfaces and perform Layer 2 ATM functions.

This chapter contains the following sections:

Software Support

Default Values

Line Card VC Limitations

Interface Syntax

Line Card Interface Configuration Examples

Line Card Commands

Software Support

Table 2-1 shows the minimum Cisco IOS release on each release train that supports the 8-Port E3/DS3 ATM line card.

Table 2-1 8-Port E3/DS3 ATM Line Card Software Support 

Required PRE
Minimum Cisco IOS Releases

PRE2

Cisco IOS Release 12.2(16)BX and later releases of Cisco IOS Release 12.2BX
Cisco IOS Release 12.3(7)XI and later releases of Cisco IOS Release 12.3XI
Cisco IOS Release 12.2(28)SB and later releases of Cisco IOS 12.2SB


Checking Hardware and Software Compatibility

The PRE installed in the Cisco 10000 series router chassis must support the Cisco IOS software running on the router. Use the show version command to check the PRE version installed.

To see if a feature is supported by a Cisco IOS release, to locate the software document for that feature, or to check the minimum software requirements of Cisco IOS software with the hardware installed on your router, Cisco maintains the Software Advisor tool on Cisco.com at http://www.cisco.com/pcgi-bin/Support/CompNav/Index.pl

This tool does not verify whether line cards within a system are compatible, but does provide the minimum Cisco IOS requirements for individual hardware line cards, modules, or options.

You must be a registered user on Cisco.com to access this tool.

Default Values

Table 2-2 lists default configuration values for the 8-Port E3/DS3 ATM line card. This table also includes the commands used to modify a default values, and provides information about values to set on the remote end of the connection.

Table 2-2 8-Port E3/DS3 ATM Line Card Defaults

Command Name
Default Setting
Command Syntax
Remote Side Setting

mtu (maximum transmission unit)

4470 bytes

[no] mtu bytes

same

atm clock internal

line

[no] atm clock internal

opposite

loopback

loopback none

[no] loopback [line | diagnostic | payload]


Line Card VC Limitations

The Cisco 10000 series router supports four ATM service categories for virtual circuits (VCs):

Constant Bit Rate (CBR)

Variable Bit Rate-non-real-time (VBR-nrt)

Unspecified Bit Rate (UBR) with a peak cell rate (PCR), referred to as shaped UBR

UBR without a PCR, referred to as unshaped UBR

The segmentation and reassembly (SAR) mechanism configures priority and additional traffic management parameters for the various ATM service categories. Table 2-3 lists the priority levels the SAR sets for the service categories.

Table 2-3 ATM Service Categories

Parameter
CBR
VBR-rt
VBR-nrt
Shaped UBR
Unshaped UBR

Priority

0

1

2

3

None


The number of SAR priority levels and the service categories supported at each priority level vary from line card to line card. For example, the 8-port E3/DS3 supports the two levels of priority and the service categories listed in the Table 2-4.

The ATM line cards support a maximum number of VCs per priority. That VC limit depends on the VC limit of the SAR (SAR limit) and the number of priority levels configured. Table 2-4 describes how to determine the VC limit per priority level per port for the 8-port E3/DS3 line card.

Table 2-4 Maximum Number of VCs per Priority per Port

ATM Line Card
SAR Priority Levels
VC Rate
Maximum Number of VCs per Priority

8-Port E3/DS3

0 = CBR VCs
0 = VBR-nrt VCs
1 = UBR VCs

Half line rate and below

SAR limit / number of PHYs / number of priority levels

2 priority system:

65,536 / 8 / 2 = 4096 VCs per priority level per port


Configuring more channels or VCs than there are available priority locations can cause random channels or VCs to get stuck in the SAR. This occurs when an active channel tries to reschedule itself, but no priority locations are available. Therefore, the channel cannot find a place to reschedule itself, which results in a lost event for the channel, and the channel becomes stuck in the SAR.

On the PRE2, when a VC becomes stuck in the SAR, the PRE2 scheduler stops forwarding traffic on only the VC that is stuck in the SAR; the other VCs still carry traffic. On the PRE3, the PRE3 scheduler stops forwarding traffic on all the VCs configured on that ATM line card.

Interface Syntax

To specify an interface number in a configuration command, use the syntax in Table 2-5 to identify interfaces and subinterfaces on the 8-Port E3/DS3 ATM line card in the Cisco series 10000 router.

Table 2-5 8-Port E3/DS3 ATM Line Card Interface Syntax

Type of Interface
Router
Slot
Subslot
Port
Subinterface

8-Port E3/DS3 interface

10008

1 through 8/

0/

0 to 7

8-Port E3/DS3 subinterface

10008

1 through 8/

0/

0.n to 7.n

n = 1 to 4294967295

8-Port E3/DS3 interface

10005

1 through 5/

0/

0 to 7

8-Port E3/DS3 subinterface

10005

1 through 5/

0/

0.n to 7.n

n = 1 to 4294967295


Examples:

Modify a permanent virtual circuit (PVC) associated with an interface.

Router(config)# interface atm 2/0/0
Router(config-if)# pvc 0/200
Router(config-if-atm-vc)#

Modify a PVC associated with a subinterface.

Router(config)# interface atm 7/0/0.1
Router(config-subif)# pvc 0/101
Router(config-if-atm-vc)#

Line Card Interface Configuration Examples

This section provides sample procedures for configuring the 8-Port E3/DS3 ATM line card for E3 or T3 connections, as well as creating ATM subinterfaces, permanent virtual circuits (PVCs), and virtual circuit (VC) classes. Procedures for enabling Integrated Local Management Interface (ILMI) are also included.

Creating a Subinterface

Use the following procedure to create a subinterface on an 8-Port E3/DS3 ATM line card interface.


Step 1 Separate the ATM interface into subinterfaces using the interface command. You can create either a point-to-point or multipoint subinterface.

In the following example, multipoint subinterface number 1 is created on port 0 of the 8-Port E3/DS3 ATM line card in slot 2.

Router(config)# interface atm 2/0/0.1 multipoint
Router(config-subif)#

Step 2 Assign an IP address and subnet mask to the subinterface using the ip address command, as shown in the following example:

Router(config-subif)# ip address 172.27.48.209 255.255.0.0


You created ATM subinterface 2/0/0.1. To configure or modify this interface, use the following command:

Router(config)# interface atm 2/0/0.1
Router(config-subif)#

Creating a PVC

You can create multiple PVCs on an 8-Port E3/DS3 ATM line card interface. You can create PVCs on an interface or subinterface.

To create a PVC, perform the following steps:


Step 1 Enter interface or subinterface configuration mode.

Use the pvc command to specify a virtual path identifier (VPI) value between 0 and 255 and a virtual channel identifier (VCI) value between 0 and 65535. The following example shows how to create a PVC with a VPI value of 0 and VCI value of 100 on a subinterface.

Router(config-subif)# pvc 0/100
Router(config-if-atm-vc)#

Step 2 Use the protocol ip command to assign a peer IP address to the PVC, as shown in the following example:

Router(config-if-atm-vc)# protocol ip 172.16.32.49
Router(config-if-atm-vc)#


Creating an ATM VC Class

This procedure demonstrates how to create an ATM VC class. An ATM VC class is a PVC boilerplate—a PVC description that you can apply to one or more PVCs.

To create an ATM VC class, perform the following steps:


Step 1 From global configuration mode, enter the vc-class atm name command, where name is the name value you assign. The following example shows how to create the ATM VC class named boston.

Router(config)# vc-class atm boston
Router(config-vc-class)#

Step 2 Enter commands to describe the ATM VC class you named boston. This example shows how to specify that the boston class uses AAL5+MUX encapsulation with a variable bit-rate non real-time (VBR-NRT) PVC.

Router(config-vc-class)# encapsulation aal5mux ip
Router(config-vc-class)# vbr-nrt 30000 20000 128
Router(config-vc-class)# exit
Router(config)#

You have created a VC class named boston. The next procedure describes steps for applying this class to a PVC or subinterface.


Applying a VC Class

You can apply a VC class (created in the previous procedure) to a PVC or a subinterface.

In the following example, the class named boston is applied to a new PVC (0/102) in subinterface 5/0/0.2.

Router(config)# interface atm 5/0/0.2
Router(config-subif)# pvc 0/102
Router(config-if-atm-vc)# class-vc boston
Router(config-if-atm-vc)#

In the following example, the class named boston is applied to subinterface 5/0/0.1.

Router(config)# interface atm 5/0/0.1
Router(config-subif)# class-int boston
Router(config-subif)#

You have completed the steps for assigning a VC class to a PVC.

Enabling ILMI PVC Discovery

You can enable ILMI to automatically discover PVCs on neighboring switches and duplicate those PVC entries on the 8-Port E3/DS3 ATM line card.

To enable ILMI, perform the following steps:


Step 1 Create PVC 0/16 on the main interface as shown in the following example:

Router(config)# interface atm 5/0/0
Router(config-if)# pvc 0/16 ilmi
Router(config-if-atm-vc)# exit
Router(config-if)#

Step 2 Enable ILMI PVC discovery for the selected port (step 1 references port 0).

Router(config-if)# atm ilmi-pvc-discovery

You have completed the steps required to run ILMI PVC discovery. You can use the show atm pvc command to display the PVCs on the Cisco 10000 series router.


Completing a Configuration

This section offers general information on creating and completing a configuration of an 8-Port E3/DS3 ATM line card.

To configure an interface, perform the following steps:


Step 1 Enter interface configuration mode and specify necessary parameters, such as the IP address and subnet mask.

Step 2 After you enter all of the commands to complete the configuration, press Ctrl-Z (hold down the Control key while you press Z) to exit configuration mode.

Step 3 Write the new configuration to memory:

Router# copy running-config startup-config

The system displays an OK message when the configuration is stored.


To check your completed configuration, use the show commands. For more information about show commands, see Useful show Commands.

Line Card Commands

The 8-Port E3/DS3 ATM line card allows you to specify eight E3 or eight T3 interfaces. You can put all the PVCs on the interfaces, or you can create associated subinterfaces. This section describes the principal commands for customizing interfaces and PVCs:

Global Configuration Commands

ATM Interface and Subinterface Commands

ATM PVC Commands

Useful show Commands

Global Configuration Commands

A PVC boilerplate is a PVC description that you can apply to one or more PVCs or interfaces.

To create a PVC boilerplate, use the vc-class atm command in global configuration mode:

vc-class atm class_name

Where class_name is any value that describes the VC class.

After you enter the vc-class atm command, you enter VC class configuration mode. In this mode, you describe the action you want the class to take by entering commands and their arguments. These commands and arguments are described in the "ATM PVC Commands" section.

In the following example, an ATM VC class named paris is created and defined. This example shows how to specify that the class uses AAL5+MUX encapsulation and a VBR-NRT PVC.

Router(config)# vc-class atm paris
Router(config-vc-class)# encapsulation aal5mux ip
Router(config-vc-class)# vbr-nrt 30000 20000 128
Router(config-vc-class)# exit
Router(config)#

For information on applying a VC class name, see the "Attaching an ATM VC Class to an Interface or Subinterface" section and the "Attaching an ATM VC Class to a PVC" section.

ATM Interface and Subinterface Commands

This section describes how to configure ATM interfaces and subinterfaces using the principle commands described in the following sections:

Setting the Line Card to E3 or T3 mode

Setting the Line Card Framing

Changing the Mode of the Line Card

Creating and Entering Subinterfaces

Attaching an ATM VC Class to an Interface or Subinterface

Creating ATM PVPs

Creating a PVC

Enabling ATM ILMI

Activating ATM ILMI PVC Discovery

Specifying the ATM ILMI Keep-Alive Rate

Configuring the ATM Clock

Configuring Cable Length

Controlling ATM Alarm Reporting

Running Loopbacks

Setting the Line Card to E3 or T3 mode

You must configure the 8-Port E3/DS3 ATM line card for either E3 or T3 from interface configuration mode.


Note When you configure the 8-Port E3/DS3 ATM line card for E3 or T3, all 8 ports of the line card operate in the mode you have selected.


atm dsx3mode {e3 | t3}{adm | plcp}

Where:

adm means ATM direct mapping

plcp means physical layer convergence procedure (PLCP)—specifications that map ATM cells into physical media, such as T3 or E3, and define certain management information.

The default is t3 adm.

In the following example, the 8-Port E3/DS3 ATM line card located in slot 2 is configured for E3 mode with PLCP:

Router(config)# interface atm 2/0/0
Router(config-if)# atm dsx3mode e3 plcp

Changing the Mode of the Line Card

The 8-Port E3/DS3 ATM line card has four modes (e3 adm, e3 plcp, t3 adm and t3 plcp), the default mode being t3 adm. Each mode has it own bandwidth and cell delay variation tolerance (CDVT) values.

When a line card is freshly inserted, the default mode of the card can be changed. However, if VCs, VPs or subinterfaces have already been configured on the line card, the line card must first be removed and reprovisioned prior to the mode change.

To change the mode of an already provisioned card use the following commands in the configuration mode:

hw-module slot <> shut

no card <>

no hw-module slot <> shut

After the line card is restarted you can change the mode, and re-apply the configurations that were lost during module shutdown.

The following example shows how to change the mode of an already provisioned card, from E3 mode with ADM to E3 mode with PLCP.

Router(config)# hw-module slot 2/0 shut
Router(config)# no card 2/0
Router(config)# no hw-module slot 2/0 shut

To change the mode of the line card:

Router(config)# interface atm 2/0/0
Router(config-if)# atm dsx3mode e3 plcp

To re-apply the configurations to the line card:

Router(config)#interface atm 2/0/0.1 point-to-point
Router(config-subif)#pvc 1/100
Router(config-if-atm-vc)#vbr-nrt 4000 4000
Router(config-if-atm-vc)#end

Setting the Line Card Framing

The 8-Port E3/DS3 ATM line card supports ADM and PLCP framing on E3 and T3 connections. The following sections describe how to set T3 ADM, T3 PLCP, E3 ADM, and E3 PLCP framing.

Setting T3 ADM Framing

If you configured the 8-Port E3/DS3 ATM line card for T3 ADM using the atm dsx3mode ds3 adm command, configure the framing using the atm framing command in interface configuration mode.

[no] atm framing {cbitadm | m23adm}

Where:

cbitadm is C-bit ADM T3 Framing

m23adm is M23 ADM T3 Framing

The default is cbitadm.

In the following example, M23 ADM T3 framing is set:

Router(config)# interface atm 2/0/0
Router(config-if)# atm framing m23adm

Setting T3 PLCP Framing

If you configured the 8-Port E3/DS3 ATM line card for T3 PLCP using the atm dsx3mode ds3 plcp command, configure the framing using the atm framing command from interface configuration mode.

[no] atm framing {cbitplcp | m23plcp}

Where:

cbitplcp is C-bit PLCP T3 Framing

m23plcp is M23 PLCP T3 Framing

The default cbitplcp

In the following example, C-bit PLCP T3 framing is set:

Router(config)# interface atm 2/0/0
Router(config-if) atm framing cbitplcp

Setting E3 ADM Framing

If you configured the 8-Port E3/DS3 ATM line card for E3 ADM using the atm dsx3mode e3 adm command, configure the framing using the atm framing command in interface configuration mode.

[no] atm framing {g751adm | g832adm}

Where:

g751adm is G.751 ADM E3 framing

g832adm is G.832 ADM E3 framing

The default is g751adm.

In the following example, G.751 ADM E3 framing is set:

Router(config)# interface atm 2/0/0
Router(config-if)# atm framing g751adm

Setting E3 PLCP Framing

If you configured the 8-Port E3/DS3 ATM line card for E3 PLCP using the atm dsx3mode e3 plcp command, configure the framing using the atm framing command in interface configuration mode.

[no] atm framing g751plcp 

Where g751plcp is G.751 PLCP E3 framing

The default is g751plcp.

In the following example, G.751 PLCP E3 framing is set:

Router(config)# interface atm 2/0/0
Router(config-if)# atm framing g751plcp

Creating and Entering Subinterfaces

Use the interface command to segment an E3 or T3 ATM main interface into multiple subinterfaces to simplify line card management, to create interfaces with different MTU sizes, and to create connections to different networks.

interface atm slot/subslot/port.subinterface type
no interface atm slot/subslot/port.subinterface type

Where:

slot is 1 to 5 for a Cisco 10005 router.

slot is 1 to 8 for a Cisco 10008 router.

subslot is always 0 for a full-height line card.

port is 0 to 3.

subinterface is a value from 1 to 4294967295.

type is always point-to-point or multipoint.

To remove a subinterface and its PVCs, use the no interface command. To change a subinterface type, you must first remove the subinterface.

Examples:

Create subinterface number 1 at port 3 for 8-Port E3/DS3 ATM line card in slot 1.

Router(config)# interface atm 1/0/3.1 point-to-point
Router(config-subif)#

Enter an existing subinterface.

Router(config)# interface atm 1/0/3.1
Router(config-subif)#

Use a multipoint subinterface.

If you want multiple PVCs to go to the same network, you must create a multipoint subinterface. For example:

Router(config)# interface atm 4/0/2.2 multipoint
Router(config-subif)#

After you create the subinterface, you can create PVCs that are attached to the same network. Figure 2-1 shows a multipoint subinterface on a fully meshed network. Fully meshed indicates that any workstation can communicate with any other workstation.

Figure 2-1 Multipoint ATM Configuration

The following examples show the commands used to configure the ATM interfaces for routers A, B, and C (see Figure 2-1), including the configuration commands you must enter to configure the multipoint connections in that network:

Router A

Router(config)# interface atm 4/0/0.2 multi
Router(config-subif)# ip address 131.108.168.1 255.255.255.0
Router(config-subif)# pvc 0/35
Router(config-if-atm-vc)# protocol ip 131.108.168.2 broadcast
Router(config-if-atm-vc)# exit
Router(config-subif)# pvc 0/36
Router(config-if-atm-vc)# protocol ip 131.108.168.3 broadcast
Router(config-if-atm-vc)# exit
Router(config-subif)# exit
Router(config)#

Router B

Router(config)# interface atm 2/0/0.1 multi
Router(config-subif)# ip address 131.108.168.2 255.255.255.0
Router(config-subif)# pvc 0/35
Router(config-if-atm-vc)# protocol ip 131.108.168.1 broadcast
Router(config-if-atm-vc)# exit
Router(config-subif)# pvc 0/37
Router(config-if-atm-vc)# protocol ip 131.108.168.3 broadcast
Router(config-if-atm-vc)# exit
Router(config-subif)# exit
Router(config)#

Router C

Router(config)# interface atm 5/0/0.1 multi
Router(config-subif)# ip address 131.108.168.3 255.255.255.0
Router(config-subif)# pvc 0/36
Router(config-if-atm-vc)# protocol ip 131.108.168.1 broadcast
Router(config-if-atm-vc)# exit
Router(config-subif)# pvc 0/37
Router(config-if-atm-vc)# protocol ip 131.108.168.2 broadcast
Router(config-if-atm-vc)# exit
Router(config)#

Attaching an ATM VC Class to an Interface or Subinterface

Use the class-int command to attach an ATM VC class to an interface or subinterface. If you customize a PVC, that customization takes precedence over the interface class.

class-int class_name

Where class_name is the name of the class created using the global configuration class-vc atm command.

In the following example, a VC class named paris is created and attached to subinterface 3/0/0.1.

Router(config)# vc-class atm paris
Router(config-vc-class)# encapsulation aal5mux ip
Router(config-vc-class)# vbr-nrt 30000 20000 128
Router(config-vc-class)# exit
Router(config)# interface atm 3/0/0.1
Router(config-subif)# class-int paris

Creating ATM PVPs

To create a permanent virtual path (PVP) used to multiplex one or more VBR-NRT VCs, use the atm pvp interface configuration command.

atm pvp vpi peak-rate [no-f4-oam]
no atm pvp vpi

Where:

vpi is the ATM network virtual path identifier (VPI) of the VC used to multiplex the permanent virtual path. The range is 0 to 255. You must use a VPI value that is not already in use by a VC.

peak-rate is the maximum rate in kilobits per second (kbps) at which the PVP can transmit data. For an E3 interface, you can enter values from 38 kbps to 34,368 kbps. For a T3 interface, you can enter values from 38 kbps to 44,200 kbps. The PVP peak rate value supersedes all rate values set for VBR-NRT PVCs associated with the PVP.

Interface Type
Allowable Kbps Range for peak-rate

E3

38 to 34,368

T3

38 to 44,200


no-f4-oam (optional) restricts the PVP from passing operations/administration/maintenance (OAM) packets. When you create a PVP, the system creates (by default) PVCs with VCI values of 3 and 4 for each PVP which passes OAM packets.

To verify the configuration of a PVP, use the show atm vp exec command.

The following example shows how to create a PVP with a peak rate of 30,000 kbps. Subsequently, the created VCs are multiplexed onto this virtual path.

Router(config)# interface atm 7/0/0
Router(config-if)# atm pvp 25 30000
Router(config-if)# pvc 25/100
Router(config-if-atm-vc)# vbr-nrt 10000 5000 16
Router(config-if-atm-vc)# exit
Router(config-if)# pvc 25/101
Router(config-if-atm-vc)# vbr-nrt 10000 5000 16
Router(config-if-atm-vc)# exit
Router(config-if)# pvc 25/102
Router(config-if-atm-vc)# vbr-nrt 10000 5000 16
Router(config-if-atm-vc)# exit
Router(config)#

Creating a PVC

This section describes how to create a permanent virtual circuit.


Note You can only create one PVC on a point-to-point interface. Multiple PVCs can be created on a multipoint interface.


You can establish an unspecified bit rate (UBR) PVC by entering the pvc command:

pvc [word] [vpi_value/]{vci_value} [ilmi]

Where:

word is an optional name referring to this connection.

vpi_value is in the range from 0 to 255. If you do not specify a VPI value, the system assigns the value 0.

vci_value is in the range 1 to 65535. The VCI value should be 33 or greater because all lower-numbered PVCs are already assigned.

ilmi parameter maps the ILMI channel to the PVC for this interface. You can only use this argument for PVCs created on the main interface. We recommend that you use this argument with PVC 0/16. For more information about activating ILMI, see the "Activating ATM ILMI PVC Discovery" section.

By default, the pvc command creates a UBR PVC. To specify a VBR-NRT PVC, see the "Configuring VBR-NRT" section.

Examples:

Create PVC 0/105 on the interface.

Router(config)# interface atm 5/0/0
Router(config-if)# pvc 105
Router(config-if-atm-vc)#

Create PVC 2/102 on a subinterface.

Router(config)# interface atm 5/0/0.1
Router(config-subif)# pvc 2/102
Router(config-if-atm-vc)#

Enabling ATM ILMI

Use the atm ilmi-enable interface configuration command to enable ILMI on a port.

atm ilmi-enable 
no atm ilmi-enable

The default is ILMI is enabled, but you should disable the ILMI if the peer does not support ILMI. For peers to be able to exchange ILMI information, you must create PVC 0/16 using the ilmi argument.

The following example shows how to disable ILMI:

Router(config)# interface atm 5/0/0
Router(config-if)# no atm ilmi-enable

Activating ATM ILMI PVC Discovery

This command causes ILMI-compliant devices to propagate PVCs. Use the atm ilmi-pvc-discovery command in interface configuration mode to activate ATM PVC discovery.

atm ilmi-pvc-discovery [subinterface]
no atm ilmi-pvc-discovery [subinterface]

Where:

subinterface instructs the software to associate all PVCs with existing subinterface numbers equal to their VPI numbers. For example: PVC 2/102 is listed under subinterface 7/0/0.2, PVC 12/156 is listed under 7/0/0.12, and so on.


Note The subinterface argument associates PVCs only with subinterfaces that have already been created. If there is no subinterface for a VPI value, the system associates the PVC with the main interface.


The following example shows how to enable PVC discovery on the ATM interface 7/0/0, for port 0, on an 8-Port E3/DS3 ATM line card that has ILMI enabled.

Router(config)# interface atm 7/0/0
Router(config-if)# pvc 0/16 ilmi
Router(config-if-atm-vc)# exit
Router(config-if)# atm ilmi-pvc-discovery

Specifying the ATM ILMI Keep-Alive Rate

Use the atm ilmi-keepalive command to specify the ILMI keep-alive rate.

atm ilmi-keepalive [seconds [retry counts]]

Where:

seconds is a value from 1 to 65535

retry counts is a value from 2 to 5

The default value for seconds is 5000 and for retry counts is 4.

The following example shows how to enable ILMI keepalives for the ATM interface 5/0/0:

Router(config)# interface atm 5/0/0
Router(config-if)# atm ilmi-keepalive 10000 retry 3

Configuring the ATM Clock

Use the atm clock internal command to configure the clock source as internal.

atm clock {internal | line}
no atm clock internal

The default clock setting is no atm clock internal, which means that clocking is derived from the line.

In the following example, clocking is set to internal.

Router(config)# interface atm 5/0/0
Router(config-if)# atm clock internal

Configuring Cable Length

The atm lbo command improves signal strength for losses associated with lengthy cables. To specify whether the cable attached to the interface is short or long, use the atm lbo command in the following format:

atm lbo {short | long}

Where:

short is for a cable that is less than 225 feet.

long is for a cable that is 225 feet or greater.

The default is short.

In the following example, the cable length is set to short:

Router(config)# interface 2/0/0
Router(config-controller)# atm lbo short

Controlling ATM Alarm Reporting

To control alarms so that they are logged to the console for an ATM interface, use the atm report command in interface configuration mode.

atm report {los | oof | ais | ferf | lcd}
no atm report {los | oof | ais | ferf | lcd}

Where:

losLoss of Signal

oof—Out of Frame

ais—Alarm Indication Signal

ferf—Far End Receive Failure

lcd—Loss of cell delineation

To disable logging of alarms, use the no form of this command.

Reporting an alarm means that the alarm can be logged to the console. Not all alarms are logged. The alarm hierarchy rules dictate that only the most severe alarm of an alarm group is reported. Whether an alarm is reported or not, you can view the current state of a defect by checking the Active Defects line from the show controllers atm command output.

The following example shows how to enable reporting of SD-BER and AIS alarms on the interface:

Router(config)# interface atm 3/0/0
Router(config-if)# atm report los
Router(config-if)# atm report ais
Router(config-if)# end
Router#

Running Loopbacks

Use the loopback command to run a loopback tests.

loopback {diagnostic | payload | line}
no loopback {diagnostic | payload | line}

Where:

diagnostic means transmit data is looped to receive data.

payload means the DS3 or E3 overhead bits are regenerated and inserted into the received DS3 or E3 data stream, and the resulting stream is transmitted.

line means the received data stream is looped to the transmit data stream.

The following example shows how to run the diagnostic loopback:

Router(config)# interface atm 5/0/0
Router(config-if)# loopback diagnostic

ATM PVC Commands

After you create a PVC using the pvc command, you can customize the PVC or a VC class by using the commands described in this section.

Specifying a Protocol

Configuring a Broadcast

Configuring Inverse ARP

Attaching an ATM VC Class to a PVC

Configuring VBR-NRT

Specifying Encapsulation

Enabling ILMI Management

Configuring OAM Retry

Enabling OAM Loopback Cell Generation and Management

Specifying a Protocol

Use the protocol ip command in interface-ATM-VC configuration mode or VC-class configuration mode to configure a static map for an ATM PVC or VC class.

protocol ip {protocol-address | arp | cdp | clns | clns_es | clns_is | cmns | 
compressedtcp | {ip {address} | ppp | pppoe | snapshot}} [[no] broadcast]}

no protocol ip {protocol-address | arp | cdp | clns | clns_es | clns_is | cmns | 
compressedtcp | {ip {address} | ppp | pppoe | snapshot}} [[no] broadcast]}

Where:

protocol-address is the peer destination address that is being mapped to a PVC.

arp (valid only for IP protocols on PVCs) enables ARP on an ATM PVC.

cdp is the Cisco Discovery Protocol.

clns is ISO Connectionless Network Service (CLNS).

clns_es is ISO CLNS end system.

clns_is is ISO CLNS intermediate system.

cmns is ISO Connection-Mode Network Service (CMNS).

compressedtcp is compressed TCP.

ip is IP.

ppp is LLC PPP over AAL5 encapsulation.

pppoe is PPP over Ethernet.

snapshot is Snapshot routing support.

[no] broadcast (optional) indicates that this PVC sends out broadcast packets (for example, IGRP updates). Pseudo broadcasting is supported. The broadcast keyword of the protocol ip command takes precedence if you previously configured the broadcast command on the ATM PVC.

For PVCs created under point-to-point subinterfaces, broadcast is enabled by default. For PVCs created under multipoint subinterfaces, use the broadcast argument to propagate IP routes.

Use the no form of this command to remove a static map.


Note Use the inarp command to configure Inverse ARP frequency.


The following example shows how to specify IP protocol on an ATM PVC:

Router(config)# interface atm 5/0/0
Router(config-if)# pvc 0/105
Router(config-if-atm-vc)# protocol ip 172.16.32.49

Configuring a Broadcast

Use the broadcast command to configure broadcast packet duplication and transmission for an ATM PVC or VC class.

The broadcast command is not used to enable ATM cell-level multicast, broadcast, replication, or to set up the broadcast of user level traffic. The broadcast command indicates which PVC (or PVCs) sends out broadcast traffic. This is typically limited to traffic associated with routing protocols and routing updates (for example, OSPF hello packets).


Note The broadcast argument within the protocol ip command takes precedence over the broadcast command. See the "Specifying a Protocol" section for more information.


Use the default form of this command to restore the default behavior described below.

broadcast
no broadcast

The default is broadcast.

Use the no form of this command to disable transmission of broadcast packets.

For PVCs created under point-to-point subinterfaces, broadcast is enabled by default. For PVCs created under multipoint subinterfaces, you should use the broadcast command if you want to propagate IP routes (only the first PVC on a multipoint interface receives broadcast traffic).

The following example shows how to use the broadcast command to restore default behavior:

Router(config)# interface atm 5/0/0.4
Router(config-subif)# pvc 0/105
Router(config-if-atm-vc)# broadcast
Router(config-if-atm-vc)#

Configuring Inverse ARP

Use the inarp command in interface-ATM-VC configuration mode or VC-class configuration mode to configure the inverse ARP time period for an ATM PVC or VC class.

inarp minutes
no inarp minutes

Where minutes is the inverse ARP frequency from 1 to 60 minutes.

The default frequency is 15 minutes.

Use the no form of this command to restore the default inverse ARP time period behavior.


Note This command is supported only for AAL5+SNAP encapsulation (the default) when Inverse ARP is enabled. Use the encapsulation command to configure AAL5+SNAP encapsulation and the protocol command to enable Inverse ARP.


The following example shows how to specify an inverse ARP frequency of 40 minutes on an ATM PVC:

Router(config)# interface atm 5/0/0
Router(config-if)# pvc 0/105
Router(config-if-atm-vc)# inarp 40

Attaching an ATM VC Class to a PVC

Use the class-vc command to attach an ATM VC class to a PVC.

class-vc name

Where:

name is the name of the class created with the global configuration class-vc atm command.

The following example shows how to assign an ATM VC class named boston to an ATM PVC:

Router(config)# interface atm 5/0/0.4
Router(config-subif)# pvc 2/100
Router(config-if-atm-vc)# class-vc boston

Configuring VBR-NRT

Use the vbr-nrt command to configure the variable bit rate non real-time (VBR-NRT) traffic management type and specify output peak cell rate, output sustainable cell rate, and output maximum burst cell size for an ATM PVC or VC class.

You can use the vbr-nrt command in PVC configuration mode or VC-class configuration mode.

vbr-nrt peak_cell_rate sustainable_cell_rate maximum_burst_size
no vbr-nrt peak_cell_rate sustainable_cell_rate maximum_burst_size

Where:

peak_cell_rate is the peak cell rate (PCR). For an E3 interface, you can enter values from 38 kbps to 34,368 kbps. For a T3 interface, you can enter values from 38 kbps to 44,200 kbps. The PCR must be at least equal to the sustainable cell rate (SCR).

sustainable_cell_rate is the sustainable cell rate (SCR) from 38 kbps to the PCR.

maximum_burst_size is a number from 1 to 65,535, which represents maximum burst size (MBS) in cells.

The default class of service is unspecified bit rate (UBR) running at the maximum line rate of the physical interface.

Use the no form of this command to remove the VBR-NRT parameters and return the PVC to its default of UBR.

The following example shows how to configure the VBR-NRT traffic parameters on an ATM PVC:

Router(config)# interface atm 5/0/0
Router(config-if)# pvc 0/105
Router(config-if-atm-vc)# vbr-nrt 10000 5000 200

Specifying Encapsulation

Use the encapsulation command in PVC configuration mode or VC-class configuration mode to specify the ATM adaptation layer (AAL) and encapsulation type for an ATM PVC or VC class.

encapsulation {aal5mux ip | aal5snap}
no encapsulation {aal5mux ip | aal5snap}

Where:

aal5mux ip is AAL5+MUX encapsulation.

aal5snap is AAL5+LLC/SNAP encapsulation (the default).

Use the no form of this command to return an encapsulation to the default SNAP.

The following example shows how to specify aal5mux ip encapsulation for an ATM PVC:

Router(config)# interface atm 5/0/0.4
Router(config-subif)# pvc 0/105
Router(config-if-atm-vc)# encapsulation aal5mux ip

Enabling ILMI Management

Use the ilmi manage command in PVC configuration mode or VC-class configuration mode to enable ILMI management on an ATM PVC. This command changes the convergence of higher-level protocols based on link-state changes.

ilmi manage
no ilmi manage

Use the no form of this command to disable ILMI management.

The following example shows how to enable ILMI management on an ATM PVC:

Router(config)# interface atm 5/0/0
Router(config-if)# pvc 0/105
Router(config-if-atm-vc)# ilmi manage

Configuring OAM Retry

Use the oam retry command in PVC configuration mode or VC-class configuration mode to configure OAM retry.

oam retry up_value [down_value frequency]
no oam retry up_value [down_value frequency]

Where:

up_value is a number from 1 to 600 that represents the OAM retry count before declaring that a VC is up.

The default is 3 retries.

down_value is a number from 1 to 600 that represents the OAM retry count before declaring a VC is down.

The default is 5 retries.

frequency is a number from 1 to 1000 that represents the OAM retry polling frequency, in seconds.

The default is 1 second.

Use the no form of this command to return OAM retry to its default values.

The following example shows how to configure OAM retry for an ATM PVC:

Router(config)# interface atm 5/0/0
Router(config-if)# pvc 0/105
Router(config-if-atm-vc)# oam retry 10 10 5

Enabling OAM Loopback Cell Generation and Management

To enable end-to-end F5 OAM loopback cell generation and OAM management for an ATM PVC or VC class, use the oam-pvc command in PVC configuration mode or VC-class configuration mode.

oam-pvc [manage] [frequency]
no oam-pvc [manage] [frequency]

Where:

manage is an optional keyword that brings down the interface or subinterface if the PVC loopback fails.

frequency (optional) is the number of seconds between transmitting OAM loopback cells. Values range from 0 to 600 seconds.

The default value is 10 seconds.

Use the no form of this command to disable generation of OAM loopback cells and OAM management.

The following example shows how to enable OAM loopback cell generation for an ATM PVC:

Router(config)# interface atm 5/0/0
Router(config-if)# pvc 0/105
Router(config-if-atm-vc)# oam-pvc 300

Useful show Commands

You can use the following show commands to view ATM interfaces and subinterfaces, and to troubleshoot ATM problems.

show atm vc

Use the show atm vc command to display information about the VCs on the interface.

Router# show atm vc
               VCD /                                     Peak Avg/Min Burst
Interface      Name         VPI   VCI  Type   Encaps     Kbps   Kbps  Cells Sts
2/0/0          1              0    16   PVC    ILMI	149760	UP
2/0/0          9              0   100   PVC    MUX	149760	UP
2/0/0.2        7              2    32   PVC    SNAP	149760	UP
2/0/0          8              2    33   PVC    SNAP	149760	UP
2/0/0          18             2   100   PVC    SNAP	149760	UP
2/0/0.2        6              4    24   PVC    SNAP	149760	UP
2/0/0          2             25     3   PVC    F4-OAM	 50000	UP
2/0/0          3             25     4   PVC    F4-OAM	 50000	UP
2/0/0          14            25   100   PVC    SNAP	 50000	 50000    0	UP
2/0/0          16            25   101   PVC    SNAP	 50000	 50000    0	UP
2/0/0          17            25   102   PVC    SNAP	 50000	 50000    0	UP
2/0/0          10            26     3   PVC    F4-OAM	 50000	UP
2/0/0          11            26     4   PVC    F4-OAM	50000	UP
2/0/0          12            27     3   PVC    F4-OAM	 50000	UP
2/0/0          13            27     4   PVC    F4-OAM	 50000	UP
2/0/0          19            33   100   PVC    SNAP	 10000	 8000   10	UP
Router#

show atm vp

Use the show atm vp command to display information about the VPs on the interface.

Router# show atm vp
                    Data  CES    Peak    CES 
Interface    VPI    VCs   VCs    Kbps    Kbps     Status
ATM2/0/0     25     3     0      50000   0        ACTIVE
ATM2/0/0     26     0     0      50000   0        ACTIVE
ATM2/0/0     27     0     0      50000   0        ACTIVE
Router#

show atm pvc

Use the show atm pvc vpi_number/vci_number command to display detailed information about a specific PVC.

Router# show atm pvc 0/100

ATM2/0/0: VCD: 9, VPI: 0, VCI: 100
UBR, PeakRate: 149760
AAL5-MUX, etype:0x800, Flags: 0xC23, VCmode: 0x0
OAM frequency: 0 second(s), OAM retry frequency: 1 second(s)
OAM up retry count: 3, OAM down retry count: 5
OAM Loopback status: OAM Disabled
OAM VC state: Not Managed
ILMI VC state: Not Managed
InARP DISABLED
InPkts: 0, OutPkts: 0, InBytes: 0, OutBytes: 0
InPRoc: 0, OutPRoc: 0, Broadcasts: 0
InFast: 0, OutFast: 0, InAS: 0, OutAS: 0
InPktDrops: 0, OutPktDrops: 0
Out CLP=1 Pkts: 0
OAM cells received: 0
F5 InEndloop: 0, F5 InSegloop: 0, F5 InAIS: 0, F5 InRDI: 0
OAM cells sent: 0
F5 OutEndloop: 0, F5 OutSegloop: 0, F5 OutRDI: 0
OAM cell drops: 0
PVC Discovery: NOT_VERIFIED
Status: UP
Router#