Table Of Contents

ATM Commands on Cisco IOS XR Software

atm address-registration

atm ilmi-config disable

atm ilmi-keepalive

atm ilmi-trap disable

atm maxvpi-bits 12

atm mcpt-timers

atm oam flush

cell-packing

class-int

class-vc

encapsulation (ATM)

f4oam disable

interface atm

l2transport (ATM)

oam ais-rdi

oam-pvc manage

oam retry

ping atm interface atm

pvc (ATM)

pvp (ATM)

shape

show atm cell-packing

show atm class-link

show atm ilmi-status

show atm interface atm

show atm pvc

show atm pvp

show atm vc-class

show atm vp-tunnel

show controllers atm

shutdown (ATM)

vc-class atm

vp-tunnel

ATM Commands on Cisco IOS XR Software

---

This module describes the commands used to manage the ATM connections on a router running Cisco IOS XR software.

atm address-registration

To enable the router to engage in address registration and callback functions with the Interim Local Management Interface (ILMI), use the atm address-registration command in interface configuration mode. To disable ILMI address registration functions, use the no form of this command.

atm address-registration

no atm address-registration

Syntax Description

This command has no arguments or keywords.

Defaults

If ILMI is configured on a PVC and its host ATM interface, then address registration and callback function enabled on the router by default.

If ILMI is not configured on a PVC and its host ATM interface, then address registration and callback functionality is disabled on the router and must be enabled with the atm address-registration command.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

---

Note The atm address-registration command is effective only when an ILMI PVC is created under the physical ATM interface.

---

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to enable the ATM interface 0 in slot 6 to register its address:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# atm address-registration

atm ilmi-config disable

To disable Interim Local Management Interface (ILMI) on an ATM interface, use the atm ilmi-config disable command in interface configuration mode. To re-enable ILMI on an ATM interface, use the no form of this command.

atm ilmi-config disable

no atm ilmi-config disable

Syntax Description

This command has no arguments or keywords.

Defaults

If an ILMI PVC is configured on the ATM interface, then ILMI is automatically enabled on the ATM interface that hosts that PVC.

If an ILMI PVC is not configured on the ATM interface, then ILMI is disabled by default on the ATM interface.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

---

Note The atm ilmi-config disable command is effective only when an ILMI PVC is created under the physical ATM interface.

---

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to disable ILMI on an ATM interface:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# atm ilmi-config disable

The following example shows how to re-enable ILMI on an ATM interface:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# no atm ilmi-config disable

Related Commands

Command	Description
show atm ilmi-status	Displays status information that is related to ILMI.

atm ilmi-keepalive

To enable Interim Local Management Interface (ILMI) keepalives on an ATM interface and configure keepalive polling frequency, use the atm ilmi-keepalive command in interface configuration mode. To disable ILMI keepalives, use the no form of this command.

atm ilmi-keepalive [act-poll-freq frequency] [retries count] [inact-poll-freq frequency]

no atm ilmi-keepalive [act-poll-freq frequency] [retries count] [inact-poll-freq frequency]

Syntax Description

act-poll-freq frequency	(Optional) Number of polling seconds between active keepalives. Range is from 1 through 65535 seconds. Default is 5 seconds.
retries count	(Optional) ILMI keepalive retry count. Range is from 2 through 5. Default is 4 retries.
inact-poll-freq frequency	(Optional) Number of polling seconds between inactive keepalives. Range is from 1 through 65535 seconds. Default is 1 second.

Defaults

act-poll-freq frequency = 5

retries count= 4

inact-poll-freq frequency = 1

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

---

Note The atm ilmi-keepalive command is effective only when an ILMI PVC is created under the physical ATM interface.

---

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to enable ILMI keepalives for the ATM interface 0 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# atm ilmi-keepalive

The following example shows how to configure the ATM interface 1 in slot 6 to poll the number of inactive keepalives every 10 seconds:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/1

