- Cisco IOS Wide-Area Networking Command Reference, Release 12.2
Feedback
Table Of Contents
ima differential-delay-maximum
atm txbuff
To set the maximum number of transmit buffers for simultaneous packet fragmentation, use the atm txbuff interface configuration command. To restore the default value, use the no form of this command.
atm txbuff number
no atm txbuff
Syntax Description
number
Maximum number of packet fragmentations that the ATM Interface Processor (AIP) can perform simultaneously, from 0 to 512.
Defaults
256
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on the 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 configures the AIP to perform up to 300 packet fragmentations simultaneously:
atm txbuff 300atm uni-version
To specify the User-Network Interface (UNI) version (3.0 or 3.1) the router should use when Interim Local Management Interface (ILMI) link autodetermination is unsuccessful or ILMI is disabled, use the atm uni-version interface configuration command. To restore the default value to 3.0, use the no form of this command.
atm uni-version version-number
no atm uni-version version-number
Syntax Description
Defaults
Version 3.0
Command Modes
Interface configuration
Command History
Usage Guidelines
Normally, when the ILMI link autodetermination is enabled on the interface and is successful, the router accepts the UNI version returned by ILMI. If the ILMI link autodetermination is unsuccessful or ILMI is disabled, the UNI version defaults to 3.0. You can override the default UNI version by using this command to enable UNI 3.1 signalling support. The no form of the command sets the UNI version to one returned by ILMI if ILMI is enabled and the link autodetermination process is successful. Otherwise, the UNI version reverts to 3.0.
Examples
The following example specifies UNI version 3.1 signalling port on the ATM interface 2/0:
interface atm 2/0atm uni-version 3.1atm vc-per-vp
To set the maximum number of virtual channel identifier (VCIs) to support per virtual path identifier (VPI), use the atm vc-per-vp interface configuration command. To restore the default value, use the no form of this command.
atm vc-per-vp number
no atm vc-per-vp
Syntax Description
Defaults
1024
Command History
Usage Guidelines
This command controls the memory allocation in the ATM Interface Processor (AIP), ATM port adapter, ATM network module, or network processor module (NPM) to deal with the VCI table.
An invalid VCI causes a warning message to be displayed.
Cisco 2600 and 3600 series with IMA
Note
For Cisco 2600 and 3600 series with IMA, changing the value of the atm vc-per-vp command on one interface affects all of the interfaces on that network module.
Table 3 lists the possible VCI ranges and corresponding VPI ranges for the Cisco 2600 and 3600 series with IMA.
Table 3 VCI and VPI Ranges for Cisco 2600 and 3600 Series with IMA
0-255
0-15, 64-79, 128-143, and 192-207
0-511
0-15, 64-79
0-1023
0-15
Examples
The following example sets the maximum number of VCIs per VPI to 512:
atm vc-per-vp 512Related Commands
atm vp-filter
To set the ATM Interface Processor (AIP) filter register, use the atm vp-filter interface configuration command. To restore the default value, use the no form of this command.
atm vp-filter hexvalue
no atm vp-filter
Syntax Description
Defaults
0x7B
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is supported on Cisco 7500 series routers, but not on Cisco 4500 and Cisco 4700 routers. This command is not supported on ATM port adapters.
This command allows you to specify a virtual path identifier (VPI) or range of VPIs to be used for ATM adaptation layer 3/4 (AAL3/4) processing. All other VPIs map to AAL5 processing. If only AAL5 processing is required, you can either let the virtual path filter default or set it to an arbitrary VPI so that AAL5 processing is performed on all VPIs.
This command configures the hexadecimal value used in the virtual path filter register in the reassembly operation. The virtual path filter comprises 16 bits. The virtual path filter register uses the most significant bits (bits 15 through 8, the left half of the filter) as mask bits, and uses bits 7 through 0 (the right half of the filter) as compare bits.
When a cell is received, the right half of the filter is exclusively NORed with the binary value of the incoming VPI. The result is then ORed with the left half of the filter (the mask). If the result is all 1s, then reassembly is done using the VCI/message identifier (MID) table (AAL3/4 processing). Otherwise, reassembly is done using the VPI-VCI pair table (AAL5 processing).
Examples
In the following example, all incoming cells are reassembled using AAL3/4 processing:
atm vp-filter ff00In the following example, all incoming cells with the virtual path equal to 0 are reassembled using AAL3/4 processing; all other cells are reassembled using AAL5 processing:
atm vp-filter 0In the following example, all incoming cells with the most significant bit of the virtual path set are reassembled using AAL3/4 processing; all other cells are reassembled using AAL5 processing:
atm vp-filter 7f80broadcast
To configure broadcast packet duplication and transmission for an ATM virtual circuit (VC) class, permanent virtual circuit (PVC), switched virtual circuit (SVC), or VC bundle, use the broadcast command in the appropriate command mode. To disable transmission of broadcast packets for your ATM VC class, PVC, SVC, or VC bundle, use the no form of this command. To restore the default behavior according to the description in the following "Usage Guidelines" section, use the default form of this command.
broadcast
no broadcast
default broadcast
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled. For classical IP SVCs, broadcast is enabled.
Command Modes
Interface-ATM-VC configuration (for ATM PVCs and SVCs)
VC-class configuration (for a VC-class)
Bundle configuration (for a VC bundle)
PVC range configuration (for an ATM PVC range)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
Usage Guidelines
If broadcasting and multipoint signalling are enabled on an SVC, a multipoint SVC will be created to handle the SVC.
Note
If the broadcast command is not explicitly configured on an ATM PVC, SVC, or VC bundle, the VC inherits the following default configuration (listed in order of precedence):
•
•
•
Note
To use the broadcast command in bundle configuration mode, enter the bundle command to enact bundle configuration mode for the bundle for which you want to enable broadcast forwarding.
Examples
The following example enables the transmission of broadcast packets on an ATM PVC named router5:
pvc router5 1/32 broadcastThe following example enables the transmission of broadcast packets on an ATM PVC bundle named chicago:
bundle chicago broadcastRelated Commands
cbr
To configure the constant bit rate (CBR) for the ATM circuit emulation service (CES) for an ATM permanent virtual circuit (PVC) on the Cisco MC3810, use the cbr command in the appropriate configuration mode. To restore the default, use the no form of this command.
cbr rate
no cbr rate
Syntax Description
rate
Constant bit bate (also known as the average cell rate) for ATM CES. The valid range for this command is from 56 to 10,000 kbps on the Cisco MC3810.
Defaults
The CBR is not configured.
Command Modes
Interface-ATM-VC configuration (for ATM PVCs and SVCs)
PVC range configuration (for an ATM PVC range)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
12.0
This command was introduced.
12.1(5)T
This command was made available in PVC range and PVC-in-range configuration modes.
Usage Guidelines
This command applies to ATM configuration on the Cisco MC3810.
Examples
The following example configures the constant bit rate on ATM PVC 20 on the Cisco MC3810:
pvc 20cbr 56Related Commands
ces
To configure Circuit Emulation Service (CES) on a router port and enter CES configuration mode, use the ces global configuration command.
ces slot/port
Syntax Description
slot/port
Backplane slot number and port number on the interface. The port value is always 0 as the interface configuration applies to all ports in the slot.
Defaults
No CES interface is configured.
Command Modes
Global configuration
Command History
Usage Guidelines
This command is used on Cisco 2600 series and 3600 series routers that have OC-3/STM-1 ATM CES network modules.
The ces command enters CES configuration mode. Use CES configuration mode to configure CES parameters such as the CES clock.
Examples
The following example configures the CES interface in slot 2:
ces 2/0Related Commands
ces aal1 clock
To configure the ATM adaptation layer 1 (AAL1) timing recovery clock for the constant bit rate (CBR) interface, use the ces aal1 clock interface configuration command. To return the clock to the default, use the no form of this command.
ces aal1 clock {adaptive | srts | synchronous}
no ces aal1 clock
Syntax Description
Defaults
synchronous
Command Modes
Interface configuration
Command History
Usage Guidelines
The clock mode must be synchronous for structured mode. In unstructured mode, use the adaptive keyword when a network-derived clock is not available.
Use the srts keyword when a network-derived clock is available but devices attached to the CES port use a different clock reference. The srts keyword samples the incoming clock, subtracts from the network clock, and sends the remainder in an AAL1 header. The clock is reconstructed during output by adding the residual to the network reference.
Use the synchronous keyword for all other modes.
Examples
The following command sets the AAL1 timing recovery clock to adaptive mode:
interface cbr 4/0ces aal1 clock adaptiveRelated Commands
ces aal1 service
To configure the type of circuit emulation service used on the constant bit rate (CBR) interface, use the ces aal1 service interface configuration command. To return the type of service to unstructured, use the no form of this command.
ces aal1 service {structured | unstructured}
no ces aal1 service
Syntax Description
structured
Sets the type of service to structured (cross-connect).
unstructured
Sets the type of service to unstructured (clear-channel).
Defaults
unstructured
Command Modes
Interface configuration
Command History
Usage Guidelines
The structured keyword means that each time slot is an independent entity grouped into circuits, where each circuit has an independent permanent virtual circuit (PVC).
The unstructured keyword reduces the incoming serial data on the receiving end of the ATM network. The keyword also sets the service to single circuit, single PVC, where all time slots are carried.
Examples
The following example changes the mode for the ces aal1 service command to structured:
interface cbr 4/0ces aal1 service structuredRelated Commands
ces-cdv
To set the cell delay variation, use the ces-cdv interface-ATM-VC configuration command.
ces-cdv time
Syntax Description
Defaults
5000 microseconds
Command Modes
Interface-ATM-VC configuration
Command History
Usage Guidelines
This command is used on Cisco 2600 series and 3600 series routers that have OC-3/STM-1 ATM CES network modules.
Examples
The following example configures the maximum tolerable cell arrival jitter at 7500 microseconds:
interface atm1/0pvc 0 0/41 cesces-cdv 7500Related Commands
ces circuit
To configure the connection attributes for the constant bit rate (CBR) interface, use the ces circuit interface configuration command. To return the connection attributes to the default or to enable the circuit, use the no form of this command.
ces circuit circuit-number [cas] [cdv range] [circuit-name name] [on-hook-detection hex-number] [partial-fill range] [shutdown] [timeslots range]
no ces circuit circuit-number [cas] [cdv range] [circuit-name name] [on-hook-detection hex-number] [partial-fill range] [shutdown] [timeslots range]
Syntax Description
Defaults
No circuit is configured.
Command Modes
Interface configuration
Command History
Usage Guidelines
Channel-associated signalling (CAS) provides information about the time slot (on or off the hook) and is updated once per multiframe.
With both the CAS and on-hook detection features enabled, these features work together to enable an ingress node in an ATM network to monitor on-hook and off-hook conditions for a specified 1 x 64 structured CES circuit. As implied by the notation "1 x 64," the on-hook detection (or bandwidth-release) feature is supported only in a structured CES circuit that involves a single time slot at each end of the connection.
The time slot configured for the structured CES circuit at the ingress node (time slot 2) can be different from the DS0 time slot configured at the egress node (time slot 4). Only one such time slot can be configured at each end of the circuit when the on-hook detection feature is used.
When you invoke the on-hook feature, the ingress ATM-CES port adapter monitors the ABCD bits in the incoming CBR bit stream to detect on-hook and off-hook conditions in the circuit. In an "off-hook" condition, all the bandwidth provisioned for the specified CES circuit is used for transporting ATM AAL1 cells across the network from the ingress node to the egress node.
In an on-hook condition, the network periodically sends dummy ATM cells from the ingress node to the egress node to maintain the connection. However, these dummy cells consume only a fraction of the circuit's reserved bandwidth, leaving the rest of the bandwidth available for use by other network traffic. This bandwidth-release feature enables the network to make more efficient use of its resources.
When the CAS feature is enabled for a CES circuit, the bandwidth of the DS0 channel is limited to 56 kbps for user data, because CAS functions consume 8 kbps of channel bandwidth for transporting the ABCD signalling bits. These signalling bits are passed transparently from the ingress node to the egress node as part of the ATM AAL1 cell stream.
In summary, when the optional CAS and on-hook detection features are enabled, the following conditions apply:
•
•
•
•
Examples
The following example sets the structured service CDV range to 5000 milliseconds and enables the interface:
interface cbr 4/0ces circuit 3 cdv 5000ces circuit 3 no shutdownRelated Commands
ces dsx1 clock source
To configure a transmit clock source for the constant bit rate (CBR) interface, use the ces dsx1 clock source interface configuration command. To return the clock source to the default, use the no form of this command.
ces dsx1 clock source {loop-timed | network-derived}
no ces dsx1 clock source
Syntax Description
loop-timed
Configures the transmit clock to loop (RX-clock to TX-clock).
network-derived
Configures the transmit clock to be derived from the network.
Defaults
network-derived
Command Modes
Interface configuration
Command History
Examples
The following example sets the clock source to loop-timed:
interface cbr 4/0ces dsx1 clock source loop-timedRelated Commands
ces dsx1 framing
To select the frame type for the data line on the constant bit rate (CBR) interface, use the ces dsx1 framing interface configuration command. To return the frame type to the default, use the no form of this command.
T1
ces dsx1 framing {esf | sf}
no ces dsx1 framing
E1
ces dsx1 framing {e1_crc_mfCASlt | e1_crc_mf_lt | e1_lt | e1_mfCAS_lt}
no ces dsx1 framing
Syntax Description
Defaults
esf (for T1)
e1_lt (for E1)
Command Modes
Interface configuration
Command History
Usage Guidelines
Use this command in configurations where the router communicates with the data line. The service provider determines which framing type is required for your circuit.
Examples
The following example sets the data line type to super frame:
interface cbr 4/0ces dsx1 framing sfRelated Commands
ces dsx1 lbo
To configure cable length for the constant bit rate (CBR) interface, use the ces dsx1 lbo interface configuration command. To return the cable length to the default, use the no form of this command.
ces dsx1 lbo length
no ces dsx1 lbo
Syntax Description
length
Sets the cable length. Values (in feet) are 0_110, 110_200, 220_330, 330_440, 440_550, 550_660, 660_above, and square_pulse. Values represent a range in feet.
Defaults
0_110 feet
Command Modes
Interface configuration
Command History
Usage Guidelines
Set the cable length to the desired number of feet on your system.
Examples
The following example sets the cable length to 440 feet:
interface cbr 4/0ces dsx1 lbo 440_550Related Commands
ces dsx1 linecode
To select the line code type for the constant bit rate (CBR) interface, use the ces dsx1 linecode interface configuration command. To return the line code to the default, use the no form of this command.
T1
ces dsx1 linecode {ami | b8zs}
no ces dsx1 linecode
E1
ces dsx1 linecode {ami | hdb3}
no ces dsx1 linecode
Syntax Description
Defaults
b8zs (for T1)
hdb3 (for E1)
Command Modes
Interface configuration
Command History
Usage Guidelines
Use this command in configurations where the switch communicates with the data line. The service provider determines which line code type is required for your circuit.
Examples
The following example specifies B8ZS as the line code type:
interface cbr 4/0ces dsx1 linecode b8zsRelated Commands
ces dsx1 loopback
To enable a loopback for the constant bit rate (CBR) interface, use the ces dsx1 loopback interface configuration command. To disable the loopback, use the no form of this command.
ces dsx1 loopback {line | noloop | payload}
no ces dsx1 loopback {line | noloop | payload}
Syntax Description
Defaults
No loopback
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is useful for testing the circuit emulation port adapter module.
Examples
The following example sets a payload loopback:
interface cbr 4/0ces dsx1 loopback payloadRelated Commands
ces dsx1 signalmode robbedbit
To enable the signal mode as robbed bit on a constant bit rate (CBR) interface, use the ces dsx1 signalmode robbedbit interface configuration command. To return the signal mode to the default, use the no form of this command.
ces dsx1 signalmode robbedbit
no ces dsx1 signalmode robbedbit
Syntax Description
This command has no arguments or keywords.
Defaults
No signal mode is enabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
A T1 frame consists of 24 time slots (DS0) that send at a rate of 64 kbps. T1 defines the ability to send signalling in-band on individual time slots by removing the low bit of each byte for signalling in robbedbit mode. This procedure allows 8 kbps for signalling and leaves 56 kbps for data.
In structured mode, you can send the T1 signalling information across the network. Structured mode means that after you enable robbedbit signalling mode on the port, and enable CAS on individual circuits that need this type of service, you are robbing bits from the DS0. The system then puts the bits in the specified format to be sent across the network and reinserts them at the passive side on the CES-IWF connection.
Examples
The following example enables channel-associated signalling and robbed bit signalling:
interface cbr 4/0ces circuit 1 casces dsx1 signalmode robbedbitRelated Commands
ces partial-fill
To configure the number of user octets per cell for the ATM circuit emulation service (CES), use the ces partial-fill command in interface configuration mode. To delete the CES partial-fill value, use the no form of this command.
ces partial-fill octets
no ces partial-fill octets
Syntax Description
Defaults
47 octets
Command Modes
Interface configuration
Command History
Usage Guidelines
This command applies to ATM configuration on the Cisco MC3810.
Setting the value of the ces partial-fill command to zero disables partial cell fill and causes all cells to be completely filled before they are sent. This command is supported on serial ports 0 and 1 when the encapsulation atm-ces command is enabled.
Examples
The following example sets the CES partial cell fill to 20 octets per cell for serial port 0:
interface serial 0ces partial-fill 20Related Commands
ces pvc
To configure the destination port for the circuit on the constant bit rate (CBR) interface, use the ces pvc interface configuration command. To remove the destination port on the circuit, use the no form of this command.
ces pvc circuit-number interface atm slot/port vpi number vci number
no ces pvc circuit-number interface atm slot/port vpi number vci number
Syntax Description
Defaults
No destination port is configured.
Command Modes
Interface configuration
Command History
Usage Guidelines
Use the interface option to create a hard PVC. Use the dest-atm-addr option to create a soft PVC. Soft PVCs are not supported on Cisco 7200 series routers.
You must configure both sides of the CES circuits because at the source (the active side in CES-IWF), the time slots are not recognized at the destination (the passive side).
Each CES circuit has an ATM address. When configuring the source PVC, you need the destination ATM address.
Examples
The following example shows setting a hard PVC. In this example, the destination of ATM port 0 in slot 1 is assigned to circuit 31 on CBR port 0 in slot 1.
interface cbr 1/0ces pvc 31 interface atm 1/0 vpi 0 vci 512Related Commands
class-int
To assign a virtual circuit (VC) class to an ATM main interface or subinterface, use the class-int command in interface configuration mode. To remove a VC class, use the no form of this command.
class-int vc-class-name
no class-int vc-class-name
Syntax Description
Defaults
No VC class is assigned to an ATM main interface or subinterface.
Command Modes
Interface configuration
Command History
11.3(4)T
This command was introduced, replacing the class command for assigning VC classes to ATM main interfaces or subinterfaces.
Usage Guidelines
Use this command to assign a previously defined set of parameters (defined in a VC class) to an ATM main interface or subinterface. To create a VC class that defines these parameters, use the vc-class atm command. Refer to the section "Configuring VC Classes" in the "Configuring ATM" chapter of the Cisco IOS Wide-Area Networking Configuration Guide for more information.
To use this command for assigning a VC class to an ATM main interface or subinterface, you must first enter the interface atm command to enter interface configuration mode.
When you create a VC class for an ATM main interface or subinterface, you can use the following commands to define your parameters: abr, broadcast, bump, encapsulation, idle-timeout, ilmi manage, inarp, oam-bundle, oam-pvc, oam retry, oam-svc, protocol, ubr, ubr+, and vbr-nrt.
Parameters applied to an individual VC supersede interface- and subinterface-level parameters. Parameters that are configured for a VC through discrete commands entered in interface-ATM-VC configuration mode supersede VC class parameters assigned to an ATM main interface or subinterface by the class-int command.
Examples
In the following example, a class called classA is first created and then applied to an ATM main interface 2/0:
! The following commands create the class classA:vc-class atm classAubr 10000encapsulation aal5mux ip! The following commands apply classA to ATM main interface 2/0:interface atm 2/0class-vc classARelated Commands
class-vc
To assign a virtual circuit (VC) class to an ATM permanent virtual circuit (PVC), switched virtual circuit (SVC), or VC bundle member, use the class-vc command in the appropriate configuration mode. To remove a VC class, use the no form of this command.
class-vc vc-class-name
no class-vc vc-class-name
Syntax Description
Defaults
No VC class is assigned to an ATM PVC, SVC, or VC bundle member.
Command Modes
Interface-ATM-VC configuration (for ATM PVCs and SVCs)
Bundle-vc configuration (for VC bundle members)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
Usage Guidelines
Use this command to assign a previously defined set of parameters (defined in a VC class) to an ATM PVC, SVC, or VC bundle member. To create a VC class that defines these parameters, use the vc-class atm command. Refer to the section "Configuring VC Classes" in the "Configuring ATM" chapter of the Cisco IOS Wide-Area Networking Configuration Guide for more information.
ATM PVCs and SVCs
To use this command for assigning a VC class to an ATM PVC or SVC, you must first enter the interface atm command in global configuration mode and then the pvc or svc command in interface configuration mode.
When you create a VC class for an ATM PVC or SVC, you can use the following commands to define your parameters: abr, broadcast, bump, encapsulation, idle-timeout, ilmi manage, inarp, oam-bundle, oam-pvc, oam retry, oam-svc, protocol, ubr, ubr+, and vbr-nrt.
Parameters that are configured for a PVC or SVC through discrete commands entered in interface-ATM-VC configuration mode supersede VC class parameters assigned to an ATM PVC or SVC by the class-vc command.
ATM VC Bundle Members
To use this command for assigning a VC class to a VC bundle member, you must first enter the pvc-bundle command to enter bundle-vc configuration mode.
When you create a VC class for a VC bundle member, you can use the following commands to define your parameters: bump, precedence, protect, ubr, ubr+, and vbr-nrt. You cannot use the following commands in vc-class configuration mode to configure a VC bundle member: encapsulation, protocol, inarp, and broadcast. These commands are useful only at the bundle level, not the bundle member level.
Parameters applied to an individual VC supersede bundle-level parameters. Parameters that are directly configured for a VC through discrete commands entered in bundle-vc configuration mode supersede VC class parameters assigned to a VC bundle member by the class-vc command.
Examples
The following sections show examples for applying the class-vc command to ATM PVC, SVC, and VC bundle members.
In the following example, a class called classA is first created and then applied to an ATM PVC:
! The following commands create the class classA:vc-class atm classAubr 10000encapsulation aal5mux ip! The following commands apply classA to an ATM PVC:interface atm 2/0pvc router5 1/32class-vc classAIn the following example, a class called classA is first created and then applied to the bundle member called vcmember, a member of bundle1:
! The following commands create the class classA:vc-class atm classAprecedence 6-5no bump trafficprotect groupbump explicitly 7vbr-nrt 20000 10000 32! The following commands create bundle1, add vcmember to bundle1, and then applies classA! to vcmember:bundle bundle1pvc-bundle vcmemberclass-vc classATaking into account hierarchy precedence rules, the VC bundle member vcmember will be characterized by these parameters:
•
•
•
•
Related Commands
clear atm arp
To clear Address Resolution Protocol (ARP) entries for an ATM interface that is configured as an ARP server, use the clear atm arp command in EXEC mode.
clear atm arp atm-interface {ip-address | *}
Syntax Description
atm-interface
ATM interface number (for example, 3/0).
ip-address
Clears the ARP entry for the specified IP address.
*
Clears all ARP entries on the interface.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
Use this command to clear ARP entries for an ATM interface. Use the asterisk (*) to delete all of the ARP entries for the interface, or specify the IP address of a particular entry to be deleted.
If an ARP entry for an existing virtual circuit (VC) is deleted, the ARP server will immediately try to get another entry for that VC.
Examples
The following example shows how to delete the ARP entry for 172.20.173.28:
Router# clear atm arp 3/0 172.20.173.28dxi map
To map a protocol address to a given virtual path identifier (VPI) and virtual channel identifier (VCI), use the dxi map interface configuration command. To remove the mapping for that protocol and protocol address, use the no form of this command.
dxi map protocol protocol-address vpi vci [broadcast]
no dxi map protocol protocol-address
Syntax Description
Defaults
No map definition is established.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is used in configurations where the router is intended to communicate with an ATM network through an ATM data service unit (ADSU). Given the circuit identifier parameters (VPI and VCI) for the ATM permanent virtual circuit (PVC), the router computes and uses the DXI frame address (DFA) that is used for communication between the router and the ADSU.
The dxi map command can be used only on a serial interface or HSSI configured for ATM-DXI encapsulation.
Examples
The following example converts all IP packets intended for the host with IP address 172.21.170.49 into ATM cells identified with a VPI of 2 (binary 0000 0010) and a VCI of 46 (binary 0000 0000 0010 1110) by the ADSU:
interface serial 0dxi map ip 172.21.170.49 2 46 broadcastUsing the mapping defined in Annex A of the ATM DXI Specification, the router uses the VPI and VCI information in this example to compute a DFA of 558 (binary 1000101110). The ADSU will use the DFA of the incoming frame to extract the VPI and VCI information when formulating ATM cells.
Related Commands
Configures multiprotocol or single protocol ATM-DXI encapsulation.
Enables ATM-DXI encapsulation.
dxi pvc
To configure multiprotocol or single protocol ATM-Data Exchange Interface (DXI) encapsulation, use the dxi pvc interface configuration command. To disable multiprotocol ATM-DXI encapsulation, use the no form of this command.
dxi pvc vpi vci [snap | nlpid | mux]
no dxi pvc vpi vci [snap | nlpid | mux]
Syntax Description
Defaults
LLC/SNAP encapsulation
Command Modes
Interface configuration
Command History
Usage Guidelines
This command can be used only on a serial interface or HSSI that is configured with ATM-DXI encapsulation.
Select the nlpid option if you are using the default encapsulation for software releases earlier than Cisco IOS Release 10.3.
Examples
The following example configures ATM-DXI MUX encapsulation on serial interface 1. The PVC identified by a VPI of 10 and a VCI of 10 can carry a single protocol. Then the protocol to be carried on this PVC is defined by the dxi map command.
interface serial 1dxi pvc 10 10 muxdxi map ip 172.21.176.45 10 10 broadcastThe following example configures ATM-DXI NLPID encapsulation on serial interface 1. The PVC identified by a VPI of 11 and a VCI of 12 can carry multiprotocol traffic that is encapsulated with a header described in RFC 1294/1490.
interface serial 1dxi pvc 11 12 nlpidRelated Commands
Maps a protocol address to a given VPI and VCI.
Enables ATM-DXI encapsulation.
Displays the PVC statistics for a serial interface.
encapsulation aal5
To configure the ATM adaptation layer (AAL) and encapsulation type for an ATM permanent virtual circuit (PVC), switched virtual circuit (SVC), virtual circuit (VC) class, or VC bundle, use the encapsulation aal5 command in the appropriate command mode. To remove an encapsulation from a PVC, SVC, VC class, or VC bundle, use the no form of this command.
encapsulation aal5encap [virtual-template number]
no encapsulation aal5encap [virtual-template number]
Note
Syntax Description
Syntax Description
Defaults
The global default encapsulation is snap. See the "Usage Guidelines" section for other default characteristics.
Command Modes
Interface-ATM-VC configuration (for an ATM PVC or SVC)
VC-class configuration (for a VC class)
Bundle configuration (for a VC bundle)
PVC range configuration (for an ATM PVC range)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
Usage Guidelines
A VC bundle can have only one encapsulation configured for it: either snap or mux.
Use one of the mux encapsulation options to dedicate the specified PVC to a single protocol; use the snap encapsulation option to multiplex two or more protocols over the same PVC. Whether you select mux or snap encapsulation might depend on practical considerations, such as the type of network and the pricing offered by the network. If the pricing of the network depends on the number of PVCs set up, snap might be the appropriate choice. If pricing depends on the number of bytes transmitted, mux might be the appropriate choice because it has slightly less overhead.
To use this command to configure a VC bundle, first enter the bundle subinterface configuration command to create a new bundle or modify an existing one and to enter bundle configuration mode.
Note
When configuring Cisco PPP over ATM, specify the ciscoppp encapsulation for the encap argument and specify the virtual template number.
It is possible to implicitly create a virtual template when configuring Cisco PPP over ATM. In other words, if the parameters of the virtual template are not explicitly defined before you configure the ATM PVC, the PPP interface will be brought up using default values from the virtual template identified. However, some parameters (such as an IP address) take effect only if they are specified before the PPP interface comes up. Therefore, we recommend that you explicitly create and configure the virtual template before configuring the ATM PVC to ensure such parameters take effect.
If you specify virtual template parameters after the ATM PVC is configured, you should enter a shutdown command followed by a no shutdown command on the ATM subinterface to restart the interface, causing the newly configured parameters (such as an IP address) to take effect.
If the encapsulation aal5 command is not explicitly configured on an ATM PVC, SVC, or VC bundle, the VC inherits the following default configuration (listed in order of precedence from lowest to highest):
•
•
•
•
When configuring a PVC range or an individual PVC within a PVC range, the following options are available:
•
•
•
Examples
The following example configures an ATM SVC called "chicago" with encapsulation auto. Encapsulation auto enables the SVC to use PPP and either aal5snap or aal5mux encapsulation.
svc chicagoencapsulation aal5autoThe following example configures an ATM PVC with VPI 0 and VCI 33 for a MUX-type encapsulation using IP:
pvc 0/33 encapsulation aal5mux ipThe following example configures a bundle called chicago for aal5snap encapsulation:
bundle chicago encapsulation aal5snapRelated Commands
encapsulation atm-dxi
To enable ATM-Data Exchange Interface (DXI) encapsulation, use the encapsulation atm-dxi interface configuration command. To disable ATM-DXI, use the no form of this command.
encapsulation atm-dxi
no encapsulation atm-dxi
Syntax Description
This command has no arguments or keywords.
Defaults
When ATM-DXI encapsulation is not configured, HDLC is the default encapsulation.
Command Modes
Interface configuration
Command History
Examples
The following example configures ATM-DXI encapsulation on serial interface 1:
interface serial 1encapsulation atm-dxiRelated Commands
idle-timeout
To configure the idle timeout parameter for tearing down an ATM switched virtual circuit (SVC) connection, use the idle-timeout command in the appropriate command mode. To disable the timeout parameter, use the no form of this command.
idle-timeout seconds [minimum-rate]
no idle-timeout seconds [minimum-rate]
Syntax Description
Defaults
The default idle timeout is 300 seconds.
The default minimum-rate is 0 kbps.
Command Modes
Interface-ATM-VC configuration (for ATM permanent virtual circuits [PVCs] or SVCs)
VC-class configuration (for virtual circuit [VC] classes)
Command History
Usage Guidelines
If within the idle timeout period, both the input and output traffic rates are below the minimum-rate, the SVC connection is torn down. The input and output traffic rates are set using the ubr, ubr+, or vbr-nrt command.
If the idle-timeout command is not explicitly configured on an ATM SVC, the SVC inherits the following default configuration (listed in order of next highest precedence):
•
•
•
•
Examples
The following example configures an ATM SVC connection inactive after an idle period of 300 seconds. The SVC connection is also configured so that it is considered inactive if the traffic rate is less than 5 kbps.
idle-timeout 300 5Related Commands
ilmi manage
To enable Integrated Local Management Interface (ILMI) management on an ATM permanent virtual circuit (PVC), use the ilmi manage command in the appropriate command mode. To disable ILMI management, use the no form of this command.
ilmi manage
no ilmi manage
Syntax Description
This command has no arguments or keywords.
Defaults
ILMI management is disabled.
Command Modes
Interface-ATM-VC configuration (for an ATM PVC)
VC-class configuration (for a virtual circuit [VC] class)
PVC range configuration (for an ATM PVC range)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
11.3 T
This command was introduced.
12.1(5)T
This command was made available in PVC range and PVC-in-range configuration modes.
Usage Guidelines
If the ilmi manage command is not explicitly configured on an ATM PVC, the PVC inherits the following default configuration (listed in order of precedence):
•
•
•
•
Examples
The following example enables ILMI management on the ATM PVC with VPI 0 and VCI 60. The ILMI PVC is assigned the name routerA and the VPI and VCI are 0 and 16, respectively.
interface atm 0/0pvc routerA 0/16 ilmiexitinterface atm 0/0.1 multipointpvc 0/60ilmi manageima active-links-minimum
To set the minimum number of links that must be operating in order for an ATM inverse multiplexing over ATM (IMA) group to remain in service, use the ima active-links-minimum interface configuration command. To remove the current configuration and set the value to the default, use the no form of this command.
ima active-links-minimum number
no ima active-links-minimum number
Syntax Description
Defaults
The default is one link.
Command Modes
Interface configuration
Command History
Usage Guidelines
The minimum number of links that should be active for continued group operation depends upon the applications you are using and the speeds they require. ATM frame size and the number of links in a group affect the overhead required by ATM.
Examples
The following example specifies that two links in IMA group 2 must be operational in order for the group to remain in service:
interface atm 0/ima2ima active-links-minimum 2Related Commands
ima clock-mode
To set the transmit clock mode for an ATM inverse multiplexing over ATM (IMA) group, use the ima clock-mode interface configuration command. To remove the current configuration, use the no form of this command.
ima clock-mode {common port | independent}
no ima clock-mode
Syntax Description
Defaults
The default value is common. If no port is specified, the system automatically chooses an active link to provide clocking.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command controls the clock for the IMA group as a whole. If all the links in the group share a clock source, use the common keyword. If all the links use different clock sources, use the independent clock source keyword.
When the common keyword is set, the clock source ATM interface configuration command for the common link determines clocking for all the links in the group.When the independent keyword is set, the clock source ATM interface configuration command is used under each interface to determine clocking individually.
Because the system automatically chooses a replacement for the common link when it fails, any link in an IMA group potentially can provide the recovered transmit clock. For this reason, even when the common keyword is set with a specific link stipulated by the port value, you should use the ATM interface configuration clock source command to make sure that the clock source is configured correctly on each interface in the IMA group.
Examples
The following example specifies that the links in IMA group 2 use a common clock source on link 0:
interface atm0/ima2ima clock-mode common 0Related Commands
clock source
Configures the clock source of a DS1 link.
Configures an ATM IMA group.
Provides information about all configured IMA groups or a specific IMA group.
ima differential-delay-maximum
To specify the maximum differential delay among the active links in an inverse multiplexing over ATM (IMA) group, use the ima differential-delay-maximum interface configuration command. To restore the default setting, use the no form of this command.
ima differential-delay-maximum msec
no ima differential-delay-maximum msec
Syntax Description
Defaults
25 milliseconds
Command Modes
Interface configuration
Command History
Usage Guidelines
This command helps control latency in ATM-layer traffic by setting a limit on how much latency the slowest link in the group is allowed to introduce (a slower link has a longer propagation delay—for example, due to a longer path through the network or less accurate physical layer clocking—than other links). Setting a high value allows a slow link to continue operating as part of the group, although such a setting means there is added delay to links across the group. A low setting may result in less latency for traffic across the group than a high setting, but it can mean that the system takes a slow link out of operation, reducing total bandwidth.
When a link has been removed from service, it is automatically placed back in service when it meets the delay differential standard. If a link delay exceeds the specified maximum, the link is dropped; otherwise, the IMA feature adjusts for differences in delays so that all links in a group are aligned and carry ATM-layer traffic.
Examples
The following example specifies that the links in IMA group 2 have a maximum differential delay of 50 ms:
interface atm0/ima2ima differential-delay-maximum 50Related Commands
ima frame-length
To specify the number of cells in IMA frames, use the ima frame-length interface configuration command. IMA frames are numbered sequentially and each contains an IMA Control Protocol (ICP) cell at a specific position. To remove the current setting and restore the default value, use the no form of this command.
ima frame-length {32 | 64 | 128 | 256}
no ima frame-length {32 | 64 | 128 | 256}
Syntax Description
32
Specifies a value of 32 cells.
64
Specifies a value of 64 cells.
128
Specifies a value of 128 cells.
256
Specifies a value of 256 cells.
Defaults
The default value is 128 cells in a frame.
Command Modes
Interface configuration
Command History
12.0(5)XE
This command was introduced.
12.0(7)XE1
Support for Cisco 7100 series routers added.
12.1(5)T
This command was integrated into Cisco IOS Release 12.1(5)T.
Usage Guidelines
Frame length can affect performance, because the greater the total number of frames required to communicate a given number of cells, the greater the overhead for header and other control cells. In addition, shorter frame lengths might diminish performance when translated ATM-Frame Relay interworking occurs.
Examples
On Cisco 7100 and 7200 series routers, the following example specifies that the links in IMA group 2 have a frame length of 64 cells:
interface atm 1/ima2ima frame-length 64ima-group
To define physical links as inverse multiplexing over ATM (IMA) group members, use the ima-group interface configuration command for each group member. To remove the port from the group, use the no form of this command.
ima-group group-number
no ima-group group-number
Syntax Description
group-number
Specifies an IMA group number from 0 to 3. IMA groups can span multiple ports on a port adapter but cannot span port adapters.
Defaults
Physical links are not included in IMA groups.
Command Modes
Interface configuration
Command History
Usage Guidelines
When the configuration is first performed or when the group number is changed, the interface is automatically disabled, moved to the new group, and then enabled.
Examples
The following example makes interface 1 on the ATM module in slot 0 a member of IMA group 2:
interface atm0/1ima-group 2Related Commands
Configures an ATM interface.
Configures an ATM IMA group.
Provides information about all configured IMA groups or a specific IMA group.
shutdown (interface)
Disables an interface.
ima test
To specify an interface and test pattern for verifying connectivity of all links in an IMA group, use the ima test interface configuration command. To stop the test, use the no form of this command.
ima test [link port] [pattern pattern-id]
no ima test [link port] [pattern pattern-id]
Syntax Description
Defaults
There is no default for the port value. The default value for pattern-id is 106 (0x6A).
Command Modes
Interface configuration
Command History
Usage Guidelines
To verify link and group connectivity, the pattern is sent from the specified link and looped back from the receiving end across all links belonging to the group as defined at the remote end. Verifying link and group connectivity can help troubleshoot physical link connectivity or configuration problems at the remote end. The local end verifies that the pattern is returned on all links belonging to the group at the local end, and testing is continuous. An IMA control protocol (ICP) cell in each frame identifies the pattern.
When a link is not transmitting or receiving a pattern correctly, the command reports the link number where the problem exists.
Examples
The following example configures link 4 to send test pattern 56:
interface atm 0/ima 2ima test link 2 pattern 56Related Commands
inarp
To configure the Inverse Address Resolution Protocol (ARP) time period for an ATM permanent virtual circuit (PVC), virtual circuit (VC) class, or VC bundle, use the inarp command in the appropriate command mode. To restore the default Inverse ARP time period behavior, use the no form of this command.
inarp minutes
no inarp minutes
Syntax Description
Defaults
When Inverse ARP is enabled, minutes = 15 minutes.
Command Modes
Interface-ATM-VC configuration (for an ATM PVC)
VC-class configuration (for a VC class)
Bundle configuration (for a VC bundle)
PVC range configuration (for an ATM PVC range)
PVC-in-range configuration (for an individual PVC within a PVC range)
Command History
Usage Guidelines
This command is supported for aal5snap encapsulation only when Inverse ARP is enabled. Refer to the encapsulation command for configuring aal5snap encapsulation and the protocol command for enabling Inverse ARP.
If the inarp command is not explicitly configured on an ATM PVC, the PVC inherits the following default configuration (listed in order of precedence):
•
•
•
•
Note
For ATM VC bundle management, the Inverse ARP parameter can only be enabled at the bundle level and applied to all VC members of the bundle—that is, it cannot be enabled in bundle-vc configuration mode for individual VC bundle members. To use this command in bundle configuration mode, first enter the bundle command to create the bundle and enter bundle configuration mode.
Examples
The following example sets the Inverse ARP time period to 10 minutes:
inarp 10Related Commands
interface atm
To configure an ATM interface type and enter interface configuration mode, use the interface atm global configuration command.
Cisco 7500 series with AIP; Cisco 7200 series with ATM, ATM-CES, and enhanced ATM port adapters; Cisco 2600 and 3600 series with 1-port ATM-25 network module
interface atm slot/0
Cisco 7500 series with ATM and enhanced ATM port adapter
interface atm slot/port-adapter/0
Cisco 4500 and 4700 series with NPM
interface atm number
Cisco 2600 and 3600 series
interface atm slot/port
To configure an ATM subinterface, use the interface atm global configuration command.
Cisco 7500 series with AIP; Cisco 7200 series with ATM, ATM-CES, and enhanced ATM port adapters; Cisco 2600 and 3600 series with 1-port ATM-25 network module
interface atm slot/0. subinterface-number {multipoint | point-to-point}
Cisco 7500 series with ATM and enhanced ATM port adapter
interface atm slot/port-adapter/0.subinterface-number {multipoint | point-to-point}
Cisco 4500 and 4700 series with NPM
interface atm number.subinterface-number {multipoint | point-to-point}
Cisco 2600 and 3600 series
interface atm slot/port.subinterface-number {multipoint | point-to-point}
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Examples
The following example assigns an IP network address and network mask to the ATM interface in slot 1 on port 0 of a Cisco 7500 series router:
interface atm 1/0ip address 10.1.1.1.255.255.255.0Related Commands
interface atm ima
To configure an inverse multiplexing over ATM (IMA) group, use the interface atm ima global configuration command.
interface atm slot/imagroup-number
Syntax Description
Defaults
By default there are no IMA groups, only individual ATM links.
Command Modes
Global configuration
Command History
Usage Guidelines
If the group does not exist when the command is issued, the command automatically creates the group.
When a port is configured for IMA functionality, it no longer operates as an individual ATM link.
Specifying ATM links as members of a group by using the ima group interface command does not enable the group. You must use the interface atm ima command to create the group.
Examples
The following example configures IMA group 0 on the module in slot 1:
interface atm 1/ima0 ip address 10.18.16.121 255.255.255.192Related Commands
Defines IMA group members.
Configures an ATM interface.
Provides information about all configured IMA groups or a specific IMA group.
shutdown (interface)
Disables an interface.
interface cbr
To specify the T1 or E1 constant bit rate interface on an ATM-CES port adapter, and to enter interface configuration mode, use the interface cbr global configuration command.
interface cbr slot/port
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Usage Guidelines
The ATM-CES port adapter has four T1 (1.544 Mbps) or four E1 (2.048 Mbps) ports (75- or 120-ohm) that can support both structured (N x 64 kbps) and unstructured ATM Forum-compliant circuit emulation services (CES), and one port that supports an OC-3 (155 Mbps) single-mode intermediate reach interface or a T3 (45 Mbps) or E3 (34 Mbps) standards-based ATM interface.
Examples
The following example specifies the first T1 or E1 port on the ATM-CES port adapter in slot 1:
interface cbr 1/0Related Commands
Displays detailed CBR port information.
Displays the information about the CBR interface on the ATM-CES port adapter.
loopback
To loop packets back to the interface for testing, use the loopback interface configuration command with or without an optional keyword. To remove the loopback, use the no form of this command.
Cisco 2600 and 3600 Series
loopback [line | local | payload | remote]
no loopback [line | local | payload | remote]
Cisco 7100, 7200, and 7500 Series
loopback {diagnostic | local {payload | line} | remote {iboc | esf {payload | line}}}
(for T1 lines)loopback {diagnostic | local {payload | line}}
(for E1 lines)no loopback
Syntax Description
Defaults
The line keyword is the default.
Loopback is disabled by default.
Command Modes
Interface configuration
Command History
Usage Guidelines
You can use a loopback test on lines to detect and distinguish equipment malfunctions caused either by line and channel service unit/digital service unit (CSU/DSU) or by the interface. If correct data transmission is not possible when an interface is in loopback mode, the interface is the source of the problem.
The local loopback does not generate any packets automatically. Instead, the ping command is used.
Examples
The following example sets up local loopback diagnostics:
interface atm 1/0 loopback localloopback (ATM)
To configure the ATM interface into loopback mode, use the loopback interface configuration command. To remove the loopback, use the no form of this command.
loopback [cell | line | payload]
no loopback [cell | line | payload]
Syntax Description
Defaults
line
Command Modes
Interface configuration
Command History
11.0
This command was introduced.
11.1
The following keywords were removed:
•
•
Usage Guidelines
This command is useful for testing because it loops all packets from the ATM interface back to the interface as well as directing the packets to the network.
Use the loopback line command to check that the PA-A3 port adapter is working by looping the receive data back to the transmit data.
Examples
The following example loops all packets back to the ATM interface:
interface atm 4/0loopbackRelated Commands
map-class atm
This command is no longer supported.
mid
To set the range of message identifier (MID) values on a permanent virtual circuit (PVC), use the mid interface-ATM-VC configuration command. To remove MID value range settings, use the no form of this command.
mid midlow midhigh
no mid midlow midhigh
Syntax Description
midlow
Starting MID number for this PVC. This can be set between 0 and 1023.
midhigh
Ending MID number for this PVC. This can be set between 0 and 1023.
Defaults
0
Command Modes
Interface-ATM-VC configuration
Command History
Usage Guidelines
This command is only available when SMDS encapsulation is configured on a PVC.
Use this command to assign different ranges of message identifiers to different PVCs.
Examples
In the following example, the atm mid-per-vc command limits the maximum number of message identifiers to 32 for each VC on the ATM interface. Using the mid command, the selected range of numbers that are available for the message identifiers on PVC 1/40 is 0 to 31. For PVC 2/50, the range is 32 to 63.
interface atm 2/0atm mid-per-vc 32pvc 1/40 smdsmid 0 31pvc 2/50 smdsmid 32 63network-clock-select (ATM)
To establish the sources and priorities of the requisite clocking signals for an ATM-CES port adapter, use the network-clock-select global configuration command. To remove the clock source, use the no form of this command.
network-clock-select priority {cbr | atm} slot/port
no network-clock-select priority {cbr | atm} slot/port
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Usage Guidelines
To support synchronous or synchronous residual time stamp (SRTS) clocking modes on the CBR interface, you must specify a primary reference source to synchronize the flow of CBR data from its source to its destination.
You can specify up to four clock priorities. The highest priority active interface in the router supplies primary reference source to all other interfaces that require network clock synchronization services. The fifth priority is the local oscillator on the ATM-CES port adapter.
Use the show network-clocks command to display currently configured clock priorities on the router.
Examples
The following example defines two clock priorities on the router:
network-clock-select 1 cbr 2/0network-clock-select 2 atm 2/0Related Commands
