cc/td/doc/product/atm/ls1010s/wa4/11_3_5
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Understanding the User Interfaces for the LightStream  1010 ATM switch

Understanding the User Interfaces for the LightStream  1010 ATM switch

This chapter describes the ATM switch user interface and provides instructions for using the command-line interface. The following sections are included:


Note For a complete description of the commands mentioned in this chapter, refer to the LightStream  1010  ATM Switch Command Reference publication.

User Interface Overview

The LightStream  1010 ATM switch user interface provides access to several different command modes, each with related commands. Users familiar with the Cisco IOS user interface will find the interfaces very similar. This chapter describes how to access and list the commands available in each command mode, and explains the primary uses for each command mode.

For security purposes, the user interface provides two levels of command access: user and privileged. The unprivileged user mode is called user EXEC mode; the privileged mode is called privileged EXEC mode, and requires a password.


Note Because all commands available in user EXEC mode are also available in privileged EXEC mode, user EXEC mode is referred to as EXEC mode in this guide.

From the privileged level, you can access global configuration mode and three specific configuration modes: terminal, memory, and network configuration. Read-only memory (ROM) monitor mode accesses a basic system kernel to which the switch may default at startup if it does not find a valid system image, or if its configuration file is corrupted.

You can enter commands in uppercase, lowercase, or a mix of both. Only passwords are case sensitive. You can abbreviate commands and keywords to a specific number of characters. For example, you can abbreviate the show command to sh. After entering the command line at the system prompt, press the Return key to execute the command.

Almost every switch configuration command has a no form. In general, use the no form to disable a feature or function. Use the command without the no keyword to reenable a disabled feature or enable a feature disabled by default.


Note Refer to the LightStream  1010 ATM Switch Command Reference publication for the complete syntax of every switch configuration command a description of the function of the no form of a command.

The context-sensitive help system allows you to obtain a list of commands available for each command mode or a list of available options for a specific command by entering a question mark (?). This chapter describes how to use the help system and also describes the command editing and command history features that enable you to recall previous command entries and edit previously entered commands.

Accessing Each Command Mode

This section describes how to access the LightStream  1010 ATM switch command modes. Table 2-1 lists the command modes, access to each mode, the prompt you see while in that mode, the main uses for each configuration mode, and the method to exit that mode. The prompts listed assume the default switch name "Switch." Table 2-1 might not include all of the possible ways to access or exit each command mode.


Table 2-1: Summary of Command Modes
Command Mode Access Method Prompt Exit Method

EXEC (user)

Log in to the switch.

Switch>

Use the logout command.

Privileged EXEC

From user EXEC mode, use the enable EXEC command and enter your password.

Switch#

To return to user EXEC mode, use the disable command.

ROM monitor

From privileged EXEC mode, use  the reload EXEC command. Press Break during the first 60 seconds while the system boots.

>

To exit to user EXEC mode, type continue.

Global configuration

From privileged EXEC mode, use  the configure privileged EXEC command. Use the keyword terminal to enter commands from your terminal.

Switch(config)#

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

Interface configuration

From global configuration mode, enter by specifying an interface with an interface command.

Switch(config-if)#

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

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

Subinterface configuration

From interface configuration mode, specify a subinterface with an interface command.

Switch(config-subif)#

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

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

Line configuration

From global configuration mode, enter by specifying a line with a line command.

Switch(config-line)#

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

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

Map-list configuration

From global configuration mode, define a map list with the map-list command.

Switch(config-map-list)#

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

To enter map-class configuration mode, use the map-class command.

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

Map-class configuration

From global configuration mode, configure a map class with the map-class command.

Switch(config-map-class)#

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

To enter map-list configuration mode, use the map-list command.

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

ATM router configuration

From global configuration mode, configure the PNNI routing protocol with the atm router pnni command.

Switch(config-atm-router)#

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

To exit directly to privileged EXEC mode use the end command or press Ctrl-Z.

PNNI node configuration

From ATM router configuration mode, configure the PNNI routing node with the node command.

Switch(config-pnni-node)#

To exit to ATM router configuration mode, use the exit command.

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

ATM accounting file

From global configuration mode, define an ATM accounting file with the atm accounting file command.

Switch(config-acct-file)#

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

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

ATM accounting selection

From global configuration mode, define an ATM accounting selection table entry with the atm  accounting selection command.