RP/0/0/CPU0:router(config-if)# atm ilmi-keepalive inact-poll-freq 10

The following example shows how to disable ILMI keepalives for the ATM interface 0 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# no atm ilmi-keepalive

Related Commands

Command	Description
show atm ilmi-status	Displays status information that is related to ILMI.

atm ilmi-trap disable

To disable Interim Local Management Interface (ILMI) trap generation on an ATM interface, use the atm ilmi-trap disable command in interface configuration mode. To reenable ILMI trap generation, use the no form of this command.

atm ilmi-trap disable

no atm ilmi-trap disable

Syntax Description

This command has no arguments or keywords.

Defaults

Support for ATM ILMI trap generation is enabled.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco XR 12000 Series Router.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to disable ILMI trap generation on the ATM interface 0 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# atm ilmi-trap disable

The following example shows how to reenable ILMI trap generation on the ATM interface 0 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/1

RP/0/0/CPU0:router(config-if)# no atm ilmi-trap disable

Related Commands

Command	Description
show atm interface atm	Displays ATM-specific information about an ATM interface.

atm maxvpi-bits 12

To enable support for the 12-bits virtual path identifier (VPI) Network-Node Interface (NNI) cell format, use the atm maxvpi-bits 12 command in interface configuration mode. To disable support for the 12-bits VPI NNI cell format, use the no form of this command.

atm maxvpi-bits 12

no atm maxvpi-bits 12

Syntax Description

This command has no arguments or keywords.

Defaults

Support for the 12-bits VPI NNI cell format is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

---

Note Out of the twelve bits, four bits in the ATM UNI cell header are reserved for local standardized generic flow control (GFC).

---

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to enable support for the 12-bits VPI NNI cell format on the ATM interface 0 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# atm maxvpi-bits 12

The following example shows how to disable support for the 12-bits VPI NNI cell format on the ATM interface 1 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/1

RP/0/0/CPU0:router(config-if)# no atm maxvpi-bits 12

Related Commands

Command	Description
show atm interface atm	Displays ATM-specific information about an ATM interface.

atm mcpt-timers

To define the three Maximum Cell Packing Timeout (MCPT) timers under a main ATM interface, use the atm mcpt-timers command in interface configuration mode. To return the three timers to the default configuration, use the no form of this command.

atm mcpt-timers timer-1 timer-2 timer-3

no atm mcpt-timers

Syntax Description

timer-1	Maximum number of microseconds to wait to complete cell packing on a single packet before that packet is transmitted. Range is from 50 through 4095. Note To associate this timer with an interface, use the cell-packing command and replace the timer argument 1.
timer-2	Maximum number of microseconds to wait to complete cell packing on a single packet before that packet is transmitted. Range is from 50 through 4095. Note To associate this timer with an interface, use the cell-packing command and replace the timer argument 2.
timer-3	Maximum number of microseconds to wait to complete cell packing on a single packet before that packet is transmitted. Range is from 50 through 4095. Note To associate this timer with an interface, use the cell-packing command and replace the timer argument 3.

Defaults

timer-1 = 50 microseconds

timer-2 = 50 microseconds

timer-3 = 50 microseconds

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.1	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the cell-packing command to attach one of the three MCPT timers to an individual L2VPN port, PVC, or PVP. If the associated MCPT timer expires before the maximum number of cells that can be packed is reached, then the packet is transmitted with the number of cells that have been packed thus far.

---

Note We recommend configuring a low, medium, and high value for the three MCPT timers to accommodate the different ATM traffic classes. Low- latency CBR traffic typically uses a low MCPT timer value, while high-latency UBR traffic typically requires a high MCPT timer value. VBR-rt and VBR-nrt traffic typically use a median MCPT timer value.

---

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to configure the three MCPT timers and then apply one of them to an interface with the cell-packing command:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# atm mcpt-timers 50 100 200

RP/0/0/CPU0:router (config-if)# l2transport

