|
|
This chapter describes the Cisco DSLAM user interface and provides instructions for using the command-line interface. This chapter includes the following sections:
The Cisco DSLAM user interface provides access to several different command modes, each with related commands. For security, the user interface provides three levels of command access:
![]() |
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. |
You can enter commands in uppercase, lowercase, or 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 you enter the command line at the system prompt, press Return to execute the command.
Most configuration commands have a no form. In general:
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.
This section describes how to access the DSLAM command modes. Table 1-1 lists
![]() |
Note Table 1-1 does not include all of the possible ways to access or exit each command mode. |
| Command Mode | Access Method | Prompt | Exit Method |
|---|---|---|---|
Log in to the switch or DSLAM. | | Use the logout command. | |
From user EXEC mode, use the enable EXEC command and enter your password. | | To return to user EXEC mode, use the disable command. | |
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, use the continue command. | |
From privileged EXEC mode, use the configure privileged EXEC command. Use the keyword terminal to enter commands from your terminal. | | To exit to privileged EXEC mode, use the exit or end command or press Ctrl-Z. | |
From global configuration mode, enter by specifying an interface with the interface command. | | 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. | |
From interface configuration, enter by specifying a profile with a dsl profile command. | | 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. | |
From global configuration mode, define a map list with the map-list command. | | 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. | |
From global configuration mode, configure the ATM router configuration with the atm router pnni command. | | 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. | |
From ATM router configuration mode, configure the PNNI routing node with the node command. | | 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. | |
From global configuration mode, define an ATM accounting file with the atm accounting file command. | | 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. | |
From global configuration mode, define an ATM accounting selection table entry with the atm accounting selection command. | | 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. | |
From global configuration mode, enter the atm e164 translation-table command | | 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. | |
From global configuration mode, enter the command atm signalling diagnostics and an index to configure. | | 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. |
The following section describes the various command modes and their levels of user access.
When you log in to the DSLAM, 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 DSLAM's host name followed by the angle bracket (>):
Frodo>
or
DSLAM>
The default host name is DSLAM, unless it has been changed using the host name global configuration command.
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. Privileged 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 DSLAM's host name followed by the pound sign (#):
DSLAM> enable Password: DSLAM#
To exit from privileged EXEC mode back to EXEC mode, use the disable command.
DSLAM# disable DSLAM>
The system administrator uses the enable password global configuration command to set the password, which is case-sensitive. If an enable password was not set, you can only access privileged EXEC mode from the console.
ROM monitor mode provides access to a basic system kernel, from which you can boot the DSLAM or perform diagnostic tests. The system may enter ROM mode automatically if the DSLAM does not find a valid system image, or if the configuration file is corrupted. 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.
To return to EXEC mode from ROM monitor mode, use the continue command:
> continue DSLAM>
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 these sections.
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 DSLAM's host name followed by (config)#:
DSLAM# configure Configuring from terminal, memory, or network [terminal]? <CR> Enter configuration commands, one per line. End with CNTL/Z. DSLAM(config)#
You can specify either the terminal, nonvolatile memory (NVRAM), or a file stored on a network server as the source of configuration commands. The default is to enter commands from the terminal console.
As a shortcut for accessing the terminal method of configuration, enter:
DSLAM# configure terminal Enter configuration commands, one per line. End with CNTL/Z. DSLAM(config)#
To exit global configuration command mode and return to privileged EXEC mode, use the exit or end command, or press Ctrl-Z:
DSLAM(config)# end DSLAM#
Interface configuration mode provides access to commands that apply on an interface basis. Use these commands to 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 DSLAM's host name followed by (config-if)#:
DSLAM(config)# DSLAM(config)# interface atm 0/1 DSLAM(config-if)#
To exit interface configuration mode and return to global configuration mode, use the exit command:
DSLAM(config-if)# exit DSLAM(config)#
To exit interface configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(config-if)# end DSLAM#
Profile mode provides access to DSL profile commands. (See "Configuring Digital Subscriber Lines".)
From interface configuration mode, enter profile mode by specifying a profile using the profile command. For example:
Step | Command | Task |
|---|---|---|
| DSLAM# configure terminal |
|
| DSLAM(config)# dsl-profile profile-name |
|
| DSLAM(config-dsl-prof)# no alarms |
|
To exit profile mode and return to global configuration mode, use the exit command:
DSLAM(config-dsl-prof)# exit DSLAM(config)#
To exit profile mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(config-dsl-prof)# end DSLAM#
Map-list configuration mode provides access to commands used to statically map protocol addresses of remote hosts or DSLAMs 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. The prompt changes to (config-map-list)#:
DSLAM(config)# map-list newlist DSLAM(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:
DSLAM(config-map-class)# map-list newlist DSLAM(config-map-list)#
To exit map-list configuration mode and return to global configuration mode, use the exit command:
DSLAM(config-map-list)# exit DSLAM(config)#
To exit map-list configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(config-map-list)# end DSLAM#
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)#:
DSLAM(config)# atm router pnni DSLAM(config-atm-router)#
To exit ATM router configuration mode and return to global configuration mode, use the exit command:
DSLAM(config-atm-router)# exit DSLAM(config)#
To exit ATM router configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(config-atm-router)# end DSLAM#
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 DSLAM.
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 DSLAM's host name followed by (config-pnni-node)#:
DSLAM(config-atm-router)# node 1 DSLAM(config-pnni-node)#
To exit PNNI node configuration mode and return to ATM router configuration mode, use the exit command:
DSLAM(config-pnni-node)# exit DSLAM(config-atm-router)#
To exit PNNI node configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(config-pnni-node)# exit DSLAM#
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 an accounting file name. The prompt changes to the DSLAM's host name followed by (config-acct-file)#:
DSLAM(config)# atm accounting file acctng_file1 DSLAM(config-acct-file)#
To exit ATM accounting file configuration mode and return to global configuration mode, use the exit command:
DSLAM(config-acct-file)# exit DSLAM(config)#
To exit ATM accounting file configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(config-acct-file)# end DSLAM#
ATM accounting selection configuration mode provides access to commands used to specify the connection data to be gathered from the DSLAM.
To enter ATM accounting selection configuration mode, use the atm accounting selection command and specify an accounting selection index. The prompt changes to the DSLAM's host name followed by (config-acct-sel)#:
DSLAM(config)# atm accounting selection 1 DSLAM(config-acct-sel)#
To exit ATM accounting selection configuration mode and return to global configuration mode, use the exit command:
DSLAM(config-acct-sel)# exit DSLAM(config)#
To exit ATM accounting selection configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(config-acct-sel)# end DSLAM#
ATM E.164 translation table configuration mode provides access to commands that you use to 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 DSLAM's host name followed by (config-atm-e164)#:
DSLAM(config)# atm e164 translation-table DSLAM(config-atm-e164)#
To exit ATM E.164 translation table configuration mode and return to global configuration mode, use the exit command:
DSLAM(config-atm-e164)# exit DSLAM(config)#
To exit ATM E.164 translation table configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(config-atm-e164)# end DSLAM#
ATM signaling diagnostics configuration mode provides access to commands used to configure the signaling diagnostics table.
To enter ATM signaling 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 DSLAM's host name followed by (cfg-atmsig-diag):
DSLAM(config)# atm signalling diagnostics DSLAM(cfg-atmsig-diag)#
To exit ATM signaling diagnostics configuration mode and return to global configuration mode, use the exit command:
DSLAM(cfg-atmsig-diag)# exit DSLAM(config)#
To exit ATM signaling diagnostics configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z:
DSLAM(cfg-atmsig-diag)# end DSLAM#
The user interface provides context-sensitive help in all modes. This section describes how to configure and display context-sensitive help.
To configure full help for the current terminal session, use this command in privileged EXEC mode:
Command | Task |
|---|---|
|
|
To configure a specific line to allow users without privileged access to obtain full help, use this command in line configuration mode:
Command | Task |
|---|---|
|
|
To get help specific to a command mode, a command, a keyword, or argument, perform one of these tasks:
Command | Task |
|---|---|
| |
| |
|
|
| |
|
|
|
|
To view 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 this example, the system displays the possible commands in privileged EXEC mode that begin with "co."
DSLAM# co? configure connect copy
This form helps you determine the minimum subset that can be used when you abbreviate a command.
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 have already entered.
This example demonstrates the use of command syntax help to complete the access-list command. Entering the question mark (?) displays the allowed arguments:
DSLAM(config)# access-list ? <1-99> IP standard access list <100-199> IP extended access list
Enter the access list number, 99, followed by question mark (?) to display the allowed keywords:
DSLAM(config)# access-list 99 ? deny Specify packets to reject permit Specify packets to forward
Enter the deny argument followed by a question mark (?) to display the next argument (host name or IP address) and two keywords:
DSLAM(config)# access-list 99 deny ? Hostname or A.B.C.D Address to match any Any source host host A single host address
Enter the IP address followed by a question mark (?) to display a final (optional) argument. The <cr> indicates that you can press Return to execute the command:
DSLAM(config)# access-list 99 deny 131.108.134.0 ? A.B.C.D Wildcard bits <cr> DSLAM(config)# <cr>
The system adds an entry to access list 99 that denies access to all hosts on subnet 131.108.134.0.
The user interface provides an error indicator (^) that appears in the command string in which you have entered an incorrect or incomplete command, keyword, or argument.
This example shows a command entry that is correct up to the last element:
DSLAM# clock set 13:04:30 28 apr 98
^
% Invalid input detected at '^' marker.
The caret symbol (^) and help response indicate the location in which the error occurs. To list the correct syntax, reenter the command, substituting a question mark (?) where the error occurred:
DSLAM# clock set 13:32:00 23 February ? <1993-2035> Year DSLAM# clock set 13:32:00 23 February
Enter the year using the correct syntax and press Return to execute the command:
DSLAM# clock set 13:32:00 23 February 1993
The user interface provides a history or record of commands you enter. You can use the command history feature for recalling long or complex commands or entries, including access lists. With the command history feature, you can complete the tasks in these sections:
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 this command in privileged EXEC mode:
Command | Task |
|---|---|
|
|
To configure the number of command lines the system records for a specific line, use this command in line configuration mode:
Command | Task |
|---|---|
|
|
To recall commands from the history buffer, perform one of these tasks:
Key Sequence/Command | Task |
|---|---|
|
|
|
|
|
| 1The arrow keys function only on ANSI-compatible terminals such as VT100s. |
The command history feature is automatically enabled. To disable it during the current terminal session, use this command in EXEC mode:
Command | Task |
|---|---|
|
To configure a specific line to disable the command history feature, use this command in line configuration mode:
Command | Task |
|---|---|
|
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 perform the tasks described in these sections:
Although the current software release enables the enhanced editing mode by default, you can disable it and revert to the editing mode of previous software releases.
To reenable the enhanced editing mode for the current terminal session, use this command in EXEC mode:
Command | Task |
|---|---|
|
To reconfigure a specific line to have enhanced editing mode, use this command in line configuration mode:
Command | Task |
|---|---|
|
Use these keystrokes to move the cursor around on the command line for corrections or changes:
Keystrokes | Task |
|
|
|
|
|
|
|
|
|
|
|
|
| 1The arrow keys function only on ANSI-compatible terminals such as VT100s. |
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 |
|---|---|
|
|
If your keyboard does not have a Tab key, press Ctrl-I instead.
In this example, when you enter the letters conf and press the Tab key, the system provides the complete command:
DSLAM# conf<Tab> DSLAM# 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 (?) after you see the error message. See the section "Using Word Help".
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 these keystrokes:
Step | Keystrokes | Task |
|---|---|---|
|
|
|
|
|
|
The buffer contains only the last ten items you have deleted or cut. If you press Esc Y more than 10 times, you cycle back to the first buffer entry.
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 10 spaces to the left. You cannot see the first 10 characters of the line, but you can scroll back and check the syntax at the beginning of the command. To scroll back, use these keystrokes:
Keystrokes | Task |
|---|---|
|
|
|
|
| 1The arrow keys function only on ANSI-compatible terminals such as VT100s. |
In this 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.
DSLAM(config)# access-list 101 permit tcp 131.108.2.5 255.255.255.0 131.108.1
DSLAM(config)# $ 101 permit tcp 131.108.2.5 255.255.255.0 131.108.1.20 255.25
DSLAM(config)# $t tcp 131.108.2.5 255.255.255.0 131.108.1.20 255.255.255.0 eq
DSLAM(config)# $108.2.5 255.255.255.0 131.108.1.20 255.255.255.0 eq 45
When you complete 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:
DSLAM(config)# access-list 101 permit tcp 131.108.2.5 255.255.255.0 131.108.1$
The DSLAM default is a terminal screen that is 80 columns wide. If you have a width other than that, use the terminal width command to provide correct width of your terminal.
Use line wrapping together with the command history feature to recall and modify previous complex command entries.
Use any of these keystrokes to delete command entries if you make a mistake or change your mind:
Keystrokes | Task |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
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 appears at the bottom of the screen. To respond to the More prompt, use these keystrokes:
Keystrokes | Task |
|---|---|
|
|
|
|
|
|
If you enter a command and a message appears on your screen, you can easily recall your current command line entry. To do so, use these keystrokes:
Keystrokes | Task |
|---|---|
|
|
If you have mistyped a command entry, you can transpose the mistyped characters by using these keystrokes:
Keystrokes | Task |
|---|---|
|
|
You can capitalize or lowercase words or capitalize a set of letters with these keystrokes:
Keystrokes | Task |
|---|---|
|
|
|
|
|
|
To use a particular keystroke as an executable command, insert a system code for this purpose:
Keystrokes | Task |
|---|---|
|
|
To disable enhanced editing mode and revert to the editing mode, use this command in privileged EXEC mode:
Command | Task |
|---|---|
|
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.
After you use the setup command or other configuration command, exit the DSLAM and quit the session.
To end a session, use this EXEC command:
Command | Task |
|---|---|
|
|
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Tue Sep 19 10:59:10 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.