|
|
This chapter contains an alphabetical listing of all switch, ATM, and ROM monitor commands available on the Catalyst 5000 series switches.
Use the alias command to set and display aliases.
alias [name=value]
name= | (Optional) Name you give to the alias. |
value | (Optional) Value of the alias. |
This command has no default settings.
ROM monitor command.
Normal.
If value contains white space or other special (shell) characters, you must use quotation marks. If value has a space as its last character, the next command line word is checked for an alias (normally, only the first word on a command line is checked).
Without an argument, this command prints a list of all aliased names with their values.
An equal sign (=) is required between the name and value of the alias.
This example shows how to display a list of available alias commands and how to create an alias for the set command:
rommon 1 > alias
r=repeat h=history ?=help b=boot ls=dir i=reset k=stack rommon 2 > alias s=set
rommon 3 > alias
r=repeat h=history ?=help b=boot ls=dir i=reset k=stack s=set rommon 4 > s
PS1=rommon ! > BOOT=bootflash:RTSYNC_llue_11,1;slot0:f1,1; =========================================================================
Use the atm-address command to override the control ATM address. To revert to the default value, use the no form of this command.
atm-address atm-address
atm-address | Control ATM address. |
The default is an autogenerated ATM address.
IOS ATM command.
Interface configuration.
This command specifies the control ATM address used when it is associated with a hardware interface.
The following example specifies the ATM address:
ATM(config-if)#atm-address 47.0091810000000061705C2B01.00E034553024.00
ATM(config-if)#
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. |
This command has no default setting.
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 an external source.
atm clock internalThis command has no arguments or keywords.
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).
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
ATM(config-if)#
This example allows you to set the ATM module to generate the transmit clock from an external source:
ATM(config-if)#no atm clock internal
ATM(config-if)#
Use the atm ds3-scramble command to enable scrambling on the current port. Enter the no form of this command to disable scrambling.
atm ds3-scrambleThis command has no arguments or keywords.
The default is scrambling not enabled.
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
ATM(config-if)#
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 PLCP framing. |
m23plcp | (Optional) Keyword that specifies M23 with PLCP framing. |
The default value is C-bit with ADM.
IOS ATM command.
Interface configuration.
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).
The following example selects m23adm frame as the frame type:
ATM(config-if)#atm framing m23adm
ATM(config-if)#
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.
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
ATM(config-if)#
This example shows how to disable the ILMI:
ATM(config-if)#no atm ilmi-enable
ATM(config-if)#
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 3 seconds. Values less than 3 seconds are rounded to 3 seconds. There is no upper boundary to the range of values.
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
ATM(config-if)#
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.
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
ATM(config-if)#
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.
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)#
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 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 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 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.
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 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 series switch to generate and echo OAM F5 loopback cells 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
ATM(config-if)#
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
ATM(config-if)#
Use the atmsig close command to disconnect a particular SVC.
atmsig close atm0 vcd
atm0 | Keyword 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. |
This command has no default setting.
IOS ATM command.
EXEC.
This example shows how to close SVC 2 on the ATM module:
ATM#atmsig close atm0 2
ATM#
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.
atm sonet {stm-1 | sts-3c} {stm-4 | sts-12c}
no atm sonet
stm-1 | Keyword that specifies synchronous transport module level 1 (STM-1) operation. Supported by the ATM dual PHY OC-3 modules. |
sts-3c | Keyword that specifies synchronous transport signal level 3, concatenated (STS-3c) operation. Supported by the ATM dual PHY OC-3 modules. |
stm-4 | Keyword that specifies synchronous transport module level 4 (STM-4) operation. Supported by the ATM dual PHY OC-12 modules. |
sts-12c | Keyword that specifies synchronous transport signal level 12, concatenated (STS-12c) operation. Supported by the ATM dual PHY OC-12 modules. |
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.
IOS ATM command.
Interface configuration command.
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.
This example shows how to set the mode for cell-rate decoupling on the SONET PLIM to stm-1:
ATM (config-if)#atm sonet stm-1
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 this 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.
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-if)#atm traffic-shape rate 50
ATM(config-if)#
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.
IOS ATM command.
Configuration.
This example shows how to set the UNI version to 3.1:
ATM(config)#atm uni-version 3.1
ATM(config)#
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.
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
ATM(config-if)#
Use the boot command to boot up an external process.
boot [-xv] [device][imagename]
-x | (Optional) Load the image but do not execute. |
-v | (Optional) Toggle verbose mode. |
device | (Optional) ID of the device. |
imagename | (Optional) Name of the image. |
This command has no default setting.
ROM monitor command.
Normal.
With no arguments, boot will boot the first image in Flash. Specify an image by typing its name. Specify the device by typing the device ID.
If no device is given with an imagename, the image is not booted.
If a device name is not recognized by the monitor, the monitor assumes netbooting and passes the device ID to the boot helper image.
This example shows how to use the boot command:
rommon> boot -x bootflash:cat5000-sup3.3-1-180.bin
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC Uncompressing file: ####################################################################################### ####################################################################################### ######################################################################################
|
|