RP/0/0/CPU0:router (config-if-l2)# cell-packing 6 1

Related Commands

Command	Description
cell-packing	Configures the maximum number of cells allowed per packet, and specifies an MCPT timer for cell packing.
show atm interface atm	Displays ATM-specific information about an ATM interface.

atm oam flush

To drop all current and future Operation, Administration, and Maintenance (OAM) cells received on an ATM interface, use the atm oam flush command in interface configuration mode. To receive OAM cells on an ATM interface, use the no form of this command.

atm oam flush

no atm oam flush

Syntax Description

This command has no arguments or keywords.

Defaults

The dropping of OAM cells is disabled.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to enable the dropping of all current and future OAM cells received on the ATM interface 0 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/0

RP/0/0/CPU0:router(config-if)# atm oam flush

The following example shows how to disable the dropping of all current and future OAM cells received on the ATM interface 1 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/1

RP/0/0/CPU0:router(config-if)# no atm oam flush

Related Commands

Command	Description
show atm interface atm	Displays ATM-specific information about an ATM interface.
show atm class-link	Displays configuration information for the parameters on a virtual circuit (VC) class that is associated with a particular PVC.
show atm vc-class	Displays information about all ATM virtual circuit (VC) classes on the router or for a specific ATM vc-class.
show atm vp-tunnel	Displays virtual path (VP) tunnel information for the entire router or for a specific interface.

cell-packing

To configure the maximum number of cells allowed per packet, and specify a Maximum Cell Packing Timeout (MCPT) timer for cell packing, use the cell-packing command in the appropriate mode. To return the interface to the default cell packing configuration, use the no form of this command.

cell-packing cells timer

no cell-packing

Syntax Description

cells	Maximum number of cells to use per packet. Range is from 2 through 86.
timer	Indicates the appropriate MCPT timer to use for cell packing. Can be 1, 2, or 3. Note You can configure up to three different MCPT values for a single main interface with the atm mcpt-timers command.

Defaults

If you do not configure the maximum number of cells allowed per packet, only one cell is carried per packet.

Command Modes

ATM layer 2 transport interface configuration

ATM layer 2 transport PVC configuration

ATM layer 2 transport PVP configuration

Command History

Release	Modification
Release 3.4.1	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the atm mcpt-timers command to configure the three MCPT timers under the main ATM interface.

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to configure cell packing parameters on an ATM interface:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface ATM 0/2/0/0

RP/0/0/CPU0:router (config-if)# l2transport

RP/0/0/CPU0:router (config-if-l2)# cell-packing 6 3

Related Commands

Command	Description
show atm cell-packing	Displays cell packing information for the Layer 2 attachment circuits (ACs) configured on your system.
show atm interface atm	Displays ATM-specific information about an ATM interface.
show interfaces	Displays statistics for all interfaces configured on the router or for a specific node.
show atm pvc	Displays ATM PVC and traffic information for the entire router, or a specific VPI/VCI or ATM interface
show atm pvp	Displays ATM PVP and traffic information for the entire router, or a specific VPI or ATM interface.
atm mcpt-timers	Defines the three MCPT timers under a main ATM interface.

class-int

To assign a virtual circuit (VC) class to an ATM main interface, use the class-int command in interface configuration mode. To remove a vc-class, use the no form of this command.

class-int vc-class-name

no class-int vc-class-name

Syntax Description

vc-class-name

Name of the vc-class you are assigning to your ATM main interface or subinterface.

Defaults

No vc-class is assigned to an ATM main interface or subinterface.

Command Modes

Interface configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

When you create a vc-class for an ATM main interface or subinterface, you can use the shape and encapsulation commands to define your parameters.

Parameters that are applied to an individual VC supersede interface- and subinterface-level parameters. Parameters that are configured for a VC through discrete commands entered in interface-ATM-VC configuration mode supersede vc-class parameters assigned to an ATM main interface or subinterface by the class-int command.

