Table of Contents

Understanding the User Interface

This chapter describes the ATM switch router user interface and provides instructions for using the command-line interface (CLI).

Note   This chapter provides advanced configuration instructions for the Catalyst 8540 MSR, Catalyst 8510 MSR, and LightStream 1010 ATM switch routers. For complete descriptions of the commands mentioned in this chapter, refer to the ATM Switch Router Command Reference publication.

The following sections are included:

User Interface Overview

The user interface for the ATM switch router 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; from global configuration mode you can access numerous submodes that allow you to configure specific, related features. Read-only memory (ROM) monitor mode accesses a basic system kernel to which the ATM switch router 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 minimum unique string 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 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 ATM Switch Router Command Reference publication for the complete syntax of commands specific to the ATM switch router and a description of the function of the no form of a command. Refer to the Configuration Fundamentals Command Reference publication for the complete syntax of other IOS commands.

Accessing Each Command Mode

This section describes how to access the command modes for the ATM switch router. Table 2-1 and Table 2-2 list 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 ATM switch router name "Switch." Table 2-1 and Table 2-2 might not include all of the possible ways to access or exit each command mode.

EXEC Mode

When you log in to the ATM switch router, 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 devices, change terminal settings on a temporary basis, perform basic tests, and list system information.

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

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 ATM switch router's host name followed by the pound sign (#):

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

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 ATM switch router or perform diagnostic tests. If a valid system image is not found, 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, refer to the Configuration Fundamentals Configuration Guide.

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

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 ATM switch router's hostname followed by (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 "Managing Configuration Files, System Images, and Functional Images." The default is to enter commands from the terminal console.

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

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

Interface Configuration Mode

Interface configuration mode provides access to commands that apply on a per-interface basis. These 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 ATM switch router's hostname followed by (config-if)#:

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

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

Interface Addressing Formats (Catalyst 8540)

In the ATM switch router chassis, you specify interfaces in slots 0 through 3 and 9 through 12 using the card/subcard/port format. Slots 4 and 8 each contain a CPU (multiservice route processor). Because the configurations on the primary and secondary route processors are automatically synchronized, they are configured via a single network interface, specified as atm0 or ethernet0. There is no need to configure the secondary separately from the primary, but some show commands allow you to display information about the secondary route processor; in these cases, you specify the interface as atm-sec0 or ethernet-sec0. Slots 5 through 7 contain the switch processors, which have no interfaces. Table 2-3 summarizes this addressing scheme, assuming that slot 4 is the primary route processor and slot 8 is the secondary route processor.

The following example shows how to enter interface configuration mode to configure the Ethernet interface on the CPU:

CPU Interface Address Format (Catalyst 8510 MSR and LightStream 1010)

With this release of the ATM switch router software, addressing the interface on the processor (CPU) has changed. The ATM interface is now called atm0, and the Ethernet interface is now called ethernet0.

The following example shows how to enter interface configuration mode to configure the Ethernet interface on the processor:

Note   The old formats (atm 2/0/0 and ethernet 2/0/0) are still supported in this release.

Interface Range Configuration Mode

Interface range configuration mode provides access to commands that apply to a range of interfaces. These commands modify the operation of an interface such as an ATM, Ethernet, or asynchronous port.

To enter interface range configuration mode from global configuration mode, use the interface range command with a range of interfaces to configure; the prompt changes to the ATM switch router hostname followed by (config-if)#:

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

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

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 ATM switch router's hostname followed by (config-subif)#:

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

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

Line Configuration Mode (Catalyst 8540 MSR)

Line configuration mode on the Catalyst 8540 MSR provides access to commands that modify the operation of individual terminal lines. These commands are used to configure the console, and vty connections, set up modem connections, and so on.

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

For detailed line configuration instructions, refer to the Configuration Fundamentals Configuration Guide.

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

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

Line Configuration Mode (Catalyst 8510 MSR and LightStream 1010)

Line configuration mode on the Catalyst 8510 MSR and LightStream 1010 ATM switch router 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 modem 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 ATM switch router's hostname followed by (config-line)#:

