Table Of Contents
ima differential-delay-maximum
broadcast
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 "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
Broadcast transmission is not enabled.
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 you use the broadcast command to configure broadcasting for an ATM PVC or SVC, VC-class, or VC bundle, this configuration takes precedence over any previous configuration using the broadcast command.
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 "bundle1":
bundle bundle1 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 or the PA-A3 port adapter for the Cisco 7200 and 7500 series routers, 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
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
Usage Guidelines
This command applies to ATM configuration on the Cisco MC3810 and the PA-A3 port adapter on the Cisco 7200 and 7500 series routers.
Examples
The following example configures the constant bit rate on ATM PVC 20 on the Cisco MC3810:
pvc 20cbr 56Related 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 command in interface configuration mode. 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 command in interface configuration mode. 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 circuit
To configure the connection attributes for the constant bit rate (CBR) interface, use the ces circuit command in interface configuration mode. 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 | no cas] [cdv range] [circuit-name name] [on-hook-detection hex-number] [partial-fill range] [shutdown | no shutdown] [timeslots range]
no ces circuit circuit-number [[no] cas] [cdv range] [circuit-name name] [on-hook-detection hex-number] [partial-fill range] [[no] 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 command in interface configuration mode. 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 command in interface configuration mode. 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 command in interface configuration mode. 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 command in interface configuration mode. 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 command in interface configuration mode. 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 command in interface configuration mode. 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 signaling in-band on individual time slots by removing the low bit of each byte for signaling 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 signaling and robbed-bit signaling:
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
octets
Number of user octets per cell for the CES. Possible values of octet range from 0 to 47. The default is 47.
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 command in interface configuration mode. 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
ces
To configure circuit emulation service (CES) on a router port and enter CES configuration mode, use the ces command in global configuration mode.
ces slot/port
Syntax Description
slot/port
Backplane slot number and port number on the interface. The port value is always 0 because the interface configuration applies to all ports in the slot. The slash (/) is required.
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-cdv
To set the cell delay variation, use the ces-cdv command in interface-ATM-VC configuration mode.
ces-cdv time
Syntax Description
time
Maximum tolerable cell arrival jitter with a range from 1 to 65535 microseconds. Default is 5000.
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
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 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-int 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 use 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 privileged 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
Privileged EXEC
Command History
Usage Guidelines
Use this command to clear ARP entries for an ATM interface. Specify the IP address of a particular entry to be deleted, or use the asterisk (*) to delete all the ARP entries for the interface.
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.28clear atm vc
To release a specified switched virtual circuit (SVC), use the clear atm vc command in privileged EXEC mode.
clear atm vc vcd
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
For multicast or control virtual channel connections (VCCs), this command causes the LAN emulation (LANE) client to exit and rejoin an emulated LAN.
For data VCCs, this command also removes the associated LAN Emulation Address Resolution Protocol (LE ARP) table entries.
Examples
The following example shows how to release SVC 1024:
Router# clear atm vc 1024clear lane le-arp
To clear the dynamic LAN Emulation Address Resolution Protocol (LE ARP) table or a single LE ARP entry of the LANE client configured on the specified subinterface or emulated LAN, use the clear lane le-arp command in user EXEC or privileged EXEC mode.
Cisco 7500 Series
clear lane le-arp [interface slot/port [.subinterface-number] | name elan-name] [mac-address mac-address | route-desc segment segment-number bridge bridge-number]
Cisco 4500 and 4700 Routers
clear lane le-arp [interface number [.subinterface-number] | name elan-name] [mac-address mac-address | route-desc segment segment-number bridge bridge-number]
Syntax Description
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
This command removes dynamic LE ARP table entries only. It does not remove static LE ARP table entries.
If you do not specify an interface or an emulated LAN, this command clears all the LE ARP tables of any LANE client in the router.
If you specify a major interface (not a subinterface), this command clears all the LE ARP tables of every LANE client on all the subinterfaces of that interface.
This command also removes the fast-cache entries built from the LE ARP entries.
Examples
The following example shows how to clear all the LE ARP tables for all clients on the router:
Router# clear lane le-arpThe following example shows how to clear all the LE ARP tables for all LANE clients on all the subinterfaces of interface 1/0:
Router# clear lane le-arp interface 1/0The following example shows how to clear the entry corresponding to MAC address 0800.aa00.0101 from the LE ARP table for the LANE client on the emulated LAN named red:
Router# clear lane le-arp name red 0800.aa00.0101The following example shows how to clear all dynamic entries from the LE ARP table for the LANE client on the emulated LAN named red:
Router# clear lane le-arp name redThe following example shows how to clear the dynamic entry from the LE ARP table for the LANE client on segment number 1, bridge number 1 in the emulated LAN named red:
Router# clear lane le-arp name red route-desc segment 1 bridge 1
Note
clear lane server
To force a LAN emulation (LANE) server to drop a client and allow the LANE configuration server to assign the client to another emulated LAN (ELAN), use the clear lane server command in user EXEC or privileged EXEC mode.
Cisco 7500 Series
clear lane server {interface slot/port [.subinterface-number] | name elan-name} [mac-address mac-address | client-atm-address atm-address | lecid lane-client-id | route-desc segment segment-number bridge bridge-number]
Cisco 4500 and 4700 Routers
clear lane server {interface number [.subinterface-number] | name elan-name} [mac-address mac-address | client-atm-address atm-address | lecid lecid | route-desc segment segment-number bridge bridge-number]
Syntax Description
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
After changing the bindings on the configuration server, use this command on the LANE server to force the client to leave one emulated LAN. The LANE server will drop the Control Direct and Control Distribute virtual channel connections (VCCs) to the LANE client. The client will then ask the LANE configuration server for the location of the LANE server of the emulated LAN it should join.
If no LANE client is specified, all LANE clients attached to the LANE server are dropped.
Examples
The following example shows how to force all the LANE clients on the emulated LAN named red to be dropped. The next time they try to join, they will be forced to join a different emulated LAN.
Router# clear lane server name redRelated Commands
clear mpoa client cache
To clear the ingress and egress cache entries of one or all Multiprotocol over ATM (MPOA) Clients MPCs, use the clear mpoa client cache command in user EXEC or privileged EXEC mode.
clear mpoa client [name mpc-name] cache [ingress | egress] [ip-address ip-address]
Syntax Description
Defaults
The system defaults are:
•
•
•
Command Modes
User EXEC
Privileged EXECCommand History
Examples
The following example shows how to clear the ingress and egress cache entries for the MPC named ip_mpc:
Router# clear mpoa client name ip_mpc cacheRelated Commands
show mpoa client cache
Displays the ingress or egress cache entries matching the IP addresses for the MPCs.
clear mpoa server cache
To clear the ingress and egress cache entries, use the clear mpoa server cache command in user EXEC or privileged EXEC mode.
clear mpoa server [name mps-name] cache [ingress | egress] [ip-address ip-address]
Syntax Description
Command Modes
User EXEC
Privileged EXECCommand History
Examples
The following example shows how to clear all cache entries:
Router# clear mpoa server cacheRelated Commands
show mpoa server cache
Displays ingress and egress cache entries associated with the MPS.
clear pppatm interface atm
To clear PPP ATM sessions on an ATM interface, use the clear pppatm interface atm command in privileged EXEC mode.
clear pppatm interface atm interface-number[.subinterface-number] [vc {[vpi/]vci | virtual-circuit-name}]
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
This command clears the PPP over ATM (PPPoA) sessions in an interface, or in a VC when the VC is specified.
When the clear pppatm interface atm command is used to clear sessions on an interface, PPP keepalives continue to work and can be used to detect a broken link.
Examples
The following example clears a PPP ATM session on ATM interface 1/0.10:
Router# clear pppatm interface atm 1/0.10Related Commands
debug pppatm
Enables reports for PPPoA events, errors, and states either globally or conditionally on an interface or VC.
show pppatm summary
Displays PPPoA session counts.
client-atm-address name
To add a LAN emulation (LANE) client address entry to the configuration server's configuration database, use the client-atm-address name command in database configuration mode. To remove a client address entry from the table, use the no form of this command.
client-atm-address atm-address-template name elan-name
no client-atm-address atm-address-template
Syntax Description
Defaults
No address and no emulated LAN name are provided.
Command Modes
Database configuration
Command History
Usage Guidelines
The effect of this command is to bind any client whose address matches the specified template into the specified emulated LAN. When a client comes up, it consults the LANE configuration server, which responds with the ATM address of the LANE server for the emulated LAN. The client then initiates join procedures with the LANE server.
Before this command is used, the emulated LAN specified by the elan-name argument must have been created in the configuration server's database by use of the name server-atm-address command.
If an existing entry in the configuration server's database binds the LANE client ATM address to a different emulated LAN, the new command is rejected.
This command affects only the bindings in the named configuration server database. It has no effect on the LANE components themselves.
See the lane database command for information about creating the database, and the name server-atm-address command for information about binding the emulated LAN's name to the server's ATM address.
The client-atm-address name command is a subcommand of the global lane database command.
ATM Addresses
A LANE ATM address has the same syntax as a network service access point (NSAP), but it is not a network-level address. It consists of the following:
•
–
•
•
Address Templates
LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character (nibble), and an ellipsis (...) to match any number of leading, middle, or trailing characters. The values of the characters replaced by wildcards come from the automatically assigned ATM address.
In LANE, a prefix template explicitly matches the prefix but uses wildcards for the ESI and selector fields. An ESI template explicitly matches the ESI field but uses wildcards for the prefix and selector.
In our implementation of LANE, the prefix corresponds to the switch, the ESI corresponds to the ATM interface, and the selector field corresponds to the specific subinterface of the interface.
Examples
The following example shows how to use an ESI template to specify the part of the ATM address corresponding to the interface. This example allows any client on any subinterface of the interface that corresponds to the displayed ESI value, no matter to which switch the router is connected, to join the emulated LAN named engineering:
ATM(lane-config-database)# client-atm-address ...0800.200C.1001.** name engineeringThe following example shows how to use a prefix template to specify the part of the ATM address corresponding to the switch. This example allows any client on a subinterface of any interface connected to the switch that corresponds to the displayed prefix to join the emulated LAN named marketing:
ATM(lane-config-database)# client-atm-address 47.000014155551212f.00.00... name marketingRelated Commands
dbs enable
To apply Dynamic Subscriber Bandwidth Selection (DBS) QoS parameters, use the dbs enable command in the appropriate configuration mode. To remove DBS QoS parameters, use the no form of this command.
dbs enable
no dbs enable
Syntax Description
This command has no arguments or keywords.
Defaults
DBS QoS parameters are not applied.
Command Modes
ATM VC class configuration
ATM VC configuration
ATM PVC range configuration
ATM PVC-in-range configurationCommand History
12.2(4)B
This command was introduced.
12.2(13)T
This command was integrated into Cisco IOS Release 12.2(13)T.
Usage Guidelines
The no dbs enable command configured in any configuration mode overrides the dbs enable command configured in any configuration mode. Both the dbs enable and no dbs enable commands are saved in the running configuration and appear, when configured, in the output of the show running-config command. The default dbs enable command does not appear in the output of the show running-config command when configured.
When you enter the dbs enable or no dbs enable command, existing sessions are not disconnected. If you have a session that has been configured for DBS and you configure the no dbs enable command on a VC, additional sessions that are configured will display DBS-configured QoS values until the first new session is up. After the first session is brought up, the VC has default and locally configured values. If you configure the dbs enable command after multiple sessions are already up on the VC, all sessions on that VC have DBS QoS parameters.
RADIUS QoS attributes are applied to PVCs when a new PPP over Ethernet (PPPoE) session has peak cell rate (PCR) and sustainable cell rate (SCR) values that are higher than existing PPPoE sessions. If a new PPPoE session with lower PCR and SCR values is added to a PVC, the RADIUS QoS attributes are not applied to the new session. If the user of the PPPoE session that has the higher PCR and SCR values logs out, the QoS attributes are set to those of the lower bandwidth user.
RADIUS QoS attributes override attributes on a PVC configured in ATM PVC-in-range or ATM PVC range configuration mode. If the RADIUS QoS attributes cannot be applied to a PVC, PPPoE and PPPoA sessions cannot be established.
When DBS is configured, normal ATM precedences apply. PVC configurations take precedence over VC class configurations. Thus, if DBS QoS parameters are applied on a VC class and disabled on one PVC in that VC class, DBS QoS parameters are not applied on the PVC. ATM PVC-in-range configurations take precedence over PVC range configurations.
When you configure DBS on a PVC, existing sessions on that PVC remain connected.
Examples
The following example configures DBS in ATM VC class configuration mode:
vc-class atm pppoedbs enableThe following example configures DBS in ATM VC configuration mode:
interface atm0/0/0.5 point-to-pointip address 10.0.0.0 255.255.255.0pvc 0/100dbs enableprotocol pppoeThe following example configures DBS in ATM PVC range configuration mode:
interface atm0/0/0.1 multipointip address 10.0.0.0 255.255.255.0range pvc 0/50 0/70dbs enableThe following example configures DBS in ATM PVC-in-range configuration mode:
interface atm0/0/0.1 multipointrange pvc 0/50 0/70pvc-in-range 60dbs enableRelated Commands
default-name
To provide an emulated LAN name in the configuration server's database for those client MAC addresses and client ATM addresses that do not have explicit emulated LAN name bindings, use the default-name command in database configuration mode. To remove the default name, use the no form of this command.
default-name elan-name
no default-name
Syntax Description
elan-name
Default emulated LAN name for any LAN emulation (LANE) client MAC address or LANE client ATM address not explicitly bound to any emulated LAN name. Maximum length is 32 characters.
Defaults
No name is provided.
Command Modes
Database configuration
Command History
Usage Guidelines
This command affects only the bindings in the configuration server's database. It has no effect on the LANE components themselves.
The named emulated LAN must already exist in the configuration server's database before this command is used. If the default name-to-emulated LAN name binding already exists, the new binding replaces it.
The default-name command is a subcommand of the global lane database global configuration command.
Examples
The following example shows how to specify the emulated Token Ring LAN named man as the default emulated LAN. Because none of the emulated LANs are restricted, clients are assigned to whichever emulated LAN they request. Clients that do not request a particular emulated LAN will be assigned to the named man emulated LAN.
lane database example2name eng server-atm-address 39.000001415555121101020304.0800.200c.1001.02name eng local-seg-id 1000name man server-atm-address 39.000001415555121101020304.0800.200c.1001.01name man local-seg-id 2000name mkt server-atm-address 39.000001415555121101020304.0800.200c.4001.01name mkt local-seg-id 3000default-name manRelated Commands
dxi map
To map a protocol address to a given virtual path identifier (VPI) and virtual channel identifier (VCI), use the dxi map command in interface configuration mode. 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
dxi pvc
Configures multiprotocol or single-protocol ATM-DXI encapsulation.
encapsulation atm-dxi
Enables ATM-DXI encapsulation.
dxi pvc
To configure multiprotocol or single protocol ATM-Data Exchange Interface (DXI) encapsulation, use the dxi pvc command in interface configuration mode. 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
class-int
Maps a protocol address to a given VPI and VCI.
encapsulation atm-dxi
Enables ATM-DXI encapsulation.
show dxi pvc
Displays the PVC statistics for a serial interface.
encapsulation (ATM)
To configure the ATM adaptation layer (AAL) and encapsulation type for an ATM virtual circuit (VC), VC class, VC, bundle, or permanent virtual circuit (PVC) range, use the encapsulation command in the appropriate mode. To remove an encapsulation type, use the no form of this command.
encapsulation {aal2 | aal5auto | aal5autoppp virtual-template number [group group-name] | aal5ciscoppp virtual-template number | aal5mux protocol | aal5nlpid | aal5snap}
no encapsulation {aal2 | aal5auto | aal5autoppp virtual-template number [group group-name] | aal5ciscoppp virtual-template number | aal5mux protocol | aal5nlpid | aal5snap}
Syntax Description
Defaults
The global default encapsulation option is aal5snap. See the "Usage Guidelines" section for other default characteristics.
Command Modes
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
Note
Use the aal5mux encapsulation option to dedicate the specified PVC to a single protocol; use the aal5snap encapsulation option to multiplex two or more protocols over the same PVC. Whether you select aal5mux or aal5snap 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, aal5snap might be the appropriate choice. If pricing depends on the number of bytes transmitted, aal5mux might be the appropriate choice because it has slightly less overhead.
Encapsulation for PPPoA
When configuring Cisco PPP over ATM, use the aal5ciscoppp keyword 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 that 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.
Configuring PPPoA/PPPoE Autosense
Use the encapsulation aal5autoppp virtual-template template-number command to configure PPPoA/PPPoE autosense. PPPoA/PPPoE autosense enables a router to distinguish between incoming PPPoA and PPPoE sessions and create virtual access for both PPP types based on demand.
If a PPPoE profile is not specified by using the group group-name option, PPPoE sessions will be established using parameters from the global PPPoE profile. PPPoE profiles must be configured using the bba-group pppoe command.
Note
Entering the no encapsulation aal5autoppp virtual-template command will terminate the PPPoA or PPPoE session and detach the virtual-access interface from the PVC.
Configuring Encapsulation for VC Bundles
Before using this command to configure a VC bundle, enter the bundle subinterface configuration command to create a new bundle or modify an existing one and to enter bundle configuration mode.
A VC bundle can have only one encapsulation configured for it: either aal5snap or aal5mux.
Encapsulation Rules of Precedence
If the encapsulation 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):
•
•
•
•
Note
Configuring Encapsulation for a PVC Range
When a PVC range or an individual PVC within a PVC range is being configured, the following options are available:
•
•
•
Examples
MUX-Type Encapsulation on a VC Example
The following example configures an ATM PVC with VPI 0 and VCI 33 for a MUX-type encapsulation using IP:
interface atm 1/0pvc 0/33encapsulation aal5mux ipSNAP Encapsulation Example
The following example configures a bundle called "chicago" for aal5snap encapsulation:
bundle chicagoencapsulation aal5snapPPP over ATM SVCs Example
The following example configures an ATM SVC called "chicago" with the encapsulation type aal5auto. Encapsulation type aal5auto enables the SVC to use PPP and either aal5snap or aal5mux encapsulation.
interface ATM 2/0/0svc chicagoencapsulation aal5autoPPPoA/PPPoE Autosense Example
The following example enables PPPoA/PPPoE autosense on PVC 30/33. PPPoA sessions will use virtual template 1, and PPPoE sessions will use the global PPPoE profile.
interface ATM 0/0/0.33 multipointpvc 30/33encapsulation aal5autoppp virtual-template 1!bba-group pppoe globalvirtual-template 1sessions max limit 8000sessions per-vc limit 8sessions per-mac limit 2AAL2 Voice over ATM Example
The following example configures a PVC to support AAL2 encapsulation for Voice over ATM:
interface ATM0.2 point-to-pointpvc 2/200vbr-rt 760 760 100encapsulation aal2Related Commands
encapsulation atm-dxi
To enable ATM-Data Exchange Interface (DXI) encapsulation, use the encapsulation atm-dxi command in interface configuration mode. 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
framer-type
To set the framer type of supported circuit emulation service (CES) multiservice interchange (MIX) connections to T1 or E1, use the framer-type command in CES configuration mode.
framer-type {t1 | e1}
Syntax Description
t1
Sets the framer type of supported CES connections to T1.
e1
Sets the framer type of supported CES connections to E1.
Defaults
T1
Command Modes
CES configuration
Command History
12.1(5)XM
This command was introduced for the Cisco 3660.
12.2(4)T
This command was integrated into Cisco IOS Release 12.2(4)T.
Usage Guidelines
This command is needed only with CES-enabled network modules (ATM OC-3 CES network modules) that do not contain Cisco T1/E1 multiflex voice/WAN interface cards (VWICs) on the Cisco 3660. Other network modules set their framer type automatically and therefore do not require use of this command. It is also not necessary to use this command for T1 connections, because t1 is the default argument.
To reach CES configuration mode for a particular slot, enter ces and the slot number and port number while in global configuration mode. Note that the port value is always 0, as the interface configuration applies to all ports in the slot.
Examples
The following example sets the framer type of the CES card in slot 1 to E1:
Router(config)# ces 1/0
Router(config-ces)# framer-type e1
Related Commands
holding-time
To specify the holding time value for the MPS-p7 variable of a Multiprotocol over ATM server (MPS), use the holding-time command in MPS configuration mode. To revert to the default value, use the no form of this command.
holding-time seconds
no holding-time seconds
Syntax Description
Defaults
The default holding time is 1200 seconds (20 minutes).
Command Modes
MPS configuration
Command History
Examples
The following example shows how to set the holding time to 600 seconds (10 minutes):
holding-time 600idle-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
Links: 1
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 command in interface configuration mode. 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
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 command in interface configuration mode. To restore the default setting, use the no form of this command.
ima differential-delay-maximum milliseconds
no ima differential-delay-maximum milliseconds
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
show ima interface atm
Provides information about all configured IMA groups or a specific IMA group.
ima frame-length
To specify the number of cells in inverse multiplexing over ATM (IMA) frames, use the ima frame-length interface configuration command. 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
IMA frames are numbered sequentially, and each contains an IMA Control Protocol (ICP) cell at a specific position.
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 test
To specify an interface and test pattern for verifying connectivity of all links in an inverse multiplexing over ATM (IMA) group, use the ima test command in interface configuration mode. To stop the test, use the no form of this .
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
show ima interface atm
Provides information about all configured IMA groups or a specific IMA group.
ima-group
To define physical links as inverse multiplexing over ATM (IMA) group members, use the ima-group command in interface configuration mode 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
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
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 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
interface atm
To configure an ATM interface and enter interface configuration mode, use the interface atm command in global configuration mode.
interface atm interface-number[.subinterface-number {mpls | multipoint | point-to-point}]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
10.0
This command was introduced.
12.1(3)T
New optional subinterface types were introduced.
Usage Guidelines
The interface atm command enables you to define a subinterface for a specified type of ATM interface. The subinterface for the ATM interface is created the first time this command is issued with a specified subinterface number.
Examples
For physical ATM interface 3/0, the following command creates an ATM MPLS subinterface having subinterface number 1:
Router# interface atm 3/0.1 mplsRelated Commands
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 command in global configuration mode.
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
show ces interface cbr
Displays detailed CBR port information.
show interface cbr
Displays the information about the CBR interface on the ATM-CES port adapter.
keepalive-lifetime
To specify the duration that a keepalive message from a Multiprotocol over ATM server (MPS) is considered valid by the Multiprotocol over ATM client (MPC), use the keepalive-lifetime command in global configuration mode.
keepalive-lifetime seconds
Syntax Description
Defaults
The default is 35 seconds.
Command Modes
Global configuration
Command History
Usage Guidelines
The keepalive lifetime (MPS-p2) must be greater than or equal to three times the value of the keepalive time (MPS-p1). MPS-p1 specifies the frequency with which a keepalive message is sent from the MPS to the MPC.
Examples
The following example shows how to specify a keepalive lifetime of 60 seconds:
Router(config)# keepalive-lifetime 60Related Commands
keepalive-time
Specifies the keepalive time value for the MPS-p1 variable of an MPS.
keepalive-time
To specify the keepalive time value for the Multiprotocol over ATM (MPOA) server (MPS)-p1variable of an MPS, use the keepalive-time command in MPS configuration mode. To revert to the default value, use the no form of this command.
keepalive-time seconds
no keepalive-time seconds
Syntax Description
Defaults
The default keepalive time is 10 seconds.
Command Modes
MPS configuration
Command History
Examples
The following example shows how to set the keepalive time to 25 seconds:
Router(mpoa-server-config)# keepalive-time 25