---

Note This command is not available for Layer 2 interfaces.

---

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to create a class called "classA" and then apply that class to ATM main interface 1 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)#vc-class atm classA

RP/0/0/CPU0:router(config-vc-class-atm)# shape cbr 40000

RP/0/0/CPU0:router(config-vc-class-atm)# encapsulation aal5snap

RP/0/0/CPU0:router(config-vc-class-atm)# oam-pvc manage 300

RP/0/0/CPU0:router(config-vc-class-atm)# commit

RP/0/0/CPU0:router (config-vc-class-atm)# exit

RP/0/0/CPU0:router(config)# interface atm 0/6/0/1

RP/0/0/CPU0:router(config-if)# class-int classA

RP/0/0/CPU0:router(config-if)# 

Related Commands

Command	Description
show atm class-link	Displays configuration information for the parameters on a virtual circuit (VC) class that is associated with a particular PVC.
show atm vc-class	Displays information about all ATM virtual circuit (VC) classes on the router or for a specific ATM vc-class.

class-vc

To attach a virtual circuit (VC) class to an ATM permanent virtual circuit (PVC), use the class-vc command in ATM PVC configuration mode for a PVC that is configured on an ATM subinterface. To remove a vc-class from a PVC, use the no form of this command.

class-vc vc-class-name

no class-vc vc-class-name

Syntax Description

vc-class-name

Name of the vc-class you are assigning to your ATM PVC.

Defaults

No vc-class is assigned to an ATM PVC.

Command Modes

ATM PVC configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

When you create a vc-class for an ATM subinterface PVC, you can use the shape and encapsulation commands to define your parameters.

Parameters that are applied to an individual VC supersede PVC-level parameters. Parameters that are configured for a VC through discrete commands entered in interface-ATM-VC configuration mode supersede vc-class parameters assigned to a PVC by the class-vc command.

---

Note The class-vc command is available in ATM PVC configuration mode for a PVC that is configured on an ATM subinterface only. This command is not available in ATM PVC configuration mode for an ATM main interface.

---

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to create a class called "classA" and then apply that class to the subinterface 1 on the ATM main interface 1 in slot 6:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)#vc atm classA

RP/0/0/CPU0:router(config-vc-class-atm)# shape cbr 40000

RP/0/0/CPU0:router(config-vc-class-atm)# commit

RP/0/0/CPU0:router (config-vc-class-atm)# exit

RP/0/0/CPU0:router(config)# interface atm 0/6/0/1.1 point-to-point

RP/0/0/CPU0:router(config-if)# pvc 10/100

RP/0/0/CPU0:router(config-atm-vc)# class-vc classA

RP/0/0/CPU0:router(config-atm-vc)# 

Related Commands

Command	Description
show atm class-link	Displays configuration information for the parameters on a virtual circuit (VC) class that is associated with a particular PVC.
show atm vc-class	Displays information about all ATM virtual circuit (VC) classes on the router or for a specific ATM vc-class.

encapsulation (ATM)

To configure the ATM adaptation layer (AAL) and encapsulation type for a virtual circuit (VC) class, ATM permanent virtual circuit (PVC), or ATM permanent virtual path (PVP), use the encapsulation command in the appropriate configuration mode. To remove an encapsulation type, use the no form of this command.

For point-to-point ATM PVCs and vc-classes:

encapsulation {aal5mux ipv4 | aal5nlpid | aal5snap}

no encapsulation {aal5mux ipv4 | aal5nlpid | aal5snap}

For ATM Layer 2 PVCs:

encapsulation {aal0 | aal5}

no encapsulation {aal0 | aal5}

Syntax Description

