To enable an authentication, authorization, and accounting (AAA) authentication method for AppleTalk Remote Access (ARA), use the
aaaauthenticationarap command in global configuration mode. To disable this authentication, use the
no form of this command.
Uses the listed methods that follow this argument as the default list of methods when a user logs in.
list-name
Character string used to name the following list of authentication methods tried when a user logs in.
method1[method2...]
At least one of the keywords described in the table below.
Command Default
If the
default list is not set, only the local user database is checked. This has the same effect as the following command:
aaa authentication arap default local
Command Modes
Global configuration
Command History
Release
Modification
10.3
This command was introduced.
12.0(5)T
Group server and local-case support were added as method keywords for this command.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
The list names and default that you set with theaaaauthenticationarapcommand are used with the
arapauthentication command. Note that ARAP guest logins are disabled by default when you enable AAA. To allow guest logins, you must use either the
guest or
auth-guest method listed in the table below. You can only use one of these methods; they are mutually exclusive.
Create a list by entering the
aaaauthenticationaraplist-namemethodcommand, where
list-name is any character string used to name this list (such as
MIS-access ). The
methodargument identifies the list of methods the authentication algorithm tries in the given sequence. See the table below for descriptions of method keywords.
To create a default list that is used if no list is specified in the
arapauthentication command, use the
default keyword followed by the methods you want to be used in default situations.
The additional methods of authentication are used only if the previous method returns an error, not if it fails.
Use the
moresystem:running-configcommand to view currently configured lists of authentication methods.
Note
In the table below, the
groupradius,
grouptacacs+, and
groupgroup-name methods refer to a set of previously defined RADIUS or TACACS+ servers. Use the
radius-serverhost and
tacacs+-serverhost commands to configure the host servers. Use the
aaagroupserverradius and
aaagroupservertacacs+ commands to create a named group of servers.
Table 1 aaa authentication arap Methods
Keyword
Description
guest
Allows guest logins. This method must be the first method listed, but it can be followed by other methods if it does not succeed.
auth-guest
Allows guest logins only if the user has already logged in to EXEC. This method must be the first method listed, but can be followed by other methods if it does not succeed.
line
Uses the line password for authentication.
local
Uses the local username database for authentication.
local-case
Uses case-sensitive local username authentication.
groupradius
Uses the list of all RADIUS servers for authentication.
grouptacacs+
Uses the list of all TACACS+ servers for authentication.
groupgroup-name
Uses a subset of RADIUS or TACACS+ servers for authentication as defined by the
aaagroupserverradius or
aaagroupservertacacs+ command.
Examples
The following example creates a list called
MIS-access, which first tries TACACS+ authentication and then none:
aaa authentication arap MIS-access group tacacs+ none
The following example creates the same list, but sets it as the default list that is used for all ARA protocol authentications if no other list is specified:
aaa authentication arap default group tacacs+ none
Related Commands
Command
Description
aaanew-model
Enables the AAA access control model.
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 abrcommand in the appropriate command mode. To remove the ABR parameters, use the no form of this command.
abroutput-pcroutput-mcr
noabroutput-pcroutput-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.
Command Default
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
Release
Modification
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.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
If the abrcommand is not explicitly configured on an ATM PVC, the VC inherits the following default configuration (listed in order of precedence):
Configuration of any QoS command (abrubr, ubr+, or vbr-nrt) in a VC class assigned to the PVC itself.
Configuration of any QoS command (abr, ubr, ubr+, or vbr-nrt) in a VC class assigned to the PVC’s ATM subinterface.
Configuration of any QoS command (abr, ubr, ubr+, or vbr-nrt) in a VC class assigned to the PVC’s ATM main interface.
Global default value: ABR QoS at the maximum line rate of the PVC.
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/32
abr 100000 3000
Related Commands
Command
Description
ubr
Configures UBR QoS and specifies the output peak cell rate for an ATM PVC, SVC, VC class, or VC bundle member.
ubr+
Configures UBR QoS and specifies the output peak cell rate and output minimum guaranteed cell rate for an ATM PVC, SVC, VC class or VC bundle member.
vbr-nrt
Configures the VBR-NRT QoS and specifies output peak cell rate, output sustainable cell rate, and output maximum burst cell size for an ATM PVC, SVC, or VC class.
atm
To provision an interface to function with ATM capabilities, use the atm command in controller configuration mode (config-controller). To undo the configuration use the
no form of this command.
atm
no atm
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values are available.
Command Modes
Controller configuration (config-controller)
Command History
Release
Modification
Cisco IOS XE Release 3.4.0S
This command was introduced on the Cisco ASR 1000 Series Aggregation Service Routers.
Cisco IOS XE Release 3.5.0S
This command was integrated into Cisco IOS XE Release 3.5.0S to support the clear E3 ATM.
Usage Guidelines
The
atm command was introduced in Cisco IOS XE Release 3.4.0S to support clear T3 ATM on the Cisco ASR 1000 Series Routers. The Circuit Emulation SPA for which the
atm command is used is SPA-2CHT3-CE-ATM. In Cisco IOS XE Release 3.5.0S, clear E3 ATM has been introduced in the SPA-2CHT3-CE-ATM .
Use the following commands in the sequence described here to configure an interface as either clear T3 or E3 ATM:
Configure the card type using the
card type {t3 | e3}slot subslot command.
The Shared Port Adapter (SPA) reloads after the card type is configured. Once the SPA is up, you should configure the controller type as T3 or E3 using the
controller {t3 | e3}slot/subslot/port command.
To provision an interface to function with ATM capabilities use the
atm command.
Examples
The following example shows how to configure an interface as clear T3 ATM:
Device# configure terminal
Device(config)# card type t30 1
Device(config)# controller t3 0/1/0
Device(config-controller)# atm
The following example shows how to configure an interface as clear E3 ATM:
Configures the card type for the SPA as either T3 or E3.
controller e3
Configures the interface on the SPA as an ET3 controller.
controller t3
Configures the interface on the SPA as a T3 controller.
atm aal aal3 4
To enable support for ATM adaptation layer 3/4 (AAL3/4) on an ATM interface, use the
atmaalaal3/4command in interface configuration mode. To disable support for AAL3/4 on an ATM interface, use the
no form of this command.
atm aal aal 3 4
no atm aal aal 3 4
Syntax Description
This command has no arguments or keywords.
Command Default
Support for AAL3/4 is disabled.
Command Modes
Interface configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command is supported on Cisco 7500 series routers with ATM Interface Processor (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/0
ip address 172.21.177.178 255.255.255.0
atm aal aal3/4
Related Commands
Command
Description
atmmid-per-vc
Limits the number of MID numbers allowed on each VC.
atmmulticast
Assigns an SMDS E.164 multicast address to the ATM subinterface that supports AAL3/4 and SMDS encapsulation.
atmsmds-address
Assigns a unicast E.164 address to the ATM subinterface that supports AAL3/4 and SMDS encapsulation.
pvc
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 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 atmabrrate-factorcommand in interface configuration mode. To return to the default, use the no form of this command.
(Optional) Factor by which to increase the data rate. The rate increase factor is specified in powers of 2 from 1 to 32768.
rate-decrease-factor
(Optional) Factor by which to decrease the data rate. The rate decrease factor is specified in powers of 2 from 1 to 32768.
Command Default
The ABR rate increase and decrease factor is 16.
Command Modes
Interface configuration
Command History
Release
Modification
11.1
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
To configure an ABR VC, use the pvc command with the abr keyword.
To verify the ABR rate factor, use the showatminterfaceatmEXEC 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/0
atm abr rate-factor 32 32
Related Commands
Command
Description
pvc
Configures the PVC interface.
showatminterfaceatm
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 atmaddress-registration command in interface configuration mode. To disable ILMI address registration functions, use the no form of this command.
atmaddress-registration
noatmaddress-registration
Syntax Description
This command has no arguments or keywords.
Command Default
Enabled
Command Modes
Interface configuration
Command History
Release
Modification
11.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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 1/0 to register its address:
interface atm 1/0
atm address-registration
Related Commands
Command
Description
atmilmi-keepalive
Enables ILMI keepalives.
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 atmarp-server command in interface configuration mode. To remove the definition of an ATM ARP server, use the no form of this command.
(Optional) Specifies the current router as the ATM ARP server.
time-outminutes
(Optional) Number of minutes for which a destination entry listed in the ATM ARP server’s ARP table will be kept before the server takes any action to verify or time out the entry. The default timeout value is 20 minutes.
nsapnsap-address
(Optional) Network service access point (NSAP) address of an ATM ARP server.
Command Default
The ARP server process is disabled.
Command Modes
Interface configuration
Command History
Release
Modification
11.1
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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:
If a virtual circuit still exists to that destination, the server sends an Inverse ARP request. If no response arrives, the entry times out.
If a virtual circuit does not exist to the destination, the entry times out immediately.
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 atmclassic-ip-extensions command with theBFIkeyword.
Examples
The following example configures ATM on an interface and configures the interface to function as the ATM ARP server for the IP subnetwork:
Enables support for redundant ATM ARP servers on a single LIS.
atm autovc retry
To configure retry frequency of create-on-demand permanent virtual circuits (PVC), use the atmautovcretry command in interface configuration mode. To set the retry frequency of create-on-demand PVCs to their default value, use the no form of this command.
atmautovcretrytimeout-value
noatmautovcretrytimeout-value
Syntax Description
timeout-value
Specifies the retry timeout value, in minutes. Range is from 1 to 60.
Command Default
The retry timeout value is set to 1 minute.
Command Modes
Interface configuration (config-if)
Command History
Release
Modification
12.2(15)B
This command was introduced.
15.0(1)M
This command was integrated into Cisco IOS Release 15.0(1)M.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRE
This command was integrated into Cisco IOS Release 12.2(33)SRE.
Cisco IOS XE 2.5
This command was implemented on ASR 1000 series routers.
Usage Guidelines
Use this command to configure retry frequency of create-on-demand PVCs, when the initial VC creation fails due to reasons such as temporary shortage of resource.
Examples
The following example shows how to configure retry frequency of 12 minutes for create-on-demand PVCs:
Configures ATM PVC auto provisioning, which enables a PVC or range of PVCs to be created automatically on demand.
atm bandwidth dynamic
To enable the automatic management of changes in the total bandwidth of an Asynchronous Transfer Mode (ATM) interface configured with an Inverse Multiplexing over ATM (IMA) group, use the atmbandwidthdynamiccommand in interface configuration mode. To disable automatic management of changes in total IMA group bandwidth, use the no form of this command.
atmbandwidthdynamic
noatmbandwidthdynamic
Syntax Description
This command has no arguments or keywords.
Command Default
Changes in total IMA group bandwidth are not automatically managed.
Command Modes
Interface configuration (config-if)
Command History
Release
Modification
12.0(30)S1
This command was introduced.
12.0(31)S
This command was integrated into Cisco IOS Release 12.0(31)S.
Usage Guidelines
When the atmbandwidthdynamiccommand is enabled, all of the permanent virtual circuits (PVCs) configured on an IMA group interface are created again if the total available IMA group bandwidth changes.
There must be at least one active link on the IMA group interface for dynamic bandwidth changes to take effect.
Automatic bandwidth management is supported only for the following quality of service (QoS) classes:
UBR--unspecified bit rate
ABR--available bit rate
VBR-NRT--variable bit rate nonreal-time
If necessary and applicable for a particular PVC based on its QoS class, new values are applied for the following parameters when PVCs are re-created:
peak cell rate (PCR)--all supported QoS classes
minimum cell rate (MCR)--ABR QoS
sustainable cell rate (SCR)--VBR-NRT QoS
The algorithm used to implement automatic bandwidth management is applied only when dynamic changes to an IMA group interface occur. It is not applied at virtual circuit creation on router bootup.
Note
PVCs may have incorrect QoS parameters if the atmbandwidthdynamic command is disabled after changing the total bandwidth, and enabled again after changing the total bandwidth once more.
Examples
The following example shows how to create IMA group 1, enable automatic bandwidth management, and assign a physical ATM interface to the IMA group:
Configures an ATM interface and enters interface configuration mode.
interfaceatmima
Configures an IMA group.
atm classic-ip-extensions
To enable support for redundant ATM Address Resolution Protocol (ARP) servers on a single logical IP subnetwork (LIS), use the atmclassic-ip-extensions command in interface configuration mode. To remove support for redundant ATM ARP servers, use the no form of this command.
atmclassic-ip-extensions
{ BFI | none }
noatmclassic-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).
Command Default
Redundant ATM ARP server support is not enabled.
Command Modes
Interface configuration
Command History
Release
Modification
11.2
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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 atmclassic-ip-extensionsBFI 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:
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 atmclockinternalcommand in interface configuration mode. To restore the default value, use the no form of this command.
atmclockinternal
noatmclockinternal
Syntax Description
This command has no arguments or keywords.
Command Default
The ATM interface uses the transmit clock signal from the remote connection (the line).
Command Modes
Interface configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
When the ATM interface uses the transmit clock signal from the remote connection (the line), the switch provides the clocking.
This command is meaningless on a 4B/5B physical layer interface module (PLIM).
For SONET interfaces, use the atmclockinternal 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/0
atm clock internal
atm compression
To specify the software compression mode on an interface, use the atmcompression command in interface configuration mode. To remove the compression mode setting, use the no form of this command.
Specifies packet-by-packet compression mode (no history). This is the default.
per-interface
Specifies one context per interface (with history).
per-vc
Specifies one context for every virtual circuit (with history).
Command Default
Packet-by-packet compression mode (no history) is used.
Command Modes
Interface configuration
Command History
Release
Modification
11.3(1)MA
This command was introduced on the Cisco MC3810 multiservice concentrator.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command applies to ATM configuration on the Cisco MC3810 multiservice concentrator.
Examples
The following example configures per-packet ATM compression:
interface atm0
atm compression per-packet
atm ds3-scramble
To enable scrambling of the ATM cell payload for the DS3 physical layer interface module (PLIM) on an ATM interface, use theatmds3-scramblecommand in interface configuration mode. To disable scrambling of the ATM cell payload for the DS3 PLIM, use the no form of this command.
atmds3-scramble
noatmds3-scramble
Syntax Description
This command has no arguments or keywords.
Command Default
DS3 scrambling is not enabled.
Command Modes
Interface configuration
Command History
Release
Modification
11.0
This command was introduced.
11.1
Command syntax was changed fromds3scramble to atmds3-scramble.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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/0
no atm ds3-scramble
atm e164 auto-conversion
To enable ATM E164 autoconversion, use the atme164auto-conversioncommand in interface configuration mode. To disable autoconversion, use the no form of this command.
atme164auto-conversion
noatme164auto-conversion
Syntax Description
This command has no arguments or keywords.
Command Default
E.164 auto conversion is not enabled.
Command Modes
Interface configuration
Command History
Release
Modification
11.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
You must enable the ATM interface before using the atme164auto-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/1
atm e164 auto-conversion
atm e3-scramble
To enable scrambling of the ATM cell payload for the E3 physical layer interface module (PLIM) on an ATM interface, use theatme3-scramble command in interface configuration mode. To disable scrambling of the ATM cell payload for the E3 PLIM, use the no form of this command.
atme3-scramble
noatme3-scramble
Syntax Description
This command has no arguments or keywords.
Command Default
E3 scrambling is enabled.
Command Modes
Interface configuration
Command History
Release
Modification
11.1
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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/0
no atm e3-scramble
atm enable-ilmi-trap
To generate an Integrated Local Management Interface (ILMI) atmfVccChange trap when an ATM interface or subinterface is enabled or shut down, use the atmenable-ilmi-trapcommand in subinterface configuration mode. To disable ILMI traps, use the no form of this command.
atmenable-ilmi-trap
noatmenable-ilmi-trap
Syntax Description
This command has no arguments or keywords.
Command Default
An atmfVccChange trap is not generated when an ATM interface or subinterface is enabled or shut down.
Command Modes
Subinterface configuration (config-subif)
Command History
Release
Modification
12.0(28)S
This command was introduced.
12.2SB
This command was integrated into Cisco IOS Release 12.2SB.
Usage Guidelines
ILMI permanent virtual circuit (PVC) should have been created under the ATM main interface.
Theatmenable-ilmi-trap command is supported only on Cisco 12000 routers.
Examples
The following example allows atmfVccChange traps to be generated when an ATM interface or subinterface has a status of shut or no shut:
atm enable-ilmi-trap
Related Commands
Command
Description
atmilmi-keepalive
Enables ILMI keepalives.
pvc
Creates or assigns a name to an ATM PVC, specifies the encapsulation type on an ATM PVC, and enters ATM virtual circuit configuration mode.
atm ether-mac-address
To configure the ATM point-to-point subinterface to use a user-defined MAC address or a MAC address of any other physical interface, use the atmether-mac-address command in ATM point-to point subinterface configuration mode. To disable any configured functionality, use the no form of this command.
You can use the MAC address of any other physical interface as the MAC address of a subinterface, in conjunction with the Dynamic Host Configuration Protocol (DHCP) client. You can also configure an explicit MAC address for an ATM point-to-point subinterface.
Examples
The following example shows how the ATM point-to-point subinterface can be configured to use the MAC address of any other physical interface:
Router# config t
Router(config)# interface atm3/0.100 point-to-point
Router(config-subif)# atm ether-mac-address interface fastEthernet 0/0
Router(config-subif)#interface ATM3/0.100 point-to-point
Router(config-subif)# atm ether-mac-address interface FastEthernet0/0
Router(config-subif)# no atm enable-ilmi-trap
Router(config-subif)# end
Note
For RBE, the client interface is restricted to ethernet interfaces only.
The following example shows how the ATM point-to-point subinterface can be configured with the user-defined MAC address:
Router(config-subif)# atm ether-mac-address 0a0a.0b0b.0c0c
Router(config-subif)# interface ATM3/0.100 point-to-point
Router(config-subif)# no atm enable-ilmi-trap
end
Note
A valid nonzero MAC address is essential for a successful configuration.
Router(config-subif)# atm ether-mac-address 0000.0000.0000
% Malformed hex mac address
Related Commands
Command
Description
showrun
Displays the configured interface name.
atm esi-address
To enter the end station ID (ESI) and selector byte fields of the ATM network service access point (NSAP) address, use the atmesi-addresscommand in interface configuration mode. 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.
atmesi-addressesi
.
selector
noatmesi-addressesi
.
selector
Syntax Description
esi
End station ID field value in hexadecimal; 6 bytes long.
.selector
Selector field value in hexadecimal; 1 byte long. Dot is required as a separator.
Command Default
No ESI is defined.
Command Modes
Interface configuration
Command History
Release
Modification
11.1
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
The atmesi-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 selectorarguments.
Note
When ILMI is configured, use the atmesi-address command instead of the atmnsap-address command. The atmesi-addressand atmnsap-addresscommandsare mutually exclusive. Configuring the router with the atmesi-address command negates the atmnsap-address setting, and vice versa.
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:
Sets the NSAP address for an ATM interface using SVC mode.
ilmimanage
Enables ILMI management on an ATM PVC.
pvc
Configures the PVC interface.
atm exception-queue
To set the exception queue length, use the atmexception-queuecommand in interface configuration mode. To restore the default value, use the no form of this command.
atmexception-queuenumber
noatmexception-queue
Syntax Description
number
Number of entries. Range is from 8 to 256. Default is 32.
Command Default
32 entries
Command Modes
Interface configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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 50
atm framing (DS3)
To specify digital signal level 3 (DS3) line framing on an ATM interface, use the atmframing command in interface configuration mode. To return to the default C-bit with Physical Layer Convergence Protocol (PLCP) framing, use the no form of this command.
(Optional) Specifies C-bit with ATM direct mapping (ADM).
cbitplcp
(Optional) Specifies C-bit with PLCP framing.
m23adm
(Optional) Specifies M23 ATM direct mapping.
m23plcp
(Optional) Specifies M23 with PLCP framing.
Command Default
C-bit with PLCP framing is used.
Command Modes
Interface configuration
Command History
Release
Modification
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.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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/0
atm framing m23adm
atm framing (E3)
To specify E3 line framing, use the atmframing command in interface configuration mode. To return to the default G.751 Physical Layer Convergence Protocol (PLCP) framing, use the no form of this command.
atmframing
[ g751adm | g832adm | g751plcp ]
noatmframing
[ 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.
Command Default
G.751 ATM direct mapping (ADM) is used.
Command Modes
Interface configuration
Command History
Release
Modification
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.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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/0
atm framing g832adm
atm ilmi-keepalive
To enable Interim Local Management Interface (ILMI) keepalives, use the atmilmi-keepalive command in interface configuration mode. To disable ILMI keepalives, use the no form of this command.
atmilmi-keepalive [seconds]
noatmilmi-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.
Command Default
3 seconds
Command Modes
Interface configuration
Command History
Release
Modification
11.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following example enables ILMI keepalives for the ATM interface 1/0:
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 atmilmi-pvc-discoverycommand in interface configuration mode. To disable PVC discovery, use the noform of this command.
atmilmi-pvc-discovery [subinterface]
noatmilmi-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.
Command Default
PVC discovery is not enabled.
Command Modes
Interface configuration
Command History
Release
Modification
11.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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:
To specify the cable length (line build-out) for the ATM interface, use the atmlbo command in interface configuration mode. To return to the default, use the no form of this command.
atmlbo
{ long | short }
noatmlbo
Syntax Description
long
Specifies a cable length greater than 50 feet.
short
Specifies a cable length up to 50 feet.
Command Default
A cable length greater than 50 feet is specified.
Command Modes
Interface configuration
Command History
Release
Modification
11.1
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following example specifies that the ATM interface uses a cable of up to 50 feet in length:
interface atm 4/0
atm lbo short
Related Commands
Command
Description
ces
Configures cable length for the CBR interface.
atm max-channels
To configure the number of transmit channels for the interface, use the atmmax-channels command in interface configuration mode. To return to the default, use the no form of this command.
atmmax-channelsnumber
noatmmax-channels
Syntax Description
number
Maximum number of transmit channels for the interface. The range is from 64 to 2048 channels. The default is 64 channels.
Command Default
64 channels
Command Modes
Interface configuration
Command History
Release
Modification
11.1
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
The atmmax-channels command replaces the atmtx-channels command.
Transmit Descriptors
The atmmax-channelscommand 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 atmmax-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 showatminterfaceatm command.
Examples
The following example sets the number of transmit descriptors for the interface to 120.
interface atm 2/0
atm max-channels 120
Related Commands
Command
Description
showatminterfaceatm
Displays ATM-specific information about an ATM interface.
atm maxvc
To set the ceiling value of the virtual circuit descriptor (VCD
) on the ATM interface, use the atmmaxvccommand in interface configuration mode. To restore the default value, use the no form of this command.
atmmaxvcnumber
noatmmaxvc
Syntax Description
number
Maximum number of supported virtual circuits. Valid values are 256, 512, 1024, and 2048.
Command Default
2048 virtual circuits
Command Modes
Interface configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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 atmpvccommand. 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 theatmpvccommand with a larger value for the vcdargument, 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 1024
Related Commands
Command
Description
pvc
Configures an ATM PVC.
atm mid-per-vc
To limit the number of message identifier (MID) numbers allowed on each virtual circuit, use the atmmid-per-vc command in interface configuration mode.
atmmid-per-vcmaximum
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.
Command Default
16 MIDs per virtual circuit.
Command Modes
Interface configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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 atmmid-per-vc command overrides the range between the midhigh and midlow values set by the atmpvccommand. 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 64
Related Commands
Command
Description
pvc
Configures the PVC interface.
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 atmmulticast command in interface configuration mode.
atmmulticastaddress
Syntax Description
address
Multicast E.164 address assigned to the subinterface.
Command Default
No multicast E.164 address is defined.
Command Modes
Interface configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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.000
Related Commands
Command
Description
abr
Selects ABR QoS and configures output peak cell rate and output minimum guaranteed cell rate for an ATM PVC or VC class.
atmsmds-address
Assigns a unicast E.164 address to the ATM subinterface that supports AAL3/4 and SMDS encapsulation.
pvc
Configures the PVC interface.
atm multipoint-interval
To specify how often new destinations can be added to multipoint calls to an ATM switch in the network, use the atmmultipoint-intervalcommand in interface configuration mode. To return to the default interval, use the no form of this command.
atmmultipoint-intervalinterval
noatmmultipoint-intervalinterval
Syntax Description
interval
Interval length, in seconds. Range is from 0 to 4294967. Default is 30.
Command Default
30 seconds
Command Modes
Interface configuration
Command History
Release
Modification
11.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
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 signaling is enabled on the interface.
Examples
The following example enables point-to-multipoint signaling on the ATM interface 2/0. It also specifies that new destinations can be added to multipoint calls every 60 seconds:
Enables point-to-multipoint signaling to the ATM switch.
atm multipoint-signalling
To enable point-to-multipoint signaling to the ATM switch, use the atmmultipoint-signalling command in interface configuration mode. To disable point-to-multipoint signalling to the ATM switch, use the no form of this command.
atmmultipoint-signalling
noatmmultipoint-signalling
Syntax Description
This command has no arguments or keywords.
Command Default
Point-to-multipoint signaling is not enabled.
Command Modes
Interface configuration
Command History
Release
Modification
11.0
This command was introduced.
11.1
Functionality was changed to allow this command on all subinterfaces, not just the main interface.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
If multipoint signaling 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 atmmultipoint-interval command determines how often new destinations can be added to a multipoint call.
Note
Prior to Cisco IOS Release 11.1, when this command was used on the main interface, it also affected all subinterfaces. For Release 11.1 and later, explicit configuration on each subinterface is required to obtain the same functionality.
Examples
The following example enables point-to-multipoint signalling on the ATM interface 2/0:
interface atm 2/0
atm multipoint-signalling
Related Commands
Command
Description
atmmultipoint-interval
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 atmnsap-addresscommand in interface configuration mode. To remove any configured address for the interface, use the noform of this command.
atmnsap-addressnsap-address
noatmnsap-address
Syntax Description
nsap-address
The 40-digit hexadecimal NSAP address of this interface (the source address).
Command Default
No NSAP address is defined for this interface.
Command Modes
Interface configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
When configuring an SVC, you must use the atmnsap-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
When the Integrated Local Management Interface (ILMI) is configured, use theatmesi-address command instead of the atmnsap-address command. The atmesi-addressand
atmnsap-addresscommandsare mutually exclusive. Configuring the router with the atmesi-address command negates the atmnsap-address setting, and vice versa.
Configuring a new address on the interface overwrites the previous address. The router considers the address as a string of bytes and will not prefix or suffix the address with any other strings or digits. The complete NSAP address must be specified, because this value is used in the Calling Party Address Information Element in the SETUP message to establish a virtual circuit.
ATM NSAP addresses have a fixed length of 40 hexadecimal digits. You must configure the complete address in the following dotted format:
All ATM NSAP addresses should be entered in the dotted hexadecimal format shown above, which conforms to the User-Network Interface (UNI) specification.The dotted method provides some validation that the address is a legal value. If you know your address format is correct, the dots may be omitted.
Examples
In the following example, the source NSAP address for the interface is AB.CDEF.01.234567.890A.BCDE.F012.3456.7890.1234.12:
To enable the generation of Operation, Administration, and Maintenance (OAM) Alarm Indication Signal (AIS) alarms, use the atmoamaisalarmcommand in interface configuration mode. To disable the generation of OAM AIS alarms, use the no form of this command.
atmoamaisalarm
noatmoamaisalarm
Syntax Description
This command has no arguments or keywords.
Command Default
OAM AIS alarms are generated.
Command Modes
Interface configuration (config-if)
Command History
Release
Modification
12.0(32)SY4
This command was introduced.
Usage Guidelines
Use the showinterfacesatmcommand to determine whether generation of OAM AIS alarms is enabled.
Examples
The following example shows how to enable the generation of OAM AIS alarms:
Router> enable
Password:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# interface atm 0/0
Router(config-if)# atm oam ais alarm
Router(config-if)# end
Related Commands
Command
Description
showinterfacesatm
Displays information about ATM interfaces.
atm oam flush
To drop all current and future Operation, Administration, and Maintenance (OAM) cells received on an ATM interface, use the atmoamflushcommand in interface configuration mode. To receive OAM cells on an ATM interface, use the no form of this command.
atmoamflush
noatmoamflush
Syntax Description
This command has no arguments or keywords.
Command Default
Dropping of OAM cells is disabled.
Command Modes
Interface configuration
Command History
Release
Modification
11.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
The following example drops all current and future OAM cells received on the ATM main interface with slot 0 and port 0:
interface atm 0/0
atm oam flush
atm oversubscribe
To enable infinite bandwidth oversubscription for service categories other than constant bit rate (CBR), use the atmoversubscribecommand in interface configuration mode. To disable bandwidth oversubscription for service categories other than CBR, use the no form of this command.
atmoversubscribe
noatmoversubscribe
Syntax Description
This command has no arguments or keywords.
Command Default
Infinite bandwidth oversubscription is enabled
Command Modes
Interface configuration
Command History
Release
Modification
12.0(3)T
This command was introduced.
12.2(16)BX3
This command was integrated into Cisco IOS Release 12.2(16)BX3.
12.3(7)XI1
This command was integrated into Cisco IOS Release 12.3(7)XI1.
12.4(6)T
Support for this command was added to DSL ATM interfaces.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command disables bandwidth management for service categories other than CBR.
When infinite bandwidth oversubscription is enabled, the interface allows as much bandwidth as possible with no upper limits (except on digital subscriber line (DSL) ATM interfaces, in which oversubscription is a not infinite, but is a factor of 2). The system determines if the ATM link is already oversubscribed. If so, the command is rejected. Otherwise, the total bandwidth available on the link is recorded, and all future connection setup requests are monitored to ensure that the link is not oversubscribed.
The bandwidth allocated for each service category appears in the output of the showatminterfaceatm command.
The ATM bandwidth manager tracks the bandwidth used by virtual circuits (VCs) on a per-interface basis. Because many services require guaranteed bandwidth (for example, for variable bit rate-real time (VBR-RT), available bit rate (ABR), and CBR), bandwidth management is required. The purpose of the bandwidth manager is to reserve resources for connections that require guaranteed services. Bandwidth management for CBR is turned on automatically for all interfaces supporting CBR. Bandwidth management for other service categories must be turned on by the user. All service categories outside CBR are monitored only if specifically requested.
Note
Because unspecified bit rate (UBR) does not provide guaranteed bandwidth, the bandwidth specified for a UBR connection is not used in any calculations.
Bandwidth checking for a permanent virtual circuit (PVC) is done when that PVC is configured. Bandwidth checking for a switched virtual circuit (SVC) is done when a signaling call is placed or received.
When you use the atm pvp command, the system checks if the specified bandwidth is available on the interface. If the bandwidth available is greater than or equal to the peak rate specified for the Permanent Virtual Path (PVP), the command is accepted; otherwise, the command is rejected.
Within the VC mode, the available bandwidth check will determine whether the bandwidth is already used by the VC to fulfill the request. If the VC being configured is a PVC and belongs to a PVP, the bandwidth available on the PVP is used for the check; otherwise, the bandwidth available on the interface is used for the check.
When services within a VC class are being configured, the check determines whether the new bandwidth requirement can be fulfilled for all VCs using the class (on a per-interface basis) by comparing it with the bandwidth available on the corresponding interface.
Bandwidth checking for an SVC occurs before a SETUP message is sent for an outbound call. If the bandwidth check fails, the SETUP message is not sent. If the bandwidth check passes, the traffic class from which the service category is inherited is updated with the requirements for the new SVC.
When an SVC setup is requested for remotely initiated calls, a bandwidth check occurs as soon as the SETUP message is received. This bandwidth check has two components:
Match the bandwidth requested by the remote end with the bandwidth configured locally.
Check if bandwidth configured locally can be satisfied currently.
If the bandwidth check fails, a RELEASE message is sent out, and the call is rejected. If the bandwidth check passes, resources are reserved for the VC, and the call is accepted.
Cisco 10000 Series Router
Oversubscription of the ATM interfaces is off by default. Oversubscription of the tunnels (the number and bandwidth of VCs that can be in a tunnel) is on by default and is not subject to any oversubscription factor. Oversubscription of the tunnels cannot be adjusted or turned off. On the Cisco 10000 Series router, to enable the oversubscription feature for a particular interface or tunnel, use the atm over-subscription-factor command (but not the atm oversubscribe command, which can cause undesirable results). To prevent oversubscription of the interface, use the no atm oversubscribe command.
With variable bit rate-nonreal time (VBR-NRT) oversubscription, because of congestion on the physical interface, the accuracy of priority queueing (PQ) and class-based weighted fair queueing (CBWFQ) on individual VCs degrades. For example, if you configure each of three queues at a distribution of 50, 30, and 20 percent, respectively, the actual distribution might be 45, 40, and 15 percent, respectively. The distribution of bandwidth for each VC might be less than expected based on the speed of the VC. Typically, low-speed VCs are allocated the expected bandwidth, and high-speed VCs share the remaining bandwidth equally. The amount of bandwidth allocated for the PQ or latency might be less than expected.
Examples
The following example enables the oversubscription feature:
The following example displays the available bandwidth in kbps after the router enters VC mode. In this example, the available bandwidth is 139,000 kbps:
Router#
show atm interface atm 2/0
Interface ATM2/0:
AAL enabled: AAL5, Maximum VCs:1024, Current VCCs:5
Maximum Transmit Channels:64
Max. Datagram Size:4496
PLIM Type:SONET - 155Mbps, TX clocking:LINE
Cell-payload scrambling:OFF
sts-stream scrambling:ON
877 input, 120843834 output, 0 IN fast, 20 OUT fast
ABR parameters, rif:16 rdf:16, 0 out drop
Bandwidth distribution :CBR :16000 Avail bw = 139000
Config. is ACTIVE
Examples
The following example enables the oversubscription feature (using the atm over-subscription-factor command rather than the atm oversubscribe command) and configures the interface with an oversubscription factor of 50:
The following example disables oversubscription of the ATM 4/0/0 interface. The previously configured factor 50 is configured on the interface, but the router does not allow the oversubscription:
Router(config)# interface atm 4/0/0
Router(config-if)# no atm oversubscribe
Router(config-if)# exit
Related Commands
Command
Description
atmoversubscribefactor
Enables finite line bandwidth oversubscription for DSL.
atmover-subscription-factor
Oversubscribes ATM VCs.
atmpvp
Creates a PVP used to multiplex (or bundle) one or more VCs.
showatminterfaceatm
Displays ATM-specific information about an ATM interface.
showcontrollers
Displays the total subscribed rate of all VCs on the port.
showrunning-config
Displays the contents of the running configuration file.
ubr+
Configures unspecified bit rate plus for an ATM PVC.
vbr-nrt
Configures variable bit rate-nonreal-time for an ATM PVC.
vbr-rt
Configures variable bit rate real-time for VoATM voice connections.
atm oversubscribe factor
To set up finite line bandwidth oversubscription for digital subscriber line (DSL), use the atmoversubscribefactor command in interface configuration mode. To disable finite line bandwidth oversubscription for DSL, use the no form of this command.
atmoversubscribefactorfactor
noatmoversubscribefactorfactor
Syntax Description
factor
Oversubscription factor in the range from 2 to 14000000000.
Command Default
Finite line bandwidth oversubscription for DSL is disabled.
Command Modes
Interface configuration
Command History
Release
Modification
12.4(2)XA
This command was introduced.
12.4(6)T
This command was integrated into Cisco IOS Release 12.4(6)T.
Usage Guidelines
Resource limitations on Cisco xDSL interfaces require a way to configure bandwidth oversubscription up to a defined bandwidth (a finite
oversubscription of bandwidth). For this requirement, the atmoversubscribefactorcommand is used. A DSL ATM interface supports only an oversubscribe factor of 2.
Oversubscription is allowed on variable bit rate real time class (VBR-rt), variable bit rate non-real time class (VBR-nrt), and unspecified bit rate plus (UBR+) permanent virtual circuits (PVCs). With oversubscription enabled, multiple VBR-rt, VBR-nrt, and UBR+ PVCs can be configured even when the sum of their sustainable cell rates (SCRs) exceeds the actual bandwidth available over the physical line. For example, if oversubscription is enabled and an oversubscription factor of 2 is set for a line rate of 2304 kbps, the sum of SCRs and minimum desired cell rates of VBR-rt, VBR-nrt, and UBR+ PVCs must be less than or equal to 4608 kbps, excluding the constant bit rate (CBR) PVC bandwidth.
An oversubscription factor of 2 is used internally; that is, VBR and UBR+ PVCs with a sum of SCRs up to twice the current line rate are valid. If you configure VBR-rt, VBR-nrt, or UBR+ for more than the configured oversubscription factor, the PVCs will be configured when bandwidth is available. But when no oversubscription bandwidth is available, a PVC is downgraded to an unspecified bit rate (UBR) (CBR PVCs are not affected, however); in this state, if you try to configure VBR or UBR+ PVCs beyond the line rate, the new PVCs will be downgraded to UBR state. If you have no oversubscription configured, each virtual circuit (VC) receives up to its configured SCR value of traffic, and VCs with higher SCR values receive more bandwidth. For example, if VC1 is a VBR-rt PVC configured with peak cell rate (PCR) and SCR line rates of 2304 kbps (command vbr-rt23042304),
VC2 is a VBR-nrt PVC configured with PCR and SCR line rates of 2000 kbps (command vbr-nrt20002000), and VC3 has PCR and SCR line rates of 496 kbps (command vbr-rt496496),
then when no oversubscription bandwidth is available, VC1 and VC 2 are configured with the specified PCR and SCR line rates, but VC3 is downgraded to UBR class.
If the DSL line rate goes down and comes back up with less than the trained rate (based on the trained bandwidth PVCs) and no bandwidth is left, some PVCs might be downgraded to UBR class.
The value of the oversubscription factor determines the maximum bandwidth that is configured, which is the sum of SCRs for all VBR-rt, VBR-nrt, and UBR+. PVCs. To disable oversubscription, the total configured bandwidth of CBR, VBR-rt, VBR-nrt, and UBR+ must not exceed actual trained bandwidth. The CBR bandwidth is counted when disabling oversubscription.
With oversubscription disabled, a PVC can be configured only up to the line rate. For example, if the line rate is 2304 kbps, the SCR or PCR of a VBR PVC cannot be more than 2304 kbps (assuming there are no other PVCs). If there is another PVC, such as a CBR PVC with a PCR of 500 kbps, that line rate is subtracted, and the maximum SCR or PCR allowed on the VBR PVC is 1804 kbps.
The first time VBR-rt, VBR-nrt, or UBR+ PVCs are configured with the oversubscription factor enabled, the available bandwidth is checked. If the required bandwidth is available, the service class commands (vbr-rt, vbr-nrt,
and ubr+) are accepted. If there is not enough requested bandwidth, the service class commands are rejected, and the PVC state will be UP with service class set to UBR.
After VBR-rt, VBR-nrt, or UBR+ PVCs are configured, a dynamic line rate modification occurs when the atmoversubscribefactorcommand is enabled. The available bandwidth is checked, and if the required amount is available, the PVC state will be UP with the configured service class. If there is not enough bandwidth, the PVC state will be UP with service class UBR.
DSL ATM interfaces do not support switched virtual circuits (SVCs).
Examples
The following example shows how to set oversubscription on the link by a factor of 2.
The oversubscription configuration can be verified by using the showatminterface EXEC command. The report from the command indicates that the link is oversubscribed by 4608 kbps.
Router# show atm interface atm 0/0
Interface ATM0/0:
AAL enabled: AAL5 , Maximum VCs: 23, Current VCCs: 4
VCIs per VPI: 256,
Max. Datagram Size: 4528
PLIM Type: GSHDSL - 2304Kbps, Framing is Unknown,, TX clocking: LINE
0 input, 0 output, 0 IN fast, 0 OUT fastCBR : 2304 UBR+ : 2304 VBR-NRT : 2304
Link oversubscribed by 4608 kbps
Config. is ACTIVE
Related Commands
Command
Description
atmoversubscribe
Disables bandwidth management for service categories other than CBR.
showatminterfaceatm
Displays ATM-specific information about an ATM interface.
ubr+
Configures unspecified bit rate plus for an ATM PVC.
vbr-nrt
Configures variable bit rate-nonreal time for an ATM PVC.
vbr-rt
Configures variable bit rate real-time for VoATM voice connections.
atm over-subscription-factor
To oversubscribe ATM virtual circuits (VCs), use the atm over-subscription-factor command in interface configuration mode. To disable oversubscription of ATM VCs, use the no form of this command.
atmover-subscription-factorvalue
noatmover-subscription-factor
Syntax Description
value
Oversubscription factor. The range is from 1 to 500.
Command Default
The default factor is 1 (no oversubscription).
Command Modes
Interface configuration
Command History
Release
Modification
12.2(16)BX
This command was introduced. on the Cisco 10000 series Performance Routing Engine (PRE-2).
12.3(7)XI3
This command was integrated into Cisco IOS Release 12.3(7)XI3, and the maximum oversubscription factor was increased from 50 to 500.
12.2(31)SB
This command was integrated into Cisco IOS Release 12.2(31)SB.
Usage Guidelines
Restrictions and Limitations for Interface Oversubscription
Because of a mismatch of rates between the packet scheduler and the network, interface oversubscription can degrade system performance during congestion.
With oversubscription, network congestion can occur if all of the network capacity is used concurrently. However, the risk is low if you avoid oversubscribing a network that is likely to congest and if you do not oversubscribe a service excessively.
The router uses the atm over-subscription-factor command in conjunction with the atm oversubscribe command to enable or disable oversubscription for a particular interface. When enabling ATM oversubscription for a particular interface, specify the atm over-subscription-factor command. Do not use the atm oversubscribe command to enable oversubscription, because this can cause undesirable results.
An ATM variable bit rate (VBR) VC uses the sustained cell rate (SCR) to define the VC’s average transmission rate. Therefore, use the atm over-subscription-factor command, but not the service-policy command, to specify the ATM VC oversubscription.
Because the oversubscription of VBR-nrt VCs requires resources from the entire line card, apply the atm over-subscription-factor command on all ports of the ATM interface (for example, the 4-port OC-3 ATM line card). If you enable oversubscription on only one port, the other ports might use more resources than they were configured to use. As a result, some ports might not receive adequate resources, which would cause VC creation failures.
Examples
The following example shows how to configure an ATM interface with an oversubscription factor of 500:
The following example shows how to disable oversubscription of the ATM 4/0/0 interface to prevent oversubscription of the interface:
Router(config)# interface atm 4/0/0
Router(config-if)# no atm oversubscribe
Related Commands
Command
Description
atmoversubscribe
Disables bandwidth management for service categories other than CBR.
service-policy
Attaches a policy map to an input interface or virtual circuit (VC), or an output interface or VC, to be used as the service policy for that interface or VC
showatminterfaceatm
Displays ATM interface information.
atm pppatm passive
To place an ATM subinterface in passive mode, use the atmpppatmpassive command in ATM subinterface configuration mode. To change the configuration back to the default (active) mode, use the no form of this command.
atmpppatmpassive
noatmpppatmpassive
Syntax Description
This command has no arguments or keywords.
Command Default
Active mode
Command Modes
ATM subinterface configuration
Command History
Release
Modification
12.2(13)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
The atmpppatmpassivecommand places PPP over ATM (PPPoA) sessions on an ATM subinterface in “listening” mode. Rather than trying to establish the sessions actively by sending out Link Control Protocol (LCP) packets, these sessions listen to the incoming LCP packets and become active only after they have received their first LCP packet. This feature is useful for L2TP access concentrators (LACs) in the broadband access deployments where thousands of PPPoA sessions are configured on LACs. When PPPoA is in the passive mode, the LAC brings up the sessions only when the subscribers become active and not use its processing power on polling all sessions.
For better scalability and faster convergence of PPP sessions, you should set the PPPoA sessions to passive mode at the LAC.
Cisco 10000 Series Router
For better scalability and faster convergence of PPPoA, PPP over Ethernet over ATM (PPPoEoA), or LAC sessions, set the sessions to passive mode.
You must use the atm pppatm passive command for large-scale PPP terminated aggregation (PPPoA and PPPoEoA) and Layer 2 Tunnel Protocol (L2TP) access concentrator (LAC). Instead of sending out LCP packets to establish the sessions actively, the sessions listen to the incoming LCP packets and become active only after they receive their first LCP packet. When PPPoX is in the passive mode, the LAC brings up the sessions only when the subscribers become active and does not use processing power polling all sessions.
Examples
The following example configures the passive mode for the PPPoA sessions on an ATM subinterface:
To create a permanent virtual path (PVP) used to multiplex (or bundle) one or more virtual circuits (VCs), use the
atmpvpcommand in interface configuration mode. To remove a PVP, use the
no form of this command.
ATM network virtual path identifier (VPI) of the VC to multiplex on the permanent virtual path. The range is 0 to 255. The VPI is an 8-bit field in the header of the ATM cell. Because it has local significance only, the VPI value is unique only on a single link, not throughout the ATM network. The VPI value must match that of the switch.
The number specified for the
vpi argument must not already exist in a VC. If the number specified for the
vpi is already used by an existing VC, this command is rejected.
peak-rate
(Optional) Maximum rate in kbps at which the PVP can transmit data. The range is 84 kbps to line rate. The default is the line rate.
l2transport
(Optional) Specifies that the PVP is for the Any Transport over MPLS (AToM) ATM cell relay feature or the ATM Cell Relay over L2TPv3 feature.
cdvt
(Optional) Cell delay variation tolerance (CDVT) in tenths of a microsecond. The range is 1 to 7140.
no-f4-oam
(Optional) Inhibits the creation of F4 (virtual path connection [VPC] level) Operation, Administration, and Maintenance (OAM) VCs.
Command Default
A PVP is not configured.
Command Modes
Interface configuration
Command History
Release
Modification
11.1
This command was introduced.
12.0(17)SL
This command was integrated into Cisco IOS Release 12.0(17)SL.
12.0(25)S
This command was integrated into Cisco IOS Release 12.0(25)S, and the l2transport keyword was added.
12.2(16)BX
This command was integrated into Cisco IOS Release 12.2(16)BX.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(31)SB
This command was integrated into Cisco IOS Release 12.2(31)SB.
Usage Guidelines
This command is commonly used to create a PVP that is used to multiplex circuit emulation service (CES) and data VCs.
The ATM-CES port adapter supports multiplexing of one or more VCs over a virtual path that is shaped at a constant bandwidth. For example, you can buy a virtual path service from an ATM service provider and multiplex both the CES and data traffic over the virtual path.
All subsequently created VCs with a
vpi argument matching the
vpi specified with theatmpvp command are multiplexed onto this PVP. This PVP connection is an ATM connection where switching is performed on the VPI field of the cell only.
A PVP is created and left up indefinitely. All VCs that are multiplexed over a PVP share and are controlled by the traffic parameters associated with the PVP.
Changing the
peak-rate value causes the ATM-CES port adapter to go down and then back up.
When you create a PVP, two VCs are created (VCI 3 and 4) by default. These VCs are created for VP end-to-end loopback and segment loopback OAM support.
When you use the l2transport keyword with the atm pvp command, the router enters l2transport PVP configuration mode. You must issue the l2transport keyword to configure the ATM cell relay over multiprotocol label switching (MPLS) feature in port mode or to configure the ATM cell relay over L2TPv3 feature.
To verify the configuration of a PVP, use the
showatmvp command.
Examples
The following example creates a PVP with a peak rate of 2000 kbps. The subsequent VCs created are multiplexed onto this virtual path.
Displays the statistics for all VPs on an interface or for a specific VP.
atm rate-queue
To create a permanent rate queue
or specify a rate queue tolerance, use the atmrate-queue command in interface configuration mode. To remove a rate queue or rate queue tolerance, use the no form of this command.
Queue number in the range 0 through 7 on the ATM Interface Processor (AIP) for Cisco 7500 series routers, and in the range 0 through 3 on the network processing module (NPM) for Cisco 4500 and Cisco 4700 routers.
On the AIP, queues 0 through 3 are in the high-priority bank, and queues 4 through 7 are in the low-priority bank. Queues in the same priority bank have the same priority; for example, queues 0 and 3 have the same priority. On the NPM, all 4 queues have the same priority.
speed
Speed in megabits per second (Mbps) in the range from 1 through 155. The maximum speed is determined by the detected physical layer inteface module (PLIM) type on the AIP or NPM:
34 Mbps for E3
45 Mbps for DS-3
100 Mbps for Transparent Asynchronous Transmitter/Receiver Interface (TAXI)
155 Mbps for Synchronous Optical Network (SONET)
tolerance
Specifies that you want to use a rate queue tolerance value.
svc
Specifies that the tolerance-value will be applied to SVCs.
pvc
(Optional) If specified, the tolerance-value will be applied to PVCs.
tolerance-value
A tolerance level expressed as a percentage used for assigning rate queues for each virtual circuit (VC) with a requested peak rate. This value is applied to switched virtual circuits (SVCs), discovered VCs, and permanent virtual circuits (PVCs) (when the pvc keyword is used). This value can be 0 or 5 through 99. For SVCs and discovered VCs, the default value is 10. For PVCs, the default value is 0.
strict
(Optional) Indicates whether SVC traffic-shaping parameters are altered beyond the SVC tolerance or rejects the incoming call.
Command Default
No rate queue is defined.
Command Modes
Interface configuration
Command History
Release
Modification
10.0
This command was introduced.
11.3
The following keywords were added:
tolerance
svc
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
If a PVC or SVC is created, and its rate queue does not match a permanent rate queue that was created using the atm-ratequeuequeue-numberspeed command, one of the following will occur:
The PVC or SVC will use an existing rate queue if the PVC’s or SVC’s rate queue falls within the tolerance-value specified.
The software will dynamically create a new and unique rate queue if the PVC or SVC does not fall within a previously configured rate-queue tolerance.
If you do not create permanent rate queues or if you create PVCs with peak or average rates that are not matched by the rate queues you configure, the software dynamically creates rate queues as necessary to satisfy the requests of the atmpvc commands.
You can create multiple rate queues. A warning message appears if all rate queues are deconfigured or if the combined rate queues exceed the PLIM rate.
Examples
The following example configures a permanent rate queue with a queue-number of 1 and a speed of
100 Mbps:
atm rate-queue 1 100
The following example configures a rate queue with a tolerance-value of 20, which will apply to SVCs, discovered VCs, and PVCs.
Creates an ATM SVC and specifies the destination NSAP address on a main interface or subinterface.
atm rawq-size
To define the ATM Interface Processor (AIP) raw-queue size
, use the atmrawq-size command in interface configuration mode. To restore the default value, use the no form of this command.
atmrawq-sizenumber
noatmrawq-size
Syntax Description
number
Maximum number of cells in the raw queue simultaneously. Range is from 8 to 256. Default is 32.
Command Default
32 cells
Command Modes
Interface configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command is supported on the Cisco 7200 and 7500 series routers, but not on the Cisco 4500 and Cisco 4700 routers.
The raw queue is used for raw ATM cells, which include Operation, Administration, and Maintenance (OAM) (F4 and F5) and Interim Local Management Interface (ILMI) cells.
Examples
The following example allows a maximum of 48 cells in the raw queue:
atm rawq-size 48
atm rxbuff
To set the maximum number of receive buffers
for simultaneous packet reassembly, use the atmrxbuff command in interface configuration mode. To restore the default value, use the no form of this command.
atmrxbuffnumber
noatmrxbuff
Syntax Description
number
Maximum number of packet reassemblies that the ATM Interface Processor (AIP) can perform simultaneously. Range is from 0 to 512. Default is 256.
Command Default
256 packet reassemblies
Command Modes
Interface configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command is supported on 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.
Examples
The following example allows the AIP to perform a maximum of 300 packet reassemblies simultaneously:
atm rxbuff 300
atm sig-traffic-shaping strict
To specify that a switched virtual circuit (SVC) should be established on an ATM interface only if shaping can be done in accordance with the signaled traffic
parameters, use the atmsig-traffic-shapingstrict command in
inter
face configuration mode. To disable strict traffic shaping, use the no form of this command.
atmsig-traffic-shapingstrict
noatmsig-traffic-shapingstrict
Syntax Description
This command has no arguments or keywords.
Command Default
The default value is lenient (not strict) traffic shaping for SVCs.
Command Modes
Interface configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command is supported on the Cisco 7500 series routers, Cisco 4500 routers, and Cisco 4700 routers. This command is not supported on the ATM port adapter.
If strict traffic shaping is configured on the router ATM interface, then an SVC is established only if traffic shaping can be provided for the transmit cell flow according to the signaled traffic parameters. If such shaping cannot be provided, the SVC is released.
If strict traffic shaping is not configured on the router ATM interface, an attempt is made to establish an SVC with traffic shaping for the transmit cell flow according to the signaled traffic parameters. If such shaping cannot be provided, the SVC is installed with default shaping parameters (it behaves as though a permanent virtual circuit (PVC) were created without specifying traffic parameters).
The signalling SETUP message carries the forward and backward traffic parameters. For connections initiated by the source router, traffic is shaped to the SETUP message forward parameters. For connections initiated by another router or host, traffic is shaped to the backward parameters.
Examples
The following example allows an SVC to be established on an ATM interface using only signaled traffic parameters:
atm sig-traffic-shaping strict
atm smds-address
To assign a unicast E.164
address to the ATM subinterface that supports ATM adaptation layer 3/4 (AAL3/4) and Switched Multimegabit Data Service (SMD
S) encapsulation, use the atmsmds-address command in interface configuration mode.
atmsmds-addressaddress
Syntax Description
address
Unicast E.164 address assigned to the subinterface.
Command Default
No E.164 address is assigned.
Command Modes
Interface configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
This command is supported on Cisco 7500 series routers, Cisco 4500 routers, and Cisco 4700 routers. This command is not supported on the ATM port adapter.
Each AAL3/4 subinterface is allowed only one unicast E.164 address.
Examples
The following example assigns a unicast E.164 address to the ATM subinterface that is being configured:
atm smds-address c141.555.1212
Related Commands
Command
Description
abr
Selects ABR QoS and configures output peak cell rate and output minimum guaranteed cell rate for an ATM PVC or VC class.
atmaalaal3/4
Enables support for AAL3/4 on an ATM interface.
atmmulticast
Assigns an SMDS E.164 multicast address to the ATM subinterface that supports AAL3/4 and SMDS encapsulation.
pvc
Configures the PVC interface.
atm sonet ignore s1
To direct a router to ignore an S1 Synchronous Optical Network (SONET) overhead byte set to 0xF and not switch to internal clocking, use the
atm sonet ignore s1 command in interface configuration mode. To stop ignoring S1 SONET overhead bytes set to 0xF, use the
no form of this command.
atm sonet ignore s1
no atm sonet ignore s1
Syntax Description
This command has no arguments or keywords.
Command Default
This command is disabled. A packet received with an S1 SONET overhead byte set to 0xF causes the router to switch the clock source to internal.
Command Modes
Interface configuration (config-if)
Command History
Release
Modification
15.1(3)S1
This command was introduced.
Usage Guidelines
An S1 SONET overhead byte set to 0xF switches the clock source to internal; however, in the event that a packet is received with an S1 byte value of 0xF, the
atm sonet ignore s1 command ensures that the clock source does not change.
Examples
The following example shows how a router can be configured to ignore an S1 byte set to 0xF:
To enable the reporting of some or all ATM Synchronous Optical Network (SONET) alarms, use the atmsonetreportcommand in interface or subinterface configuration mode. To disable the reporting of some or all ATM SONET alarms, use the no form of this command.
Enables the reporting of B1 threshold crossing alarms (B1-TCA).
b2-tca
Enables the reporting of B2 threshold crossing alarms (B2-TCA).
b3-tca
Enables the reporting of B3 threshold crossing alarms (B3-TCA).
lais
Enables the reporting of line alarm indication signal (LAIS) alarms.
lrdi
Enables the reporting of line remote defect indication (LRDI) alarms.
none [ignore]
Disables the reporting of all ATM SONET alarms. The optional ignore keyword supports only OSM and SPA ATM interfaces, and instructs the ATM interface to ignore any ATM SONET alarms and to remain up and continue operation. This option allows the ATM interface to be used in a “transmit-only” mode, without a receive fiber being connected, so as to support one-way applications, such as video-on-demand.
Note
You must remove all IP (layer 3) configuration (such as the IP address) from the interface before you can use the none [ignore] option. Also, the none [ignore] option cannot be used with any of the other atmsonetreport options.
pais
Enables the reporting of path alarm indication signal (PAIS) alarms.
plop
Enables the reporting of path loss of pointer (PLOP) alarms.
pplm
Enables the reporting of path payload mismatch (PPLM) alarms.
prdi
Enables the reporting of path remote defect indication (PRDI) alarms.
ptim
Enables the reporting of path trace identifier mismatch (PTIM) alarms.
puneq
Enables the reporting of path label equivalent to zero (path unequal, PUNEQ) alarms.
sd-ber
Enables the reporting of signal degrade bit error rate (SD-BER) alarms.
sf-ber
Enables the reporting of signal failure bit error rate (SF-BER) alarms.
slof
Enables the reporting of signal loss of frame (SLOF) alarms.
slos
Enables the reporting of signal loss of signal (SLOS) alarms.
Command Default
PLOP, SLOF, and SLOS alarms are enabled. All other alarms are not enabled.
Command Modes
Interface or subinterface configuration
Command History
Release
Modification
12.1(7)E
This command was introduced.
12.2(14)SX
This command was integrated into Cisco IOS Release 12.2(14)SX to support OSM ATM interfaces.
12.2(18)SXE
This command was integrated into Cisco IOS Release 12.2(18)SXE to support ATM shared port adapters (SPAs) on the Cisco 7600 series routers and Catalyst 6500 series switches. The none [ignore] option was also added to support one-way applications.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
The atmsonetreportcommand enables one or more of the possible SONET alarms that can be generated by the ATM interface. By default, only the PLOP, SLOF, and SLOS alarms are enabled, but you can enable the other alarms or all alarms, as well. You can also disable one or all of the alarms using the no form of the command.
Examples
The following example shows how to enable the alarm for B1 threshold crossings:
Router# configureterminal
Router(config)# interfaceatm3/1/1
Router(config-if)# atmsonetreportb1-tca
Router(config-if)# end
Router#
The following example shows multiple SONET alarms being enabled for an ATM interface:
The following example shows an ATM interface being configured to ignore all ATM SONET alarms, so as to allow transmit-only operation. This example shows the error message that appears if you attempt to give this command when an IP address is configured on the interface. To resolve the problem, you must first remove the IP address and then repeat the command.
Router# configure terminal
Router(config)# interface atm 3/1/1
Router(config-if)# ip address 192.168.100.12 255.255.255.0
Router(config-if)# atm sonet report none ignore
%Configuration is not allowed: IP address is already configured on ATM3/1/1
Router(config-if)# no ip address 192.168.100.12 255.255.255.0
Router(config-if)# atm sonet report none ignore
Router(config-if)#
Note
When an ATM interface is configured to ignore ATM SONET alarms, you cannot then configure any IP (Layer 3) parameters on the interface. If you attempt to do so, the CLI displays the following error message:
%Configuration is not allowed: <interface> is already configured to ignore alarms
Related Commands
Command
Description
setmplsexperimentalimposition
Configures a policy map class with the value of the Multiprotocol Label Switching (MPLS) experimental (EXP) field to be set on all imposed label entries.
setmplsexperimentaltopmost
Configures a policy map class to set the topmost MPLS label on outgoing packets with one or more specified experimental values.
showclass-map
Displays information about the configured traffic classes.
showpolicy-map
Displays information about the configured policy maps and the interfaces on which they are applied.
atm sonet stm-1
To set the mode of operation and thus control type of ATM cell used for cell-rate decoupling on the SONET physical layer interface module (PLIM)
, use the atmsonetstm-1command in interface configuration mode. To restore the default Synchronous Transport Signal level 3, concatenated (STS-3c) operation, use the no form of this command.
atmsonetstm-1
noatmsonetstm-1
Syntax Description
This command has no arguments or keywords.
Command Default
STS-3c is used.
Command Modes
Interface configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
Use STM-1 in applications where the ATM switch requires “idle cells” for rate adaptation. An idle cell contains 31 zeros followed by a one. STM-1 is defined as a Synchronous Digital Hierarchy/Synchronous Transport Signal level 1 (SDH/STM-1) operation (ITU-T specification).
Use the default (STS-3c) in applications where the ATM switch requires “unassigned cells” for rate adaptation. An unassigned cell contains 32 zeros.