-
Command Reference
-
About This Publication
-
A Commands for the ATM Switch
-
ATM Commands for the ATM Switch
-
B Commands for the ATM Switch
-
C Commands for the ATM Switch
-
D Commands for the ATM Switch
-
E Commands for the ATM Switch
-
F Commands for the ATM Switch
-
H Commands for the ATM Switch
-
I Commands for the ATM Switch
-
K Command for the ATM Switch
-
L Commands for the ATM Switch
-
M Commands for the ATM Switch
-
N Commands for the ATM Switch
-
O Command for the ATM Switch
-
P Commands for the ATM Switch
-
Q Command for the ATM Switch
-
R Commands for the ATM Switch
-
S Commands for the ATM Switch
-
Show Commands for the ATM Switch
-
T Commands for the ATM Switch
-
U Commands for the ATM Switch
-
V Commands for the ATM Switch
-
W Commands for the ATM Switch
-
Word List
-
References 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 database
lane fixed-config-atm-address
lane le-arp
lane server-atm-address
lane server-bus
lbo
linecode
load-interval
logging event link-status
loopback (controller)
loopback (interface)
L Commands
Note Commands that are identical to those documented in the Cisco IOS software documentation have been removed from this chapter. Refer to Appendix D, "Removed and Changed Commands," of this command reference for a list of removed commands.
lane auto-config-atm-address
To specify that the configuration server ATM address is computed by the ATM switch 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
Default
No specific ATM address is set.
Command Mode
Usage Guidelines
This command only applies to the 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 fixed-config-atm-address.
Example
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 our automatic method.
Related Commands
lane config-atm-address
lane database
lane fixed-config-atm-address
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
Default
Automatic ATM address assignment
Command Mode
Usage Guidelines
This command only applies to the 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 was 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 end-system identifier (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, 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 Command
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
Default
No LANE clients are enabled on the interface.
Command Mode
Usage Guidelines
This command only applies to the 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.
Example
The following example shows how to enable a Token Ring LANE client on a subinterface.
Related Command
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
Default
Automatic ATM address assignment
Command Mode
Usage Guidelines
This command only applies to the processor interface.
Use of this command on a selected subinterface but with a different ATM address than was 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 end-system identifier (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 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 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; the remaining parts of the ATM address come from automatic assignment.
Related Command
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
Default
No specific ATM address or method is set.
Command Mode
Usage Guidelines
This command only applies to the 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 interfaces 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 (LANE)" chapter in the Wide-Area Networking Configuration Guide.
Related Commands
lane auto-config-atm-address
lane config database
lane database
lane fixed-config-atm-address
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
Syntax Description
Default
No configuration server is defined, and no database name is provided.
Command Mode
Usage Guidelines
This command only applies to the 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 auto-config-atm-address
lane config-atm-address
lane database
lane fixed-config-atm-address
lane database
To create a named configuration database that can be associated with a configuration server, use the lane database global configuration command. To delete the database, use the no form of this command.
- lane database database-name
no lane database database-name
Syntax Description
Default
This command has no default setting.
Command Mode
Usage Guidelines
Using the lane database command puts you in database configuration mode, where you can use the client-atm-address name, default-name, name restricted, name unrestricted, name new-name, name server-atm-address, and mac-address commands to create entries in the specified database. When you are finished creating entries, enter ^Z or exit to return to global configuration mode.
Related Commands
client-atm-address name
default-name
lane config database
name server-atm-address
lane fixed-config-atm-address
To specify that the fixed configuration server ATM address assigned by the ATM Forum is used, use the lane fixed-config-atm-address interface configuration command. To specify that the fixed ATM address is not used, use the no form of this command.
- lane [config] fixed-config-atm-address
no lane [config] fixed-config-atm-address
Syntax Description
Default
No specific ATM address or method is set.
Command Mode
Usage Guidelines
This command only applies to the processor interface.
When the config keyword is not present, this command causes the LANE server and LANE client on the subinterface to use that ATM address, rather than the ATM address provided by the ILMI, to locate the configuration server.
When you use this command with the config keyword, and the LECS is a master, the master monitors on the fixed address. If you enter this command when a server is not a master, the server monitors on this address when it becomes a master. If you do not enter this command, the LECS does not monitor on the fixed address.
Multiple commands that assign ATM addresses to the LECS can be issued on the same interface in order to assign different ATM addresses to the LECS. Commands that assign ATM addresses to the LECS include lane auto-config-atm-address, lane config-atm-address, and lane fixed-config-atm-address. The lane config database command and at least one command that assigns an ATM address to the LECS are required to activate an LECS.
Related Commands
lane auto-config-atm-address
lane config-atm-address
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
|
Segment number of the next-hop route descriptor. The segment number ranges from 1 to 4095. |
|
|
Bridge number of the next-hop route descriptor. The bridge number ranges from 1 to 15. |
Default
No static address bindings are provided.
Command Mode
Usage Guidelines
This command only applies to the 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.
Example
The following example shows how to add a static entry to the LE_ARP table on the processor main ATM interface 0.
Related Command
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 Mode
Usage Guidelines
This command only applies to the 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.
Related Command
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
|
Identifies the type of emulated LAN attached to this subinterface as Ethernet. |
|
|
Identifies the type of emulated LAN attached to this subinterface as Token Ring. |
|
Default
No LAN type and emulated LAN name are provided.
Command Mode
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.
Example
The following example enables a LANE server and broadcast-and unknown server for a Token Ring ELAN.
Related Command
lbo
To set the line build-out to various lengths, use the lbo interface configuration command.
For the channelized DS3 port adapter the syntax is:
- lbo [short | long]
For the channelized E1 port adapter the syntax is:
- lbo [0_110 | 110_220 | 220_330 | 330_440 | 440_550 | 550_660 | gt_600]
Syntax Description
Default
For DS3 interfaces: short
For E1 interfaces: 110_220
Command Mode
Usage Guidelines
The lbo command applies on E1 and DS3 interfaces.
Example
The following example illustrates how to set the line build-out for an E1 port adapter to l10.
linecode
To select the linecode type for the T1 or E1 line, use the linecode controller configuration command.
- linecode {ami | b8zs | hdb3}
Syntax Description
Defaults
b8zs is the default for T1 lines.
hdb3 is the default for E1 lines.
Command Mode
Usage Guidelines
Use this command in configurations where the switch 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.
Example
The following example specifies AMI as the linecode type.
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 seconds
Syntax Description
|
Length of time for which data is used to compute load statistics; a value that is a multiple of 30, and between 30 and 600 (30, 60, 90, 120, and so forth). |
Default
Command Mode
Usage Guidelines
This command only applies to the interfaces on the 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.
Example
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.
Default
Command Mode
Example
The following example shows how to enable logging link status events on serial interface 11/0/0:1.
Related Command
loopback (controller)
To enable controller loopback, use the loopback controller configuration command. To disable loopback, use the no form of this command.
- loopback {diagnostic | line}
no loopback {diagnostic | line}
Syntax Description
|
The transmit frames are looped back to the Frame Relay port adapter. |
|
|
The frames received on the Frame Relay receive connection are looped back on the transmit connection and are passed to the switch. |
Default
Command Mode
Example
The following example configures the E1 interface to line loopback mode.
Related Command
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
Default
Command Mode
Usage Guidelines
The cell and payload loopbacks are only available on DS1/E1 and DS3/E3 interfaces. The diagnostic-path loopback is only available for the OC-12 interface to loop the payload.
To show interfaces currently in loopback operation, use the show interface EXEC command. To isolate problems in the field, use the diagnostic or line options.
Example
The following example shows how to configure diagnostic loopback on the atm 3/1/0 line.
Related Commands
show controllers
show interface