aal5mux ipv4	Specifies IPv4 encapsulation for multiplex (MUX)-type VCs. Note The aal5mux ipv4 keywords are available in ATM PVC configuration and ATM vc-class configuration modes only.
aal5nlpid	Specifies the AAL and encapsulation type that allows ATM interfaces to interoperate with High-Speed Serial Interfaces (HSSIs), which are using an ATM data service unit (ADSU) and running ATM-Data Exchange Interface (DXI). Supported on ATM PVCs only. Note The aal5nlpid keyword is available in ATM PVC configuration and ATM vc-class configuration modes only.
aal5snap	Specifies the AAL encapsulation type that supports Inverse ARP. Logical Link Control/Subnetwork Access Protocol (LLC/SNAP) precedes the protocol datagram. Note The aal5snap keyword is available in ATM PVC configuration and ATM vc-class configuration modes only.
aal0	Specifies the AAL encapsulation type that contains 48 bytes of data within an ATM cell. AAL0 cells are also referred to as "raw cells." The payload consists of 48 bytes. Note The aal0 keyword is available in the ATM Layer 2 transport PVC configuration mode only.
aal5	Specifies the AAL encapsulation type that carries higher-layer datagrams while enhancing the link layer with services available through ATM. AAL5 is defined in the ITU standard I.363.5, and is typically used to carry IP datagrams over ATM. Note The aal5 keyword is available in the ATM Layer 2 transport PVC configuration mode only.

.

Defaults

For point-to-point PVCs, the default encapsulation type is aal5snap.

For Layer 2 PVCs, the default encapsulation type is aal5.

Command Modes

ATM PVC configuration

ATM vc-class configuration

ATM layer 2 transport PVC configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.4.1	To support Layer 2 VPN ACs, the encapsulation command was updated to include the aal0 and aal5 keywords in ATM Layer 2 transport PVC configuration mode.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the aal5mux ipv4 encapsulation option to dedicate the specified PVC to a single protocol; use the aal5snap encapsulation option to multiplex two or more protocols over the same PVC. Whether you select aal5mux ipv4 or aal5snap encapsulation depends on the type of network you are configuring, and the pricing offered by that network. If the pricing of the network depends on the number of PVCs set up, we recommend aal5snap encapsulation. If pricing depends on the number of bytes transmitted, we recommend aal5mux ipv4 encapsulation because it has less overhead than aal5snap and aal5mux ipv4 encapsulation.

If you configure vc-class parameters for a PVC after that PVC is configured, you must enter the shutdown command followed by the no shutdown command on the ATM subinterface that hosts the PVC. This action restarts the interface, causing the newly configured vc-class parameters to take effect on that interface.

Unless specifically configured otherwise, a PVC automatically inherits the encapsulation type of the vc-class that is assigned to the main interface or subinterface that hosts the PVC. If no vc-class is assigned, then the PVC inherits the encapsulation type of the main interface or subinterface that hosts the PVC. If no encapsulation is configured of the main interface or subinterface, then the PVC inherits the default aal5snap encapsulation.

Use the encapsulation command in ATM PVC configuration mode to modify the inherited or default encapsulation assigned to a PVC. You can modify the encapsulation for each individual PVC to be different from the encapsulation configured for the vc-class that is assigned to the ATM main interface or subinterface that hosts the PVC.

If you do not use the encapsulation command to configure the encapsulation type for a new ATM PVC, then the PVC inherits the one of the following default configurations (listed in order of precedence from lowest to highest):

•The encapsulation assigned to the vc-class that is assigned to the PVC itself.

•The encapsulation assigned to the vc-class that is assigned to the ATM subinterface that hosts the PVC.

•The encapsulation assigned to the vc-class that is assigned to the ATM main interface that hosts the PVC

•The default aal5snap encapsulation

When configuring a PVC range or an individual PVC within a PVC range, the following encapsulation types are supported:

•encapsulation aal5mux ipv4

•encapsulation aal5snap

---

Note For Layer 2 PVCs, the default encapsulation type is aal5, and the encapsulation type is not inherited from the VC-Class.

---

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to configure a vc-class with aal5snap encapsulation:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)#vc atm classA

