Table of Contents

Switch CLI

Accessing the Switch CLI

Accessing the Switch CLI via the Console Port (EIA/TIA-232)
Accessing the Switch CLI via Telnet

Operating the Switch CLI

Accessing the Command Modes
Using Command-Line Processing
Using Command Aliases
Using History Substitution
Accessing Command Help
Designating Modules, Ports, and VLANs
Designating MAC Addresses, IP Addresses, and IP Aliases

Switch Commands Quick Reference
ATM CLI

Accessing the ATM CLI
Operating the ATM CLI

Accessing the Command Modes
Performing ATM Functions

ATM Commands Quick Reference
ROM Monitor CLI

Accessing the ROM Monitor CLI
Operating the ROM Monitor CLI

ROM Monitor Commands Quick Reference

Command-Line Interfaces

This chapter describes the command-line interfaces (CLI) available on the Catalyst  5000 series switch and contains the following sections:

• Switch CLI

• ATM CLI

• ROM Monitor CLI

For definitions of any terms listed in this publication, refer to Internetworking Terms and Acronyms; "Acronyms," contains a list of acronyms.

Switch CLI

The Catalyst 5000 series switch is a multimodule system. Commands you enter from the CLI can apply to the entire system or to a specific module, port, or VLAN.

You can configure and maintain the Catalyst 5000 series Ethernet, Fast Ethernet, CDDI, and FDDI modules by entering commands from the switch CLI. The CLI is a basic command-line interpreter similar to the UNIX C shell. Using the CLI session command, you can access the router configuration software and perform tasks such as history substitution and alias creation.

To configure the ATM module, you must use the ATM module CLI. For more information about the ATM module CLI, refer to the "ATM CLI" section.

Accessing the Switch CLI

You can access the switch CLI from a console terminal connected to an EIA/TIA-232 port or through a Telnet session. The CLI allows fixed baud rates. Telnet sessions disconnect automatically after remaining idle for a user-defined time period.

Accessing the Switch CLI via the Console Port (EIA/TIA-232)

To access the switch through the console (EIA/TIA-232) port, perform these steps:

Task	Command
Step 1 From the Cisco Systems Console prompt, press Return.
Step 2 At the prompt, enter the system password. The Console> prompt appears indicating that you have accessed the CLI in normal mode.	<password>
Step 3 Enter the necessary commands to complete your desired tasks.	Appropriate commands
Step 4 When finished, exit the session.	quit

After connecting through the console port, you see this display:

Cisco Systems Console
Enter password:
Console>
Console>

Accessing the Switch CLI via Telnet

To access the switch through a Telnet session, you must first set the IP address for the switch. You can open multiple sessions to the switch via Telnet.

To access the switch from a remote host with Telnet, perform these steps:

Task	Command
Step 1 From the remote host, enter the telnet command and the name or IP address of the switch you want to access.	telnet hostname | ip_addr
Step 2 At the prompt, enter the password for the CLI. If no password has been configured, press Return.	<password>
Step 3 Enter the necessary commands to complete your desired tasks.	Appropriate commands
Step 4 When finished, exit the Telnet session.	quit

After connecting through a Telnet session, you see this display:

host% telnet cat5000-1.cisco.com
Trying 172.16.44.30 ...
Connected to cat5000-1.

Operating the Switch CLI

This section describes command modes and functions that allow you to operate the switch CLI.

Accessing the Command Modes

The CLI has two modes of operation: normal and privileged. Both are password-protected. Use normal-mode commands for everyday system monitoring. Use privileged commands for system configuration and basic troubleshooting.

After you log in, the system enters normal mode, which gives you access to normal-mode commands only. You can enter privileged mode by entering the enable command followed by the enable password. Privileged mode is indicated by the word "enable" in the system prompt. To return to normal mode, enter the disable command at the prompt.

The following example shows how to enter privileged mode:

Console> enable
Enter password: <password>
Console> (enable)

Using Command-Line Processing

Switch commands are not case sensitive. Commands and parameters can be abbreviated as long as they contain enough letters to be unique relative to any other currently available commands or parameters. (See Table 1-1.)

Using Command Aliases

Like regular commands, aliases are not case sensitive. However, unlike regular commands, some aliases cannot be abbreviated. (See Table 1-2.)

Using History Substitution

Commands that you enter during each terminal session are stored in a history buffer, which stores the last 20 commands entered during a terminal session. History substitution allows you to access these commands without retyping them, by using special abbreviated commands. (See Table 1-3.)

Accessing Command Help

To see a list of top-level commands and command categories, type help or ? in normal or privileged mode. Context-sensitive help (usage and syntax information) for individual commands can be seen by appending help or ? to any specific command. If you enter a command using the wrong number of arguments or inappropriate arguments, usage and syntax information for that command is displayed. Additionally, appending help or ? to a command category displays a list of commands in that category.

Console> ?
Commands:
----------------------------------------------------------------------
enable              Enable privileged mode
 

Console> (enable) ?
Commands:
----------------------------------------------------------------------
clear               Clear, use 'clear help' for more info
configure           Configure system from terminal/network
disable             Disable privileged mode

Console> (enable) clear help
 
Clear commands:
----------------------------------------------------------------------------
clear alias         Clear aliases of commands
clear arp           Clear ARP table entries
clear banner        Clear Message Of The Day banner
 

clear               Clear, use `clear help' for more info
set                 Set, use `set help' for more info
 
