cc/td/doc/product/lan/cat5000/rel_4_2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Catalyst  5000 Series Switch Commands

Catalyst  5000 Series Switch Commands

This chapter contains an alphabetical listing of all switch, ATM, and ROM monitor commands available on the Catalyst  5000 series switches.

alias

Use the alias command to set and display aliases.

alias [name=value]
Syntax Description

name=

(Optional) Name you give to the alias.

value

(Optional) Value of the alias.

Default

This command has no default settings.

Command Type

ROM monitor command.

Command Mode

Normal.

Usage Guidelines

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.

Example

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;
=========================================================================
Related Command

unalias

atm-address

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
no atm-address
Syntax Description

atm-address

Control ATM address.

Default

The default is an autogenerated ATM address.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

This command specifies the control ATM address used; that is, when it is associated with a hardware interface.

Example

The following example specifies the ATM address:

ATM(config-if)#atm-address 47.0091810000000061705C2B01.00E034553024.00
ATM(config-if)#
Related Command

show atm interface atm

atm bind pvc vlan

Use the atm bind pvc vlan command to bind a PVC to a specified VLAN.

atm bind pvc vlan vcd vlan_num
Syntax Description

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.

Default

This command has no default setting.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

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.

Example

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
Related Command

show atm vc


atm clock internal

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 internal
no atm clock internal

Syntax Description

This command has no arguments or keywords.

Default

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 Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

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 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)#

atm ds3-scramble

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-scramble
no atm ds3-scramble

Syntax Description

This command has no arguments or keywords.

Default

The default is scrambling not enabled.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

This command applies to DS3 interfaces only.

Example

This example shows how to enable scrambling:

ATM(config)#interface atm0
ATM(config-if)#atm ds3-scramble
ATM(config-if)#

atm framing

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]
no atm framing [m23adm | cbitplcp | m23plcp]

Syntax Description

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.

Default

The default value is C-bit with ADM.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guidelines

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).

Example

The following example selects m23adm frame as the frame type:

ATM(config-if)#atm framing m23adm
ATM(config-if)#

atm ilmi-enable

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-enable
no atm ilmi-enable

Syntax Description

This command has no arguments or keywords.

Default

ILMI is enabled.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

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:

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)#
Related Command

show atm vc

atm ilmi-keepalive

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
no atm ilmi-keepalive
Syntax Description

seconds

Number of seconds between keepalives.

Default

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 Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Example

This example shows how to set the number of seconds between ILMI keepalives:

ATM(config-if)#atm ilmi-keepalive 5
ATM(config-if)#
Related Command

show atm vc


atm lbo

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}
Syntax Description

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).

Default

The default is short.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

The atm lbo command applies to DS3 interfaces only.

Example

This example sets the line buildout (cable length) to over 255 feet (77.4 meters):

ATM(config-if)#atm lbo long
ATM(config-if)#
Related Command

show atm vc


atm preferred phy

Use the atm preferred phy command to change the preferred PHY to the one not currently in use.

atm preferred phy {A | B}
Syntax Description

A

Keyword that indicates PHY A.

B

Keyword that indicates PHY B.

Default

The default is PHY A.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

Use this command only with the OC-12 dual PHY ATM module connected to the same or different switches.

Example

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)#
Related Command

show lane default-atm-addresses

atm pvc

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]
no atm pvc vcd vpi vci

Note This version of the atm pvc command is available only in ATM software release 50.1(1) and later and 51.1(1) and later.
atm pvc vcd vpi vci [aal5snap | ilmi | qsaal] [peak_rate average_rate [burst_size]]
     [oam seconds]
no atm pvc vcd vpi vci
Syntax Description

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.

Default

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.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

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.

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.

Examples

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)#
Related Command

show atm vc


atmsig close

Use the atmsig close command to disconnect a particular SVC.

atmsig close atm0 vcd
Syntax Description

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.

Default

This command has no default setting.

Command Type

Cisco IOS ATM command.

Command Mode

EXEC.

Example

This example shows how to close SVC 2 on the ATM module:

ATM#atmsig close atm0 2
ATM#
 

atm sonet

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

Syntax Description

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.

Default

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 Type

Cisco IOS ATM command.

Command Mode

Interface configuration command.

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.

Example

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)#

atm traffic-shape rate

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
no atm traffic-shape rate
Syntax Description

1-155

Number between 1 and 155 indicating Mbps.

Default

The default is 155 Mbps.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

This command is not supported by the ATM dual PHY OC-12 module.

Example

This example shows how to set the output throttle to 50:

ATM(config-if)#atm traffic-shape rate 50
ATM(config-if)#
 

atm uni-version

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
no atm uni-version
Syntax Description

version_num

UNI version for the interface. Valid values are 3.0 or 3.1.

Default

The default UNI version is 3.0.

Command Type

Cisco IOS ATM command.

Command Mode

Configuration.

Example

This example shows how to set the UNI version to 3.1:

ATM(config)#atm uni-version 3.1
ATM(config)#
 

atm vc-per-vp

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
no atm vc-per-vp
Syntax Description

num

Maximum number of VCIs to support per VPI. Valid values are 32, 64, 128, 256, 512, and 1024.

Default

By default, the maximum number of VCIs to support per VPI is 1024.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guidelines

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.

Example

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)#

boot

Use the boot command to boot up an external process.

boot [-xv] [device][imagename]
Syntax Description

-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.

Default

This command has no default setting.

Command Type

ROM monitor command.

Command Mode

Normal.

Usage Guidelines

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 net 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.

Example

This example shows how to use the boot command:

rommon> boot -x bootflash:cat5000-sup3.3-1-180.bin
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
Uncompressing file:  ####################################################################################################################################################################################################################################################################

hometocprevnextglossaryfeedbacksearchhelp

Copyright 1989-1999©Cisco Systems Inc.