RP/0/0/CPU0:router (config-vc-class-atm)# encapsulation aal5snap

The following example shows how to configure an individual PVC with aal5mux encapsulation:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/2/0/0.1 point-to-point

RP/0/0/CPU0:router (config-subif)# pvc 10/100

RP/0/0/CPU0:router(config-atm-vc)# encapsulation aal5mux

The following example shows how to remove aal5mux ipv4 encapsulation from a vc-class:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)#vc atm classA

RP/0/0/CPU0:router (config-vc-class-atm)# no encapsulation aal5mux ipv4

The following example shows how to configure an individual Layer 2 PVC with aal0 encapsulation:

RP/0/0/CPU0:router# configure

RP/0/0/CPU0:router(config)# interface atm 0/6/0/1.10 l2transport

RP/0/0/CPU0:router(config-if)# pvc 30/300

RP/0/0/CPU0:router(config-atm-l2transport-pvc)# encapsulation aal0

Related Commands

Command	Description
show atm pvc	Displays ATM PVC and traffic information for the entire router, or a specific VPI/VCI or ATM interface.
show atm vc-class	Displays information about all ATM virtual circuit (VC) classes on the router or for a specific ATM vc-class.

f4oam disable

To disable the F4 Operations Administration and Maintenance (OAM) packets for a vp-tunnel, enter the f4oam disable command in ATM vp-tunnel configuration mode. To re-enable F4 OAM packets for a vp-tunnel, enter the no form of this command.

f4oam disable

no f4oam disable

Syntax Description

This command has no arguments or keywords.

Defaults

F4 OAM is enabled by default.

Command Modes

ATM Vp-tunnel configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
atm	read, write

Examples

The following example shows how to restrict a VP from passing OAM packets:

RP/0/0/CPU0:router# config

RP/0/0/CPU0:router (config)# interface atm 0/6/0/0

RRP/0/0/CPU0:router(config-if)# vp-tunnel 10

RP/0/0/CPU0:router(config-atm-vp-tunnel)# f4oam disable

The following example shows how to re-enable the passing of OAM packets on a VP:

RP/0/0/CPU0:router# config

RP/0/0/CPU0:router (config)# interface atm 0/6/0/0

RRP/0/0/CPU0:router(config-if)# vp-tunnel 10

RP/0/0/CPU0:router(config-atm-vp-tunnel)# no f4oam disable

Related Commands

Command	Description
show atm interface atm	Displays ATM-specific information about an ATM interface.
show atm class-link	Displays configuration information for the parameters on a virtual circuit (VC) class that is associated with a particular PVC.
show atm vc-class	Displays information about all ATM virtual circuit (VC) classes on the router or for a specific ATM vc-class.
show atm vp-tunnel	Displays virtual path (VP) tunnel information for the entire router or for a specific interface.

interface atm

To configure an ATM interface and enter ATM interface configuration mode, use the interface atm command in global configuration mode. To delete the interface configuration, use the no form of this command.

interface atm instance[.subinterface] [point-to-point | l2transport]

no interface atm instance[.subinterface]

Syntax Description

instance	Physical interface instance. Naming notation is rack/slot/module/port, and a slash between values is required as part of the notation. •rack—Chassis number of the rack. •slot—Physical slot number of the card. •module—Module number. A physical layer interface module (PLIM) is always 0. •port—Physical port number of the interface. Note For more information about the syntax for the router, use the question mark (?) online help function.
.subinterface	(Optional) Subinterface instance. Naming notation is .subinterface. The period in front of the subinterface value is required as part of the notation. Replace subinterface with the virtual interface number to be associated with the physical interface. Note For more information about the syntax for the router, use the question mark (?) online help function.
point-to-point	Interface functions as one endpoint of a point-to-point link.
l2transport	Interface functions as one endpoint on an Layer 2 link.

Defaults

No interfaces are configured.