Switch(config-acct-sel)#

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

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

LANE configuration server database configuration

From global configuration mode, specify a LANE configuration server database name with the lane  database command.

Switch(lane-config-database)#

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

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

ATM E.164 translation table configuration

From global configuration mode, enter the atm  e164  translation-table command

Switch(config-atm-e164)

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

To exit directly to privileged EXEC mode, use the end command or press Ctrl-Z

ATM signalling diagnostics configuration

From global configuration mode, enter the atm  signalling  diagnostics command and an index to configure.

Switch(cfg-atmsig-diag)

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

To exit directly to privileged EXEC mode, use the end command or press Ctrl-Z

EXEC (User EXEC) Mode

When you log in to the switch, you are in user EXEC, or simply EXEC, command mode. The EXEC commands available at the user level are a subset of those available at the privileged level. In general, the user-level EXEC commands allow you to connect to remote switches, change terminal settings on a temporary basis, perform basic tests, and list system information.

The user-level prompt consists of the switch's host name followed by the angle bracket (>):

Switch>
 

The default host name is Switch, unless it has been changed during using the hostname global configuration command.

Privileged EXEC Mode

The privileged EXEC command set includes all user-level EXEC mode commands and the configure command, through which you can access global configuration mode and the remaining configuration submodes. Privilege EXEC mode also includes high-level testing commands, such as debug, and commands that display potentially secure information.

To enter privileged EXEC mode from EXEC mode, use the enable command and enter your password; the prompt changes to the switch's host name followed by the pound sign (#):

Switch> enable
Password:
Switch# 
 

To exit from privileged EXEC mode back to EXEC mode, use the disable command.

Switch# disable
Switch>
 

The system administrator uses the enable password global configuration command to set the password, which is case sensitive. If an enable password has not been set, privileged EXEC mode can only be accessed from the console.

ROM Monitor Mode

ROM monitor mode provides access to a basic system kernel, from which you can boot the switch or perform diagnostic tests. If the switch does not find a valid system image, or if the configuration file is corrupted, the system might enter ROM monitor mode. The ROM monitor prompt is the angle bracket:

>
 

You can also enter ROM monitor mode by intentionally interrupting the boot sequence with the Break key during loading. For a description of this process, see "Manually Load a System Image from ROM Monitor" in the chapter "Loading System Software Images and Configuration Files."

To return to EXEC mode from ROM monitor mode, use the continue command:

> continue
Switch>

Global Configuration Mode

Global configuration mode provides access to commands that apply to the entire system. From global configuration mode you can also enter the other configuration modes described in the following subsections.

To enter global configuration mode from privileged EXEC mode, enter the configure command and specify the source of the configuration commands at the prompt; the prompt changes to the switch's hostname followed by (config)#:

Switch# configure
Configuring from terminal, memory, or network [terminal]? <CR>
Enter configuration commands, one per line. End with CNTL/Z.
Switch(config)#
 

You can specify either the terminal, nonvolatile memory (NVRAM), or a file stored on a network server as the source of configuration commands. For more information, see the chapter "Loading System Software Images and Configuration Files." The default is to enter commands from the terminal console.

As a shortcut for accessing the terminal method of configuration, enter the following:

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

To exit global configuration command mode and return to privileged EXEC mode, use the exit or end command, or press Ctrl-Z:

Switch(config)# end
Switch#

Interface Configuration Mode

Interface configuration mode provides access to commands that apply on a per- interface basis. Such commands modify the operation of an interface such as an ATM, Ethernet, or asynchronous port.

To enter interface configuration mode from global configuration mode, use the interface command with a keyword indicating the interface type, followed by an interface number; the prompt changes to the switch's hostname followed by (config-if)#:

Switch(config)# 
Switch(config)# interface atm 3/0/0
Switch(config-if)#
 

To exit interface configuration mode and return to global configuration mode, use the exit command:

Switch(config-if)# exit
Switch(config)# 
 

To exit interface configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-if)# end
Switch# 

Subinterface Configuration Mode

Subinterface configuration mode allows access to commands that affect logical interfaces, also called subinterfaces. Subinterfaces are used, for example, to configure multiple VP tunnels on a single interface.

To enter subinterface configuration command mode from global configuration or interface configuration mode, use the interface command with a keyword indicating the interface type, followed by an interface and subinterface number; the prompt changes to the switch's hostname followed by (config-subif)#:

Switch(config)# interface atm 0/0/0.99
Switch(config-subif)# 
 

To exit subinterface configuration mode and return to global configuration mode, use the exit command:

Switch(config-subif)# exit
Switch(config)# 
 

To exit interface configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-subif)# end
Switch# 

Line Configuration Mode

Line configuration mode provides access to commands that modify the operation of individual terminal lines. These commands are used to configure the console, auxiliary, and VTY connections, set up moden connections, and so on.

To enter line configuration mode from global configuration mode, use the line command followed by a line type (aux, console, or vty) and a line number or range; the prompt changes to the switch's hostname followed by (config-line)#:

Switch(config)# line vty 0
Switch(config-line)#
 

For detailed line configuration instructions, see the chapter "Configuring Terminal Lines and Modem Support."

To exit line configuration mode and return to global configuration mode, use the exit command:

Switch(config-line)# exit
Switch(config)# 
 

To exit line configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-line)# end
Switch# 

Map-List Configuration Mode

Map-list configuration mode provides access to commands used to statically map protocol addresses of remote hosts or switches to PVCs or SVCs.

To enter map-list configuration mode from global configuration mode, use the map-list command followed by a map-list name to configure; the prompt changes to (config-map-list)#:

Switch(config)# map-list newlist
Switch(config-map-list)#
 

You can also use the map-list command to enter map-list configuration mode directly from map-class configuration mode, without first returning to global configuration mode:

Switch(config-map-class)# map-list newlist
Switch(config-map-list)#
 

To exit map-list configuration mode and return to global configuration mode, use the exit command:

Switch(config-map-list)# exit
Switch(config)# 
 

To exit map-list configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-map-list)# end
Switch# 

Map-Class Configuration Mode

Map-class configuration mode provides access to command used to define the traffic parameters used in specifying a request for an SVC.

To enter map-class configuration mode from global configuration mode, enter the map-class command followed by a class name to configure; the prompt changes to (config-map-class)#:

Switch(config)# map-class atm newclass
Switch(config-map-class)# 
 

You can also use the map-class command to enter map-class configuration mode directly from map-list configuration mode, without first returning to global configuration mode:

Switch(config-map-list)# map-class atm newclass
Switch(config-map-class)#
 

To exit map-class configuration mode and return to global configuration mode, use the exit command:

Switch(config-map-class)# exit
Switch(config)# 
 

To exit map-class configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-map-class)# end
Switch# 

ATM Router Configuration Mode

ATM router configuration mode provides access to commands used to configure Private Network-to-Network Interface (PNNI) routing.

To enter ATM router configuration mode from global configuration mode, use the atm router pnni command; the prompt changes to (config-atm-router)#:

Switch(config)# atm router pnni
Switch(config-atm-router)# 
 

To exit ATM router configuration mode and return to global configuration mode, use the exit command:

Switch(config-atm-router)# exit
Switch(config)# 
 

To exit ATM router configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-atm-router)# end
Switch# 
 

For detailed information on configuring PNNI routing, refer to the chapter "Configuring ATM Routing and PNNI."

PNNI Node Configuration Mode

The PNNI node configuration mode is a submode of ATM router configuration mode and provides access to commands you use to configure PNNI nodes on the switch.

To enter PNNI node configuration mode from ATM router configuration mode, use the node command followed by a node index; the prompt changes to the switch's hostname followed by (config-pnni-node)#:

Switch(config-atm-router)# node 1
Switch(config-pnni-node)# 
 

To exit PNNI node configuration mode and return to ATM router configuration mode, use the exit command:

Switch(config-pnni-node)# exit
Switch(config-atm-router)# 
 

To exit PNNI node configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-pnni-node)# exit
Switch# 
 

For detailed information on configuring PNNI nodes, refer to the chapter "Configuring ATM Routing and PNNI."

ATM Accounting File Configuration Mode

ATM accounting file configuration mode provides access to commands used to configure a file for accounting and billing of virtual circuits (VCs).

To enter ATM accounting file configuration mode from global configuration mode, use the atm accounting file command followed by a an accounting filename; the prompt changes to the switch's hostname followed by (config-acct-file)#:

Switch(config)# atm accounting file acctng_file1
Switch(config-acct-file)# 
 