clear ip            Clear IP, use `clear ip help' for more info
 
set bridge          Set bridge, use `set bridge help' for more info
set cdp             Set cdp, use `set cdp help' for more info
 
test help           Show this message
test snmp           Send trap message to SNMP trap receivers

Designating Modules, Ports, and VLANs

The Catalyst 5000 series modules (module slots), ports, and VLANs are numbered starting with 1. The supervisor module is module 1, residing in the top slot. If you are using a Catalyst 5505 switch or a Catalyst 5500 switch with a redundant supervisor engine, the supervisor modules reside in slots 1 and 2. On each module, port 1 is the left-most port. To reference a specific port on a specific module, the command syntax is mod_num/port_num. For example, 3/1 denotes module 3, port 1. In some commands, such as set trunk, set cam, and set vlan, you can enter lists of ports and VLANs.

You can designate ports by entering the module and port number pairs, separated by commas. To specify a range of ports, use a dash (-) between the module number and port number pairs. Dashes take precedence over commas. The following examples show several ways of designating ports:

Example 1: 2/1,2/3 denotes module 2, port 1 and module 2, port 3.

Example 2: 2/1-12 denotes module 2, ports 1 through 12.

Example 3: 2/1-2/12 also denotes module 2, ports 1 through 12.

Each VLAN is designated by a single number. You can specify lists of VLANs the same way you do for ports. Individual VLANs are separated by commas (,); ranges are separated by dashes (-). In the following example, VLANs 1 through 10 and VLAN 1000 are specified:

1-10,1000	

Designating MAC Addresses, IP Addresses, and IP Aliases

Some commands require a MAC address, IP address, or IP alias, which you must designate in a standard format. The MAC address format must be six hexadecimal numbers separated by hyphens, as shown in this example:

00-00-0c-24-d2-fe
 

The IP address format is 32 bits, written as four octets separated by periods (dotted decimal format). IP addresses are made up of a network section, an optional subnet section, and a host section, as shown in this example:

126.2.54.1
 

If the IP alias table is configured, you can use IP aliases in place of the dotted decimal IP address. This is true for most commands that use an IP address, except commands that define the IP address or IP alias.

Switch Commands Quick Reference

Table 1-4 identifies each command in the switch command set, shows the command syntax, provides a short description, and specifies the mode for the command.

Table 1-4: Switch Command Set

Command	Syntax	Description	Mode1
cd	cd [[m/]device:]	Sets the default Flash device.	P
clear alias	clear alias {name | all}	Clears the specified alias of a command.	P
clear arp	clear arp {ip_addr | all}	Clears ARP table entries.	P
clear banner motd	clear banner motd	Clears the message-of-the-day banner.	P
clear boot	clear boot [mod_num]	Clears the boot value.	P
clear cam	clear cam {mac_addr | dynamic | static | permanent} [vlan_num]	Clears CAM table entries.	P
clear cgmp statistics	clear cgmp statistics	Clears CGMP statistical information.	P
clear config	clear config {mod_num | rmon | all}	Clears the configuration and resets the system.	P
clear counters	clear counters	Clears MAC and port counters.	P
clear drip statistics	clear drip statistics	Clears DRiP statistical information.	P
clear igmp statistics	clear igmp statistics	Clears IGMP statistical information.	P
clear ip alias	clear ip alias {name | all}	Clears IP address aliases.	P
clear ip dns domain	clear ip dns domain	Clears the default DNS domain name.	P
clear ip dns server	clear ip dns server {ip_addr | all}	Clears the IP address of a DNS server.	P
clear ip permit	clear ip permit {ip_addr | all}[mask]	Clears hosts from the IP permit list.	P
clear ip route	clear ip route destination gateway	Clears IP routing table entries.	P
clear log	clear log [mod_num]	Deletes all entries in the system error log.	P
clear logging buffer	clear logging buffer	Clears the system logging buffer.	P
clear logging server	clear logging server ip_addr	Deletes a syslog server from the configuration.	P
clear mls	clear mls include {{ip_addr}| all} clear mls nde flow clear mls statistics clear mls entry {[destination {ip_addr_spec}] [source {ip_addr_spec}] | [flow  {protocol} {src_port} {dst_port}] | all}	Clears the MLS feature in the Catalyst  5000 series switch.	P
clear multicast router	clear multicast router {mod_num/port_num | all}	Clears multicast router ports.	P
clear ntp server	clear ntp server {ip_addr | all}	Deletes an NTP server from the server table.	P
clear port broadcast	clear port broadcast mod_num/port_num	Disables broadcast/multicast suppression on one or more ports.	P
clear port filter	clear port filter [mod_num/port_num] [mac_addr | protocol_type | all]	Clears all configured MAC addresses or protocol filters or those filters configured on a specific port.	P
clear snmp trap	clear snmp trap {rcvr_addr | all}	Clears SNMP trap receiver addresses.	P
clear spantree portvlancost	clear spantree portvlancost mod_num/port_num [vlan_list]	Clears spanning-tree path cost to a VLAN on a port.	P
clear spantree portvlanpri	clear spantree portvlanpri mod_num/port_num [vlans]	Clears spanning-tree port VLAN priority.	P
clear spantree root	clear spantree root [vlan_list]	Restores the switch priority and Spanning-Tree Protocol parameters to the default values.	P
clear spantree statistics	clear spantree statistics [vlan_list]	Clears spanning-tree statistics.	P
clear spantree uplinkfast	clear spantree uplinkfast	Turns off the uplinkfast features and returns the switch priority and port costs to the factory default values.	P
clear tacacs key	clear tacacs key	Clears the key used for TACACS+ authentication and encryption.	P
clear tacacs server	clear tacacs server ip_addr	Removes a host from the list of TACACS+ servers.	P
clear timezone	clear timezone	Clears NTP time zone information.	P
clear top	clear top {all | report_num}	Stops the TopN process.	P
clear trunk	clear trunk mod_num/port_num [vlans]	Resets trunk ports and clears information from the trunk table.	P
clear vlan	clear vlan vlan_num	Deletes a VLAN from a management domain.	P
clear vmps server	clear vmps server ip_addr	Removes a VMPS server from the VMPS table.	P
clear vmps statistics	clear vmps statistics	Deletes VMPS statistics.	P
clear vtp pruneeligible	clear vtp pruneeligible vlan_num	Turns off the pruning eligibility of a VLAN.	P
clear vtp statistics	clear vtp statistics	Deletes VTP statistics.	P
configure	configure {host file | network}	Downloads a configuration file from the network and executes each command in the file.	P
copy	copy file-id {tftp | flash | file-id | config} copy tftp2 {flash | file-id | config} copy flash {tftp | file-id | config} copy config {flash | file-id | tftp}	Copies software images between a Supervisor Engine III and a host.	P
delete	delete [[m/]device:] filename	Deletes a file.	P
dirswitch	dir [[m/]device:][filename] [all | deleted | long]	Displays a list of files on a Flash device (switch command).	N2
disableswitch	disable	Returns the CLI to normal mode.	P
disconnect	disconnect {ip_addr | console}	Closes an active console port or Telnet session.	P
download	download {serial | host file} [mod_num]	Copies a software image from a host to a module's Flash memory.	P
download vmps	download vmps	Downloads VMPS database information.	P
enableswitch	enable	Activates CLI privileged mode.	N
format	format [spare spare-num] [m/]device1: [[device2:][monlib_filename]]	Formats a Flash device.	P
historyswitch	history	Shows the contents of the command history buffer.	N2
ping	ping [-s] host [packet_size] [packet_count]	Sends ICMP echo request packets to another node on the network.	N
pwd	pwd [[m/]device:]	Shows the current setting of the cd command.	P
quit	quit	Exits the CLI session.	N
reconfirm vmps	reconfirm vmps	Reconfirms the current dynamic port VLAN membership with VMPS.	P
reloadswitch	reload mod_num	Forces a Gigabit EtherChannel Switching Module to accept a download.	P
resetswitch	reset {mod_num | system}	Sets the system to its default values or configures the system as an individual module.	P2
session	session mod_num	Connects the CLI to a session on a module (such as the ATM or RSM modules).	P2
set alias	set alias name command [parameter] [parameter]	Creates an alias for a command.	P
set arp	set arp ip_addr hw_addr [route_descr] | agingtime agingtime	Creates an ARP table entry and sets the ARP entry aging time.	P
set authentication enable	set authentication enable {tacacs | local} {enable | disable}	Sets TACACS+ enable authentication (for privileged mode access).	P
set authentication login	set authentication login {tacacs  | local} {enable | disable}	Sets TACACS+ login authentication (for login access).	P
set banner motd	set banner motd c [text] c	Sets the message-of-the-day banner.	P
set boot config-register	set boot config-register 0xvalue [mod_num] set boot config-register baud [1200 | 2400 | 4800 | 9600] [mod_num] set boot config-register ignore-config [enable | disable] [mod_num] set boot config-register boot [rommon | bootflash | system] [mod_num]	Sets the boot configuration register attributes.	P
set boot system flash	set boot system flash device:[filename][prepend] [mod_num]	Sets the boot system flash device.	P
set bridge apart	set bridge apart {enable | disable}	Enables or disables APaRT on FDDI.	P
set bridge fddicheck	set bridge fddicheck {enable | disable}	Enables or disables FDDICHECK on FDDI.	P
set bridge ipx 8022toether	set bridge ipx 8022toether {8023 | snap | eii | 8023raw}	Sets the default mode for translating IPX frames from FDDI 802.2 to Ethernet.	P
set bridge ipx 8023rawtofddi	set bridge ipx 8023rawtofddi {8022 | snap | fddiraw}	Sets the default mode for translating IPX frames from Ethernet 802.3 raw to FDDI.	P
set bridge ipx snaptoether	set bridge ipx snaptoether {8023 | snap | eii | 8023raw}	Sets the default mode for translating IPX FDDI SNAP frames to Ethernet frames.	P
set cam	set cam {dynamic | static | permanent} {unicast_mac | multicast_mac | route_descr} mod_num/port_nums [vlan] set cam agingtime vlan agingtime	Creates a CAM table entry and sets the CAM aging time.	P
set cdp	set cdp {enable | disable} {mod_num/port_num | all}	Enables or disables CDP on a port.	P
set cdp interval	set cdp interval {mod_num/port_num | all} interval	Sets the message interval for CDP.	P
set cgmp	set cgmp {enable | disable}	Enables or disables CGMP.	P
set cgmp leave	set cgmp leave {enable | disable}	Enables or disables CGMP leave processing.	P
set enablepass	set enablepass	Sets the enable (privileged) password.	P
set fddi alarm	set fddi alarm mod_num/port_num value	Sets the LER-alarm value.	P
set fddi cutoff	set fddi cutoff mod_num/port_num value	Sets the LER-cutoff value.	P
set fddi tlmin	set fddi tlmin mod_num/port_num microseconds	Sets the TL_MIN value for an FDDI port.	P
set fddi tnotify	set fddi tnotify mod_num time	Sets the T_Notify timer value for an FDDI port.	P
set fddi treq	set fddi treq mod_num time	Sets the TRequest value for an FDDI module.	P
set fddi userdata	set fddi userdata mod_num [userdata_string]	Sets the user-data string in the SMT MIB of an FDDI module.	P
set igmp	set igmp {enable | disable}	Enables or disables IGMP snooping on the switch.	P
set interface	set interface {sc0 | sl0} {up | down} set interface sc0 [vlan] [ip_addr [netmask [broadcast]]] set interface sl0 slip_addr dest_addr	Sets a network interface configuration.	P
set ip alias	set ip alias name ip_addr	Creates an alias for an IP address.	P
set ip dns	set ip dns {enable | disable}	Enables or disables DNS.	P
set ip dns domain	set ip dns domain name	Sets the default DNS domain name.	P
set ip dns server	set ip dns server ip_addr [primary]	Sets the IP address of a DNS server.	P
set ip fragmentation	set ip fragmentation {enable | disable}	Enables or disables IP fragmentation for packets bridged between FDDI and Ethernet networks.	P
set ip permit	set ip permit {enable | disable} set ip permit ip_addr [mask]	Enables or disables the IP permit list and creates entries in the IP permit list.	P
set ip redirect	set ip redirect {enable | disable}	Enables or disables ICMP redirect messages.	P
set ip route	set ip route destination gateway [metric] [primary]	Adds entries to the IP routing table.	P
set ip unreachable	set ip unreachable {enable | disable}	Enables or disables ICMP unreachable messages.	P
set length	set length number [default]	Sets the number of lines in the terminal display screen.	N
set logging console	set logging console {enable | disable}	Enables and disables system message logging to the console.	P
set logging level	set logging level facility severity [default]	Sets the facility and severity level for system message logging.	P
set logging server	set logging server {enable | disable} set logging server ip_addr	Enables or disables system message logging to syslog servers and adds syslog servers to the system logging server table.	P
set logging session	set logging session {enable | disable}	Enables and disables system logging messages to the current login session.	P
set logout	set logout timeout	Sets the number of minutes before an automatic logout.	P
set mls	set mls agingtime [agingtime] set mls disable set mls enable set mls include {route_processor_ip | route_processor_name} set mls statistics protocol protocol port_num	Configures the MLS feature in the Catalyst  5000 series switch.	P
set mls agingtime fast	set mls agingtime fast [fastagingtime] [pkt_threshold]	Configures the MLS fast-aging time feature in the Catalyst  5000 series switch.	P
set mls flow	set mls flow destination | destination-source | full	Specifies the minimum flow mask used for MLS.	P
set mls nde	set mls nde {disable | enable} set mls nde {collector_ip | collector_name} {udp_port_num} set mls nde flow [destination ip_addr_spec] [source ip_addr_spec] [protocol protocol] [src_port port_number] [dst_port port_number]	Configures the NDE feature to allow command exporting statistics to the preconfigured collector.	P
set module disable	set module disable mod_num	Disables a module.	P
set module enable	set module enable mod_num	Enables a module.	P
set module name	set module name mod_num [mod_name]	Sets the name of a module.	P
set multicast router	set multicast router mod_num/port_num	Configures multicast router ports.	P
set ntp broadcastclient	set ntp broadcastclient {enable | disable}	Enables or disables NTP in broadcast-client mode.	P
set ntp broadcastdelay	set ntp broadcastdelay microseconds	Configures a delay for the receiving of broadcast NTP packets.	P
set ntp client	set ntp client {enable | disable}	Enables or disables the switch as an NTP client.	P
set ntp server	set ntp server ip_addr	Configures the IP address of the NTP server.	P
set password	set password	Sets the console password.	P
set port broadcast	set port broadcast mod_num/port_num threshold[%]	Sets the broadcast/multicast suppression for one or more ports.	P
set port channel	set port channel [port_list] {on | off | desirable | auto}	Enables or disables Fast EtherChannel on two or more ports.	P
set port disable	set port disable mod_num/port_num	Disables a port.	P
set port duplex	set port duplex mod_num/port_num {full | half | auto}	Sets the port duplex mode.	P
set port enable	set port enable mod_num/port_num	Enables a port or a range of ports.	P
set port filter	set port filter mod_num/port_num {mac_addr | protocol_type} {permit | deny}	Configures a MAC address filter or a protocol filter.	P
set port flowcontrol	set port flowcontrol {receive | send} [mod_num/port_num] {off | on | desired}	Sets the receive flow-control value for a particular port.	P
set port level	set port level mod_num/port_num {normal | high}	Sets the priority level of a port.	P
set port membership	set port membership mod_num/port_num {dynamic | static}	Dynamically or statically assigns a port to a VLAN membership.	P
set port name	set port name mod_num/port_num [name_string]	Sets the name of a port.	P
set port negotiation	set port negotiation mod_num/port_num {enable | disable}	Sets the link negotiation protocol for a port.	P
set port protocol	set port protocol mod_num/port_num {ip | ipx | group} {on | off | auto}	Enables or disables protocol membership of ports.	P
set port security	set port security mod_num/port_num {enable | disable} [mac_addr]	Enables or disables port security on a port of an Ethernet module.	P
set port speed	set port speed mod_num/port_num {4 | 10 | 16 | 100 | auto}	Sets the port speed.	P
set port trap	set port trap mod_num/port_num {enable | disable}	Enables or disables the standard SNMP link trap (up or down) for a port.	P
set prompt	set prompt prompt_string	Sets the CLI prompt.	P
set protocolfilter	set protocolfilter {enable | disable}	Activates or deactivates protocol filtering.	P
set rsmautostate	set rsmautostate {enable | disable}	Sets the line protocol state determination of the RSM(s) due to Catalyst 5000 series port state changes.	P
set snmp community	set snmp community {read-only | read-write | read-write-all} [community_string]	Sets SNMP communities and associated access types.	P
set snmp rmon	set snmp rmon {enable | disable}	Enables or disables SNMP RMON support.	P
set snmp trap	set snmp trap {enable | disable} [all | module | chassis | bridge | repeater | auth | vtp | ippermit | vmps | config | entity | stpx] set snmp trap rcvr_addr rcvr_community	Enables or disables SNMP traps. Also sets the SNMP trap receiver address and community.	P
set span	set span enable set span disable set span {src_mod/src_ports} {dest_mod/dest_port} [rx | tx | both] [inpkts {enable | disable} set span {src_vlan} {dest_mod/dest_port} [rx  |  tx  |  both] [inpkts {enable | disable}	Enables or disables SPAN. Also sets the source and destination SPAN ports.	P
set spantree backbonefast	set spantree backbonefast {enable | disable}	Enables or disables the Spanning-Tree Backbone Fast Convergence feature.	P
set spantree disable	set spantree disable [vlan]	Disables spanning tree.	P
set spantree enable	set spantree enable [vlan]	Enables spanning tree.	P
set spantree fwddelay	set spantree fwddelay delay [vlan]	Sets the bridge forward delay for a VLAN.	P
set spantree hello	set spantree hello interval [vlan]	Sets the bridge hello interval for a VLAN.	P
set spantree maxage	set spantree maxage agingtime [vlan]	Sets the bridge maximum aging time for a VLAN.	P
set spantree multicast-address	set spantree multicast-address trbrf_num {ieee  |  ibm}	Specifies the bridge functional address instead of the IEEE Spanning-Tree Protocol address.	P
set spantree portcost	set spantree portcost {mod_num/port_num | trcf} cost	Sets the bridge path cost for a port.	P
set spantree portfast	set spantree portfast mod_num/port_num {enable | disable}	Enables or disables fast-start mode on a port.	P
set spantree portpri	set spantree portpri {mod_num/port_num | trcrf} [priority | trcrf_priority]	Sets the bridge priority for a spanning-tree port.	P
set spantree portstate	set spantree portstate trcf {block | forward | auto} [trbrf]	Sets the forwarding state for a spanning-tree port.	P
set spantree portvlancost	set spantree portvlancost mod_num/port_num [cost cost] [vlan_list]	Assigns a lower path cost to a set of VLANs on a port.	P
set spantree portvlanpri	set spantree portvlanpri mod_num/port_num priority [vlans]	Sets the port priority for a subset of VLANs in the trunk port.	P
set spantree priority	set spantree priority bridge_priority [vlan]	Sets the bridge priority for a VLAN.	P
set spantree root	set spantree root [secondary] [vlan_list] [dia network_diameter] [hello hello_time]	Sets the primary or secondary root for specific VLANs or for all VLANs of the switch.	P
set spantree uplinkfast	set spantree uplinkfast {enable | disable} [rate station_update_rate]	Enables fast switchover to alternate ports when the root port fails.	P
set summertime	set summertime {enable | disable} [zone]	Sets the clock adjustment for daylight saving time.	P
set system baud	set system baud rate	Sets the console port baud rate.	P
set system contact	set system contact [contact_string]	Sets the system contact information.	P
set system location	set system location [location_string]	Sets the system location information.	P
set system modem	set system modem {enable | disable}	Enables or disables modem control lines on the console port.	P
set system name	set system name [name_string]	Sets the system name.	P
set tacacs attempts	set tacacs attempts count	Sets the maximum number of TACACS+ login attempts allowed.	P
set tacacs directedrequest	set tacacs directedrequest {enable | disable}	Sets the TACACS+ directed-request option.	P
set tacacs key	set tacacs key key	Sets the TACACS+ authentication and encryption key.	P
set tacacs server	set tacacs server ip_addr [primary]	Sets the IP address of TACACS+ servers.	P
set tacacs timeout	set tacacs timeout seconds	Sets the response timeout interval for the TACACS+ server daemon.	P
set time	set time [day_of_week] [mm/dd/yy] [hh:mm:ss]	Sets the system time.	P
set timezone	set timezone [zone_name] [hours [minutes]]	Sets the time zone.	P
set tokenring acbits	set tokenring acbits mod_num/port_num {enable | disable}	Sets whether AC bits are set unconditionally when a port forwards certain LLC frames.	P
set tokenring configloss	set tokenring configloss mod_num/port_num [threshold thresh_num] [interval int_num]	Sets thresholds that, when exceeded, cause the port to be administratively disabled.	P
set tokenring distrib-crf	set tokenring distrib-crf {enable | disable}	Enables or disables distribution of TrCRF VLANs.	P
set tokenring etr	set tokenring etr mod_num/port_num {enable | disable}	Enables or disables the early token release procedure when transmitting frames.	P
set tokenring portmode	set tokenring portmode mod_num/port_num {auto | fdxcport | hdxcport | fdxstation | hdxstation | riro}	Specifies the connection type and access protocol used by a port.	P
set tokenring priority	set tokenring priority mod_num/port_num {threshold thresh_num | minxmit min_num}	Specifies the highest and lowest Token Ring frame priority.	P
set tokenring reduction	set tokenring reduction {enable | disable}	Reduces broadcast storms in an externally looped network.	P
set trunk	set trunk mod_num/port_num [on | off | desirable | auto | nonegotiate] [vlan_range] [isl | dot1q | dot10 | lane | negotiate]	Configures trunk ports.	P
set vlan	set vlan vlan_num mod_num/port_list set vlan vlan_num [name name] [type {ethernet | fddi | fddinet | trcrf | trbrf}] [state {active | suspend}] [said said] [mtu mtu] [ring hex_ring_number ] [decring decimal_ring_number] [bridge bridge_num] [parent  vlan_num] [mode {srt | srb}] [stp {ieee | ibm}] [translation vlan_num] [backupcrf {off | on}] [aremaxhop hop_count] [stemaxhop hop_count]	Creates and configures options for VLANs.	P
set vmps server	set vmps server ip_addr [primary]	Sets the IP address of the VMPS server.	P
set vmps state	set vmps state {enable | disable}	Enables or disables VMPS.	P
set vmps tftpserver	set vmps tftpserver ip_addr [filename]	Specifies the IP address of the VMPS TFTP server.	P
set vtp	set vtp [domain_name] [mode {client | server | transparent}] [passwd passwd] [pruning  {enable | disable}] [v2 {enable | disable}]	Sets VTP options.	P
set vtp pruneeligible	set vtp pruneeligible vlan_range	Configures pruning eligibility for the device.	P
show alias	show alias [name]	Shows aliases for commands.	N
show arp	show arp [ip_addr | hostname][noalias]	Shows the ARP table.	N
show boot	show boot [mod_num]	Displays the contents of the BOOT and BOOTLDR environment variables and the configuration register setting.	N
show bridge	show bridge	Displays bridge information.	N
show cam	show cam [count]{dynamic | static | permanent | system} [vlan] show cam {dynamic | static | permanent} mod_num | port_num show cam mac_addr [vlan]	Shows the CAM table.	N
show cam agingtime	show cam agingtime	Shows CAM aging time information for all configured VLANs.	N
show cam mlsrp	show cam mlsrp {ip_addr}[vlan]	Shows the specified router entries in the MLS forwarding table.	N
show cdp	show cdp neighbors [mod_num[/port_num]] [detail] show cdp port [mod_num[/port_num]]	Shows CDP information.	N
show cgmp leave	show cgmp leave	Displays CGMP leave feature statistical information.	N
show cgmp statistics	show cgmp statistics [vlan_id]	Displays CGMP statistical information.	N
show config	show config	Shows the current system configuration.	P
show counters	show counters mod_num/port_num	Displays hardware counters for a port.	N
show drip statistics	show drip statistics	Displays DRiP statistical information.	P
show dvlan statistics	show dvlan statistics	Displays DVLAN statistical information.	N
show fddi	show fddi	Displays the settings of the FDDI/CDDI modules.	N
show fddicam	show fddicam mod_num [fddi] [mac_addr]	Displays the CAM table for the FDDI/CDDI modules.	N
show flash	show flash [[m/]device:] [all | chips | filesys]	Lists Flash code information.	N
show igmp statistics	show igmp statistics [vlan_id]	Displays IGMP statistics for a particular VLAN.	N
show interface	show interface	Shows information about network interfaces.	N
show ip alias	show ip alias [name]	Shows aliases for IP addresses.	N
show ip dns	show ip dns	Shows the DNS name server and the default domain name.	N
show ip permit	show ip permit [noalias]	Shows IP permit list information.	N
show ip route	show ip route [noalias]	Displays the IP routing table.	N
show log	show log [mod_num]	Displays system and module error logs.	N
show logging	show logging	Displays the system message log configuration.	N
show logging buffer	show logging buffer [-] [number_of_messages]	Displays system messages from the internal buffer.	N
show mac	show mac [mod_num[/port_num]]	Shows MAC counters.	N
show microcode	show microcode	Displays the switch microcode version.	N
show mls	show mls show mls rp {ip_addr} [noalias] show mls entry {[destination {ip_addr_spec}] [source {ip_addr_spec}] | [flow  {protocol} {src_port [port_num]} {dst_port}]} [rp {ip_addr} show mls include show mls nde	Displays MLS shortcut information.	N
show mls debug	show mls debug	Displays a list of all MLS-related debugging information.	P
show mls statistics	show mls statistics protocol show mls statistics rp [ip_addr] [noalias] show mls statistics entry [destination {ip_addr_spec}] [source {ip_addr_spec}] | [flow  {protocol} {src_port} {dst_port}]}	Displays MLS statistical information.	N
show module	show module [mod_num]	Shows module information.	N
show multicast group	show multicast group [cgmp | igmp] [mac_addr] [vlan_id]	Displays the multicast group configuration.	N
show multicast group count	show multicast group count [cgmp | igmp] [vlan_id]	Shows the total count of multicast addresses (groups) in a VLAN.	N
show multicast router	show multicast router [cgmp | igmp] [mod_num/port_num] [vlan_id]	Displays the multicast router configuration.	N
show netstat	show netstat [tcp | udp | ip | icmp | routes | stats | interfaces]	Shows currently active network connections and network statistics for the TCP/IP stack.	N
show ntp	show ntp	Displays the current NTP status.	N
show port	show port [mod_num[/port_num]]	Shows port status and counters.	N
show port broadcast	show port broadcast [mod_num[/port_num]]	Displays broadcast information.	N
show port capabilities	show port capabilities [mod_num[/port_num]]	Displays the capabilities of the modules and ports in a switch.	N
show port cdp	show port cdp [mod_num[/port_num]]	Displays port CDP information.	N
show port channel	show port channel [mod_num[/port_num][info | statistics]	Shows Fast EtherChannel information.	N
show port counters	show port counters [mod_num/port_num]	Displays the counters for a port.	N
show port filter	show port filter [mod_num] [canonical] show port filter mod_num/port_num [canonical] show port filter mac_addr [canonical]	Displays configured MAC address and protocol filters.	N
show port flowcontrol	show port flowcontrol [mod_num[/port_num]]	Displays per port flow control status and statistics.	N
show port negotiation	show port negotiation [mod_num[/port_num]]	Displays the link negotiation protocol setting for the specified port.	N
show port protocol	show port protocol [mod_num[/port_num]]	Displays protocol filters.	N
show port status	show port status [mod_num[/port_num]]	Displays port status information.	N
show protocolfilter	show protocolfilter	Displays enabled or disabled status of protocol filters.	N
show rif	show rif [vlan_num]	Displays RIF information.	N
show rsmautostate	show rsmautostate mod_num	Displays the line protocol state determination of the RSM(s).	N
show snmp	show snmp [noalias]	Shows SNMP information.	N
show span	show span	Shows SPAN port monitoring information.	N
show spantree	show spantree [vlan | mod_num/port_num] show spantree backbonefast show spantree blockedports [vlan_num] show spantree portstate [trcrf] show spantree portvlancost mod_num/port_num show spantree statistics mod_num/port_num [vlan] show spantree statistics {trcrf} {trbrf} show spantree summary show spantree uplinkfast	Shows spanning-tree information.	N
show station controltable	show station controltable [mod_num[/port_num]]	Displays a collection of statistics and status information associated with each Token Ring station on the local ring.	N
show station ordertable	show station ordertable [mod_num[/port_num]]	Displays a listing of the order of stations on the monitored rings.	N
show summertime	show summertime	Displays the current status of the summertime feature.	N
show system	show system	Shows system information.	N
show tacacs	show tacacs [noalias]	Displays the TACACS+ configuration.	N
show test	show test [mod_num]	Shows the results of diagnostic tests.	N
show time	show time	Shows the current system time.	N
show timezone	show timezone	Shows the current time zone and offset.	N
show tokenring	show tokenring	Displays various Token Ring configuration parameters.	N
show top	show top [N] [metric] [interval interval] [port_type] [background]	Starts the TopN process.	N
show top report	show top report [report_num]	Lists all TopN processes and specific TopN reports.	N
show traffic	show traffic	Displays traffic/peak information.	N
show trunk	show trunk [mod_num[/port_num]][detail]	Shows trunking information for the switch.	N
show users	show users [noalias]	Shows whether the console port is active. Also lists all active Telnet sessions.	N
show versionswitch	show version	Shows software and hardware version information.	N
show vlan	show vlan [vlan] [trunk | notrunk]	Shows VLAN information.	N
show vmps	show vmps [noalias]	Displays VMPS configuration information.	N
show vmps mac	show vmps mac [mac_addr]	Displays the MAC-address-to-VLAN mapping table.	N
show vmps statistics	show vmps statistics	Displays VMPS statistics.	N
show vmps vlan	show vmps vlan vlan_name	Displays MAC address to VLAN mappings in the VMPS table.	N
show vmps vlanports	show vmps vlanports vlan_name	Displays ports belonging to a restricted VLAN.	N
show vtp domain	show vtp domain	Shows VTP domain information.	N
show vtp statistics	show vtp statistics	Shows VTP statistics.	N
slip	slip {attach | detach}	Attaches or detaches SLIP for the console port.	P
squeeze	squeeze [m/]device:	Permanently deletes Flash files.	P
switch	switch {clock | supervisor}	Switches between clocks or from the active to the standby supervisor.	P
telnet	telnet host [port_num]	Starts a Telnet connection to a remote host.	P
test snmp trap	test snmp trap trap_num [specific_num]	Sends an SNMP trap message to the trap receivers.	P
traceroute	traceroute [-n] [-w wait_time] [-i initial_ttl] [-m  max_ttl] [-p dest_port] [-q nqueries] [-t tos] host [data_size]	Displays a hop-by-hop path through an IP network from the Catalyst  5000 series switch to a specific destination host.	P
undelete	undelete index [[m/]device:]	Undeletes a file.	P
upload	upload host file [mod_num]	Uploads a software image to a network host.	P
verify	verify[[m/]device:] filename	Verifies the checksum of a file on a Flash device.	N
wait	wait seconds	Causes the CLI to pause for a specified number of seconds.	N
whichboot	whichboot	Displays the name of the active boot device.	N
write	write {host file | network | terminal}	Uploads the current configuration to a host or displays it on the terminal.	P
write erase	write erase	Erases the configuration information in NVRAM.	P
write memory	write memory	Copies the configuration information in running memory to NVRAM.	P
write terminal	write terminal	Displays the system configuration information currently in running memory.	P

1P=Privileged; N=Normal 2This command is not supported by the ATM  dual PHY OC-12 module, ATM software release 4.3(0).

ATM CLI

You can configure and maintain the Catalyst 5000 series ATM module by entering commands from the ATM module CLI. The ATM module CLI uses a subset of the Cisco IOS software commands. Generally, Cisco IOS software works the same on the ATM module as it does on routers.

Accessing the ATM CLI

You can open a session with the ATM module on a Catalyst 5000 series switch by using the session mod_num command from the switch CLI Console> prompt. After you enter this command, the switch responds with the Enter Password prompt. Enter atm as the default password. At this point, you are at the ATM> prompt, and you have direct access only to the ATM module with which you have established a session.

This example shows how to establish a session with the ATM module (in this case, module  5):

Console> (enable) session 5
Trying ATM-5...
Connected to ATM-5.
Escape character is '^]'.
 
ATM>

Operating the ATM CLI

This section describes the command modes and functions that allow you to access and operate the ATM module CLI.

Accessing the Command Modes

This section describes how to access and list the commands available in each of the command modes available in the Cisco IOS user interface and explains the primary uses for each command mode.

Cisco IOS software provides two levels of access to commands: user and privileged (see Table 1-5.) The user mode is called user EXEC mode. The privileged mode is called privileged EXEC mode. The default password to access the privileged EXEC mode on the ATM module is atm. The commands available in user EXEC mode are a subset of those available in privileged EXEC mode.

Table 1-5: ATM Module Command Modes

Command Mode	Access Method	Prompt	Exit Method
User EXEC	Use the session command in the switch CLI.	ATM>	Enter the logout command.
Privileged EXEC	From user EXEC mode, enter the enable EXEC command. Enter the enable password at the prompt (default is atm).	ATM#	Enter the disable command.

User EXEC Mode

Privileged EXEC Mode

Global Configuration Mode

Configuring from terminal, memory, or network [terminal]?

Interface Configuration Mode

Line Configuration Mode

Performing ATM Functions

This section describes how to perform ATM-related tasks on the Catalyst 5000 series ATM module.

Getting Context-Sensitive Help

Entering a question mark (?) at the system prompt displays a list of commands available for each command mode. You can also use ? to see a list of the keywords and arguments associated with a command.

Checking Command Syntax

Using the Command History Features

Using the Editing Features

Ending a Session

ATM Commands Quick Reference

Table 1-6 identifies each command in the ATM module command set, gives the command syntax, provides a short description, and specifies the command type and mode.

Table 1-6: ATM Module Command Set

Command	Syntax	Description	Type1	Mode2
atm-address	atm-address atm-address	Overrides the control ATM address.	ATM	IC
atm bind pvc vlan	atm bind pvc vlan vcd vlan_num	Binds a PVC to a specified VLAN.	ATM	IC
atm clock internal3	atm clock internal no atm clock internal	Specifies the transmit clock source.	ATM	IC
atm ds3-scramble	atm ds-3 scramble no atm ds-3 scramble	Enables or disables scrambling on the current port.	ATM	IC
atm framing	atm framing [m23adm | cbitplcp | m23plcp] no atm framing	Changes the default DS3 line framing.	ATM	IC
atm ilmi-enable	atm ilmi-enable no atm ilmi-enable	Enables or disables the ILMI.	ATM	IC
atm ilmi-keepalive	atm ilmi-keepalive seconds no atm ilmi-keepalive seconds	Enables ILMI keepalives.	ATM	IC
atm lbo	atm lbo {short | long}	Sets the line buildout corresponding to the cable length.	ATM	IC
atm preferred phy	atm preferred phy {A | B}	Changes the preferred PHY.	ATM	IC
atm pvc	atm pvc vcd vpi vci [aal5snap | ilmi | qsaal] atm pvc vcd vpi vci [aal5snap | ilmi | qsaal] [peak_rate average_rate [burst_size]] [oam seconds]4 no atm pvc vcd vpi vci	Creates a PVC on the ATM interface.	ATM	IC
atmsig close	atmsig close atm0 vcd	Disconnects an SVC.	ATM	IC
atm sonet5	atm sonet {stm-1 | sts-3c} {stm-4 | sts-12c} no atm sonet	Sets the mode of operation and control type for cell-rate decoupling.	ATM	IC
atm traffic-shape rate	atm traffic-shape rate 1-155 no atm traffic-shape rate	Configures output throttling on the ATM module.	ATM	IC
atm uni-version	atm uni-version version_num no atm uni-version	Specifies the UNI version to be used.	ATM	GC
atm vc-per-vp	atm vc-per-vp num no atm vc-per-vp	Sets the maximum number of VCIs to support per VCI.	ATM	IC
clear mpoa client cache	clear mpoa client [name mpc_name] cache [ingress | egress] [ip-address ip-address]	Clears ingress/egress cache entries of one or all MPCs.	ATM	EXEC
client-atm-address name	client-atm-address atm-address-template name elan-name no client-atm-address atm-address-template	Adds a LANE address entry to the configuration server's database.	ATM	Dbase
debug mpoa client	debug mpoa client {all | data | egress | general | ingress | keep-alives | platform-specific} [name mpc_name] no debug mpoa client [name mpc_name]	Displays debug information for the MPC.	ATM	EXEC
default-name	default-name elan-name no default name	Provides a default ELAN name in the configuration server's database.	ATM	Dbase
disableATM	disable [level]	Exits privileged EXEC mode and returns to user EXEC mode.	ATM	EXEC
display-databases	display-databases	Displays all the LECS database tables.	ATM	Dbase
editing	editing no editing	Enables enhanced editing mode.	ATM	Line
enableATM	enable	Enters privileged EXEC mode.	ATM	EXEC
end	end	Exits configuration mode.	ATM	GC
exit	exit	Exits any command mode or closes an active terminal session and terminates the EXEC.	ATM	ATM
help	help	Displays the help commands.	ATM	ATM
historyATM	history [size number-of-lines] no history	Enables the command history function.	ATM	Line
interface	interface atm_num[.sub_interface_num mul] | loopback_num	Enters the configure interface or subinterface mode.	ATM	IC
lane auto-config-atm-address	lane [config] auto-config-atm-address no lane [config] auto-config-atm-address	Specifies the ATM address is computed automatically.	ATM	IC
lane bus-atm-address	lane bus-atm-address bus_name atm-addr no lane bus-atm-address bus_name atm-addr	Sets the ATM address for the BUS.	ATM	IC
lane client	lane client [ethernet vlan_num [elan-name]] no lane client [ethernet vlan_num [elan-name]]	Activates a LANE client.	ATM	IC
lane client-atm-address	lane client-atm-address atm-address-template no client-atm-address [atm-address-template]	Specifies an ATM address for the LANE client (overriding automatic assignment).	ATM	IC
lane client mpoa client name	lane client mpoa client name mpc-name no lane client mpoa client name mpc-name	Binds a LEC to the named MPC.	ATM	IC
lane config-atm-address	lane config-atm-address atm-address-template no lane config-atm-address [atm-address-template]	Specifies the ATM address of a given configuration server.	ATM	IC
lane config database	lane config database database-name no lane config database	Associates a named configuration database with the configuration server on the selected ATM interface.	ATM	GC
lane database	lane database database-name no lane database database-name	Creates a named configuration database that can be associated with a configuration server.	ATM	GC
lane le-arp	lane le-arp mac-addr atm-addr no lane le-arp mac-addr atm-addr	Adds a static entry to the LE ARP table.	ATM	IC
lane register	lane register vcd mac-addr atm-addr no lane register vcd [mac-addr atm-addr]	Registers a LANE client.	ATM	IC
lane server-atm-address	lane server-atm-address les_name atm-address-template no lane server-atm-address les_name atm-address-template	Configures the LES ATM address template.	ATM	IC
lane server-bus	lane server-bus {ethernet | tokenring} elan_name [elan-id id] no lane server-bus {ethernet | tokenring} elan_name [elan-id id]	Configures the LES and BUS for the specified ELAN on the subinterface.	ATM	IC
mac-address	mac-address ieee-address	Defines the MAC layer address.	ATM	IC
mpoa client config name	mpoa client config name mpc-name no mpoa client config name mpc-name	Defines an MPC with a specified name.	ATM	IC
mpoa client name	mpoa client name mpc-name no mpoa client name mpc-name	Attaches an MPC to a major ATM interface.	ATM	IC
mtu	mtu size	Sets the interface MTU size.	ATM	IC
name	name elan-name elan-id id {local-seg-id | new-name | preempt | restricted | server-atm-address | un-restricted} atm-addr no name elan_name atm-addr	Assigns a unique ELAN name to a LES.6	ATM	Dbase
reloadATM	reload	Reloads the operating system.	ATM	EXEC
show atm ilmi-status atm	show atm ilmi-status atm mod_num/subcard_num/port_num	Displays ILMI information about the ATM interface.	ATM	EXEC
show atm interface atm	show atm interface atm0	Displays information about the ATM interface.	ATM	EXEC
show atm traffic	show atm traffic	Displays global ATM traffic information.	ATM	EXEC
show atm vc	show atm vc [vcd]	Displays the active ATM virtual circuits.	ATM	EXEC
show atm vlan	show atm vlan [vlan_num]	Displays the active VLAN-to-PVC bindings.	ATM	IC
show history	show history	Lists the command history for the current EXEC session.	ATM	EXEC
show lane	show lane [interface atm0[.subinterface] | name elan-name] [brief]	Displays global and per-VCC LANE information.	ATM	EXEC
show lane bus	show lane bus [interface atm0[.subinterface] | name elan-name] [brief]	Displays LANE information for the configured BUS.	ATM	EXEC
show lane client	show lane client [interface atm0[.subinterface] | name elan-name] [brief]	Displays global and per-VCC LANE information.	ATM	EXEC
show lane config	show lane config [interface atm0] [brief]	Displays LANE information for the LECS.	ATM	EXEC
show lane default-atm-addresses	show lane default-atm-addresses	Displays default ATM addresses for dual PHYs.	ATM	EXEC
show lane le-arp	show lane le-arp [interface atm0[.subinterface] | name elan-name]	Displays the LE ARP table.	ATM	EXEC
show lane server	show lane server [interface atm0[.subinterface] | name elan-name] [brief]	Displays LANE information about the configured LES.	ATM	EXEC
show mpoa client	show mpoa client [name mpc-name] [brief]	Displays a summary of information regarding one/all MPCs.	ATM	EXEC
show mpoa client cache	show mpoa client [name mpc-name] cache [ingress | egress] [ip-address ip-address]	Displays the ingress and/or egress cache entries matching the IP addresses for the MPCs.	ATM	EXEC
show mpoa client statistics	show mpoa client [name mpc-name] statistics	Displays all the statistics collected by an MPC.	ATM	EXEC
show mpoa default-atm-addresses	show mpoa default-atm-addresses	Displays the default ATM addresses for the MPC.	ATM	EXEC
show sscop	show sscop	Displays SSCOP details for all ATM interfaces.	ATM	EXEC
show versionATM	show version	Displays version information for the ATM module.	ATM	EXEC
shutdown	shutdown no shutdown	Shuts down or restarts a physical interface.	Config	IC
sscop cc-timer	sscop cc-timer msecs no sscop cc-timer	Changes (in msecs) the SSCOP connection control timer value.	ATM	IC
sscop keepalive-timer	sscop keepalive-timer msecs no sscop keepalive-timer	Changes the SSCOP keepalive timer period (in msecs).	ATM	IC
sscop max-cc	sscop max-cc retries no sscop max-cc	Changes the maximum number of retries for connection control operations.	ATM	IC
sscop max-stat	sscop max-stat entries no sscop max-stat	Changes the maximum number of entries in a Stat frame.	ATM	IC
sscop poll-timer	sscop poll-timer msecs no sscop poll-timer	Changes the maximum time (in msecs) to wait for a response before sending a POLL PDU.	ATM	IC
sscop receive-window	sscop receive-window packets no sscop receive-window	Changes the size of the SSCOP receiver window.	ATM	IC
sscop send-window	sscop send-window packets no sscop send-window	Changes the size of the SSCOP transmitter window.	ATM	IC
terminal	terminal length [screen-length] terminal no length	Sets the number of lines displayed on the terminal.	ATM	EXEC
write terminal	write terminal	Displays the ATM configuration information currently in running memory.	ATM	EXEC

1Type - indicates whether the command is an ATM, LANE, or configuration command. 2Mode - indicates whether the command is available in every command mode (All) or whether it is an EXEC, global configuration (GC), interface configuration  (IC), line configuration (Line), or database configuration (Dbase) command. 3This command is not supported by the ATM  dual PHY OC-12 module, ATM software release 4.3(0). 4This version of the atm pvc command is available only in ATM software release 50.1(1) and later and ATM software release 51.1(1) and later. 5This command applies only to the ATM dual PHY OC-12 module. 6The new-name and preempt variables are supported in Catalyst 5000 series ATM software release 3.2(8) and later.

ROM Monitor CLI

The ROM monitor is a ROM-based program that executes upon platform power-up, reset, or when a fatal exception occurs.

Accessing the ROM Monitor CLI

The system enters ROM monitor mode if the switch does not find a valid system image, if the NVRAM configuration is corrupted, or if the configuration register is set to enter ROM monitor mode. From the ROM monitor mode, you can load a system image manually from Flash memory, from a network server file, or from bootflash. You can also enter ROM monitor mode also by restarting the switch and pressing the Break key during the first 60 seconds of startup.

To connect through a terminal server, escape to the Telnet prompt, and enter the send break command to break back to the ROM monitor mode.

Operating the ROM Monitor CLI

The ROM monitor commands are used to load and copy system images, microcode images, and configuration files. System images contain the system software. Microcode images contain microcode to be downloaded to various hardware devices. Configuration files contain commands entered to customize the function of Cisco IOS software.

The manual boot command has the following syntax:

• boot-boot from ROM

• boot device:[filename]-boot from Flash device. If you do not specify a filename, the system defaults to the first valid file in the device. The filename is case sensitive.

Once you are in ROM monitor mode, the prompt changes to rommon #>.

ROM Monitor Commands Quick Reference

Table 1-7 identifies each command in the switch command set, shows the command syntax, provides a short description, and specifies the mode for the command.

Table 1-7: ROM Monitor Commands

Command	Syntax	Description
alias	alias [name=value]	Sets and displays aliases.
boot	boot [-xv] [device][imagename]	Boots up an external process.
confreg	confreg [num]	Configures the configuration register utility.
dev	dev	Lists the device IDs available on a platform.
dirROM monitor	dir device	Lists the files of the named device.
historyROM monitor	history	Displays the command history (the last 16 commands executed in the monitor environment).
meminfo	meminfo [-l]	Displays switch memory information.
repeat	repeat [num | string]	Repeats a specified command.
resetROM monitor	reset {mod_num | system}	Performs a soft reset of the switch.
set	set	Displays all of the monitor variable names with their values, or sets a monitor variable.
sync	sync	Saves changes to the ROM monitor configuration.
unalias	unalias name	Removes the alias name and associated value from the alias list.
unset=varname	unset=varname	Removes a variable name from the variable list.
varname=	varname=value	Assigns a variable to a value.

Copyright 1989-1999©Cisco Systems Inc.