- Cisco IOS Wide-Area Networking Command Reference, Release 12.2
Table Of Contents
atm sig-traffic-shaping strict
ATM Commands
This chapter describes the commands available for configuring ATM interfaces on the following platforms:
•
Cisco 2600 series routers
•
•
•
•
•
This chapter also describes the commands available for configuring a serial interface for ATM access in other routers.
Note
For ATM configuration information and examples, refer to the chapter "Configuring ATM" in the Cisco IOS Wide-Area Networking Configuration Guide.
abr
To select available bit rate (ABR) quality of service (QoS) and configure the output peak cell rate and output minimum guaranteed cell rate for an ATM permanent virtual circuit (PVC) or virtual circuit (VC) class, use the abr command in the appropriate command mode. To remove the ABR parameters, use the no form of this command.
abr output-pcr output-mcr
no abr output-pcr output-mcr
Syntax Description
output-pcr
The output peak cell rate in kilobits per second.
output-mcr
The output minimum guaranteed cell rate in kilobits per second.
Defaults
ABR QoS at the maximum line rate of the physical interface
Command Modes
Interface-ATM-VC configuration (for an ATM PVC)
VC-class configuration (for a VC class)
PVC range configuration (for an ATM PVC range)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
11.1
This command was introduced.
12.1(5)T
This command was modified to be available in PVC range and PVC-in-range configuration modes.
Usage Guidelines
If the abr command is not explicitly configured on an ATM PVC, the VC inherits the following default configuration (listed in order of precedence):
•
•
•
•
ABR is a quality of service class defined by the ATM Forum for ATM networks. ABR is used for connections that do not require timing relationships between source and destination. ABR provides no guarantees in terms of cell loss or delay, providing only best-effort service. Traffic sources adjust their transmission rate in response to information they receive describing the status of the network and its capability to successfully deliver data.
In ABR transmission, the peak cell rate (PCR) specifies the maximum value of the allowed cell rate (ACR), and minimum cell rate (MCR) specifies the minimum value for the ACR. ACR varies between the MCR and the PCR and is dynamically controlled using congestion control mechanisms.
Examples
The following example specifies the output-pcr argument to be 100,000 kbps and the output-mcr argument to be 3000 kbps for an ATM PVC:
pvc 1/32abr 100000 3000Related Commands
atm aal aal3/4
To enable support for ATM adaptation layer 3/4 (AAL3/4) on an ATM interface, use the atm aal aal3/4 interface configuration command. To disable support for ATM adaptation layer 3/4 (AAL3/4) on an ATM interface, use the no form of this command.
atm aal aal3/4
no atm aal aal3/4
Syntax Description
This command has no arguments or keywords.
Defaults
Support for AAL3/4 is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on Cisco 7500 series routers with AIP. This command is not supported on the ATM port adapter. Because Cisco 4500 and Cisco 4700 routers always support both AAL3/4 and AAL5, this command is not required on Cisco 4500 and Cisco 4700 routers.
Only one virtual circuit can exist on a subinterface that is being used for AAL3/4 processing, and that virtual circuit must be an AAL3/4 virtual circuit.
The AAL3/4 support feature requires static mapping of all protocols except IP.
Examples
The following example enables AAL3/4 on ATM interface 2/0:
interface atm2/0ip address 172.21.177.178 255.255.255.0atm aal aal3/4Related Commands
atm abr rate-factor
To configure the amount by which the cell transmission rate increases or decreases in response to flow control information from the network or destination for available bit rate (ABR) virtual circuits (VCs), use the atm abr rate-factor interface configuration command. To return to the default, use the no form of this command.
atm abr rate-factor [rate-increase-factor] [rate-decrease-factor]
no atm abr rate-factor [rate-increase-factor] [rate-decrease-factor]
Syntax Description
Defaults
ABR rate increase and decrease factor is 16.
Command Modes
Interface configuration
Command History
Usage Guidelines
To configure an ABR VC, use the pvc command with the abr keyword.
To verify the ABR rate factor, use the show atm interface atm EXEC command.
Examples
The following example sets the ABR rate factor to 32 for the next cell transferred on ATM interface 4/0:
interface atm 4/0atm abr rate-factor 32 32Related Commands
Configures the PVC interface.
Displays ATM-specific information about an ATM interface.
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 interface configuration command. 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
Enabled
Command Modes
Interface configuration
Command History
Usage Guidelines
This command enables a router to register its address with the ILMI for callback when specific events occur, such as incoming Simple Network Management Protocol (SNMP) traps or incoming new network prefixes.
Examples
The following example enables ATM interface I/O to register its address:
interface atm 1/0atm address-registrationRelated Commands
atm arp-server
To identify an ATM Address Resolution Protocol (ARP) server for the IP network or set time-to-live (TTL) values for entries in the ATM ARP table, use the atm arp-server interface configuration command. To remove the definition of an ATM ARP server, use the no form of this command.
atm arp-server [self [time-out minutes] | [nsap nsap-address]]
no atm arp-server [self [time-out minutes] | [nsap nsap-address]]
Syntax Description
Defaults
The default timeout value is 20 minutes.
The ARP server process is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
If an NSAP address is specified, the ARP client on this interface uses the specified host as an ARP server. You can specify multiple ATM ARP servers by repeating the command. If self is specified, this interface acts as the ARP server for the logical IP network.
The ATM ARP server takes one of the following actions if a destination listed in the server's ARP table expires:
•
•
This implementation follows RFC 1577, Classical IP over ATM.
To configure redundant ARP servers, you must first enable redundant ARP server support by entering the atm classic-ip-extensions command with the BFI keyword.
Examples
The following example configures ATM on an interface and configures the interface to function as the ATM ARP server for the IP subnetwork:
interface atm 0/0ip address 10.0.0.1.255.0.0.0atm nsap-address ac.1533.66.020000.0000.0000.0000.0000.0000.0000.00atm rate-queue 1 100atm maxvc 1024atm pvc 1 0 5 qsaalatm arp-server selfRelated Commands
atm classic-ip-extensions
To enable support for redundant ATM Address Resolution Protocol (ARP) servers on a single logical IP subnetwork (LIS), use the atm classic-ip-extensions command in interface configuration mode. To remove support for redundant ATM ARP servers, use the no form of this command.
atm classic-ip-extensions {BFI | none}
no atm classic-ip-extensions
Syntax Description
BFI
Enables simple redundant ARP server support. BFI as an acronym is undefined.
none
Enables standard RFC 1577 behavior (no redundant ARP server support).
Defaults
Redundant ATM ARP server support is not enabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
Cisco's implementation of the ATM ARP server supports redundant ATM ARP servers on a single logical IP subnetwork (LIS). In order for redundant ATM ARP server support to work, all of the devices on the LIS must be Cisco devices and must have the atm classic-ip-extensions BFI command configured.
The none keyword enables behavior that complies with RFC 1577, Classical IP over ATM. RFC 1577 does not support redundant ARP servers.
Examples
The following example shows how to configure redundant ARP servers on an ATM interface:
Router(config)# interface atm 1/0Router(config-if)# atm classic-ip-atm BFIRouter(config-if)# atm arp-server nsap 47.000580FFE1000000F21A3167.666666666666.00Router(config-if)# atm arp-server nsap 47.000580FFE1000000F21A3167.555555555555.00Related Commands
Identifies an ATM Address Resolution Protocol (ARP) server for the IP network or sets TTL values for entries in the ATM ARP table.
atm clock internal
To cause the ATM interface to generate the transmit clock internally, use the atm clock internal interface configuration command. To restore the default value, use the no form of this command.
atm clock internal
no atm clock internal
Syntax Description
This command has no arguments or keywords.
Defaults
The ATM interface uses the transmit clock signal from the remote connection (the line). The switch provides the clocking.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is meaningless on a 4B/5B physical layer interface module (PLIM).
For SONET interfaces, use the atm clock internal command to configure an ATM port adapter to supply its internal clock to the line.
Examples
The following example causes the ATM interface to generate the transmit clock internally:
interface atm 4/0atm clock internalatm compression
To specify the software compression mode on an interface, use the atm compression command in interface configuration mode. To remove the compression mode setting, use the no form of this command.
atm compression {per-packet | per-interface | per-vc}
no atm compression {per-packet | per-interface | per-vc}
Syntax Description
Defaults
per-packet
Command Modes
Interface configuration
Command History
11.3(1)MA
This command was introduced on the Cisco MC3810 multiservice concentrator.
Usage Guidelines
This command applies to ATM configuration on the Cisco MC3810 multiservice concentrator.
Examples
The following example configures per-packet ATM compression:
interface atm0atm compression per-packetatm ds3-scramble
To enable scrambling of the ATM cell payload for the DS3 physical layer interface module (PLIM) on an ATM interface, use the atm ds3-scramble interface configuration command. To disable scrambling of the ATM cell payload for the DS3 PLIM, use the no form of this command.
atm ds3-scramble
no atm ds3-scramble
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Interface configuration
Command History
11.0
This command was introduced.
11.1
Command syntax was changed from ds3 scramble to atm ds3-scramble.
Usage Guidelines
DS3 scrambling is used to assist clock recovery on the receiving end.
Examples
The following example disables DS3 scrambling on the interface:
interface atm 4/0no atm ds3-scrambleatm e164 auto-conversion
To enable ATM E164 autoconversion, use the atm e164 auto-conversion interface configuration command. To disable autoconversion, use the no form of this command.
atm e164 auto-conversion
no atm e164 auto-conversion
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Interface configuration
Command History
Usage Guidelines
You must enable the ATM interface before using the atm e164 auto-conversion command.
When an interface is configured for E.164 auto conversion, ATM E.164 format addresses are converted to the corresponding native E.164 address for outgoing calls. For incoming calls, native E.164 addresses are converted to the corresponding ATM E.164 format.
Examples
The following example enables E.164 auto conversion on ATM interface 0/0/1:
interface atm 0/0/1atm e164 auto-conversionatm e3-scramble
To enable scrambling of the ATM cell payload for the E3 physical layer interface module (PLIM) on an ATM interface, use the atm e3-scramble interface configuration command. To disable scrambling of the ATM cell payload for the E3 PLIM, use the no form of this command.
atm e3-scramble
no atm e3-scramble
Syntax Description
This command has no arguments or keywords.
Defaults
E3 scrambling is enabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
E3 scrambling is used to assist clock recovery on the receiving end.
Examples
The following example disables E3 scrambling on the interface:
interface atm 2/0no atm e3-scrambleatm esi-address
To enter the end station ID (ESI) and selector byte fields of the ATM network service access point (NSAP) address, use the atm esi-address interface configuration command. The NSAP address prefix is filled in via Integrated Local Management Interface (ILMI) from the ATM switch. To delete the end station address, use the no form of this command.
atm esi-address esi.selector
no atm esi-address esi.selector
Syntax Description
esi
End station ID field value in hexadecimal; 6 bytes long.
.selector
Selector field value in hexadecimal; 1 byte long.
Defaults
No ESI is defined.
Command Modes
Interface configuration
Command History
Usage Guidelines
The atm esi-address command allows you to configure the ATM address by entering the ESI (12 hexadecimal characters) and the selector byte (2 hexadecimal characters). The ATM prefix (26 hexadecimal characters) will be provided by the ATM switch. To get the prefix from the ATM switch, the ILMI permanent virtual circuit (PVC) must be configured on the router and the ATM switch must be able to supply a prefix via ILMI. A period must be used to separate the esi from the selector arguments.
Note
The ILMI PVC must be configured in order to get an NSAP address prefix from the switch.
Examples
The following example sets up the ILMI PVC and assigns the ESI and selector field values on the ATM interface 4/0:
interface atm 4/0atm pvc 2 0 16 ilmiatm esi-address 345678901234.12Related Commands
Sets the NSAP address for an ATM interface using SVC mode.
Enables ILMI management on an ATM PVC.
Configures the PVC interface.
atm exception-queue
To set the exception queue length, use the atm exception-queue interface configuration command. To restore the default value, use the no form of this command.
atm exception-queue number
no atm exception-queue
Syntax Description
Defaults
32 entries
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on ATM interface processor (AIP) for Cisco 7500 series routers. This command is not supported on the ATM port adapter for Cisco 7200 and 7500 series routers, nor is it supported on Cisco 4500 and Cisco 4700 routers.
The exception queue is used for reporting ATM events, such as cycle redundancy check (CRC) errors.
Examples
The following example sets the exception queue to 50 entries:
atm exception-queue 50atm framing (DS3)
To specify DS3 line framing on an ATM interface, use the atm framing interface configuration command. To return to the default C-bit with Physical Layer Convergence Protocol (PLCP) framing, use the no form of this command.
atm framing [cbitadm | cbitplcp | m23adm | m23plcp]
no atm framing [cbitadm | cbitplcp | m23adm | m23plcp]
Syntax Description
Defaults
cbitplcp
Command Modes
Interface configuration
Command History
11.0
This command was introduced.
11.1
This command was modified to include the Cisco 7200 series routers with the ATM-CES port adapter.
Usage Guidelines
This command is available on Cisco 4500 and 4700 routers with DS3 access speeds, Cisco 7200 series routers, and Cisco 7500 series routers.
Framing on the interface must match that on the switch for this ATM link.
Examples
The following example specifies M23 ADM framing on a router that has been set up with DS3 access to an ATM network:
interface atm 4/0atm framing m32admatm framing (E3)
To specify E3 line framing, use the atm framing interface configuration command. To return to the default G.751 Physical Layer Convergence Protocol (PLCP) framing, use the no form of this command.
atm framing [g751adm | g832adm | g751plcp]
no atm framing [g751adm | g832adm | g751plcp]
Syntax Description
g751adm
(Optional) Specifies G.751 ATM Direct Mapping (ADM).
g832adm
(Optional) Specifies G.832 ATM Direct Mapping.
g751plcp
(Optional) Specifies G.751 PLCP encapsulation.
Defaults
g751plcp
Command Modes
Interface configuration
Command History
11.0
This command was introduced.
11.1
The g751plcp keyword was added, together with information on the Cisco 7200 series router with the ATM-CES port adapter.
Usage Guidelines
The default framing is described in the ITU-T Recommendation G.751.
Framing on the interface must match that on the switch for this ATM link.
Examples
The following example specifies G.832 ADM framing on a router that has been set up with E3 access to an ATM network:
interface atm 4/0atm framing g832admatm ilmi-keepalive
To enable Interim Local Management Interface (ILMI) keepalives, use the atm ilmi-keepalive interface configuration command. To disable ILMI keepalives, use the no form of this command.
atm ilmi-keepalive [seconds]
no atm ilmi-keepalive [seconds]
Syntax Description
seconds
(Optional) Number of seconds between keepalives. Values less than 3 seconds are rounded up to 3 seconds, and there is no upper limit.
Defaults
3 seconds
Command Modes
Interface configuration
Command History
Examples
The following example enables ILMI keepalives for the ATM interface 1/0:
interface atm 1/0atm address-registrationatm ilmi-keepaliveRelated Commands
Enables the router to engage in address registration and callback functions with the ILMI.
atm ilmi-pvc-discovery
To enable ATM permanent virtual circuit (PVC) discovery, use the atm ilmi-pvc-discovery interface configuration command. To disable PVC Discovery, use the no form of this command.
atm ilmi-pvc-discovery [subinterface]
no atm ilmi-pvc-discovery [subinterface]
Syntax Description
subinterface
(Optional) Causes discovered PVCs to be assigned to the ATM subinterface whose number matches the discovered PVC's VPI number.
Defaults
Disabled
Command Modes
Interface configuration
Command History
Examples
The following example enables PVC Discovery on the ATM main interface 2/0. The subinterface keyword is used so that all discovered PVCs with a VPI value of 1 will be assigned to the subinterface 2/0.1:
interface atm 2/0pvc RouterA 0/16 ilmiexitatm ilmi-pvc-discovery subinterfaceexitinterface atm 2/0.1 multipointip address 172.21.51.5 255.255.255.0atm lbo
To specify the cable length (line build-out) for the ATM interface, use the atm lbo interface configuration command. To return to the default, use the no form of this command.
atm lbo {long | short}
no atm lbo
Syntax Description
long
Specifies a cable length greater than 50 feet.
short
Specifies a cable length less than 50 feet.
Defaults
short
Command Modes
Interface configuration
Command History
Examples
The following example specifies that the ATM interface use a cable less than 50 feet:
interface atm 4/0atm lbo shortRelated Commands
atm max-channels
To configure the number of transmit channels for the interface, use the atm max-channels interface configuration command. To return to the default, use the no form of this command.
atm max-channels number
no atm max-channels
Syntax Description
number
Maximum number of transmit channels for the interface. The range is 64 to 2048 channels. The default is 64 channels.
Defaults
64 channels
Command Modes
Interface configuration
Command History
Usage Guidelines
The atm max-channels command replaces the atm tx-channels command.
Transmit Descriptors
The atm max-channels command can be used to divide the available number (fixed) of transmit descriptors across the configured number of transmit channels. Typically, you think of a one-to-one association between a transmit channel and a VC; however, the ATM-CES port adapter supports other types of VCs than data VCs (for example CES VCs). Also, the ATM-CES port adapter can multiplex one or more VCs over a single virtual path (VP) that is shaped, and the VP only requires a single transmit channel. Therefore, the term transmit channel is used rather than virtual circuit.
Maximum Burst
The maximum burst of packets that are allowed per VC is limited by the number of transmit descriptors allocated per VC. Because the total number of transmit descriptors available is limited by the available SRAM space, configuration of the number of transmit channels for the interface determines the number of transmit descriptors for each transmit channel. Hence the burst size for each transmit channel is determined by the atm max-channels command. For example, for 64 (the default) transmit channels for the interface, 255 transmit descriptors are associated per channel, and for 512 transmit channels for the interface, 31 transmit descriptors are associated per channel.
To display information about the transmit descriptors, use the show atm interface atm command.
Examples
The following example sets the number of transmit descriptors for the interface to 120.
interface atm 2/0atm max-channels 120Related Commands
atm maxvc
To set the ceiling value of the virtual circuit descriptor (VCD) on the ATM interface, use the atm maxvc interface configuration command. To restore the default value, use the no form of this command.
atm maxvc number
no atm maxvc
Syntax Description
Defaults
2048 virtual circuits
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on Cisco 7500 series routers; it is not supported on the Cisco 4500 and Cisco 4700 routers, which have a fixed maximum of 1024 VCs.
This command sets the maximum value supported for the vcd argument in the atm pvc command. It also determines the maximum number of virtual circuits on which the AIP allows segmentation and reassembly (SAR) to occur. However, if you set a maxvc limit and then enter the atm pvc command with a larger value for the vcd argument, the software does not generate an error message.
This command does not affect the virtual path identifier (VPI)-virtual channel identifier (VCI) pair of each virtual circuit.
Examples
The following example sets a ceiling VCD value of 1024 and restricts the AIP to supporting no more than 1024 virtual circuits:
atm maxvc 1024Related Commands
Creates or assigns a name to an ATM PVC, specifies the encapsulation type on an ATM PVC, or enters interface-ATM-VC configuration mode.
atm mid-per-vc
To limit the number of message identifier (MID) numbers allowed on each virtual circuit, use the atm mid-per-vc interface configuration command.
atm mid-per-vc maximum
Syntax Description
maximum
Number of MIDs allowed per virtual circuit on this interface. The values allowed are 16, 32, 64, 128, 256, 512, and 1024.
Defaults
16 MIDs per virtual circuit.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on Cisco 7200 and 7500 series routers.
MID numbers are used by receiving devices to reassemble cells from multiple sources into packets.
This command limits the number of discrete messages allowed on the PVC at the same time. It does not limit the number of cells associated with each message.
The maximum set by the atm mid-per-vc command overrides the range between the midhigh and midlow values set by the atm pvc command. If you set a maximum of 16 but a midlow of 0 and a midhigh of 255, only 16 MIDs (not 256) are allowed on the virtual circuit.
Examples
The following example allows 64 MIDs per ATM virtual circuit:
atm mid-per-vc 64Related Commands
atm multicast
To assign a Switched Multimegabit Data Service (SMDS) E.164 multicast address to the ATM subinterface that supports ATM adaptation layer 3/4 (AAL3/4) and SMDS encapsulation, use the atm multicast interface configuration command.
atm multicast address
Syntax Description
Defaults
No multicast E.164 address is defined.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on Cisco 7500 series, Cisco 4500, and Cisco 4700 routers. This command is not supported on the ATM port adapter.
Each AAL3/4 subinterface is allowed only one multicast E.164 address. This multicast address is used for all protocol broadcast operations.
Examples
The following example assigns a multicast E.164 address to the ATM subinterface that is being configured:
atm multicast e180.0999.000Related Commands
atm multipoint-interval
To specify how often new destinations can be added to multipoint calls to an ATM switch in the network, use the atm multipoint-interval interface configuration command. To return to the default interval, use the no form of this command.
atm multipoint-interval interval
no atm multipoint-interval interval
Syntax Description
Defaults
30 seconds
Command Modes
Interface configuration
Command History
Usage Guidelines
This command applies to switched virtual circuits (SVCs) only, not to permanent virtual circuits (PVCs).
This command has no effect unless ATM multipoint signalling is enabled on the interface.
Examples
The following example enables point-to-multipoint signalling on the ATM interface 2/0. It also specifies that new destinations can be added to multipoint calls every 60 seconds:
interface atm 2/0atm multipoint-signallingatm multipoint-interval 60Related Commands
atm multipoint-signalling
To enable point-to-multipoint signalling to the ATM switch, use the atm multipoint-signalling interface configuration command. To disable point-to-multipoint signalling to the ATM switch, use the no form of this command.
atm multipoint-signalling
no atm multipoint-signalling
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Interface configuration
Command History
11.0
This command was introduced.
11.1
Functionality was changed to allow this command on all subinterfaces, not just the main interface.
Usage Guidelines
If multipoint signalling is enabled, the router uses existing static map entries that have the broadcast keyword set to establish multipoint calls. One call is established for each logical subnet of each protocol.
All destinations are added to the call. One multicast packet is sent to the ATM switch for each multipoint call. The ATM switch replicates the packet to all destinations.
The atm multipoint-interval command determines how often new destinations can be added to a multipoint call.
Note
Examples
The following example enables point-to-multipoint signalling on the ATM interface 2/0:
interface atm 2/0atm multipoint-signallingRelated Commands
Specifies how often new destinations can be added to multipoint calls to an ATM switch in the network.
atm nsap-address
To set the network service access point (NSAP) address for an ATM interface using switched virtual circuit (SVC) mode, use the atm nsap-address interface configuration command. To remove any configured address for the interface, use the no form of this command.
atm nsap-address nsap-address
no atm nsap-address
Syntax Description
Defaults
No NSAP address is defined for this interface.
Command Modes
Interface configuration
Command History
Usage Guidelines
When configuring an SVC, you must use the atm nsap-address command to define the source NSAP address. It identifies a particular port on the ATM network and must be unique across the network.
Note
<