To exit ATM accounting file configuration mode and return to global configuration mode, use the exit command:

Switch(config-acct-file)# exit
Switch(config)# 
 

To exit ATM accounting file configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-acct-file)# end
Switch# 
 

For detailed information on configuring ATM accounting, refer to the chapter "Configuring ATM Accounting and ATM RMON."

ATM Accounting Selection Configuration Mode

ATM accounting selection configuration mode provides access to commands used to specify the connection data to be gathered from the switch.

To enter ATM accounting selection configuration mode, use the atm accounting selection command and specify an accounting selection index; the prompt changes to the switch's hostname followed by (config-acct-sel)#:

Switch(config)# atm accounting selection 1
Switch(config-acct-sel)# 
 

To exit ATM accounting selection configuration mode and return to global configuration mode, use the exit command:

Switch(config-acct-sel)# exit
Switch(config)# 
 

To exit ATM accounting selection configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-acct-sel)# end
Switch# 
 

For detailed information on configuring ATM accounting selections, refer to the chapter "Configuring ATM Accounting and ATM RMON."

LANE Configuration Server Database Configuration Mode

LANE configuration server database configuration mode provides access to commands used to define the LAN emulation configuration server database.

To enter LANE configuration server database configuration mode from global configuration mode, use the lane database command and specify a database name; the prompt changes to the switch's hostname followed by (lane-config-database)#:

Switch(config)# lane database lecsdb
Switch(lane-config-database)# 
 

To exit LANE configuration server database configuration mode and return to global configuration mode, use the exit command:

Switch(lane-config-database)# exit
Switch(config)# 
 

To exit LANE configuration server database configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(lane-config-database)# end
Switch# 
 

For detailed information on configuring the LAN emulation configuration server database, refer to the chapter "Configuring LAN Emulation."

ATM E.164 Translation Table Configuration Mode

ATM E.164 translation table configuration mode provides access to commands used configure the translation table that maps native E.164 format addresses to ATM end system (AESA) format addresses.

To enter ATM E.164 translation table configuration mode from global configuration mode, use the atm e164 translation-table command; the prompt changes to the switch's hostname followed by (config-atm-e164)#:

Switch(config)# atm e164 translation-table
Switch(config-atm-e164)
 

To exit ATM E.164 translation table configuration mode and return to global configuration mode, use the exit command:

Switch(config-atm-e164)# exit
Switch(config)# 
 

To exit ATM E.164 translation table configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(config-atm-e164)# end
Switch# 
 

For detailed information on configuring E.164 addresses, refer to the section "Configuring E.164 Addresses" in the chapter "Configuring Signalling Features."

ATM Signalling Diagnostics Configuration Mode

ATM signalling diagnostics configuration mode provides access to commands used to configure the signalling diagnostics table.

To enter ATM signalling diagnostics configuration mode from global configuration mode, use the atm signalling diagnostics command and specify an index for the filter table; the prompt changes to the switch's hostname followed by (cfg-atmsig-diag):

Switch(config)# atm signalling diagnostics
Switch(cfg-atmsig-diag)
 

To exit ATM signalling diagnostics configuration mode and return to global configuration mode, use the exit command:

Switch(cfg-atmsig-diag)# exit
Switch(config)# 
 

To exit ATM signalling diagnostics configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:

Switch(cfg-atmsig-diag)# end
Switch# 
 

For detailed information on configuring signalling diagnostics, refer to the section "Configuring Signalling Diagnostics Tables" in the chapter "Configuring Signalling Features."

Using Context-Sensitive Help

The user interface provides context-sensitive help in all modes. The following subsection describe how to configure and display context-senstive help.

Configuring Help for Terminal Sessions

To configure full help for the current terminal session, use the following command in privileged EXEC mode:
Command Task

terminal full-help

Configure the current terminal session to receive help for the full set of user-level commands.

To configure a specific line to allow users without privileged access to obtain full help, use the following command in line configuration mode:
Command Task

full-help

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

Displaying Context-Sensitive Help

To get help specific to a command mode, a command, a keyword, or argument, perform one of the following tasks:
Command Task

help

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

abbreviated-command-entry?

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

abbreviated-command-entry<Tab>

Complete a partial command name.

?

List all commands available for a particular command mode.

command ?

List a command's associated keywords.