Command Modes

Global configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco XR 12000 Series Router.
Release 3.4.1	To support Layer 2 VPN ATM ACs, this command was updated to include the l2transport keyword.
Release 3.5.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The interface command enters interface configuration mode to allow you to configure interfaces. If a virtual interface is configured, then the interface is created if it did not already exist.

When you issue the interface atm command in global configuration mode, the CLI prompt changes to "config-if," indicating that you have entered interface configuration submode for an ATM interface.

---

Note Although the CLI prompt looks the same in the interface configuration mode for an ATM main interface and for an ATM subinterface, the commands that are available under each interface type vary.

---

In the following sample output, the question mark (?) online help function displays all the commands available under the interface configuration submode for a ATM main interface:

RP/0/0/CPU0:router(config)# interface atm 0/2/0/0

RP/0/0/CPU0:router(config-if)#?

affinity       Affinity to include/exclude

  atm            Global ATM interface configuration subcommands

  bandwidth      Set the bandwidth of an interface

  cdp            Enable CDP on an interface

  class-int      Apply a VC class

  commit         Commit the configuration changes to running

  crypto         Set crypto parameters

  dampening      configure state dampening on the given interface

  describe       Describe a command without taking real actions

  description    Set description for this interface

  do             Run an exec command

  exit           Exit from this submode

  flow           Netflow configuration

  frame-relay    Frame Relay interface configuration commands

  ipv4           IPv4 interface subcommands

  ipv6           IPv6 interface subcommands

  l2transport    Enable Layer 2 transport and enter its configuration submode

  load-interval  Specify interval for load calculation for an interface

  mpls           MPLS interface subcommands

  mtu            Set the MTU on an interface

  no             Negate a command or set its defaults

  pvc            Configure a pvc on this interface

  root           Exit to the global configuration mode

  show           Show contents of configuration

 --More--

In the following sample output, the question mark (?) online help function displays all the commands available under the interface configuration submode for a point-to-point ATM subinterface:

RP/0/0/CPU0:router(config)#interface atm 0/2/0/0.1 point-to-point

RP/0/0/CPU0:router(config-if)#?

  affinity       Affinity to include/exclude

  bandwidth      Set the bandwidth of an interface

  cdp            Enable CDP on an interface

  class-int      Apply a VC class

  commit         Commit the configuration changes to running

  crypto         Set crypto parameters

  dampening      configure state dampening on the given interface

  describe       Describe a command without taking real actions

  description    Set description for this interface

  do             Run an exec command

  exit           Exit from this submode

  flow           Netflow configuration

  frame-relay    Frame Relay interface configuration commands

  ipv4           IPv4 interface subcommands

  ipv6           IPv6 interface subcommands

  load-interval  Specify interval for load calculation for an interface

  logging        Per-interface logging configuration

  mpls           MPLS interface subcommands

  mtu            Set the MTU on an interface

  no             Negate a command or set its defaults

  pvc            Configure a pvc on this interface

  root           Exit to the global configuration mode

  show           Show contents of configuration

  shutdown       shutdown the given interface

 --More--

In the following sample output, the question mark (?) online help function displays all the commands available under the interface configuration submode for an ATM Layer 2 subinterface:

RP/0/0/CPU0:router(config)#interface atm 0/2/0/0.1 l2transport

RP/0/0/CPU0:router(config-if)#?

bandwidth      Set the bandwidth of an interface

  cdp            Enable CDP on an interface

  commit         Commit the configuration changes to running

  crypto         Set crypto parameters

  dampening      configure state dampening on the given interface

  describe       Describe a command without taking real actions

  description    Set description for this interface

  do             Run an exec command

  exit           Exit from this submode

  firewall       Configure a Virtual Firewall on this Interface

  flow           Netflow configuration

  frame-relay    Frame Relay interface configuration commands

  ipv4           IPv4 interface subcommands

  ipv6           IPv6 inter