For detailed line configuration instructions, refer to the Configuration Fundamentals Configuration Guide.

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

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

Map-List Configuration Mode

Map-list configuration mode provides access to commands used to statically map protocol addresses of remote hosts or switches to permanent virtual connections (PVCs) or switched virtual connections (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 the ATM switch router's hostname followed by (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:

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

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

Map-Class Configuration Mode

Map-class configuration mode provides access to command used to define the traffic parameters when specifying a request for a switched virtual channel (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 the ATM switch router's hostname followed by (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:

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

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

ATM Router Configuration Mode

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

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

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

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

For detailed information on configuring PNNI routing, see "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 ATM switch router.

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 ATM switch router's hostname followed by (config-pnni-node)#:

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

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

For detailed information on configuring PNNI nodes, see "Configuring ATM Routing and PNNI."

PNNI Explicit Path Configuration Mode

The PNNI explicit path configuration mode provides access to commands used to manually configure fully specified or partially specified paths for routing soft permanent virtual channel (soft PVC) and soft permanent virtual path (soft PVP) connections.

To enter the PNNI explicit path configuration mode from global configuration mode, use the atm pnni explicit-path command followed by an explicit path name or path-id number; the prompt changes to the ATM switch router's hostname followed by (cfg-pnni-expl-path)#:

To exit PNNI explicit path configuration mode and return to global configuration mode, use the exit command:

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

For detailed information on configuring PNNI explicit paths, see Chapter 10, "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 an accounting filename; the prompt changes to the ATM switch router hostname followed by (config-acct-file)#:

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

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

For detailed information on configuring ATM accounting, see "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 ATM switch router.

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

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

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

For detailed information on configuring ATM accounting selections, see "Configuring ATM Accounting and ATM RMON."

LANE Configuration Server Database Configuration Mode

LAN emulation (LANE) configuration server database configuration mode provides access to commands used to define the LANE 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 ATM switch router's hostname followed by (lane-config-database)#:

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

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

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

ATM E.164 Translation Table Configuration Mode

ATM E.164 translation table configuration mode provides access to commands used 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 ATM switch router's hostname followed by (config-atm-e164)#:

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

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

For detailed information on configuring E.164 addresses, see the "Configuring E.164 Addresses" section.

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 ATM switch router's hostname followed by (cfg-atmsig-diag):

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

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

For detailed information on configuring signalling diagnostics, see the "Configuring Signalling Diagnostics Tables" section.

Controller Configuration Mode

Controller configuration mode provides access to commands used to configure physical and logical parameters of a channelized interface.

To enter ATM controller configuration mode from global configuration mode, use the controller command with a channel type and interface:

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

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

For detailed information on configuring channel groups on a Frame Relay/FUNI interface, see "Configuring Frame Relay to ATM Interworking Port Adapter Interfaces."

Redundancy Configuration Mode (Catalyst 8540 MSR)

Redundancy configuration mode provides access to commands used to configure system redundancy and EHSA operation.

To enter redundancy configuration mode from global configuration mode, use the redundancy command; the prompt changes to the ATM switch router's hostname followed by (config-r):

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

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

For detailed information on configuring system redundancy, see the "Configuring Redundancy and Enhanced High System Availability (Catalyst 8540 MSR)" section.

Main CPU Configuration Mode (Catalyst 8540 MSR)

Main CPU configuration mode provides access to commands used to synchronize the configuration of the primary and secondary route processors.

To enter main CPU configuration mode from redundancy configuration mode, use the main-cpu command; the prompt changes to the ATM switch router's hostname followed by (config-r-mc):

To exit ATM main CPU configuration mode and return to redundancy configuration mode, use the exit command:

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

For detailed information on synchronizing configurations, see the "Configuring Redundancy and Enhanced High System Availability (Catalyst 8540 MSR)" section.

Additional Cisco IOS CLI Features

Because the ATM switch router's operating system is based on Cisco IOS software, its interface provides a number of features that help you use the CLI with greater flexibility, ease, and power. These features includes the following:

For information on using these and other features of Cisco IOS software, refer to the Configuration Fundamentals Configuration Guide.