Command-Line Interfaces

Note For descriptions of all switch, ATM, and ROM monitor commands, refer to the Catalyst 5000 Series Command Reference publication. For descriptions of the commands used to configure the Route Switch Module (RSM), refer to the Cisco IOS software command reference publications.

This chapter consists of these sections:

ROM Monitor Command-Line Interface

The ROM monitor is a ROM-based program that executes upon platform power-up, reset, or when a fatal exception occurs. The system enters ROM monitor mode if the switch does not find a valid system image, if the nonvolatile RAM (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.

Note The ROM monitor CLI is only present on the Supervisor Engine III module. The Supervisor Engine I and II modules do not have a ROM monitor interface.

You can also enter ROM monitor mode by restarting the switch and pressing the Break key during the first 60 seconds of startup.

Note The Break key is always enabled for 60 seconds after rebooting the system, regardless of whether the Break key is configured to be off by configuration register settings.

To access the ROM monitor through a terminal server, you can escape to the Telnet prompt and enter the send break command for your terminal emulation program to break into ROM monitor mode.

Once you are in ROM monitor mode, the prompt changes to rommon#>. Use the ? command to see the available ROM monitor commands.

Switch Command-Line Interface

The Catalyst 5000 series switch CLI is a basic command-line interpreter, similar to the UNIX C shell.

Accessing the Switch CLI

You can access the CLI from a console terminal connected to an EIA/TIA-232 port or through Telnet. Telnet disconnects automatically after remaining idle for a configurable time period.

Note EIA/TIA-232 was known as recommended standard RS-232 before its acceptance as a standard by the Electronic Industries Association (EIA) and Telecommunications Industry Association (TIA).

Accessing the CLI through the EIA/TIA-232 Port

To access the switch through the EIA/TIA-232 port, perform this task:

Task Command

Step 1 From the Catalyst 5000 series switch 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.

Step 3 Enter the necessary commands to complete your desired tasks.

Appropriate commands

Step 4 When finished, exit the session.

quit

Task	Command
Step 1 From the Catalyst 5000 series switch 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.
Step 3 Enter the necessary commands to complete your desired tasks.	Appropriate commands
Step 4 When finished, exit the session.	quit

After accessing the switch through the console port (EIA/TIA-232), you see this display:

Cisco Systems Console
Enter password:
Console>

Accessing the CLI through Telnet

To use Telnet, you must set the IP address for the switch. For information about setting the IP address, refer to the "Configuring the Supervisor Engine Software" chapter. You can conduct multiple sessions through Telnet.

To access the switch from a remote host with Telnet, perform this task:

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

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

This example shows how to open a Telnet session to the switch:

unix_host% telnet Catalyst_1

Trying 172.16.10.10...
Connected to Catalyst_1.
Escape character is '^]'.
Cisco Systems Console
Enter password:
Catalyst_1>

Operating the Switch CLI

There are two modes of operation, both password protected: normal and privileged. Enter normal-mode commands for everyday system monitoring. Enter privileged commands for system configuration and basic troubleshooting.

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

This example shows how to enter privileged mode:

Console> enable

Enter Password:
Console> (enable)

Performing Command Line Processing

Switch commands are not case sensitive. You can abbreviate commands and parameters as long as they contain enough letters to be different from any other currently available commands or parameters. Table 2-1 lists the keyboard shortcuts you can use when entering switch commands.

Table 2-1: Keyboard Shortcuts
Command Function

Ctrl-W

Deletes last word typed.

Ctrl-U

Deletes entire line.

Ctrl-C

Escapes and terminates prompts and lengthy tasks.

Delete key or Backspace key

Erases mistake when entering a command; reenter command after using this key.

**Table 2-1: Keyboard Shortcuts**
Command	Function
Ctrl-W	Deletes last word typed.
Ctrl-U	Deletes entire line.
Ctrl-C	Escapes and terminates prompts and lengthy tasks.
Delete key or Backspace key	Erases mistake when entering a command; reenter command after using this key.

Performing History Substitution

The history buffer stores the last 20 commands you entered during a terminal session. History substitution allows you to access these commands without retyping them, by using special abbreviated commands. Table 2-2 lists the history substitution commands.

Table 2-2: History Substitution Commands
Command Function

Repeating recent commands:

!!

Repeat the most recent command.

!-nn

Repeat the nnth most recent command.

!n

Repeat command n.

!aaa

Repeat the command beginning with string aaa.

!?aaa

Repeat the command containing the string aaa.

To modify and repeat the most recent command:

^aaa^bbb

Replace the string aaa with the string bbb in the most recent command.

To add a string to the end of a previous command and repeat it:

!!aaa

Add string aaa to the end of the most recent command.

!n aaa

Add string aaa to the end of command n.

!aaa bbb

Add string bbb to the end of the command beginning with string aaa.

!?aaa bbb

Add string bbb to the end of the command containing the string aaa.

Table 2-2: **History Substitution Commands**
Command	Function
Repeating recent commands:
!!	Repeat the most recent command.
!-nn	Repeat the nnth most recent command.
!n	Repeat command n.
!aaa	Repeat the command beginning with string aaa.
!?aaa	Repeat the command containing the string aaa.
To modify and repeat the most recent command:
^aaa^bbb	Replace the string aaa with the string bbb in the most recent command.
To add a string to the end of a previous command and repeat it:
!!aaa	Add string aaa to the end of the most recent command.
!n aaa	Add string aaa to the end of command n.
!aaa bbb	Add string bbb to the end of the command beginning with string aaa.
!?aaa bbb	Add string bbb to the end of the command containing the string aaa.

Accessing Command Help

Enter help or ? in normal or privileged mode to see the commands available in those modes. On selected commands, entering help or ? after a command provides additional information, such as a command usage description. Command usage, the help menu, and when appropriate, parameter ranges are provided if you enter a command using the wrong number of arguments or inappropriate arguments. Additionally, appending help or ? to a command category displays a list of commands in that category.

Additional Usage Guidelines

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 virtual LAN (VLAN).

Catalyst 5000 series module slots, ports, and VLANs are numbered starting with 1. The supervisor engine module is module 1, residing in the top slot. If your Catalyst 5505 or 5500 switch has 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 commands, you can enter lists of ports and VLANs.

Designating Ports

To designate ports, enter the module and port number pairs, separated by commas. To specify a range of ports, use a hyphen (-) between the port numbers. Hyphens 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 is the same as Example 2.

Each VLAN is designated by a single number. You specify lists of VLANs the same way you do for ports. Individual VLANs are separated by commas (,); ranges are separated by hyphens (-). 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 Media Access Control (MAC) address, IP address, or IP alias, which must be designated in a standard format. The MAC address format must be six hexadecimal numbers separated by hyphens, as shown in the following example:

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

The IP address format is 32 bits, written as 4 octets separated by periods (dotted decimal format) that are made up of a network section, an optional subnet section, and a host section, as shown in the following 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 for commands that define the IP address or IP alias. For more information about the set interface and set ip alias commands, refer to the Catalyst 5000 Series Command Reference publication.

ATM Module Command-Line Interface

The ATM module uses a subset of the Cisco IOS software. The Cisco IOS user interface provides access to several different command modes. Each command mode provides a group of related commands.

Cisco IOS software provides two command access modes: user EXEC and privileged EXEC. The user EXEC mode does not require a password, and allows you direct access only to the ATM module with which you have established a session. The user EXEC mode commands are a subset of the privileged EXEC mode commands.

The privileged EXEC mode requires a password (the default password is atm). From the privileged level, you can access the six configuration modes: user EXEC, privileged EXEC, global configuration, interface configuration, line configuration, and LAN Emulation (LANE) database configuration. Enter a question mark (?) at the system prompt to display the available commands for the current command mode.

Almost every configuration command has a no form. The no form disables a feature or function. Enter the command without the keyword no to reenable a disabled feature or to enable a feature that is disabled by default. Refer to the Catalyst 5000 Series Command Reference publication for more information about the ATM module commands.

The user interface also provides context-sensitive help on command syntax. Refer to the "Getting Context-Sensitive Help" section later in this chapter for information on how to use the help system. It also describes the command editing and command history features that enable you to recall previous command entries and easily edit command entries.

Accessing the ATM Module

To access an ATM module installed in a Catalyst 5000 series switch, enter the session mod_num command at the Console> prompt. The switch responds with the Enter Password prompt. Enter atm as the default password. The ATM module responds with the ATM> prompt. At this point, you are in user EXEC command mode, and you have direct access only to the ATM module with which you have established a session.

This example shows how to open a session on an ATM module installed in slot 4:

Console> session 4

Enter Password:
ATM>

Operating the ATM Module CLI

This section describes the command modes and functions that allow you to access and operate the ATM module CLI. Table 2-3 lists the command modes, how to access each mode, the prompt you see while you are in that mode, the main uses for each configuration mode, and the method to exit that mode. The prompts listed assume the default name ATM.

Table 2-3: ATM Module Command Mode Summary
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.

Global configuration

From privileged EXEC mode, enter the configure privileged EXEC command.

ATM(config)#

Enter the exit or end command, or press Ctrl-Z.

Interface configuration

From global configuration mode, enter the interface interface_num command.

ATM (config-if)#

To exit to global configuration mode, enter the end command.

To exit to privileged EXEC mode, enter the exit command, or press Ctrl-Z.

Subinterface configuration

From interface configuration mode, enter the interface sub_interface_num command.

ATM (config-subif)#

To exit to global configuration mode, enter the end command.

To exit to privileged EXEC mode, enter the exit command, or press Ctrl-Z.

Line configuration

From global configuration mode, enter the line line_number command.

ATM (config-line)#

To exit to global configuration mode, enter the exit command.

To exit to privileged EXEC mode, enter the end command, or press Ctrl-Z.

LANE database configuration

From global configuration mode, enter the lane database command.

ATM (config-if)#

To exit to global configuration mode, enter the exit command.

To exit to privileged EXEC mode, enter the end command, or press Ctrl-Z.

**Table 2-3: ATM Module Command Mode Summary**
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.
Global configuration	From privileged EXEC mode, enter the configure privileged EXEC command.	ATM(config)#	Enter the exit or end command, or press Ctrl-Z.
Interface configuration	From global configuration mode, enter the interface interface_num command.	ATM (config-if)#	To exit to global configuration mode, enter the end command. To exit to privileged EXEC mode, enter the exit command, or press Ctrl-Z.
Subinterface configuration	From interface configuration mode, enter the interface sub_interface_num command.	ATM (config-subif)#	To exit to global configuration mode, enter the end command. To exit to privileged EXEC mode, enter the exit command, or press Ctrl-Z.
Line configuration	From global configuration mode, enter the line line_number command.	ATM (config-line)#	To exit to global configuration mode, enter the exit command. To exit to privileged EXEC mode, enter the end command, or press Ctrl-Z.
LANE database configuration	From global configuration mode, enter the lane database command.	ATM (config-if)#	To exit to global configuration mode, enter the exit command. To exit to privileged EXEC mode, enter the end command, or press Ctrl-Z.

Accessing User EXEC Mode

After you log in to the ATM module, you are automatically in user EXEC command mode. The user EXEC commands are a subset of the privileged EXEC commands. The user EXEC commands allow you to change terminal settings on a temporary basis, perform basic tests, and list system information.

To list the commands available in user EXEC mode, enter a question mark (?) at the ATM> prompt.

The user-level prompt is as follows:

ATM>

Accessing Privileged EXEC Mode

Because many privileged commands set operating parameters, use password protection to restrict access to privileged EXEC mode. The privileged EXEC command set includes those commands in user EXEC mode, as well as the configure command through which you can access the remaining command modes. Privileged EXEC mode also includes high-level testing commands, such as debug.

To access and list the privileged EXEC commands, perform this task:

Task Command

Step 1 Enter privileged EXEC mode.

enable password

Step 2 List privileged EXEC commands.

?

Task	Command
Step 1 Enter privileged EXEC mode.	enable password
Step 2 List privileged EXEC commands.	?

If the system administrator has set a password, you are prompted to enter it before you are allowed access to privileged EXEC mode. The password is not displayed on the screen and is case sensitive. If an enable password has not been set, you can only access privileged EXEC mode from the console. The default password for the ATM module is atm.

This example shows how to access privileged EXEC mode:

ATM> enable

Password: 
ATM#

From privileged EXEC mode, you can access global configuration mode. For instructions, see the "Accessing Global Configuration Mode" section.

To return from privileged EXEC mode to user EXEC mode, perform this task:

Task Command

Exit privileged EXEC mode and return to user EXEC mode.

disable

Task	Command
Exit privileged EXEC mode and return to user EXEC mode.	disable

Accessing Global Configuration Mode

Global configuration commands apply to features that affect the ATM module as a whole. To enter global configuration mode, enter the configure privileged EXEC command. When you enter this command, the privileged EXEC mode prompts you for the source of the configuration commands, as follows:

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

Note Only the write memory and write terminal commands are supported. The write network command is not supported.

You can specify either the terminal or NVRAM as the source of configuration commands (refer to the Cisco IOS configuration guide and command reference publications for complete information on Cisco IOS commands). The default is to enter commands from the console terminal. Press Return to enter terminal configuration mode.

To access and list the global configuration commands, perform this task:

Task Command

Step 1 At the console terminal, from privileged EXEC mode, enter global configuration mode.

configure

Step 2 List the global configuration commands.

?

Task	Command
Step 1 At the console terminal, from privileged EXEC mode, enter global configuration mode.	configure
Step 2 List the global configuration commands.	?

This example shows how to access global configuration mode:

ATM#configure terminal

Enter configuration commands, one per line.  End with CNTL/Z.
ATM(config)#

To exit global configuration command mode and return to privileged EXEC mode, perform this task using one of these commands:

Task Command

Exit global configuration mode.

exit
end
Ctrl-Z

Task	Command
Exit global configuration mode.	exit end Ctrl-Z

Accessing Interface Configuration Mode

Interface configuration commands modify the operation of the ATM interface. Interface configuration commands always follow an interface global configuration command, which defines the interface type.

To access and list the interface configuration commands, perform this task:

Task Command

Step 1 From global configuration mode, enter interface configuration mode.

interface atm0¹

Step 2 List the interface configuration commands.

?

Step 3 From interface configuration mode, enter subinterface configuration mode.

interface atm0.sub_interface_num mul

Step 4 List the subinterface configuration commands.

?

¹Always specify ATM interface 0 for the Catalyst 5000 series ATM module.

Task	Command
Step 1 From global configuration mode, enter interface configuration mode.	interface atm0¹
Step 2 List the interface configuration commands.	?
Step 3 From interface configuration mode, enter subinterface configuration mode.	interface atm0.sub_interface_num mul
Step 4 List the subinterface configuration commands.	?

This example shows how to access interface configuration mode:

ATM(config)#interface atm0

ATM(config-if)#

This example shows how to access subinterface configuration mode:

ATM(config-if)#interface atm0.1

ATM(config-subif)#

To exit interface configuration mode and return to global configuration mode, perform this task:

Task Command

Exit interface configuration mode.

exit

Task	Command
Exit interface configuration mode.	exit

To exit global configuration mode and return to privileged EXEC mode, perform this task using one of these commands:

Task Command

Exit global configuration mode.

end
Ctrl-Z

Task	Command
Exit global configuration mode.	end Ctrl-Z

Accessing Line Configuration Mode

Line configuration commands modify the operation of a terminal line. Line configuration commands always follow a line command, which defines a line number. These commands change terminal parameter settings either on a line-by-line basis or for a range of lines.

To access and list the virtual terminal line configuration commands, perform this task:

Task Command

Step 1 From global configuration mode, configure a virtual terminal line.

line [vty] line-number [ending-line-number]¹

Step 2 List the line configuration commands.

?

¹This command is documented in the "Terminal Lines and Modem Support Commands" chapter in the Router Products Command Reference publication.

Task	Command
Step 1 From global configuration mode, configure a virtual terminal line.	line [vty] line-number [ending-line-number]¹
Step 2 List the line configuration commands.	?

This example shows how to enter line configuration mode for virtual terminal line 4:

ATM(config)# line 0 4

ATM(config-line)#

To exit line configuration mode and return to global configuration mode, perform this task:

Task Command

Exit line configuration mode.

exit

Task	Command
Exit line configuration mode.	exit

To exit global configuration mode and return to privileged EXEC mode, perform this task using one of these commands:

Task Command

Exit global configuration mode.

end
Ctrl-Z

Task	Command
Exit global configuration mode.	end Ctrl-Z

Performing ATM Module Functions

This section describes how to perform the following functions:

Getting Context-Sensitive Help

You can get a list of the associated keywords and arguments for any command by using the context-sensitive help feature.

To get help specific to a command mode, a command, a keyword, or arguments, perform one of these tasks:

Task Command

Obtain a brief description of the help system in any command mode.

help

Configure a line or lines to receive help for the full set of user-level commands when you enter ?.

full-help

Configure a line to receive help for the full set of user-level commands for this EXEC session.

terminal full-help¹

Obtain a list of commands that begin with a particular character string.

abbreviated-command-entry?

Complete a partial command name.

abbreviated-command-entry<Tab>

List all commands available for a particular command mode.

?

List the associated keywords for a command.

command ?

List the associated arguments for a keyword.

command keyword ?

¹This command is documented in the Cisco Access Connection Guide.

Task	Command
Obtain a brief description of the help system in any command mode.	help
Configure a line or lines to receive help for the full set of user-level commands when you enter ?.	full-help
Configure a line to receive help for the full set of user-level commands for this EXEC session.	terminal full-help¹
Obtain a list of commands that begin with a particular character string.	abbreviated-command-entry?
Complete a partial command name.	abbreviated-command-entry<Tab>
List all commands available for a particular command mode.	?
List the associated keywords for a command.	command ?
List the associated arguments for a keyword.	command keyword ?

When using context-sensitive help, the space (or lack of a space) before the question mark (?) is significant.

To obtain a list of commands that begin with a particular character sequence, enter the characters immediately followed by the question mark (?). Do not include a space. This form of help completes the word for you.

To list keywords or arguments, enter command syntax help by entering a question mark (?) in place of a keyword or argument. Include a space before the ?. This form of help reminds you which keywords or arguments are applicable based on the command, keywords, and arguments you have already entered.

You can abbreviate commands and keywords by using a number of characters that allow a unique abbreviation. For example, you can abbreviate the show command to sh.

Enter the help command (which is available in any command mode) for 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 back up 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?'.)

You can enter a partial command name and a question mark (?) to obtain a list of commands beginning with a particular character set. See the section "Completing a Partial Command Name" for more details.

This example shows how context-sensitive help enables you to create an access list from configuration mode. Enter co at the system prompt followed by a question mark (?). Do not leave a space between the last letter and the question mark (?). The system provides the commands that begin with co.

ATM# co?

configure  connect  copy

Enter the configure command followed by a space and a question mark (?) to list the command's keywords and a brief explanation:

ATM# configure ?

  memory    Configure from NV memory
  network   Configure from a TFTP network host
  terminal  Configure from the terminal
  <cr>

Checking Command Syntax

An error indicator (^) symbol appears at the point in the command string where you have entered an incorrect command, keyword, or argument. The error location indicator and interactive help system allow you to easily find and correct syntax errors.

This example shows how to use context-sensitive help to determine how to clear an ATM interface. First, check the syntax for the command:

ATM#clear ?

  counters   Clear counters on one or all interfaces
  interface  Clear the hardware logic on an interface
  lane       lane
  line       Reset a terminal line
  logging    Clear logging buffer
  tcp        Clear a TCP connection or statistics
 
ATM#clear

The help output shows that clear interface is the syntax for clearing an interface. Next, check the syntax for specifying the type of interface:

ATM#clear interface ?

  ATM       ATM interface
  Ethernet  IEEE 802.3
  Null      Null interface
 
ATM#clear interface

The help output shows that clear interface atm is the syntax for clearing an ATM interface. Next, check the syntax for specifying the specific ATM interface:

ATM#clear interface atm ?

  <0-0>  ATM interface number
 
ATM#clear interface atm

The help output shows you must specify the ATM interface number. When you specify the interface correctly, the ATM interface is cleared:

ATM#clear interface atm 0

ATM#

Using the Command History Features

The command history feature keeps a record of commands you have entered and allows you to recall these commands. The functions of the command history feature are as follows:

Setting the Command History Buffer Size

By default, the system records ten command lines in its history buffer. To set the number of command lines the system records during the current terminal session, perform this task in user EXEC mode:

Task Command

Enable the command history feature for the current terminal session.

terminal history [size number-of-lines]¹

¹This command is documented in the Cisco Access Connection Guide.

Task	Command
Enable the command history feature for the current terminal session.	terminal history [size number-of-lines]¹

The terminal no history size command resets the number of lines saved by history to the default of ten lines.

To configure the number of command lines the system records, perform this task in line configuration mode:

Task Command

Enable the command history feature.

history [size number-of-lines]¹

¹The no history command turns off command history for the line.

Task	Command
Enable the command history feature.	history [size number-of-lines]¹

Recalling Commands

To recall commands from the history buffer, perform one of these tasks:

Task Key Sequence/Command

Recall commands in the history buffer, beginning with the most recent command. Repeat the key sequence to recall successively older commands.

Press Ctrl-P or the up arrow key.¹

Return to more recent commands in the history buffer after recalling commands with Ctrl-P or the up arrow key. Repeat the key sequence to recall successively more recent commands.

Press Ctrl-N or the down arrow key.¹

In EXEC mode, list the last several commands you have just entered.

show history

¹The arrow keys function only on ANSI-compatible terminals such as VT100s.

Task	Key Sequence/Command
Recall commands in the history buffer, beginning with the most recent command. Repeat the key sequence to recall successively older commands.	Press Ctrl-P or the up arrow key.¹
Return to more recent commands in the history buffer after recalling commands with Ctrl-P or the up arrow key. Repeat the key sequence to recall successively more recent commands.	Press Ctrl-N or the down arrow key.¹
In EXEC mode, list the last several commands you have just entered.	show history

Disabling the Command History Feature

The command history feature is enabled automatically. To disable it during the current terminal session, perform this task in user EXEC mode:

Task Command

Disable the command history feature for the current session.

terminal no history¹

¹This command is documented in the Cisco Access Connection Guide.

Task	Command
Disable the command history feature for the current session.	terminal no history¹

To configure a specific line so that the command history feature is disabled, perform this task in line configuration mode:

Task Command

Configure the line so that the command history feature is disabled.

no history

Task	Command
Configure the line so that the command history feature is disabled.	no history

Using the Editing Features

Catalyst 5000 series software release 2.3 and above includes an enhanced editing mode that provides a set of editing key functions similar to those of the Emacs editor. You can enter commands in uppercase, lowercase, or a mix of both. Only passwords are case sensitive. You can abbreviate commands and keywords to the number of characters that allow a unique abbreviation.

For example, you can abbreviate the show command to sh. After entering the command at the system prompt, press Return to execute the command.

Enabling Enhanced Editing Mode

Although enhanced editing mode is enabled automatically, you can disable it and revert to the editing mode of previous software releases. See the section "Ending a Session" later in this chapter.

To reenable the enhanced editing mode for the current terminal session, perform this task in user EXEC mode:

Task Command

Enable the enhanced editing features for the current terminal session.

terminal editing¹

¹This command is documented in the Cisco Access Connection Guide.

Task	Command
Enable the enhanced editing features for the current terminal session.	terminal editing¹

To reconfigure a specific line in enhanced editing mode, perform this task in line configuration mode:

Task Command

Enable the enhanced editing features.

editing

Task	Command
Enable the enhanced editing features.	editing

Moving Around on the Command Line

Perform one of these tasks to move the cursor around on the command line for corrections or changes:

Task Keystrokes

Move the cursor back one character.

Press Ctrl-B or
press the left arrow key.¹

Move the cursor forward one character.

Press Ctrl-F or
press the right arrow key.¹

Move the cursor to the beginning of the command line.

Press Ctrl-A.

Move the cursor to the end of the command line.

Press Ctrl-E.

Move the cursor back one word.

Press Esc B.

Move the cursor forward one word.

Press Esc F.

¹The arrow keys function only on ANSI-compatible terminals such as VT100s.

Task	Keystrokes
Move the cursor back one character.	Press Ctrl-B or press the left arrow key.¹
Move the cursor forward one character.	Press Ctrl-F or press the right arrow key.¹
Move the cursor to the beginning of the command line.	Press Ctrl-A.
Move the cursor to the end of the command line.	Press Ctrl-E.
Move the cursor back one word.	Press Esc B.
Move the cursor forward one word.	Press Esc F.

Completing a Partial Command Name

If you cannot remember a complete command name, press the Tab key to allow the system to complete a partial entry. To do so, perform this task:

Task Keystrokes

Complete a command name.

Enter the first few letters, and press the Tab key.

Task	Keystrokes
Complete a command name.	Enter the first few letters, and press the Tab key.

If your keyboard does not have a Tab key, press Ctrl-I instead.

In the following example, when you enter the letters conf and press the Tab key, the system provides the complete command:

ATM# conf<Tab>

ATM# configure

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 (?) to obtain a list of commands that begin with that set of characters. Do not leave a space between the last letter and the question mark (?). For example, three commands in privileged mode start with co. To see what they are, enter co? at the privileged EXEC prompt. The system displays all commands that begin with co, as follows:

ATM# co?

configure  connect  copy

Pasting in Buffer Entries

The system provides a buffer that contains the last ten items you deleted. You can recall these items and paste them in the command line by performing this task:

Task Keystrokes

Step 1 Recall the most recent entry in the buffer.

Press Ctrl-Y.

Step 2 Recall the next buffer entry.

Press Esc Y.

The buffer contains only the last ten items you have deleted or cut. If you press Esc Y more than ten times, you cycle back to the first buffer entry.

Editing Command Lines That Wrap

The new editing command set provides a wraparound feature for commands that extend beyond a single line on the screen. When the cursor reaches the right margin, the command line shifts ten spaces to the left. You cannot see the first ten characters of the line, but you can scroll back and check the syntax at the beginning of the command. To scroll back, perform this task:

Task Keystrokes

Return to the beginning of a command line to verify that you have entered a lengthy command correctly.

Press Ctrl-B or the left arrow key repeatedly until you scroll back to the beginning of the command entry, or press Ctrl-A to return directly to the beginning of the line.¹

¹The arrow keys function only on ANSI-compatible terminals such as VT100s.

In this example, the lane config-atm-address command entry extends beyond one line. When the cursor reaches the end of the line, the line shifts ten spaces to the left and is redisplayed. The dollar sign ($) indicates that the line scrolled to the left. Each time the cursor reaches the end of the line, the line shifts ten spaces to the left.

ATM(config-subif)# lane config-atm-address 39.000000000000014155551211.080020

ATM(config-subif)#$ -atm-address 39.000000000000014155551211.0800200c1001.00

When you complete the entry, press Ctrl-A to check the complete syntax, and then press Return to execute the command. The dollar sign ($) appears at the end of the line to indicate that the line scrolled to the right:

ATM(config-subif)# lane config-atm-address 39.000000000000014155551211.080020 $

The system assumes your terminal screen is 80 columns wide. If your screen has a different width, enter the terminal width command to tell the router the correct width of your screen.

Use line wrapping with the command history feature to recall and modify previous complex command entries. See the section "Recalling Commands" for information about recalling previous command entries.

Deleting Entries

Perform one of these tasks to delete command entries if you make a mistake or change your mind:

Task Keystrokes

Erase the character to the left of the cursor.

Press the Delete or Backspace key.

Delete the character at the cursor.

Press Ctrl-D.

Delete from the cursor to the end of the command line.

Press Ctrl-K.

Delete from the cursor to the beginning of the command line.

Press Ctrl-U or Ctrl-X.

Delete the word to the left of the cursor.

Press Ctrl-W.

Delete from the cursor to the end of the word.

Press Esc D.

Scrolling Down a Line or a Screen

When you use the help facility to list the commands in a particular mode, the list is often longer than the terminal screen can display. In such cases, a ---More--- prompt is displayed at the bottom of the screen. To view the next line or screen, perform these tasks:

Task Keystrokes

Scroll down one line.

Press the Return key.

Scroll down one screen.

Press the Spacebar.

Note The ---More--- prompt is used for any output that has more lines than can be displayed on the terminal screen, including show command output.

Redisplaying the Current Command Line

If you enter a command and the system suddenly sends a message to your screen, you can recall your current command line entry. To do so, perform this task:

Task Keystrokes

Redisplay the current command line.

Press Ctrl-L or Ctrl-R.

Transposing Mistyped Characters

If you mistype a command entry, you can transpose the mistyped characters by performing this task:

Task Keystrokes

Transpose the character to the left of the cursor with the character located at the cursor.

Press Ctrl-T.

Controlling Capitalization

You can change words to uppercase or lowercase, or capitalize a set of letters, with simple keystroke sequences:

Task Keystrokes

Capitalize at the cursor.

Press Esc C.

Change the word at the cursor to lowercase.

Press Esc L.

Capitalize letters from the cursor to the end of the word.

Press Esc U.

Designating a Keystroke as a Command Entry

You can use a particular keystroke as an executable command. Perform this task:

Task Keystrokes

Insert a code to indicate to the system that the keystroke immediately following should be treated as a command entry, not an editing key.

Press Ctrl-V or Esc Q.

Ending a Session

After entering the setup command or other configuration commands, exit the ATM module and quit the session.

To end a session, perform this task:

Task Command

Enter the quit EXEC command.

quit

RSM Command-Line Interface

The RSM is a fully-functional router running Cisco IOS software. The Cisco IOS user interface allows you to access several different command modes. Each command mode provides a group of related commands.

Cisco IOS software has two levels of access to commands: user and privileged. The unprivileged user mode is the user EXEC mode. The privileged mode is the privileged EXEC mode and requires a password. The commands available in user EXEC mode are a subset of the commands available in privileged EXEC mode.

From the privileged EXEC level, you can access global configuration mode and six specific configuration modes: interface, subinterface, line, router, ipx-router, and route-map configuration. Enter a question mark (?) at the system prompt to display a list of commands for each command mode.

Almost every configuration command has a no form. Enter the no form to disable a feature or function. Enter the command without the keyword no to reenable a disabled feature or to enable a feature that is disabled by default. Refer to the Catalyst 5000 Series Route Switch Module Installation and Configuration Note, Catalyst 5000 Series Command Reference, and the Cisco IOS Configuration Fundamental Command Reference publications for more information about the RSM commands.

The user interface provides context-sensitive help on command syntax. It also describes the command editing and command history features that enable you to recall previous command entries and easily edit command entries.

Accessing the RSM

To access an RSM installed in a Catalyst 5000 series switch, enter the session mod_num command at the Console> prompt. The switch responds with the Enter Password prompt. Enter the password for the RSM. The RSM responds with the Router> prompt. At this point, you are in user EXEC command mode, and you have direct access only to the RSM with which you have established a session.

The following example shows how to open a session on an RSM installed in slot 4:

Console> session 4

Enter Password:
Router>

Accessing the VIP2 Port Adapters

When you use the RSM with the Catalyst VIP2, the combination is a double-wide module that occupies two consecutive Catalyst 5505, Catalyst 5000, or Catalyst 5500 slots. The Catalyst VIP2 data and control interface is provided through two ribbon cables. Power to the Catalyst VIP2 is provided through the Catalyst VIP2 backplane connector.

For more information, refer to the Route Switch Module Catalyst VIP2-15 and VIP2-40 Installation and Configuration Note.

Note You can install the RSM/VIP2 combination in Catalyst 5505, Catalyst 5000, and Catalyst 5500 switches; you can use the standalone RSM in the Catalyst 5002 switch.

Operating the RSM CLI

Refer to the Configuration Fundamentals Command Reference publication for router commands and instructions on how to configure the IOS Router CLI.

Task	Keystrokes
Step 1 Recall the most recent entry in the buffer.	Press Ctrl-Y.
Step 2 Recall the next buffer entry.	Press Esc Y.

Task	Keystrokes
Erase the character to the left of the cursor.	Press the Delete or Backspace key.
Delete the character at the cursor.	Press Ctrl-D.
Delete from the cursor to the end of the command line.	Press Ctrl-K.
Delete from the cursor to the beginning of the command line.	Press Ctrl-U or Ctrl-X.
Delete the word to the left of the cursor.	Press Ctrl-W.
Delete from the cursor to the end of the word.	Press Esc D.

Task	Keystrokes
Scroll down one line.	Press the Return key.
Scroll down one screen.	Press the Spacebar.

Task	Keystrokes
Capitalize at the cursor.	Press Esc C.
Change the word at the cursor to lowercase.	Press Esc L.
Capitalize letters from the cursor to the end of the word.	Press Esc U.

Table of Contents

Command-Line Interfaces