command keyword ?

List a keyword's associated arguments.

Word Help

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

In the following example, the system displays the possible commands in privileged EXEC mode that begin with "co".

Switch# co?
configure  connect  copy
 

This form helps you determine the minimum subset that can be used when abbreviating a command. The example above shows, for example, that you can enter configuration mode by typing conf.

Command Syntax Help

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

The following example demonstrates using command syntax help to complete the access-list command. Entering the question mark (?) displays the allowed arguments:

Switch(config)#  access-list ?
  <1-99>     IP standard access list
  <100-199>  IP extended access list
 

Entering the access list number, 99, followed by question mark (?) displays the allowed keywords:

Switch(config)#  access-list 99 ?
  deny    Specify packets to reject
  permit  Specify packets to forward
 

Entering the deny argument followed by a question mark (?) displays the next argument (hostname or IP address) and two keywords:

Switch(config)# access-list 99 deny ?
  Hostname or A.B.C.D  Address to match
  any                  Any source host
  host                 A single host address
 

Entering the IP address followed by a question mark (?) displays a final (optional) argument. The <cr> indicates that you can press Return at this point to execute the command:

Switch(config)# access-list 99 deny 131.108.134.0 ?
  A.B.C.D  Wildcard bits
  <cr>
Switch(config)# <cr>
 

The system adds an entry to access list  99 that denies access to all hosts on subnet 131.108.134.0.

Command Syntax Checking

The user interface provides error isolation in the form of an error indicator (^) that appears in the command string where you have entered an incorrect or incomplete command, keyword, or argument.

The following example shows a command entry that is correct up to the last element:

Switch# clock set 13:04:30 28 apr 98
                                 ^
% Invalid input detected at '^' marker.
 

The caret symbol (^) and help response indicate where the error occurs. To list the correct syntax, reenter the command, substituting a question mark  (?) where the error occurred:

Switch# clock set 13:32:00 23 February ?
  <1993-2035> Year
Switch# clock set 13:32:00 23 February
 

Enter the year using the correct syntax and press Return to execute the command:

Switch# clock set 13:32:00 23 February 1993

Using the Command History Features

The user interface provides a history or record of commands you enter. You can use this feature for recalling long or complex commands or entries, including access lists. With the command history feature, you can complete the tasks in the following sections:

Set 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, use the following command in privileged EXEC mode:
Command Task

terminal history [size number-of-lines]

Enable the command history feature for the current terminal session.

To configure the number of command lines the system records for a specific line, use the following command in line configuration mode:
Command Task

history [size number-of-lines]

Enable the command history feature.

Recall Commands

To recall commands from the history buffer, perform one of the following tasks:
Key Sequence/Command Task

Press Ctrl-P or the up arrow key.1

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

Press Ctrl-N or the down arrow key.1

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.

show history

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

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

Disable the Command History Feature

The command history feature is automatically enabled. To disable it during the current terminal session, use the following command in EXEC mode:
Command Task

terminal no history

Disable the command history feature for the current session.

To configure a specific line to disable the command history feature, use the following command in line configuration mode:
Command Task

no history

Configure the line to disable the command history feature.

Using the Editing Features

The user interface includes an enhanced editing mode that provides a set of editing key functions similar to those of the Emacs editor.

Using the editing features you can complete the tasks in the following sections:

Enable Enhanced Editing Mode

Although the current software release enables the enhanced editing mode, you can disable it and revert to the editing mode of previous software releases. See the section "Disable Enhanced Editing Mode" later in this chapter.

To reenable the enhanced editing mode for the current terminal session, use the following command in EXEC mode:
Command Task

terminal editing

Enable the enhanced editing features for the current terminal session.

To reconfigure a specific line to have enhanced editing mode, use the following command in line configuration mode:
Command Task

editing

Enable the enhanced editing features.

Move Around on the Command Line

Use the following keystrokes to move the cursor around on the command line for corrections or changes:
Keystrokes Task

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

Move the cursor back one character.

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

Move the cursor forward one character.

Press Ctrl-A.

Move the cursor to the beginning of the command line.

Press Ctrl-E.

Move the cursor to the end of the command line.

Press Esc B.

Move the cursor back one word.

Press Esc F.

Move the cursor forward one word.

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

Complete a Partial Command Name

