|
|
This chapter describes the general commands used in the Catalyst 5000 series ATM module CLI. For a summary of the ATM CLI commands, refer to the "ATM Command Quick Reference" chapter. For more information about the ATM CLI, refer to the "ATM Command-Line Interface" chapter.
Use the atm bind pvc vlan command to bind a PVC to a specified VLAN.
atm bind pvc vlan vcd vlan_num| vcd | Virtual circuit descriptor; a unique number for each switch that identifies which VPI/VCI to use for a particular packet. |
| vlan_num | Number of the VLAN. |
Cisco IOS ATM command.
Interface configuration.
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 series switches.
This example shows how to bind PVC 10 to VLAN 5 and PVC 11 to VLAN 5:
ATM(config-if)#atm bind pvc vlan 10 5 ATM(config-if)#atm bind pvc vlan 11 5
Use the atm clock internal command to cause the ATM module on the Catalyst 5000 series switch 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 the received clock.
atm clock internalThis command has no arguments or keywords.
The ATM module generates the transmit clock signal from its internal source.
Cisco IOS ATM command.
Interface configuration.
The atm clock internal and the no atm clock internal commands are not supported by the ATM dual PHY OC-12 module.
This example allows you to set the ATM module to generate the transmit clock from its internal source:
ATM(config-if)#atm clock internal
This example allows you to set the ATM module to generate the transmit clock from the received clock:
ATM(config-if)#no atm clock internal
Use the atm ds3-scramble command to enable scrambling on the current port. Enter the no form of this command to disable scrambling. This command is not available to the OC-3 ATM module.
atm ds3-scrambleThis command has no arguments or keywords.
The default is scrambling not enabled.
Cisco IOS ATM command.
Interface configuration.
This command applies to DS3 interfaces only.
This example shows how to enable scrambling:
ATM(config)#interface atm0 ATM(config-if)#atm ds3-scramble
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:
This command is not available to the OC-3 ATM module. Enter the no form of this command to use the default value.
atm framing [m23adm | cbitplcp | m23plcp]| m23adm | (Optional) Keyword that specifies M23 ADM. |
| cbitplcp | (Optional) Keyword that specifies C-bit with physical layer convergence procedure (PLCP) framing. |
| m23plcp | (Optional) Keyword that specifies M23 with PLCP framing. |
The default value is C-bit with ADM.
Cisco IOS ATM command.
Interface configuration.
The atm framing command applies to DS3 interfaces only.
This command allows you to set DS3 framing mode to either M23 ADM, M23 PLCP, C-bit PLCP, or C-bit ADM (default value).
The following example selects m23adm frame as the frame type:
ATM(config-if)#atm framing m23adm
Use the atm ilmi-enable command to enable the ILMI on a port. To disable the ILMI, use the no form of this command.
atm ilmi-enableThis command has no arguments or keywords.
ILMI is enabled.
Cisco IOS ATM command.
Interface configuration.
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.
This example shows how to enable the ILMI:
ATM(config-if)#atm ilmi-enable
This example shows how to disable the ILMI:
ATM(config-if)#no atm ilmi-enable
Use the atm ilmi-keepalive command to enable ILMI keepalives. To disable ILMI keepalives, use the no form of this command.
atm ilmi-keepalive seconds| seconds | Number of seconds between keepalives. |
The default is three seconds. Values less than three seconds are rounded to three seconds. There is no upper boundary to the range of values.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the number of seconds between ILMI keepalives:
ATM(config-if)#atm ilmi-keepalive 5
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.
atm lbo {short | long}| short | Keyword that sets the line buildout (cable length) up to 255 feet (77.4 meters). |
| long | Keyword that sets the line buildout (cable length) over 255 feet (77.4 meters). |
The default is short.
Cisco IOS ATM command.
Interface configuration.
The atm lbo command applies to DS3 interfaces only.
This example sets the line buildout (cable length) to over 255 feet (77.4 meters):
ATM(config-if)#atm lbo long
Use the atm preferred phy command to change the preferred PHY to the one not currently in use.
atm preferred phy {A | B}| A | Keyword that indicates PHY A. |
| B | Keyword that indicates PHY B. |
The default is PHY A.
Cisco IOS ATM command.
Interface configuration.
Use this command only with the OC-12 dual PHY ATM module connected to the same or different switches.
This example shows how to specify PHY A as the preferred PHY:
ATM#configure terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(config)#interface atm0 ATM(config-subif)#atm preferred phy A ATM(config-subif)#end ATM#
show lane default-atm-addresses
Use the atm pvc command to create a PVC on the Catalyst 5000 series switch interface. The no form of this command deletes the specified PVC.
atm pvc vcd vpi vci [aal5snap | ilmi | qsaal]
| vcd | Virtual circuit descriptor; a unique number for each Catalyst 5000 series switch that identifies which VPI/VCI to use for a particular packet. |
| vpi | VPI for the PVC. The range of vpi is 0 to 255. The VPI value is unique only on a single interface, not throughout the ATM network. |
| vci | VCI for the PVC. The range is from 0 to 65535. The VCI value is unique only on a single interface, not throughout the ATM network. |
| aal5snap | (Optional) Keyword that specifies the use of AAL5 with LLC/SNAP encapsulation. |
| ilmi | (Optional) Keyword that specifies the use of ILMI. |
| qsaal | (Optional) Keyword that specifies signaling AAL. |
| peak_rate | (Optional) Maximum rate (in kbps) at which this virtual circuit can transmit. The range is from 0 to 155000. Available in ATM PVC traffic-shaping software release 50.1(1) and later. The maximum rate for peak_rate in ATM PVC traffic-shaping software release 51.1(1) and later is 45000 kbps. |
| average_rate | (Optional) Average rate (in kbps) at which this virtual circuit can transmit. The range is from 0 to 1000. Available in ATM PVC traffic-shaping software release 50.1(1) and later, and 51.1(1) and later. |
| burst_size | (Optional) Burst cell size in number of cells. Acceptable values are 0 to 1. Available in ATM PVC traffic-shaping software release 50.1(1) and later, and software release 51.1(1) and later. |
| oam seconds | (Optional) Keyword that specifies how often to generate an OAM 5 loopback cell from this virtual circuit. Available in ATM PVC traffic-shaping software release 50.1(1) and later, and software release 51.1(1) and later. |
If the peak_rate and average_rate options are omitted, the PVC defaults to the highest bandwidth rate queue available. By default, the VC is configured to run as fast as possible. If the oam keyword is omitted, OAM cells are not generated. If you use the oam keyword without specifying seconds, the default value of 10 seconds is used.
Cisco IOS ATM command.
Interface configuration.
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.
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 software release 51.1(1) and later dynamically create rate queues 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 series switch to generate and echo OAM F5 loopback cells, used to verify connectivity. Once OAM cell generation is enabled, OAM cells are transmitted periodically. The remote end must respond by echoing back the cells.
This example shows how to create a PVC to be used for ATM signaling for an SVC, using VPI 0 and VCI 5:
ATM(config-if)#atm pvc 1 0 5 qsaal
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:
ATM(config-if)#atm pvc 1 0 5 aal5snap 155000 1000 oam
Use the atm sonet command to set the mode of operation and control type for cell-rate decoupling on the SONET PLIM. The no form of this command restores the default value.
atm sonet {stm-4 | sts-12c}
no atm sonet
| stm-4 | Keyword that specifies synchronous transport module level 4 (STM-4) operation. |
| sts-12c | Keyword that specifies synchronous transport signal level 12, concatenated (STS-12c) operation. |
The default is STS-12c operation.
Cisco IOS ATM command.
Interface configuration.
This command applies only to the ATM dual PHY OC-12 module.
The no atm sonet stm-4 command is the same as the atm sonet sts-12c command.
This example shows how to set the mode of operation to stm-4:
ATM (config-if)#atm sonet stm-4 ATM (config-if)#
Use the atm traffic-shape rate command to configure output throttling on your Catalyst 5000 series switch ATM module. The no form of the command returns the output rate to the default.
atm traffic-shape rate 1-155| 1-155 | Number between 1 and 155 indicating Mbps. |
The default is 155 Mbps.
Cisco IOS ATM command.
Interface configuration.
This command is not supported by the ATM dual PHY OC-12 module.
This example shows how to set the output throttle to 50:
ATM(config)#int atm0 ATM(config-if)#atm traffic-shape rate 50 ATM(config-if)#end
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.
atm uni-version version_num| version_num | UNI version for the interface. Valid values are 3.0 or 3.1. |
The default UNI version is 3.0.
Cisco IOS ATM command.
Configuration.
This example shows how to set the UNI version to 3.1:
ATM(config)#atm uni-version 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.
atm vc-per-vp num| num | Maximum number of VCIs to support per VPI. Valid values are 32, 64, 128, 256, 512, and 1024. |
By default, the maximum number of VCIs to support per VPI is 1024.
Cisco IOS ATM command.
Interface configuration.
This command controls the memory allocation in the Catalyst 5000 series switch for the VCI table. It defines the maximum number of VCIs to support per VPI; it does not designate the VCI numbers.
An invalid VCI causes a warning message to display.
This example shows how to set the maximum number of VCIs to support per VPI to 512:
ATM(config-if)#atm vc-per-vp 512
Use the atmsig close command to disconnect a particular SVC.
atmsig close atm0 vcd| atm0 | Keyword used to specify the atm0 interface number to close the SVC, because VCs are numbered per interface. |
| vcd | Virtual circuit descriptor of the SVC to close. |
Cisco IOS ATM command.
EXEC.
This example shows how to close SVC 2 on the ATM module:
ATM#atmsig close atm0 2
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.
client-atm-address atm-address-template name elan-name| atm-address-template | Template that explicitly specifies an ATM address or a specific part of an ATM address and uses wildcard characters for other parts of the ATM address.
Wildcard characters can replace any nibble or group of nibbles in the prefix, the ESI, or the selector fields of the ATM address. |
| name elan-name | Name of the ELAN. The maximum length of elan-name is 32 characters. |
By default, no address and no ELAN name are configured.
Database configuration.
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 a 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 explicitly matches the prefix but uses wildcards for the ESI and selector fields. An ESI template explicitly matches the ESI field but uses wildcards for the prefix and selector.
In our implementation of LANE, the prefix corresponds to the specific subinterface of the interface.
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:
ATM(lane-config-database)#client-atm-address ...0800.200c.1001.** name engineering
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:
ATM(lane-config-database)#client-atm-address 47.000014155551212f.00.00... name marketing
default-name
lane database
name server-atm-address
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.
default-name elan-name| elan-name | Default 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. |
By default, no name is configured.
Cisco IOS ATM command.
Database configuration.
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.
client-atm-address name
lane database
name server-atm-address
Use the disable command to exit privileged EXEC mode and return to user EXEC mode. After executing this command, the angle-bracket (>) prompt appears.
disable [level]| level | (Optional) Indicates the option to reduce the privilege level. |
This command has no default setting.
Cisco IOS ATM command.
EXEC.
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.
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:
ATM#disable ATM>
Use the editing command to enable enhanced editing mode. Use the no form of this command to disable enhanced editing mode.
editingThis command has no arguments or keywords.
Cisco IOS ATM command.
Enabled.
Line configuration.
Table 11-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. Esc must be pressed first, followed by the associated letter key. Keys are not case sensitive.
| Keys | Function |
|---|---|
| Tab | Completes a partial command name entry. When you enter a unique set of characters and press the Tab key, the system completes the command name. If you enter a set of characters that could indicate more than one command, the system beeps to indicate an error. Enter a question mark (?) immediately following the partial command (no space). The system lists the commands that begin with that string. |
| Delete or Backspace | Erases the character to the left of the cursor. |
| Return | Processes a command when you are at the command line. At the "---More---" prompt on a terminal screen, pressing the Return key scrolls down a line. |
| Spacebar | Allows you to see more output on the terminal screen. Press the Spacebar when you see "---More---" on the screen to display the next screen. |
| Left Arrow1 | Moves the cursor one character to the left. When you enter a command that extends beyond a single line, you can press the left arrow key repeatedly to scroll back to the system prompt and verify the beginning of the command entry. |
| Right Arrow1 | Moves the cursor one character to the right. |
| Up Arrow1 or Ctrl-P | Recalls commands in the history buffer, beginning with the most recent command. Repeat the key sequence to recall older commands. |
| Down Arrow1 or Ctrl-N | Returns to more recent commands in the history buffer after recalling commands with the up arrow or Ctrl-P. Repeat the key sequence to recall more recent commands. |
| Ctrl-A | Moves the cursor to the beginning of the line. |
| Ctrl-B | Moves the cursor back one character. |
| Ctrl-D | Deletes the character at the cursor. |
| Ctrl-E | Moves the cursor to the end of the command line. |
| Ctrl-F | Moves the cursor forward one character. |
| Ctrl-K | Deletes all characters from the cursor to the end of the command line. |
| Ctrl-L or Ctrl-R | Redisplays the system prompt and command line. |
| Ctrl-T | Transposes the character to the left of the cursor with the character located at the cursor. |
| Ctrl-U or Ctrl-X | Deletes all characters from the cursor back to the beginning of the command line. |
| Ctrl-V or Esc Q | Inserts a code to indicate to the system that the keystroke immediately following should be treated as a command entry, not as an editing key. |
| Ctrl-W | Deletes the word to the left of the cursor. |
| Ctrl-Y | Recalls the most recent entry in the delete buffer. The delete buffer contains the last ten items you deleted or cut. Ctrl-Y can be used with Esc Y. |
| Ctrl-Z | Ends configuration mode and returns to the EXEC prompt. |
| Esc B | Moves the cursor back one word. |
| Esc C | Capitalizes from the cursor to the end of the word. |
| Esc D | Deletes from the cursor to the end of the word. |
| Esc F | Moves the cursor forward one word. |
| Esc L | Changes to lowercase from the cursor to the end of the word. |
| Esc U | Capitalizes from the cursor to the end of the word. |
| Esc Y | Recalls the next buffer entry. The buffer contains the last ten items you deleted. Press Ctrl-Y first to recall the most recent entry. Then press Esc Y up to nine times to recall the remaining entries in the buffer. If you bypass an entry, press Esc Y to cycle back to it. |
This example shows how to disable enhanced editing mode on virtual terminal line 3:
ATM#config terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(config)#line vty 3 ATM(config-line)#no editing ATM(config-line)#
Use the enable command to enter privileged EXEC mode.
enableThis command has no arguments or keywords.
This command has no default setting.
Cisco IOS ATM command.
EXEC.
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.
This example shows how to cause the system to enter privileged command mode, as indicated by the pound sign (#):
ATM>enable Password: <password> ATM#
Use the end command to exit configuration mode.
endThis command has no arguments or keywords.
This command has no default setting.
Cisco IOS ATM command.
Global configuration.
You can also press Ctrl-Z to exit configuration mode.
This example shows how to exit configuration mode and return to EXEC mode:
ATM(config)#end ATM#
Use the exit command at the system prompt to exit any command mode or close an active terminal session and terminate the EXEC.
exitThis command has no arguments or keywords.
This command has no default setting.
Cisco IOS ATM command.
Available in all command modes.
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.
This example shows how to exit an active session:
ATM>exit
Use the help command to display a brief description of the help system.
helpThis command has no arguments or keywords.
Cisco IOS ATM command.
Available in all ATM command modes.
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.
This example shows how to display a brief description of the help system:
ATM#help Help may be requested at any point in a command by entering a question mark '?'. If nothing matches, the help list will be empty and you must backup until entering a '?' shows the available options. Two styles of help are provided: 1. Full help is available when you are ready to enter a command argument (e.g. 'show ?') and describes each possible argument. 2. Partial help is provided when an abbreviated argument is entered and you want to know what arguments match the input (e.g. 'show pr?'.)
This example shows how to use word help to display the privileged EXEC commands that begin with the letters co:
ATM#co? configure copy
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.
history [size number-of-lines]| size | (Optional) Keyword used to specify the number of command entries that the system records in its history buffer. |
| number-of-lines | (Optional) Number of command line entries; valid values are 0 to 256. |
By default, number-of-lines is set to 10.
Cisco IOS ATM command.
Line configuration.
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 11-2 lists the keys and functions you can use to recall commands from the command history buffer.
| Key | Function |
|---|---|
| Up Arrow or Ctrl-P1 | Recalls commands in the history buffer in a backward sequence, beginning with the most recent command. Repeat the key sequence to recall older commands. |
| Down Arrow or Ctrl-N1 | Returns to more recent commands in the history buffer after recalling commands with the up arrow or Ctrl-P. Repeat the key sequence to recall more recent commands. |
This example shows how to configure virtual terminal line 4 with a history buffer size of 35 lines:
ATM#config terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(config)#line vty 4 ATM(config-line)#history size 35 ATM(config-line)#
Use the interface command within privileged EXEC mode to enter the configure interface mode.
interface atm_num[.sub_interface_num mul] | loopback_num| atm_num | Keyword used to specify ATM interface number; valid values are 0 to 4294967295. |
| .sub_interface_num | (Optional) Number of the subinterface. |
| mul | Keyword used to specify multipoint. |
| loopback_num | Keyword used to specify the loopback interface number; valid values are 0 to 2147483647. |
None.
Cisco IOS ATM command.
Interface configuration and subinterface configuration.
If you do not specify the mul keyword when entering a subinterface number, the CLI does not accept the command.
This example shows how to enter interface configuration mode for interface atm0:
ATM(config)#interface atm0 ATM(config-if)#
This example shows how to enter subinterface configuration mode for subinterface atm0.1:
ATM(config-if)#interface atm0.1 ATM(config-subif)#
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. To remove the previously assigned ATM address, use the no form of this command.
lane [config] auto-config-atm-address| config | (Optional) Keyword used to specify the LECS ATM address. |
By default, no specific ATM address or method is set.
Cisco IOS ATM command.
Interface configuration.
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.
This example shows how to associate the LECS with the database named network1 and how to specify that the LECS's ATM address is automatically assigned:
ATM(config-if)#lane config auto-config-atm-address lane database network1 name eng server-atm-address 39.0000014155551211.0800.AA00.1001.02 name mkt server-atm-address 39.0000014155551211.0800.AA00.4001.01 lane config network1 lane auto-config-atm-address ATM(config-if)#
lane config database
lane config-atm-address
Use the lane client command to activate a LANE client on the specified subinterface. To remove a previously activated LANE client on the subinterface, use the no form of this command.
lane client ethernet vlan_num [elan-name]| ethernet | Keyword that indicates the type of ELAN attached to the interface. |
| vlan_num | Number of the VLAN that corresponds to the specified ELAN. |
| elan-name | (Optional) Name of the ELAN. This argument is optional because the client obtains its ELAN name from the configuration server. Maximum length for elan-name is 32 characters. |
None.
Cisco IOS LANE command.
Interface configuration.
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.
This example shows how to activate the LANE client for a VLAN 3 called eng:
ATM(config-if)#lane client ethernet vlan 3 eng
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. To remove the ATM address previously specified for the LANE client on the specified subinterface and revert to automatic address assignment, use the no form of this command.
lane client-atm-address atm-address-template| atm-address-template | ATM address, or a 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. |
Automatic ATM address assignment.
Cisco IOS LANE command.
Interface configuration.
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 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.
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:
ATM(config-if)#lane client-atm-address...0800.200C.1001.**
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:
ATM(config-if)#lane client-atm-address 47.000014155551212f.00.00...
Use the lane config-atm-address command to specify the ATM address of a given configuration server. To remove an assigned ATM address, use the no form of this command.
lane config-atm-address atm-address-template| atm-address-template | 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. |
By default, no specific ATM address or method is set.
Cisco IOS LANE command.
Interface configuration.
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.
This example shows how to specify the ATM address of the LANE configuration server:
ATM(config-subif)#lane config-atm-address 39.000000000000014155551211.0800200c1001.00
Use the lane config database command to associate a named configuration table (database) with the configuration server on the selected ATM interface. To remove the association between a named database and the configuration server, use the no form of this command.
lane config database database-name| database-name | Name of the LANE database. |
By default, no configuration server is defined and no database name is provided.
Cisco IOS LANE command.
Interface configuration.
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. Refer to 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 the following commands: lane fixed-config-atm-address, lane auto-config-atm-address, or lane config-atm address.
This example shows how to associate a named configuration database with the configuration server:
ATM(config)#int atm0 ATM(config-if)#lane config database test
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.
lane database database-name| database-name | Database name (32 characters maximum). |
By default, no name is provided.
Cisco IOS LANE command.
Global configuration.
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.
This example shows how to create a configuration database named test:
ATM(config)#int atm0 ATM(config-if)#lane database test ATM(lane-config-database)#end
client-atm-address name
default-name
name server-atm-address
Use the lane le-arp command to add a static entry to the LE ARP table of the LANE client configured on the subinterface. To remove a static entry, use the no form of this command.
lane le-arp mac-addr atm-addr| mac-address | MAC address to bind to the specified ATM address. |
| atm-address | ATM address to bind to the specified MAC address. |
By default, no static address bindings are provided.
Cisco IOS LANE command.
Interface configuration.
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.
This command adds a static entry to the LE ARP table:
ATM(config-if)#lane le-arp 0800.aa00.0101 47.000014155551212f.00.00.0800.200C.1001.01
Use the lane register command to register a LANE client connected by a PVC to the LANE server on the subinterface. To remove a prior entry, use the no form of this command.
lane register vcd mac-addr atm-addr| vcd | Virtual channel descriptor of the Server Direct PVC through which the LANE client is connected to the LANE server. |
| mac-addr | MAC address of the LANE client. |
| atm-addr | ATM address of the LANE client. |
By default, no PVC is defined and no MAC address and ATM address are provided.
Cisco IOS LANE command.
Interface configuration.
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.
This example shows how to register a LANE client connected by a PVC to the LANE server on the subinterface:
ATM(config)#int atm0.1
ATM(config-subif)#lane register 98 0800.aa00.0101 47.000014155551212f.00.00.0800.200C.1001.01
ATM(config-subif)#end
Use the lane server-bus command to configure the LES and BUS for the specified ELAN on the subinterface. The no version of this command deletes the specified LES/BUS.
lane server-bus ethernet elan_name| ethernet | Keyword used to specify an ethernet network. |
| elan_name | Name of the ELAN. |
The default is Ethernet.
Cisco IOS LANE command.
Interface configuration.
In this software release, the LES and BUS of an ELAN must be collocated.
This example shows how to configure the LES and BUS for the default ELAN:
ATM(config)#int atm0.1 ATM(config-subif)#lane server-bus ethernet default ATM(config-subif)#end
Use the name server-atm-address command to assign a unique ELAN name to a LES. The no form of this command deletes the specified ELAN name.
name elan_name server-atm-address atm-addr| elan_name | Name of the ELAN. |
| atm-addr | ATM address of the LANE client. |
Cisco IOS ATM command.
Database configuration.
Use this command when setting up the LECS database on Catalyst 5000 series switches or when configuring the address of a LES/BUS.
This example shows how to configure the LES ATM NSAP address for the default ELAN:
ATM#config terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(lane-config-database)#name default server-atm-address 47.0091810000000061705b7701.00400BFF0011.00 ATM(lane-config-database)#end
Use the reload command to reload the operating system.
reloadThis command has no arguments or keywords.
Cisco IOS Configuration command.
EXEC.
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.
You cannot reload from a virtual terminal if the system is not set up for automatic booting. This 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.
This example shows how to reload the system from the privileged EXEC prompt:
ATM#reload
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.
sscop cc-timer seconds| seconds | Number of seconds between Begin messages. |
The default SSCOP connection control timer value is 10 seconds.
Cisco IOS ATM command.
Interface configuration.
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.
This example shows how to set the SSCOP connection control timer value to 15 seconds:
ATM(config-if)#sscop cc-timer 15
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.
sscop keepalive-timer seconds| seconds | Number of seconds the ATM module waits between transmission of poll PDUs when no SD or SDP PDUs are queued for transmission or are outstanding pending acknowledgments. |
The default SSCOP keepalive timer value is 30 seconds.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the SSCOP keepalive timer to 15 seconds:
ATM(config-if)#sscop keepalive-timer 15
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.
sscop max-cc retries| retries | Number of times that SSCOP attempts to transmit BGN, END, or RS PDUs as long as an acknowledgment has not been received. The range of retries is 1 to 6000. |
The default SSCOP connection control retry count is ten retries.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the SSCOP connection control retry count to 20:
ATM(config-if)#sscop max-cc 20
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.
sscop poll-timer seconds| seconds | Number of seconds the ATM module waits between transmission of POLL PDUs. |
The default SSCOP poll timer value is 10 seconds.
Cisco IOS ATM command.
Interface configuration.
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.
This example shows how to set the SSCOP poll timer to 15 seconds:
ATM(config-if)#sscop poll-timer 15
Use the sscop rcv-window command to change the size of the SSCOP receiver window. Use the no form of this command to restore the default value.
sscop rcv-window packets| packets | Number of packets the interface receives before it sends an acknowledgment to the ATM switch. The range of packets is 1 to 6000. |
The default size of the SSCOP receiver window is 7 packets.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the size of the SSCOP receiver window to 10 packets:
ATM(config-if)#sscop rcv-window 10
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.
sscop send-window packets| packets | Number of packets the interface can send before it must receive an acknowledgment from the ATM switch. The range of packets is 1 to 6000. |
The default size of the SSCOP transmitter window is 7 packets.
Cisco IOS ATM command.
Interface configuration.
This example shows how to set the size of the SSCOP transmitter window to 10 packets:
ATM(config-if)#sscop send-window 10
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.
terminal length [screen-length]| screen-length | (Optional) Number of lines to display on-screen. The range of screen-length is 0 to 512. A value of 0 disables pausing between screens of output. |
The default screen length is 24 lines.
Cisco IOS ATM module interface command.
EXEC.
This example shows how to set the terminal length to 0 so that output scrolls on the screen without pausing:
ATM>terminal length 0
Use the write erase command to erase the configuration information in NVRAM. The NVRAM is then filled with the default configuration.
write eraseThis command has no arguments or keywords.
Cisco IOS configuration command.
EXEC.
This example shows how to erase the configuration in nonvolatile memory:
ATM#write erase
Use the write memory command to copy the configuration information in running memory to NVRAM.
write memoryThis command has no arguments or keywords.
Cisco IOS configuration command.
EXEC.
If you issue the write memory command from a bootstrap system image, a warning displays that the previous NVRAM configuration will be overwritten and some of the configuration commands will be lost unless you answer no. This warning is not displayed if NVRAM does not contain a valid configuration or if the previous configuration in NVRAM was generated by a bootstrap system image.
This example shows how to copy the current configuration information to NVRAM:
ATM#write memory ###[OK]
Use the write terminal command to display the configuration information currently in running memory.
write terminalThis command has no arguments or keywords.
Cisco IOS configuration command.
EXEC.
This example shows how to display the current configuration information:
ATM#write terminal
Building configuration...
Current configuration:
!
version 11.2
!
hostname ATM
!
!
!
interface ATM0
atm preferred phy A
atm pvc 1 0 5 qsaal
atm pvc 2 0 16 ilmi
lane client ethernet 100
!
!
line con 0
line vty 0 4
no login
!
end
ATM#
|
|