-
ATM Switch Router Command Reference, 12.0(13)W5(19) through 12.0(22)W5(25)
-
Preface
-
A Commands
-
ATM Commands
-
B Commands
-
C Commands
-
D Commands
-
E Commands
-
F Commands
-
H Commands
-
I Commands
-
K Commands
-
L Commands
-
M Commands
-
N Commands
-
O Commands
-
P Commands
-
R Commands
-
S Commands
-
Show Commands
-
T Commands
-
U Commands
-
V Commands
-
Y Commands
-
Acronyms
-
Reference and Recommended Reading
-
Regular Expressions
-
Removed and Changed Commands
-
Table of Contents
L Commandslane auto-config-atm-address
lane bus-atm-address
lane client
lane client-atm-address
lane config-atm-address
lane config database
lane le-arp
lane server-atm-address
lane server-bus
lbo
linecode
load-interval
logging event link-status
loopback (controller)
loopback (interface)
L Commands
The commands shown in this chapter apply to the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. Where an entire command or certain attributes of a command have values specific to a particular switch or switch router, an exception is indicated by the following callouts:
Refer to Appendix D of this command reference for a detailed list of commands that have been removed, changed or replaced.
lane auto-config-atm-address
To specify that the configuration server ATM address is computed by the ATM switch router automatic method, use the lane auto-config-atm-address interface configuration command.
To remove the previously assigned ATM address, use the no form of this command.
- lane [config] auto-config-atm-address
- no lane [config] auto-config-atm-address
Syntax Description
Defaults
No specific ATM address is set.
Command Modes
Command History
Usage Guidelines
This command only applies to the route processor interface ATM 0.
When the config keyword is not present, this command causes the LANE server and LANE client on the subinterface to use the automatically assigned ATM address for the configuration server.
When the config keyword is present, this command assigns the automatically generated ATM address to the configuration server (LECS) configured on the interface. Multiple commands that assign ATM addresses to the LANE configuration server can be issued on the same interface to assign different ATM addresses to the configuration server. These commands include
lane auto-config-atm-address, lane config-atm-address, and lane le-arp.
Examples
The following example associates the LANE configuration server with the database named network1, and specifies that the configuration server's ATM address is assigned by the automatic method.
Related Commands
|
lane bus-atm-address
To specify an ATM address—and override the automatic ATM address assignment—for the broadcast-and-unknown server on the specified subinterface, use the lane bus-atm-address interface configuration command. To remove the ATM address previously specified for the broadcast-and-unknown server on the specified subinterface and thus revert to the automatic address assignment, use the no form of this command.
- lane bus-atm-address atm-address-template
- no lane bus-atm-address [atm-address-template]
Syntax Description
|
Defaults
Automatic ATM address assignment
Command Modes
Command History
Usage Guidelines
This command only applies to the route processor interface.
This command gives the client the ATM address of the broadcast-and-unknown server. The client will use this address rather than sending LE_ARP requests for the broadcast address.
When applied to a selected interface but with a different ATM address than used previously, this command replaces the broadcast-and-unknown server's ATM address.
ATM Addresses. A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):
- A 13-byte prefix that includes the following fields defined by the ATM Forum: AFI field (1 byte), DCC or ICD field (2 bytes), DFI field (1 byte), Administrative Authority field (3 bytes), Reserved field (2 bytes), Routing Domain field (2 bytes), and the Area field (2 bytes).
- A 6-byte ESI.
- A 1-byte Selector field.
Address Templates. LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character, and an ellipsis (...) to match any number of leading or trailing characters.
The values of the digits that are replaced by wildcards come from the automatic ATM assignment method.
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 the Cisco implementation of LANE, the prefix corresponds to the switch router, the ESI corresponds to the ATM interface, and the Selector field corresponds to the specific subinterface of the interface.
Examples
The following example uses an ESI template to specify the part of the ATM address corresponding to the interface; the remaining values in the ATM address come from automatic assignment.
The following example uses a prefix template to specify the part of the ATM address corresponding to the switch; the remaining values in the ATM address come from automatic assignment.
Related Commands
|
lane client
To activate a LANE client on the specified subinterface, use the lane client interface configuration command. To remove a previously activated LANE client on the subinterface, use the no form of this command.
- lane client {ethernet | tokenring} [elan-name]
- no lane client {ethernet | tokenring} [elan-name]
Syntax Description Description
Defaults
No LANE clients are enabled on the interface.
Command Modes
Command History
Usage Guidelines
This command only applies to the route processor interface.
If a lane client command has already been entered on the subinterface for a different emulated LAN, the client initiates termination procedures for that emulated LAN and joins the new emulated LAN.
If you do not provide an elan-name value, the client contacts the server to find which emulated LAN to join. If you do provide an emulated LAN name, the client consults the configuration server to ensure that no conflicting bindings exist.
Examples
The following example shows how to enable a Token Ring LANE client on a subinterface.
Related Commands
|
lane client-atm-address
To specify an ATM address—and override the automatic ATM address assignment—for the LANE client on the specified subinterface, use the lane client-atm-address interface configuration command. To remove the ATM address previously specified for the LANE client on the specified subinterface and revert to the automatic address assignment, use the no form of this command.
- lane client-atm-address atm-address-template
- no client-atm-address [atm-address-template]
Syntax Description
|
Defaults
Automatic ATM address assignment
Command Modes
Command History
Usage Guidelines
This command only applies to the route processor interface.
Use of this command on a selected subinterface, but with a different ATM address than used previously, replaces the LANE client's ATM address.
ATM Addresses. A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):
- A 13-byte prefix that includes the following fields defined by the ATM Forum: AFI field (1 byte), DCC or ICD field (2 bytes), DFI field (1 byte), Administrative Authority field (3 bytes), Reserved field (2 bytes), Routing Domain field (2 bytes), and the Area field (2 bytes).
- A 6-byte ESI.
- A 1-byte Selector field.
Address Templates. LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character, and an ellipsis (...) to match any number of leading or trailing characters. The wildcard characters come from the automatically assigned ATM address.
In LANE, a prefix template explicitly matches the ATM address 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 the ATM switch router implementation of LANE, the prefix corresponds to the switch router, the ESI corresponds to the ATM interface, and the Selector field corresponds to the specific subinterface of the interface.
For a discussion of the Cisco method for automatically assigning ATM addresses, refer to the "Configuring LAN Emulation" chapter in the Router Products Configuration Guide.
Examples
The following example uses an ESI template to specify the part of the ATM address corresponding to the interface; the remaining parts of the ATM address come from automatic assignment.
The following example uses a prefix template to specify the part of the ATM address corresponding to the switch router; the remaining parts of the ATM address come from automatic assignment.
Related Commands
lane config-atm-address
To specify a configuration server's ATM address explicitly, use the lane config-atm-address interface configuration command. To remove an assigned ATM address, use the no form of this command.
- lane [config] config-atm-address atm-address-template
- no lane [config] config-atm-address atm-address-template
Syntax Description
|
Defaults
No specific ATM address or method is set.
Command Modes
Command History
Usage Guidelines
This command only applies to the route processor interface.
If the config keyword is not present, this command causes the LANE server and LANE client on the subinterface to use the specified ATM address for the configuration server.
When the config keyword is present, this command adds an ATM address to the configuration server configured on the interface. A LANE configuration server can listen on multiple ATM addresses. Multiple commands that assign ATM addresses to the LANE configuration server can be issued on the same interface to assign different ATM addresses to the LANE configuration server.
ATM Addresses. A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address) and 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 ATM address 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 the Cisco implementation of LANE, the prefix corresponds to the switch prefix, the ESI corresponds to a function of ATM interface's MAC address, and the Selector field corresponds to the specific subinterface of the interface.
For a discussion of the Cisco method of automatically assigning ATM addresses, refer to the "Configuring LAN Emulation" chapter in the Cisco IOS Switching Services Configuration Guide.
Related Commands
|
lane config database
To associate a named configuration table (database) with the configuration server on the selected ATM interface, use the lane config database interface configuration command. To remove the association between a named database and the configuration server on the specified interface, use the no form of this command.
- lane config database database-name
- no lane config database
Syntax Description
Defaults
No configuration server is defined, and no database name is provided.
Command Modes
Command History
Usage Guidelines
This command only applies to the route processor interface.
This command is not available on a subinterface, because only one LANE configuration server can exist per interface.
The named database must exist before the lane config database command is entered. Refer to the
lane database command for more information.
Multiple lane config database commands cannot be entered multiple times on the same interface.
You must delete an existing association by using the no form of this command before you create a new association on the specified interface.
To activate a LANE configuration server, you need to use the lane config database command and one of the following commands:
Related Commands
|
lane le-arp
To add a static entry to the LE_ARP table of the LANE client configured on the specified subinterface, use the lane le-arp interface configuration command. To remove a static entry from the LE_ARP table of the LANE client on the specified subinterface, use the no form of this command.
- lane le-arp {mac-address | route-desc segment seg-num bridge bridge-num} atm-address
- no lane le-arp {mac-address | route-desc segment seg-num bridge bridge-num} atm-address
Syntax Description
|
Defaults
No static address bindings are provided.
Command Modes
Command History
Usage Guidelines
This command only applies to the route processor interface.
This command only adds or removes a static entry binding a MAC address or next-hop route descriptor (for Token Ring) to an ATM address. It does not add or remove dynamic entries. Removing the static entry for a specified ATM address from an LE_ARP table does not release the data-direct VCC established to that ATM address. However, clearing a static entry clears any fast-cache entries that were created from the MAC address-to-ATM address binding.
Static LE_ARP entries are not aged and are not removed automatically.
To remove dynamic entries from the LE_ARP table of the LANE client on the specified subinterface, use the clear lane le-arp command.
Examples
The following example shows how to add a static entry to the LE_ARP table on the route processor main ATM interface 0.
Related Commands
|
lane server-atm-address
To specify an ATM address—and override the automatic ATM address assignment—for the LANE server on the specified subinterface, use the lane server-atm-address interface configuration command. To remove the ATM address previously specified for the LANE server on the specified subinterface and revert to the automatic address assignment, use the no form of this command.
- lane server-atm-address atm-address-template
- no server-atm-address [atm-address-template]
Syntax Description
|
Defaults
The LANE client finds the LANE server by consulting the configuration server.
Command Modes
Command History
Usage Guidelines
This command only applies to the route processor interface.
This command also instructs the LANE client configured on this subinterface to reach the LANE server by using the specified ATM address instead of the ATM address provided by the configuration server.
When used on a selected subinterface, but with a different ATM address than was used previously, this command replaces the LANE server's ATM address.
ATM Addresses. A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):
- A 13-byte prefix that includes the following fields defined by the ATM Forum: AFI field (1 byte), DCC or ICD field (2 bytes), DFI field (1 byte), Administrative Authority field (3 bytes), Reserved field (2 bytes), Routing Domain field (2 bytes), and the Area field (2 bytes).
- A 6-byte ESI.
- A 1-byte selector field.
Address Templates. LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character, and an ellipsis (...) to match any number of leading or trailing characters. The values of characters replaced by wildcards come from automatic ATM address assignment.
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 the LightStream 1010 ATM switch 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.
For a discussion of the Cisco method for automatically assigning ATM addresses, refer to the "Configuring LAN Emulation" chapter of the Router Products Configuration Guide.
Examples
The following example uses an ESI template to specify the part of the ATM address corresponding to the interface; the remaining parts of the ATM address come from automatic assignment.
The following example uses a prefix template to specify the part of the ATM address corresponding to the switch; the remaining parts of the ATM address come from automatic assignment.
lane server-bus
To enable a LANE server and a broadcast-and-unknown server on the specified subinterface, use the lane server-bus interface configuration command. To disable a LANE server and broadcast-and-unknown server on the specified subinterface, use the no form of this command.
- lane server-bus {ethernet | tokenring} elan-name
- no lane server-bus [ethernet | tokenring elan-name]
Syntax Description
|
Defaults
No LAN type and emulated LAN name are provided.
Command Modes
Command History
Usage Guidelines
The LANE server and the broadcast-and-unknown server are located on the same switch.
If a lane server-bus command was entered on the subinterface for a different emulated LAN, the server initiates termination procedures with all clients and comes up as the server for the new emulated LAN.
Use of the no form of this command removes a previously configured LANE server and broadcast-and-unknown server on the subinterface.
Examples
The following example enables a LANE server and broadcast-and unknown server for a
Token Ring ELAN.
Related Commands
|
lbo
To set the line build-out to various lengths, use the lbo interface configuration command.
To restore the default in all instances, use the no form of this command.
For the channelized DS3 port adapter the syntax is:
- lbo [short | long]
- no lbo
For the channelized E1 and T1 port adapter the syntax is:
- lbo [0_110 | 110_220 | 220_330 | 330_440 | 440_550 | 550_660 | gt_600]
For the T1 IMA port adapter the syntax is:
- lbo {{long {gain26 | gain36} {-15db | -22.5db | -7.5db | 0db}} | {short {133ft | 266ft | 399ft | 53ft | 655ft}}}
For the E1 IMA port adapter the syntax is:
- lbo {{long gain43 {120db | 75db}} | {short gain12 22db}}
Syntax Description
|
|
Defaults
For T1 and E1 interfaces: 110_220
For T1 IMA interfaces: short 133
For E1 IMA interfaces: short gain 12 22db
Command Modes
Command History
Usage Guidelines
The lbo command applies on T1, E1, T1 IMA, E1 IMA, and DS3 interfaces.
Examples
The following example illustrates how to set the line build-out for an E1 port adapter to l10.
Related Commands
linecode
To select the linecode type for the T1 or E1 line, use the linecode interface configuration command.
To revert to the default, use the no form of this command.
- linecode {ami | b8zs | hdb3}
- no lincode {ami | b8zs | hdb3}
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
Use this command in configurations where the switch router or access server must communicate with T1 fractional data lines.
The T1 service provider determines which linecode type, either ami or b8zs, is required for your
T1 circuit.
The E1 service provider determines which linecode type, either ami or hdb3, is required for your E1 circuit.
Examples
The following example specifies AMI as the linecode type.
Related Commands
load-interval
To change the length of time for which data is used to compute load statistics, use the load-interval interface configuration command. To revert to the default setting, use the no form of this command.
- load-interval seconds
- no load-interval
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
This command only applies to the interfaces on the route processor card: Ethernet 0 or ATM 0. To load computations to be more reactive to short bursts of traffic rather than to those averaged over 5-minute periods, shorten the length of time over which load averages are computed.
If the load interval is set to 30 seconds, new data is used for load calculations over a 30-second period. This data is used to compute load statistics, including input rate in bits and packets per second, output rate in bits and packets per second, load, and reliability.
Load data is gathered every 5 seconds on the switch. This data is used for a weighted average calculation in which more recent load data has more weight in the computation than older load data. If the load interval is set to 30 seconds, the average is computed for the last 30 seconds of load data.
The load-interval command enables you to change the default interval of 5 minutes to a shorter or longer period of time. If you change it to a shorter period of time, the input and output statistics that are displayed when you use the show interfaces command are more current and are based on instantaneous data, rather than reflecting an average load over a longer period of time.
This command is often used for dial backup purposes to increase or decrease the likelihood of a backup interface being implemented, but it can be used on any interface.
Examples
In the following example, the default 5-minute average is set to a 30-second average. A burst in traffic that does not trigger a dial backup for an interface configured with the default 5-minute interval might trigger a dial backup for this interface that is set for a shorter, 30-second interval.
logging event link-status
Configure logging for interface link-status event, use the logging event link-status interface configuration command. To disable logging, use the no form of this command.
- logging event link-status
- no logging event link-status
Syntax Description
This command has no arguments or keywords.
Defaults
Command Modes
Command History
Examples
The following example shows how to enable logging link-status events on serial interface 11/0/0:1.
Related Commands
loopback (controller)
To enable controller loopback for the channelized DS3 (CDS3) and channelized E1 (CE1)
Frame Relay port adapters, use the loopback controller configuration command. To disable loopback, use the no form of this command.
For the CDS3 Frame Relay port adapter, use the following syntax:
- loopback {diagnostic | line | dual | pif}
- no loopback {diagnostic | line | dual | pif}
For the CE1 Frame Relay port adapter, use the following syntax:
- loopback {diagnostic | line}
- no loopback {diagnostic | line}
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines
Use this command for testing, diagnostics, and troubleshooting.
Examples
The following example configures the E1 interface to line loopback mode.
Related Commands
loopback (interface)
To enable a loopback on the physical device associated with a port, use the loopback interface configuration command. To remove the loop, use the no form of this command.
- loopback looptype
- no loopback
Syntax Description
|
Defaults
Command Modes
Command History
Usage Guidelines