If you cannot remember a complete command name, you can use the Tab key to allow the system to complete a partial entry:
Keystrokes Task

Enter the first few letters and press the Tab key.

Complete a command name.

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:

Switch# conf<Tab>
Switch# configure
 

If you enter an ambiguous set of characters, the system generates an error message. To display the list of legal commands beginning with the specified string, enter a question mark (?). See the section "Word Help."

Paste 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 using the following keystrokes:
Step Keystrokes Task
1

Press Ctrl-Y.

Recall the most recent entry in the buffer.

2

Press Esc Y.

Recall the next buffer entry.

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.

Edit 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, use the following keystrokes:
Keystrokes Task

Press Ctrl-B or the left arrow key1 repeatedly

Scroll back one character at a time to the beginning of a command line to verify that you entered a lengthy command correctly.

Press Ctrl-A

Return directly to the beginning of the line.

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

In the following example, the access-list command entry extends beyond one line. When the cursor reaches the end of the line, the line is shifted ten spaces to the left and redisplayed. The dollar sign ($) indicates that the line has been scrolled to the left. Each time the cursor reaches the end of the line, the line is again shifted ten spaces to the left.

Switch(config)#  access-list 101 permit tcp 131.108.2.5 255.255.255.0 131.108.1
Switch(config)#  $ 101 permit tcp 131.108.2.5 255.255.255.0 131.108.1.20 255.25
Switch(config)#  $t tcp 131.108.2.5 255.255.255.0 131.108.1.20 255.255.255.0 eq
Switch(config)#  $108.2.5 255.255.255.0 131.108.1.20 255.255.255.0 eq 45 
 

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

Switch(config)#  access-list 101 permit tcp 131.108.2.5 255.255.255.0 131.108.1$
 

The switch assumes you have a terminal screen that is 80 columns wide. If you have a width other than that, use the terminal width command to tell the switch the correct width of your terminal.

Use line wrapping together with the command history feature to recall and modify previous complex command entries. See the section "Recall Commands" earlier in this chapter for information about recalling previous command entries.

Delete Entries

Use any of the following keystrokes to delete command entries if you make a mistake or change your mind:
Keystrokes Task

Press the Delete or Backspace key.

Erase the character to the left of the cursor.

Press Ctrl-D.

Delete the character at the cursor.

Press Ctrl-K.

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

Press Ctrl-U or Ctrl-X.

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

Press Ctrl-W.

Delete the word to the left of the cursor.

Press Esc D.

Delete from the cursor to the end of the word.

Scroll Down a Line or a Screen

When you use the help facility to list the commands available 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 respond to the --More-- prompt, use the following keystrokes:
Keystrokes Task

Press the Return key.

Scroll down one line.

Press the Space bar.

Scroll down one screen.

Press the Esc key.

Stop scrolling and return to the main prompt.

Redisplay the Current Command Line

If you are entering a command and the system suddenly sends a message to your screen, you can easily recall your current command line entry. To do so, use the following keystrokes:
Keystrokes Task

Press Ctrl-L or Ctrl-R.

Redisplay the current command line.

Transpose Mistyped Characters

If you have mistyped a command entry, you can transpose the mistyped characters by using the following keystrokes:
Keystrokes Task

Press Ctrl-T.

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

Control Capitalization

You can capitalize or lowercase words or capitalize a set of letters with the following keystrokes:
Keystrokes Task

Press Esc C.

Capitalize at the cursor.

Press Esc L.

Change the word at the cursor to lowercase.

Press Esc U.

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

Designate a Keystroke as a Command Entry

Tto use a particular keystroke as an executable command, insert a system code for this purpose:
Keystrokes Task

Press Ctrl-V or Esc Q.

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

Disable Enhanced Editing Mode

To disable enhanced editing mode and revert to the editing mode, use the following command in privileged EXEC mode:
Command Task

terminal no editing

Disable the enhanced editing features for the local line.

If you have prebuilt scripts that do not interact well when enhanced editing is enabled, you can disable enhanced editing mode. To reenable enhanced editing mode, use the terminal  editing command.

Ending a Session

After using the setup command or other configuration commands, exit the switch and quit the session.

To end a session, use the following EXEC command:
Command Task

quit

Enter the quit EXEC command.


hometocprevnextglossaryfeedbacksearchhelp

Copyright 1989-1999©Cisco Systems Inc.