![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
This chapter contains an alphabetical reference for all ATM commands available on the Catalyst 5000 and 6000 family switches.
Use the atm-address command to override the control ATM address. To revert to the default value, use the no form of this command.
Syntax Description
Defaults
The default is an autogenerated ATM address.
Command Types
Command Modes
Usage Guidelines
This command specifies the control ATM address used when it is associated with a hardware interface. The ubr+ pcr value mcr value optional command arguments are used to set a CoS to QoS mapping on a specific interface.
Examples
The following example specifies the ATM address:
The following example shows how to enter CoS to QoS mappings using PCR and MCR values on a specific ATM address. This command is entered from the lane qos database configuration mode.
Related Commands
show atm interface atm0
lane client qos
lane qos database
Use the atm bind pvc vlan command to bind a PVC to a specified VLAN.
Syntax Description
Virtual circuit descriptor; a unique number for each switch that identifies which VPI/VCI to use for a particular packet. |
|
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
You can bind any number of PVCs to the same VLAN. To prevent loops, each PVC must uniquely connect a VLAN group between two Catalyst 5000 family and 2926G series switches.
Examples
This example shows how to bind PVC 10 to VLAN 5 and PVC 11 to VLAN 5:
Related Commands
Use the atm clock internal command to cause the ATM module on the Catalyst 5000 family and 2926G series switches to generate the transmit clock from its internal source. Enter the no form of this command to set the clock generation mode to receive timing from an external source.
Syntax Description
This command has no arguments or keywords.
Defaults
The ATM module generates the transmit clock signal from its internal source. The default is loop-timed clock mode for the ATM dual PHY OC-3 modules (WS-X5167 and WS-X5168).
Command Types
Command Modes
Usage Guidelines
The atm clock internal and the no atm clock internal commands are not supported by the ATM dual PHY OC-12 module.
Examples
This example shows how to set the ATM module to generate the transmit clock from its internal source:
This example shows how to set the ATM module to generate the transmit clock from an external source:
Use the atm ds3-scramble command to enable scrambling on the current port. Enter the no form of this command to disable scrambling.
![]() |
Note All devices speaking to each other must have the same scramble setting (on or off) to be able to communicate. |
Syntax Description
This command has no arguments or keywords.
Defaults
The default is scrambling not enabled.
Command Types
Command Modes
Usage Guidelines
Because ATM network equipment can exhibit sensitivity to certain bit patterns, scrambling is used to randomize such patterns to guarantee cell synchronization. This command applies to DS3 interfaces only.
Examples
This example shows how to enable scrambling:
Use the atm framing command to change the default DS3 line framing from C-bit with ATM direct mapping (ADM) to one of the following:
Enter the no form of this command to use the default value.
Syntax Description
Defaults
The default value is C-bit with ADM.
Command Types
Command Modes
Usage Guidelines
This command is not available to the OC-3 ATM module.
The atm framing command applies to DS3 interfaces only.
This command allows you to set the DS3 framing mode to either M23 ADM, M23 PLCP, C-bit PLCP, or C-bit ADM (default value).
Examples
This example shows how to select m23adm frame as the frame type:
Use the atm ilmi-enable command to enable the ILMI on a port. To disable the ILMI, use the no form of this command.
Syntax Description
This command has no arguments or keywords.
Defaults
The default is ILMI is enabled.
Command Types
Command Modes
Usage Guidelines
The ILMI is enabled by default; however, if the peer does not support ILMI, you should turn off the ILMI using this command. When you use the no form of this command, the switch is disabled only after restart.
Examples
This example shows how to enable the ILMI:
This example shows how to disable the ILMI:
Related Commands
Use the atm ilmi-keepalive command to enable ILMI keepalives. To disable ILMI keepalives, use the no form of this command.
Syntax Description
Defaults
The default is 3 seconds. Values less than 3 seconds are rounded to 3 seconds. There is no upper boundary to the range of values.
Command Types
Command Modes
Examples
This example shows how to set the number of seconds between ILMI keepalives:
Related Commands
Use the atm lbo command to set the line buildout corresponding to the cable length. This command is specific to DS3 and is not available in the OC-3 ATM module.
Syntax Description
Keyword to set the line buildout (cable length) up to 255 feet (77.4 meters). |
|
Keyword to set the line buildout (cable length) over 255 feet (77.4 meters). |
Defaults
Command Types
Command Modes
Usage Guidelines
The atm lbo command applies to DS3 interfaces only.
Examples
This example sets the line buildout (cable length) to over 255 feet (77.4 meters):
Related Commands
Use the atm preferred phy command to change the preferred PHY to the one not currently in use.
Syntax Description
Defaults
Command Types
Command Modes
Usage Guidelines
Use this command only with the OC-12 dual PHY ATM module connected to the same or different switches.
Examples
This example shows how to specify PHY A as the preferred PHY:
Related Commands
show lane default-atm-addresses
Use the atm pvc command to create a PVC on the Catalyst 5000 family and 2926G series switch interface. The no form of this command deletes the specified PVC.
![]() |
Note The following version of the atm pvc command is available only in ATM software release 50.1(1) and later and 51.1(1) and later. |
![]() |
Note The following version of the atm pvc command is available only in ATM software release 11.3(6)WA4(9b) and later. |
Syntax Description
1The minimum pcr rate is 64 kbps. If you specify a pcr greater than 0 and less than 64 kbps, the rate specified to the SAR is 64 kbps.
2The minimum scr rate is 64 kbps. If you specify an scr greater than 0 and less than 64 kbps, the rate specified to the SAR is 64 kbps. |
Defaults
If you omit the pcr argument, the PVC defaults to the highest bandwidth rate queue available
(622,000 kbps). By default, the VC is configured to run as fast as possible. If you omit the oam keyword, OAM cells are not generated. If you use the oam keyword without specifying seconds, the default value of 10 seconds is used.
Command Types
Command Modes
Usage Guidelines
The atm pvc command creates a PVC and attaches it to the VPI and VCI specified. You cannot specify both vpi and vci as 0.
The VPI is an 8-bit field in the header of the ATM cell. The VPI value is unique only on a single interface, not throughout the ATM network.
The VCI is a 16-bit field in the header of the ATM cell. The VCI value is unique only on a single interface, not throughout the ATM network.
The allowed VPI and VCI ranges vary depending on the value specified by the atm vc-per-vp command. The atm vc-per-vp command sets the VCI bits, and the number of VCI bits set determines the allowable VPI range.
If you are configuring an SVC, you must use this command to configure the PVC that handles the SVC call setup and termination. In this case, specify the qsaal keyword.
The peak_rate argument determines the size of the rate queue used. ATM PVC traffic-shaping software release 50.1(1) and later and 51.1(1) and later create rate queues dynamically to satisfy the specifications of atm pvc commands. When an atm pvc command specifies a peak rate that does not match any use-configured rate queue, a rate queue is created dynamically.
The oam keyword causes the Catalyst 5000 family and 2926G series switch to generate and echo OAM F5 loopback cells to verify connectivity. After OAM cell generation is enabled, OAM cells are transmitted periodically. The remote end must respond by echoing back the cells.
The atm pvc command on the ATM dual PHY OC-12 modules (WS-X5161 and WS-X5162), the ATM dual PHY OC-3 modules (WS-X5167 and WS-X5168), and the ATM fabric integration module (WS-X5165) supports RFC 1483 Ethernet-bridged AAL5/SNAP encapsulation only.
For the ATM dual PHY OC-12 modules (WS-X5161 and WS-X5162) and the ATM dual PHY OC-3 modules (WS-X5167 and WS-X5168), and the ATM fabric integration module (WS-X5165) with ATM module Release 11.3(6)WA4(9b) and later, traffic shaping supports multiple traffic classes:
When configuring a PVC, if you enter a zero value for PCR and SCR (or do not specify any value), the channel is opened with a service type of UBR (with a maximum line rate).
While configuring a PVC, if you enter a zero value for SCR and non-zero PCR, the channel is opened with a service type of CBR at 1/PCR.
While configuring a PVC, if you enter non-zero values for PCR and SCR, the channel is opened with a service type of VBR.
![]() |
Note The MBS should be a value between 2 and 255. If you specify an MBS of 1, the channel is opened as 1/PCR rate-shaped. |
The atm pvc command creates a PVC and attaches it to the specified VPI and VCI. The vpi and vci values cannot both be specified as 0. For example, if vpi is 0, then vci cannot be 0, and conversely, if vci is 0, then vpi cannot be 0.
The pcr, scr, and mbs arguments are only supported on the ATM dual PHY OC-12 modules (WS-X5161 and WS-X5162), the ATM dual PHY OC-3 modules (WS-X5167 and WS-X5168), and the ATM fabric integration module (WS-X5165).
Maximum pcr values are 0 to 622,000 for the ATM dual PHY OC-12 modules (WS-X5161 and WS-X5162) and the ATM fabric integration module (WS-X5165); 0 to 155,000 for the ATM dual PHY OC-3 modules (WS-X5167 and WS-X5168).
The minimum pcr or scr is 64 kbps. If you specify a pcr or scr greater than 0 and less than 64 kbps, the rate specified to the SAR is 64 kbps.
Examples
This example shows how to create a PVC to be used for ATM signaling for an SVC, using VPI 0
and VCI 5:
This example shows how to create a PVC in ATM PVC traffic-shaping software release 50.1, specifying the peak and average rates and OAM cell generation:
This example shows how to create a PVC in ATM PVC traffic-shaping Release 11.3(6)WA4(9b), specifying the PCR, SCR, and MBS:
Related Commands
Use the atmsig close command to disconnect a particular SVC.
Syntax Description
Keyword to specify the atm0 interface number to close the SVC, because VCs are numbered per interface. |
|
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows how to close SVC 2 on the ATM module:
Use the atm sonet command to set the mode of operation and control type for cell-rate decoupling on the SONET PLIM. To revert to the default value, use the no form of this command.
[no] atm sonet {stm-1 | sts-3c} {stm-4 | sts-12c}
Syntax Description
Defaults
The default is STS-3c operation for the ATM dual PHY OC-3 modules and STS-12c operation for the ATM dual PHY OC-12 modules.
Command Types
Command Modes
Usage Guidelines
This command applies only to the ATM dual PHY OC-3 and OC-12 modules.
The no atm sonet command is the same as the atm sonet sts-3c command for the ATM dual PHY OC-3 modules and the atm sonet sts-12c command for the ATM dual PHY OC-12 modules.
Examples
This example shows how to set the mode for cell-rate decoupling on the SONET PLIM to stm-1:
Use the atm traffic-shape rate command to configure output throttling on your Catalyst 5000 family and 2926G series switch ATM module. The no form of this command returns the output rate to the default.
Syntax Description
Defaults
Command Types
Command Modes
Usage Guidelines
This command is not supported by the ATM dual PHY OC-12 module.
Examples
This example shows how to set the output throttle to 50:
Use the atm uni-version command to specify the UNI version (3.0 or 3.1) the switch should use when ILMI link autodetermination is unsuccessful or ILMI is disabled. The no form of this command restores the version to the default.
Syntax Description
Defaults
The default UNI version is 3.0.
Command Types
Command Modes
Examples
This example shows how to set the UNI version to 3.1:
Use the atm vc-per-vp command to set the maximum number of VCIs to support per VPI. The no form of this command restores the default value.
Syntax Description
Defaults
The default is that the maximum number of VCIs to support per VPI is 1024.
Command Types
Command Modes
Usage Guidelines
This command controls the memory allocation in the Catalyst 5000 family and 2926G series switches for the VCI table. It defines the maximum number of VCIs to support per VPI; it does not designate the VCI numbers. Use the atm pvc command to designate the VCI number.
An invalid VCI causes a warning message to display.
Examples
This example shows how to set the maximum number of VCIs to support per VPI to 512:
Use the clear mpoa client cache command to clear the ingress and egress cache entries of one or all MPCs.
Syntax Description
Defaults
Command Types
Command Modes
Examples
This example shows how to clear the ingress and egress cache entries for the MPC named ip_mpc:
Related Commands
Use the client-atm-address name command to add a LANE address entry to the configuration server's database. The no form of this command removes a client address entry from the table.
Syntax Description
Defaults
The default is that no address and no ELAN name are configured.
Command Types
Command Modes
Usage Guidelines
This command binds to the specified ELAN any client whose address matches the specified template. When a client comes up, it consults the LANE configuration server, which responds with the ATM address of the LANE server for the ELAN. The client then initiates join procedures with the LANE server.
You must create the ELAN specified by the elan-name argument using the name server-atm-address command before you use the client-atm-address command.
If an existing entry in the configuration server's database binds the LANE client ATM address to a different ELAN, 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.
A LANE ATM address has the same syntax as an NSAP but is not a network-level address:
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.
In LANE, a prefix template matches the prefix explicitly but uses wildcards for the ESI and selector fields. An ESI template matches the ESI field explicitly but uses wildcards for the prefix and selector.
In our implementation of LANE, the prefix corresponds to the specific subinterface of the interface.
Examples
This example uses an ESI template to specify the part of the ATM address corresponding to an interface. This template allows any client on any subinterface of the interface that corresponds to the displayed ESI value, no matter which switch the router is connected to, to join the engineering ELAN:
This example uses a prefix template to specify the part of the ATM address corresponding to the switch. This template allows any client on the subinterface of any interface connected to the switch that corresponds to the displayed prefix to join the marketing ELAN:
Related Commands
Use the debug mpoa client command to display MPC debug information.
Syntax Description
Defaults
The default is debugging is turned on for all MPCs.
Command Types
Command Modes
Examples
This example shows how to turn on debugging for the MPC ip_mpc:
Related Commands
Use the default-name command to provide an ELAN name in the configuration server's database for those client MAC addresses and client ATM addresses that do not have explicit ELAN name bindings. Use the no form of this command to remove the default name.
Syntax Description
ELAN name for any LANE client MAC address or LANE client ATM address not explicitly bound to any ELAN name. The maximum length of elan-name is 32 characters. |
Defaults
The default is that no name is configured.
Command Types
Command Modes
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 ELAN must already exist in the configuration server's database before this command is used. If the default name-to-ELAN name binding already exists, the new binding replaces it.
Related Commands
client-atm-address name
lane database
name
Use the disable command to exit privileged EXEC mode and return to user EXEC mode. After executing this command, the angle-bracket (>) prompt appears.
Syntax Description
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
Use this command with the level option to reduce the privilege level. If you do not specify a level, it defaults to the user EXEC mode, which is level 1.
Examples
This example shows how to cause the system to exit privileged EXEC mode and return to user EXEC mode, as indicated by the angle bracket (>) prompt:
Related Commands
Use the display-databases command to display all the LECS database tables.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows how to display all the LECS database tables:
Use the editing command to enable enhanced editing mode. Use the no form of this command to disable enhanced editing mode.
Syntax Description
This command has no arguments or keywords.
Command Types
Defaults
Command Modes
Usage Guidelines
Table 7-1 describes the keys used to enter and edit commands. Ctrl indicates the Control key. You must press Ctrl simultaneously with the associated letter key. Esc indicates the Escape key. You must press Esc first, followed by the associated letter key. Keys are not case sensitive.
1The arrow keys function only with ANSI-compatible terminals such as VT100. |
Examples
This example shows how to disable enhanced editing mode on virtual terminal line 3:
Related Commands
Use the enable command to enter privileged EXEC mode.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
If the system administrator has set a password with the enable password command, you are prompted to enter the password before gaining access to privileged EXEC mode. The password is case sensitive. The default password on the ATM module is atm.
Examples
This example shows how to cause the system to enter privileged command mode, as indicated by the pound sign (#):
Related Commands
Use the end command to exit configuration mode.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
You can also press Ctrl-Z to exit configuration mode.
Examples
This example shows how to exit configuration mode and return to EXEC mode:
Related Commands
Use the exit command at the system prompt to exit any command mode or close an active terminal session and terminate the EXEC.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Available in all command modes.
Usage Guidelines
When you enter the exit command at the EXEC level, the EXEC session is ended. Use the exit command at the configuration level to return to privileged EXEC mode. Use the exit command in interface and line command modes to return to global configuration mode. Use the exit command in subinterface configuration mode to return to interface configuration mode. You can also press Ctrl-Z in any configuration mode to return to privileged EXEC mode.
Examples
This example shows how to exit an active session:
Related Commands
Use the help command to display a brief description of the help system.
Syntax Description
This command has no arguments or keywords.
Command Types
Command Modes
Available in all ATM command modes.
Usage Guidelines
To list all commands available for a particular command mode, enter a question mark (?) at the
system prompt.
To obtain commands that begin with a particular character string, enter the abbreviated command entry and then a question mark (?). This form of help is called word help, because it lists only the keywords or arguments that begin with the abbreviation you entered.
To list associated keywords or arguments for a command, enter a question mark (?) in place of a keyword or argument on the command line. This form of help is called command syntax help, because it lists the keywords or arguments that apply based on the command, keywords, and arguments you have already entered.
Examples
This example shows how to display a brief description of the help system:
This example shows how to use word help to display the privileged EXEC commands that begin with the letters co:
Use the history command to enable the command history function or to change the command history buffer size for a particular line. Use the no form of this command to disable the command history feature.
Syntax Description
(Optional) Keyword to specify the number of command entries that the system will record in its history buffer. The range of number-of-lines is 0 to 256. |
Defaults
The default is number-of-lines is set to 10.
Command Types
Command Modes
Usage Guidelines
The history command provides a record of EXEC commands you have entered. This feature is useful for recalling long or complex commands or entries, such as access lists.
The history command enables the history function with the last buffer size specified or with the default of ten lines if there was no prior setting. The history size number-of-lines command sets the number of command entries stored in the command history buffer.
The no history command disables the history feature but remembers the buffer size if it was set to a value other than the default. The no history size command resets the buffer size to the default.
Table 7-2 lists the keys and functions you can use to recall commands from the command history buffer.
1The arrow keys function only with ANSI-compatible terminals such as VT100s. |
Examples
This example shows how to configure virtual terminal line 4 with a history buffer size of 35 lines:
Related Commands
Use the interface command within privileged EXEC mode to enter the interface configuration mode.
Syntax Description
Number of the ATM interface; valid values are from 0 to 4294967295. |
|
Loopback interface number; valid values are from 0 to 2147483647. |
Defaults
This command has no default settings.
Command Types
Command Modes
Interface configuration and subinterface configuration.
Usage Guidelines
If you do not specify the mul keyword when entering a subinterface number, the CLI does not accept the command.
Examples
This example shows how to enter interface configuration mode for interface atm0:
This example shows how to enter subinterface configuration mode for subinterface atm0.1:
Use the lane auto-config-atm-address command to specify that the ATM address is computed automatically for the LECS or the LES and LEC, depending on whether the config keyword is used. Use the no form of this command to remove the previously assigned ATM address.
Syntax Description
Defaults
The default is that no specific ATM address or method is set.
Command Types
Command Modes
Usage Guidelines
When the config keyword is not present, this command causes the LES and LEC on the subinterface to use the automatically assigned ATM address for the LECS.
When the config keyword is present, this command assigns the automatically generated ATM address to the LECS configured on the interface. Multiple commands that assign ATM addresses to the LECS can be issued on the same interface 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.
Examples
This example shows how to associate the LECS with the database named network1 and how to specify that the LECS ATM address is automatically assigned:
Related Commands Related Commands
lane config database
lane config-atm-address
Use the lane bus-atm-address command to define the ATM address for the LANE BUS. Use the no form of this command to remove the ATM address for the BUS.
Syntax Description
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows how to define the ATM address for the LANE BUS:
Use the lane client command to activate a LANE client on the specified subinterface. Use the no form of this command to remove a previously activated LANE client on the subinterface.
Syntax Description
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
If you already entered a lane client command on the subinterface for a different ELAN, the client initiates termination procedures for that ELAN and joins the new ELAN.
If you do not provide an elan-name value, the client contacts the server to find which ELAN to join. If you provide an elan-name value, the client consults the configuration server to ensure that no conflicting bindings exist.
Examples
This example shows how to activate the LANE client for a VLAN 3 called eng:
Related Commands Related Command
Use the lane client-atm-address command to specify an ATM address and to override automatic ATM address assignment for the LANE client on the specified subinterface. Use the no form of this command to remove the ATM address previously specified for the LANE client on the specified subinterface and revert to automatic address assignment.
Syntax Description
Defaults
The default is automatic ATM address assignment.
Command Types
Command Modes
Usage Guidelines
If you use this command on a selected subinterface, but with a different ATM address than was used previously, it replaces the LANE client's ATM address.
A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):
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 characters replaced by wildcards come from the automatically assigned ATM address.
In LANE, a prefix template matches the ATM address prefix explicitly but uses wildcards for the ESI and selector fields. An ESI template matches the ESI field explicitly 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
This example shows how to use 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, designated by the double asterisks:
This example shows how to use 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, designated by the ellipses:
Related Commands Related Command
Use the lane client mpoa client name command to bind a LEC to the named MPC. Use the no form of this command to unbind the named MPC from a LEC.
Syntax Description
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
When you enter this command, the named MPC binds to a LEC. The named MPC must exist before this command is accepted. If you enter this command before a LEC is configured (not necessarily running), a warning message is issued.
Examples
This example shows how to bind a LEC on a subinterface to the MPC:
Related Commands Related Command
Use the lane client qos database_name command to apply the database to an interface. Use the no form of this command to remove the database from the interface.
Syntax Description
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows how to apply a LANE QoS database to a subinterface:
Related Commands Related Command
atm-address
lane qos database
show lane qos database
Use the lane config-atm-address command to specify the ATM address of a given configuration server. Use the no form of this command to remove an assigned ATM address.
Syntax Description
ATM address or template in which wildcard characters are replaced by any nibble or group of nibbles of the prefix bytes, the ESI bytes, or the selector byte of the automatically assigned ATM address. |
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
This command causes the LANE client on the subinterface to use the specified ATM address (rather than the ATM address provided by the ILMI) to locate the configuration server.
A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):
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 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 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
This example shows how to specify the ATM address of the LANE configuration server:
Related Commands Related Command
Use the lane config database command to associate a named configuration table (database) with the configuration server on the selected ATM interface. Use the no form of this command to remove the association between a named database and the configuration server.
Syntax Description
Defaults
The default is that no configuration server is defined, and no database name is provided.
Command Types
Command Modes
Usage Guidelines
This command is valid only on a major interface, not a subinterface, because only one LANE configuration server can exist for a switch cloud.
The named database must exist before you enter the lane config database command. See the lane database command for more information.
You cannot enter multiple lane config database commands on the same interface. You must delete an existing association using the no form of this command before you can enter a new association.
Activating a LANE client requires the lane config database command and one of these commands: lane fixed-config-atm-address, lane auto-config-atm-address, or lane config-atm address.
Examples
This example shows how to associate a named configuration database with the configuration server:
Related Commands Related Commands
lane auto-config-atm-address
lane config-atm-address
lane database
Use the lane database command to create a named configuration database that can be associated with a configuration server when one is configured. Use the no form of this command to delete all entries in the specified database.
Syntax Description
Defaults
The default is that no name is provided.
Command Types
Command Modes
Usage Guidelines
A LANE database contains entries that bind an ELAN name to the ATM address of the LANE server, bind LANE client MAC addresses to an ELAN name, and bind LANE client ATM address templates to an ELAN name.
Entering the lane database command places you in database configuration mode, in which you can enter the client-atm-address name, default name, mac-address name, and name server-atm-address commands to create entries in the specified database. When you are done creating entries, type Ctrl-Z or exit to return to global configuration mode.
Examples
This example shows how to create a configuration database named test:
Related Commands Related Commands
client-atm-address name
default-name
name
Use the lane le-arp command to add a static entry to the LE ARP table of the LANE client configured on the subinterface. Use the no form of this command to remove a static entry.
Syntax Description
Defaults
The default is that no static address bindings are provided.
Command Types
Command Modes
Usage Guidelines
This command only adds or removes a static entry binding a MAC address 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 Data Direct VCCs 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, enter the clear lane le-arp command.
Examples
This command adds a static entry to the LE ARP table:
Related Commands Related Command
Use the lane qos database command to create the LANE QoS database. Use the no form of this command to delete the specified database.
Syntax Description
Defaults
The default is that no name is provided.
Command Types
Command Modes
Examples
This example shows how to create a configuration database named test:
Related Commands Related Commands
atm-address
lane client qos
show lane qos database
Use the lane qos iptos trust global configuration command to change the LANE QoS mode to trusted. Use the no form of the command to change the LANE QoS mode to untrusted.
Syntax Description
Defaults
The default LANE QoS command mode is untrusted.
Command Modes
Examples
This example shows how to set the mode to trusted:
Related Commands Related Commands
atm-address
lane client qos
show lane qos database
Use the lane register command to register a LANE client connected by a PVC to the LANE server on the subinterface. Use the no form of this command to remove a prior entry.
Syntax Description
Virtual channel descriptor of the Server Direct PVC through which the LANE client is connected to the LANE server. |
|
Defaults
The default is that no PVC is defined, and no MAC address and ATM address are provided.
Command Types
Command Modes
Usage Guidelines
Ordinarily, SVCs are used instead of PVCs for communications within ELANs, and registration occurs dynamically via the LANE protocol. Use the lane register command only when you use PVCs.
If you use PVCs instead of SVCs for Server Direct circuits between the LANE server and LANE clients, use this command on the LANE server to identify the MAC address and the ATM address of the LANE client at the other end of a virtual circuit. If the client at the other end has a different ATM address, it is not allowed to join the ELAN.
Use the lane pvc command on a LANE client and the lane register command on a LANE server to enable PVCs, instead of SVCs alone, for LANE. The vcd value in the lane register command must match the vcd value in a lane pvc command and in an atm pvc command.
If you use PVCs for the Control Direct VCCs, you must also use PVCs for the Control Distribute VCCs. If you use PVCs for the Multicast Send VCCs, you must also use PVCs for the Multicast Forward VCCs.
Examples
This example shows how to register a LANE client connected by a PVC to the LANE server on the subinterface:
Related Commands Related Command
Use the lane server-atm-address command to configure the LES ATM address. Use the no form of this command to delete the specified LES.
Syntax Description
ATM address or template in which wildcard characters are replaced by any nibble or group of nibbles of the prefix bytes, the ESI bytes, or the selector byte of the automatically assigned ATM address. |
Defaults
Command Types
Command Modes
Usage Guidelines
For complete information on using ATM address templates, refer to the "Configuring ATM LANE Emulation" chapter in the Software Configuration Guide for your switch.
Examples
This example shows how to configure the LES ATM address:
Use the lane server-bus command to configure the LES and BUS for the specified ELAN on the subinterface. Use the no form of this command to delete the specified LES/BUS.
Syntax Description
Defaults
![]() |
Note Only emulated Ethernet LANs are supported. |
Command Types
Command Modes
Usage Guidelines
The LES/BUS of an ELAN must be co-located.
The maximum length of the elan_name is 32 characters.
If you have already entered the lane server-bus command on the subinterface for a different ELAN, the LES terminates procedures with all LECs and appears as the LES for the new ELAN.
To participate in MPOA, a LEC must have an ELAN ID. The lane server-bus command enables the LEC to obtain the ELAN ID from the LES when the LEC bypasses the LECS phase.
![]() |
Caution If an ELAN ID is supplied, ensure that it corresponds to the same ELAN ID value specified in the LECS for the same ELAN. |
You can also enter the name elan-id command to obtain the ELAN ID from the LECS. The no form of this command removes a previously configured LES/BUS on the subinterface.
Examples
This example shows how to enable the LES/BUS for an Ethernet ELAN:
Related Commands Related Commands
Use the mac-address command to set the MAC layer address.
Syntax Description
Defaults
The default is no MAC layer address is set.
Command Types
Command Modes
Usage Guidelines
If you have a LECS, LES, or BUS configured on an ATM module, and you replace the supervisor engine or move the ATM module from one slot to another, you can enter the mac-address command to modify the default ATM address network service access points (NSAPs). This way, if you replace the supervisor engine or move the ATM module from one slot to another, the NSAP is taken from the MAC address instead of the supervisor engine.
Examples
This example shows how to set the MAC layer address, where xx.xxxx is an appropriate second half of the MAC address to use:
Use the mpoa client config name command to define an MPC with a specified name. Use the no form of this command to delete the MPC.
Syntax Description
Defaults
The system defaults are as follows:
Command Types
Command Modes
Usage Guidelines
When you enter this command, you are placed in the MPC configuration/definition mode. From here, you can enter subcommands to define or change MPC variables specific only to this MPC. Note that the MPC is not functional until it is attached to a hardware interface.
Examples
This example shows how to create or modify the MPC named ip_mpc:
Related Commands Related Commands
atm-address
shortcut-frame-count
shortcut-frame-time
Use the mpoa client name command to attach an MPC to a major ATM interface. Use the no form of this command to break the attachment.
Syntax Description
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
The mpoa client name command provides an interface to the MPC through which the MPC can set up and receive calls.
When you enter this command on a major interface that is up and operational, the named MPC becomes operational. After the MPC is fully operational, it can register its ATM address.
Examples
This example shows how to attach the MPC ip_mpc to an interface:
Related Commands Related Commands
show mpoa client
mpoa client config name
show mpoa default-atm-addresses
Use the mpoa server config name command to define an MPS with the specified name. Use the no form of this command to delete an MPS.
Syntax Description
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
The mpoa server config name command defines an MPS with the specified name. The MPS does not start functioning until it is attached to a specific hardware interface. Once that attachment is complete, the MPS starts functioning. When you configure or create an MPS, you automatically enter the MPS configuration mode.
You can define the MPS variables specific to an MPS, only after that MPS is defined with a specified name. After you enter this command, you may enter further commands to change MPS variables that are specific only to this MPS.
Examples
This example shows how to attach the MPC ip_mpc to an interface:
Related Commands Related Commands
show mpoa client
mpoa client config name
show mpoa default-atm-addresses
Use the mtu command to set the interface MTU.
Syntax Description
MTU size in bytes. Valid values are from 64 to 17944. Valid ATM values are 1500, 4528, and 9218 for Ethernet; and 4490 and 9180 for Token Ring. |
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
This command is not supported by these modules:
Examples
This example shows how to set the MTU to 1500 for an Ethernet module:
Related Commands Related Command
Use the name command to assign a unique ELAN name to an LES and to configure an ELAN. Use the no form of this command to delete the specified ELAN name.
Syntax Description
Defaults
The default has higher priority LES preemption off.
Command Types
Command Modes
Usage Guidelines
Use this command when setting up the LECS database on Catalyst 5000 family and 2926G series switches or when configuring the address of a LES/BUS.
When you enter the name elan-name elan-id id preempt command to turn on higher priority LES preemption, if the primary LANE server (LES) fails, a switchover to a secondary LES occurs. But when a LES that is ranked higher in the priority list becomes active, the active LES is switched to the new LES (with the higher priority).
If you use the default configuration, the second switchover to the new LES does not occur, regardless of the priority. Use the no form of the command to turn off higher priority LES preemption.
The new-name and preempt keywords are supported in Catalyst 5000 and 2926G series ATM software release 3.2(8) and later.
Examples
This example shows how to configure the LES ATM NSAP address for the default ELAN:
Related Commands Related Commands
Use the reload command to halt and perform a cold restart on the module.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Usage Guidelines
The reload command halts the ATM module. If you set the ATM module to restart on error, it reboots itself. Use the reload command after you enter configuration information into a file and save to the startup configuration.
Once you have confirmed the reload, you are logged out of the session and returned to the
Console> prompt.
You cannot reload from a virtual terminal if the system is not set up for automatic booting. This restriction prevents the system from dropping to the ROM monitor and taking the system out of the remote user's control.
If you modify your configuration file, the system prompts you to save the configuration. During a save operation, the system asks you if you want to proceed with the save if the CONFIG_FILE environment variable points to a startup configuration file that no longer exists. If you say "yes" in this situation, the system goes to setup mode upon reload.
Examples
This example shows how to reload the system from the privileged EXEC prompt:
Use the shortcut-frame-count command to specify the maximum number of times a packet can be routed to the default router within the shortcut-frame time before an MPOA resolution request is sent. Use the no form of this command to restore the default shortcut-setup frame count value.
Syntax Description
Defaults
Command Types
Command Modes
Examples
This example shows how to set the shortcut-setup frame count to 5 for the MPC:
Related Commands Related Commands
atm-address
mpoa client config name
shortcut-frame-time
Use the shortcut-frame-time command to set the shortcut-setup frame time (in seconds) for the MPC. Use the no form of this command to restore the default shortcut-setup frame-time value.
Syntax Description
Defaults
Command Types
Command Modes
Examples
This example shows how to set the shortcut-setup frame time to 7 for the MPC:
Related Commands Related Commands
atm-address
mpoa client config name
shortcut-frame-count
Use the show atm ilmi-status atm command to display ILMI-related information.
Syntax Description
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows how to display ILMI-related information.
Table 7-3 describes the fields shown in the show atm ilmi-status atm output.
Field | Description |
---|---|
Number of the module, submodule, and port of the specified ATM interface. |
|
Use the show atm interface atm0 command to display information about the ATM interface.
![]() |
Note The interface number atm0 must always be used for the Catalyst 5000 family and 2926G series ATM module. |
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows how to display statistics on the ATM module:
Table 7-4 describes the fields in the show atm interface atm0 output.
Use the show atm traffic command to display current global ATM traffic information to and from all ATM networks connected to the ATM module.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows sample output from the show atm traffic command:
Table 7-5 describes the fields in the show atm traffic output.
Related Commands Related Command
Use the show atm vc command to display the active ATM virtual connections (PVCs and SVCs) and traffic information.
Syntax Description
Defaults
If you do not specify a vcd, the command displays information for all SVCs. The output is in summary form (one line per VC).
Command Types
Command Modes
Examples
This example shows how to display statistics for all VCs:
Table 7-6 describes the fields in the show atm vc output.
Field | Description |
---|---|
AAL type and encapsulation type configured for the virtual connection. |
|
Use the show atm vlan command to display the active VLAN-to-PVC bindings.
Syntax Description
(Optional) Number of the VC about which information is displayed. The range of vlan_num is 1 to 1023. |
Defaults
If you do not specify a vlan_num, all active VLAN-to-PVC bindings are displayed.
Command Types
Command Modes
Examples
After entering the show atm vlan command, you see this display:
The display shows the VCD of the VC and the VLAN-ID of the VLAN to which the VC belongs.
Use the show history command to list the commands you have entered in the current EXEC session.
Syntax Description
This command has no arguments or keywords.
Command Types
Command Modes
Usage Guidelines
The command history feature provides a record of EXEC commands you have entered. The number of commands the history buffer records is determined by the history size line configuration command or the terminal history size EXEC command.
Table 7-7 lists the keys and functions you can use to recall commands from the command history buffer.
1The arrow keys function only with ANSI-compatible terminals such as VT100s. |
Examples
This example shows how to list the command history:
Use the show lane command to display global and per-VCC LANE information for all the LANE clients configured on an interface, a subinterface, or an ELAN.
![]() |
Note This command displays exactly the same information as the show lane client command. |
Syntax Description
Command Types
Command Modes
Examples
This example shows sample output of the show lane command:
Table 7-8 describes the fields in the show lane output.
Related Commands Related Commands
show lane bus
show lane client
show lane config
show lane default-atm-addresses
show lane le-arp
show lane server
Use the show lane bus command to display LANE information for the BUSs configured on all servers, on a specified interface, or on an ELAN.
Syntax Description
Command Types
Command Modes
Examples
This example shows how to display information about all LANE BUSs:
Table 7-9 describes the fields in the show lane bus output.
Related Commands Related Commands
show lane
show lane client
show lane config
show lane default-atm-addresses
show lane le-arp
show lane server
Use the show lane client command to display global and per-VCC LANE information for all the LANE clients configured on an interface, a subinterface, or an ELAN.
![]() |
Note This command displays the same output as the show lane command. |
Syntax Description
Command Types
Command Modes
Examples
This example shows how to display LANE client information:
For a description of the fields in the show lane client command output, see Table 7-13.
Related Commands Related Commands
show lane
show lane bus
show lane config
show lane default-atm-addresses
show lane le-arp
Use the show lane config command to display LANE information about the LECS.
Syntax Description
Command Types
Command Modes
Examples
This example shows how to display information about the LECS:
Table 7-10 describes the fields in the show lane config output.
Related Commands Related Commands
show lane
show lane bus
show lane client
show lane default-atm-addresses
show lane le-arp
show lane server
Use the show lane default-atm-addresses command to display default ATM addresses for the LEC, LES/BUS, and LECS.
Syntax Description
This command has no arguments or keywords.
Command Types
Command Modes
Usage Guidelines
If the two PHYs of the ATM dual PHY card connect to different switches, and if you configure the ATM card to have a LES/BUS or LECS, you must determine the addresses to be used if the first PHY goes down. See the atm preferred phy command for more information.
Examples
After entering the show lane default-atm-addresses command, you see this display:
The display shows the last 12 digits of the default LEC, LES, BUS, and LECS ATM addresses (followed by the subinterface number).
Related Commands Related Commands
atm preferred phy
show lane default-atm-addresses
Use the show lane le-arp command to display the LE ARP table of the LANE client configured on an interface or any of its subinterfaces, on a specified subinterface, or on an ELAN.
Syntax Description
(Optional) Number of the subinterface; the period (.) is required. |
|
(Optional) Keyword to specify the name of an ELAN; the maximum length of elan-name is 32 characters. |
Command Types
Command Modes
Examples
This example shows how to display the LANE ARP table of the LEC:
Table 7-11 describes the fields in the show lane le-arp output.
Related Commands Related Commands
Use the show lane qos database command to display the contents of a specific LANE QoS database.
Syntax Description
Command Types
Command Modes
Examples
This example shows how to display the contents of a LANE QoS database:
Related Commands Related Commands
lane qos database
lane client qos
Use the show lane server command to display LANE information for the LESs configured on all servers, on a specified interface, or on an ELAN.
Syntax Description
Command Types
Command Modes
Examples
This example shows how to display LANE information for the LES:
Table 7-12 describes the fields in the show lane server output.
Field | Description |
---|---|
ATM address of the LECS used by the LES, the connection state, and the VCD used. |
Related Commands Related Commands
Use the show mpoa client command to display a summary of information regarding one or all MPCs.
Syntax Description
Defaults
The default is that all MPC information is displayed.
Command Types
Command Modes
Usage Guidelines
If you omit the name keyword, the command displays information for all MPCs.
Examples
This example shows output from the show mpoa client command:
Table 7-13 describes the fields in the show mpoa client output.
Related Commands Related Command
Use the show mpoa client cache command to display the ingress or egress cache entries matching the IP addresses for the MPCs.
Syntax Description
Defaults s
Command Types
Command Modes
Usage Guidelines
The more optional parameters specified, the more filtering is applied to the show command.
Examples
This example shows output from the show mpoa client cache command for a specific MPC:
Table 7-14 describes the fields in the show mpoa client cache output.
1Valid states are initialized, trigger, refresh, hold_down, resolved, and suspended. |
Related Commands Related Command
Use the show mpoa client statistics command to display all the statistics collected by an MPC.
Syntax Description
Defaults
The defaults are that all the statistics collected by an MPC are displayed.
Command Types
Command Modes
Usage Guidelines
This command displays all the statistics collected by an MPC.
Examples
This example shows output from the show mpoa client statistics command for the MPC ip_mpc:
Related Commands Related Command
Use the show mpoa default-atm-addresses command to display the default ATM addresses for the MPC.
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows output from the show mpoa default-atm-addresses command when the switch prefix is NOT available:
This example shows output from the show mpoa default-atm-addresses command when the switch prefix is available:
Related Commands Related Command
Use the show sscop command to show SSCOP details for all ATM interfaces.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows sample output from the show sscop command:
Table 7-15 describes the possible fields (depending on the port type queried) in the show sscop output.
![]() |
Note Interpreting the output of the show sscop command requires a thorough understanding of SSCOP. This information is used by Cisco technicians to help diagnose network problems. |
Related Commands Related Commands
sscop cc-timer
sscop keepalive-timer
sscop max-cc
sscop poll-timer
sscop receive-window
sscop send-window
Use the show version ATM command to display version information for the ATM module.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Command Modes
Examples
This example shows how to display version information for the ATM module:
Table 7-16 describes the fields in the show version output.
Use the shutdown command to shut down a physical interface. Use the no form of this command to restart the interface.
Syntax Description
This command has no arguments or keywords.
Defaults
Command Types
Command Modes
Examples
This example shows how to access and shut down the atm0 interface:
This example shows how to access and then restart the atm0 interface:
Use the sscop cc-timer command to change the SSCOP connection control timer value. Use the no form of this command to restore the default value.
Syntax Description
Defaults
The default SSCOP connection control timer value is 10 seconds.
Command Types
Command Modes
Usage Guidelines
The SSCOP connection control timer determines the time between transmission of SSCOP BGN, END, or RS PDUs as long as an acknowledgment has not been received.
Examples
This example shows how to set the SSCOP connection control timer value to 15 microseconds:
Related Commands Related Command
Use the sscop keepalive-timer command to change the SSCOP keepalive timer value. Use the no form of this command to restore the default value.
Syntax Description
Defaults
The default SSCOP keepalive timer value is 30 seconds.
Command Types
Command Modes
Examples
This example shows how to set the SSCOP keepalive timer to 15 microseconds:
Related Commands Related Command
Use the sscop max-cc command to change the SSCOP connection control retry count. Use the no form of this command to restore the default value.
Syntax Description
Defaults
The default SSCOP connection control retry count is 10 retries.
Command Types
Command Modes
Examples
This example shows how to set the SSCOP connection control retry count to 20:
Related Commands Related Command
Use the sscop max-stat command to change the SSCOP number of entries in a Stat frame. Use the no form of this command to restore the default value.
Syntax Description
Command Types
Command Modes
Examples
This example shows how to set the SSCOP entries in a Stat frame to 50:
Related Commands Related Command
Use the sscop poll-timer command to change the SSCOP poll timer value. Use the no form of this command to restore the default value.
Syntax Description
Number of microseconds the ATM module waits between transmission of POLL PDUs; the range of msecs is from 1 to 60000. |
Defaults
The default SSCOP poll timer value is 10 seconds.
Command Types
Command Modes
Usage Guidelines
The SSCOP poll timer controls the maximum time between transmission of POLL PDUs when SD or SDP PDUs are queued for transmission or are outstanding pending acknowledgments.
Examples
This example shows how to set the SSCOP poll timer to 15 microseconds:
Related Commands Related Command
Use the sscop receive-window command to change the size of the SSCOP receiver window. Use the no form of this command to restore the default value.
Syntax Description
Number of packets the interface receives before it sends an acknowledgment to the ATM switch; the range of packets is from 1 to 127. |
Defaults
The default size of the SSCOP receiver window is 7 packets.
Command Types
Command Modes
Examples
This example shows how to set the size of the SSCOP receiver window to 10 packets:
Related Commands Related Command
Use the sscop send-window command to change the size of the SSCOP transmitter window. Use the no form of this command to restore the default value.
Syntax Description
Number of packets the interface can send before it must receive an acknowledgment from the ATM switch; the range of packets is from 1 to 127. |
Defaults
The default size of the SSCOP transmitter window is 7 packets.
Command Types
Command Modes
Examples
This example shows how to set the size of the SSCOP transmitter window to 10 packets:
Related Commands Related Command
Use the terminal command to set the number of lines displayed on-screen. Use the no form of this command to return the screen length to the default.
Syntax Description
(Optional) Number of lines to display on-screen. The range of screen-length is from 0 to 512. A value of 0 disables pausing between screens of output. |
Defaults
The default screen length is 24 lines.
Command Types
Command Modes
Examples
This example shows how to set the terminal length to 0 so that output scrolls on the screen without pausing:
Use the ubr+cos command to map the CoS value or range of values to a UBR+ VCC. Use the no form of this command to remove the configuration.
Syntax Description
Defaults
The default CoS range for a UBR+ VCC is from 4 to 7.
Command Types
Command Modes
Examples
This example shows how to map traffic with CoS values between 5 and 7 to a UBR+ VCC:
Use the write terminal command to display the configuration information currently in running memory.
Syntax Description
This command has no arguments or keywords.
Command Types
Command Modes
Usage Guidelines
You can also use this command in ATM EXEC mode to display the current ATM configuration information.
Examples
This example shows how to display the current ATM configuration information:
Posted: Sat Jan 18 07:57:15 PST 2003
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.