|
|
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 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. The commands available in user EXEC mode are a subset of the commands available in privileged EXEC mode.
From the privileged level, you can access global configuration mode and three specific configuration modes: terminal, memory, and network configuration. If your switch does not find a valid system image, or if its configuration file is corrupted at startup, the system might enter read-only memory (ROM) monitor mode. Entering a question mark (?) at the system prompt allows you to obtain a list of commands available for each command mode.
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 keyword no to reenable a disabled feature or enable a feature disabled by default. For example, terminal history is enabled by default. Specify the command no history to disable terminal history and specify terminal history to reenable it. The LightStream 1010 ATM Switch Command Reference (11.2) publication provides the complete syntax for every switch configuration command and describes what the no form of a command does.
The user interface also provides context-sensitive help on command syntax. 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 easily edit command entries.
Perform the tasks in the following sections to become familiar with the LightStream 1010 ATM switch user interface:
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.
| Command Mode | Access Method | Prompt | Exit Method |
|---|---|---|---|
Log in to the switch. | | Use the logout command. | |
From user EXEC mode, use the enable EXEC command. | | To exit back to user EXEC mode, use the disable command. To enter global configuration mode, use the configure privileged EXEC 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, type continue. | |
From privileged EXEC mode, use the configure privileged EXEC command. | | To exit to privileged EXEC mode, use the exit or end command or press Ctrl-Z. To enter interface configuration mode, enter an interface configuration command. | |
From global configuration mode, enter by specifying an interface with an interface command. | | To exit to global configuration mode, use the exit command. To exit to privileged EXEC mode, use the exit command or press Ctrl-Z. To enter subinterface configuration mode, specify a subinterface with the interface command. | |
From interface configuration mode, specify a subinterface with an interface command. | | To exit to global configuration mode, use the exit command. To enter privileged EXEC mode, use the end command or press Ctrl-Z. | |
From global configuration mode, enter by specifying a line with a line command. | | To exit to global configuration mode, use the exit command. To enter 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 map-class configuration mode, use the map-class command. To enter privileged EXEC mode, use the end command or press Ctrl-Z. | |
From global configuration mode, configure a map class with the map-class command. | | To exit to global configuration mode, use the exit command. To enter privileged EXEC mode, 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 enter 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 enter 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 to privileged EXEC mode, use the exit 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 to privileged EXEC mode, use the exit command or press Ctrl-Z. |
When you log in to the switch, you are in user 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 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 initial configuration using the hostname global configuration command described in the section "Configure the System Information").
To list the commands available in user EXEC mode, enter a question mark (?) as shown in the following example:
Switch> ?
Exec commands:
access-enable Create a temporary Access-List entry
access-profile Apply user-profile to interface
cd Change current device
clear Reset functions
connect Open a terminal connection
dir List files on given device
disable Turn off privileged commands
disconnect Disconnect an existing network connection
enable Turn on privileged commands
exit Exit from the EXEC
help Description of the interactive help system
lock Lock the terminal
login Log in as a particular user
logout Exit from the EXEC
mrinfo Request neighbor and version information from a multicast
router
mstat Show statistics after multiple multicast traceroutes
mtrace Trace reverse multicast path from destination to source
name-connection Name an existing network connection
ping Send echo messages
ppp Start IETF Point-to-Point Protocol (PPP)
pwd Display current device
resume Resume an active network connection
show Show running system information
slip Start Serial-line IP (SLIP)
systat Display information about terminal lines
telnet Open a telnet connection
terminal Set terminal line parameters
traceroute Trace route to destination
tunnel Open a tunnel connection
where List active connections
Switch>
Because many privileged commands set operating parameters, privileged access should be password-protected to prevent unauthorized use. The privileged command set includes user EXEC mode commands and the configure command (through which you can access the remaining command modes). Privilege EXEC mode also includes high-level testing commands, such as debug. For details on the debug commands, see the LightStream 1010 ATM Switch Command Reference (11.2) (11.2) publication.
To access and list the privileged EXEC commands, complete the following tasks:
| Task | Command |
|---|---|
Step 1 Enter the privileged EXEC mode. | enable |
Step 2 List privileged EXEC commands. | ? |
If the system administrator sets a password, you are prompted to enter it before being 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, enabled mode can only be accessed from the console. The system administrator uses the enable password global configuration command to set the password that restricts access to privileged mode. This command is described in the LightStream 1010 ATM Switch Command Reference (11.2) publication.
The privileged EXEC mode prompt consists of the switch's host name followed by the pound sign (#). (If the switch was named with the hostname command, that name would appear as the prompt instead of "Switch.")
Switch#
The following example shows how to access privileged EXEC mode and list privileged EXEC commands:
Switch> enable
Password: Switch# ?
Exec commands:
access-enable Create a temporary Access-List entry
access-profile Apply user-profile to interface
access-template Create a temporary Access-List entry
atm ATM commands
calendar Manage the hardware calendar
cd Change current device
clear Reset functions
clock Manage the system clock
configure Enter configuration mode
connect Open a terminal connection
copy Copy configuration or image data
debug Debugging functions (see also 'undebug')
delete Delete a file
dir List files on given device
disable Turn off privileged commands
disconnect Disconnect an existing network connection
enable Turn on privileged commands
erase Erase flash or configuration memory
exit Exit from the EXEC
format Format a device
help Description of the interactive help system
lock Lock the terminal
login Log in as a particular user
logout Exit from the EXEC
mrinfo Request neighbor and version information from a multicast
router
mstat Show statistics after multiple multicast traceroutes
mtrace Trace reverse multicast path from destination to source
name-connection Name an existing network connection
no Disable debugging functions
ping Send echo messages
ppp Start IETF Point-to-Point Protocol (PPP)
pwd Display current device
reload Halt and perform a cold restart
resume Resume an active network connection
rsh Execute a remote command
send Send a message to other tty lines
show Show running system information
slip Start Serial-line IP (SLIP)
squeeze Squeeze a device
start-chat Start a chat-script on a line
systat Display information about terminal lines
telnet Open a telnet connection
terminal Set terminal line parameters
test Test subsystems, memory, and interfaces
traceroute Trace route to destination
tunnel Open a tunnel connection
undebug Disable debugging functions (see also 'debug')
undelete Undelete a file
verify Verify checksum of a Flash file
where List active connections
write Write running configuration to memory, network, or terminal
Switch#
From the privileged level, you can access global configuration mode. For instructions, see the "Global Configuration Mode" section, which follows this section.
To return from privileged EXEC mode to user EXEC mode, perform the following task:
| Task | Command |
|---|---|
Move from privileged EXEC mode to user EXEC mode. |
If your switch does not find a valid system image, or if you interrupt the boot sequence, the system might enter read-only memory (ROM) monitor mode. From ROM monitor mode, you can boot the switch or perform diagnostic tests.
You can enter ROM monitor mode by entering the reload EXEC command and pressing the Break key during the first 60 seconds of startup. To save changes to the configuration file, use the copy running-config startup-config command before issuing the reload command.
To access and list the ROM monitor configuration commands, complete the following tasks:
| Task | Command |
|---|---|
Enter ROM monitor mode from privileged EXEC mode. | reload1 |
List the ROM monitor commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The ROM monitor prompt is the angle bracket (>):
rommon 1> help
alias set and display aliases command boot boot up an external process break set/show/clear the breakpoint confreg configuration register utility cont continue executing a downloaded image context display the context of a loaded image dev list the device table dir list files in file system dis disassemble instruction stream dnld serial download a program module frame print out a selected stack frame help monitor builtin command help history monitor command history meminfo main memory information repeat repeat a monitor command reset system reset set display the monitor variables stack produce a stack trace sync write monitor environment to NVRAM sysret print out info from last system return unalias unset an alias unset unset a monitor variable rommon 3 >
To initialize the switch, enter the boot command. To boot the system image file, use the boot command as described in the chapter "Loading System Images, Software Images, and Configuration Files."
Global configuration commands apply to features that affect the entire system. Use the configure privileged EXEC command to enter global configuration mode. When you enter this command, the EXEC prompts you for the source of the configuration commands:
Configuring from terminal, memory, or network [terminal]?
You can then 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 Images, Software Images, and Configuration Files." The default is to enter commands from the terminal console. Pressing the Return key begins this configuration method.
To access and list the global configuration commands, complete the following tasks:
| Task | Command |
|---|---|
Step 1 At the terminal, from the privileged EXEC mode, enter global configuration mode. | |
Step 2 List the global configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example shows how to access global configuration mode and list global configuration commands:
Switch# configure
Configuring from terminal, memory, or network [terminal]? <CR>
Enter configuration commands, one per line. End with CNTL/Z. Switch(config)# ?
Configure commands:
aaa Authentication, Authorization and Accounting.
access-list Add an access list entry
alias Create command alias
arp Set a static ARP entry
async-bootp Modify system bootp parameters
atm Global ATM configuration subcommands
atmacct-deb My debug command
banner Define a login banner
boot Modify system boot parameters
buffers Adjust system buffer pool parameters
cdp Global CDP configuration subcommands
chat-script Define a modem chat script
clock Configure time-of-day clock
config-register Define the configuration register
default Set a command to its defaults
default-value Default character-bits values
dialer-list Create a dialer list entry
dnsix-dmdp Provide DMDP service for DNSIX
dnsix-nat Provide DNSIX service for audit trails
downward-compatible-config Generate a configuration compatible with older
software
enable Modify enable password parameters
end Exit from configure mode
exception Exception handling
exit Exit from configure mode
help Description of the interactive help system
hostname Set system's network name
interface Select an interface to configure
ip Global IP configuration subcommands
lane Configure LAN Emulation
line Configure a terminal line
logging Modify message logging facilities
map-class Configure static map class
map-list Configure static map list
multilink PPP multilink global configuration
network-clock-select Network clock select
no Negate a command or set its defaults
ntp Configure NTP
priority-list Build a priority list
privilege Command privilege parameters
queue-list Build a custom queue list
rif Source-route RIF cache
rmon Remote Monitoring
route-map Create route-map or enter route-map command mode
router Enable a routing process
scheduler Scheduler parameters
service Modify use of network based services
snmp-server Modify SNMP parameters
tacacs-server Modify TACACS query parameters
tftp-server Provide TFTP service for netload requests
username Establish User Name Authentication
virtual-profile Dialer Global Configuration
Switch(config)#
To exit global configuration command mode and return to privileged EXEC mode, use one of the following commands:
| Task | Command |
|---|---|
Exit global configuration mode. |
From global configuration mode, you can access the following configuration modes:
These command modes are described in the following sections.
You can enable many features on a per-interface basis. Interface configuration commands modify the operation of an interface such as an ATM, Ethernet, or asynchronous port. Interface configuration commands always follow an interface global configuration command, which defines the interface type.
To access and list the interface configuration commands, complete the following task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, enter interface configuration mode. | |
Step 2 List the interface configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example shows how to configure an ATM interface 3/0/0. The new prompt Switch(config-if)# indicates interface configuration mode. In this example, the user asks for help by requesting a list of commands.
Switch# configure
Configuring from terminal, memory, or network [terminal]? Enter configuration commands, one per line. End with CNTL/Z. Switch(config)# interface ?
ATM ATM interface Async Async interface BVI Bridge-Group Virtual Interface CBR CBR interface Dialer Dialer interface Ethernet IEEE 802.3 Group-Async Async Group interface Lex Lex interface Loopback Loopback interface Null Null interface Tunnel Tunnel interface Virtual-Template Virtual Template interface Virtual-TokenRing Virtual TokenRing Vlan Catalyst 5000 Vlan Switch(config)# Switch(config)# interface atm 3/0/0
Switch(config-if)#? Interface configuration commands: arp Set arp type (arpa, probe, snap) or timeout asig ATM Signalling Interface Subcommands atm Modify ATM parameters bandwidth Set bandwidth informational parameter carrier-delay Specify delay for interface transitions cdp CDP interface subcommands clock config Tx clock custom-queue-list Assign a custom queue list to an interface default Set a command to its defaults delay Specify interface throughput delay description Interface specific description exit Exit from interface configuration mode help Description of the interactive help system hold-queue Set hold queue depth load-interval Specify interval for load calculation for an interface logging Configure logging for interface loopback Configure internal loopback on an interface map-group Configure static map group mtu Set the interface Maximum Transmission Unit (MTU) multiring Enable RIF usage for a routable protocol no Negate a command or set its defaults ntp Configure NTP priority-group Assign a priority group to an interface random-detect Enable Random Early Detection (RED) on an Interface scrambling Configure SONET scrambling shutdown Shutdown the selected interface snmp Modify SNMP interface parameters sonet Configure OC3 SONET mode sscop SSCOP Interface Subcommands timeout Define timeout values for this interface traffic-shape Enable Traffic Shaping on an Interface or Sub-Interface transmit-interface Assign a transmit interface to a receive-only interface tx-queue-limit Configure card level transmit queue limit Switch(config-if)#
To exit interface configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
You can configure multiple logical interfaces (called subinterfaces) on a single ASP interface. You can configure multiple subinterfaces for VP tunneling on each ATM interface the subinterface number corresponds to the VPI. VP tunnels are not used on ASP interfaces.
To access and list the subinterface configuration commands, complete the following task:
| Task | Command |
|---|---|
Step 1 From interface configuration mode, configure a logical interface. | interface atm card/sub_card/port |
Step 2 List the subinterface configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
In the following example, an interface is configured for ATM 0/0/0. The subinterface number 99 to indicate that it is subinterface 99 of port 0 on the port adapter module (PAM) 0 in carrier module (CM in slot 0). The subinterface 99 also designates a tunnel with VPI=99 on ATM interface 0/0/0.
The new prompt, Switch(config-subif)#, indicates subinterface configuration mode. The subinterface can be configured to support one or more ATM PVCs. To list the commands available in subinterface configuration mode, enter a question mark (?).
Switch(config)# interface atm 0/0/0.99
Switch(config-subif)#?
Interface configuration commands: atm ATM Interface ILMI Config Commands bandwidth Set bandwidth informational parameter cdp CDP interface subcommands delay Specify interface throughput delay description Interface specific description exit Exit from interface configuration mode map-group Configure static map group no Negate a command or set its defaults ntp Configure NTP shutdown Shutdown the selected interface Switch(config-subif)#
To exit subinterface configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, press Ctrl-Z.
Line configuration commands modify the operation of a terminal line. Line configuration commands follow a line command, which defines a line number. you use these commands to connect to remote switches, change terminal parameter settings (either on a line-by-line basis or for a range of lines) and set up the auxiliary port modem configuration. For detailed line configuration instructions, see the chapter "Configuring Terminal Lines and Modem Support."
To access and list the auxiliary port, console port, and virtual terminal line configuration commands, complete the following task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, configure an auxiliary, console, or virtual terminal line. | line {aux | con | vty} line-number [ending-line-number]1 |
Step 2 List the line configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example shows how to enter line configuration mode for the console line and list the line configuration commands. The new prompt Switch(config-line)# indicates line configuration mode.
Switch(config)# line console 0
Switch(config-line)#?
Line configuration commands:
access-class Filter connections based on an IP access list
autocommand Automatically execute an EXEC command
data-character-bits Size of characters being handled
databits Set number of data bits per character
default Set a command to its defaults
domain-lookup Enable domain lookups in show commands
editing Enable command line editing
escape-character Change the current line's escape character
exec Start an EXEC process
exec-banner Enable the display of the EXEC banner
exec-character-bits Size of characters to the command exec
exec-timeout Set the EXEC timeout
exit Exit from line configuration mode
flowcontrol Set the flow control
full-help Provide help to unprivileged user
help Description of the interactive help system
history Enable and control the command history function
international Enable international 8-bit character support
ip IP options
length Set number of lines on a screen
location Enter terminal location description
logging Modify message logging facilities
login Enable password checking
modem Configure the Modem Control Lines
monitor Copy debug output to the current terminal line
motd-banner Enable the display of the MOTD banner
no Negate a command or set its defaults
notify Inform users of output from concurrent sessions
ntp Configure NTP
padding Set padding for a specified output character
parity Set terminal parity
password Set a password
privilege Change privilege level for line
refuse-message Define a refuse banner
rotary Add line to a rotary group
rxspeed Set the receive speed
script specify event related chat scripts to run on the line
session-timeout Set interval for closing connection when there is no
input traffic
special-character-bits Size of the escape (and other special) characters
speed Set the transmit and receive speeds
start-character Define the start character
stop-character Define the stop character
stopbits Set async line stop bits
terminal-type Set the terminal type
transport Define transport protocols for line
txspeed Set the transmit speeds
vacant-message Define a vacant banner
width Set width of the display terminal
Switch(config-line)#
To exit line configuration mode and return to global configuration mode, use the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The LightStream 1010 ATM switch supports a static mapping scheme that identifies the ATM address of remote hosts or switches.
Map-list configuration commands configure a map list. They always follow a map-list global configuration command. To access and list the map list configuration commands, complete the following task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, use the map-list command. | map-list name 1 |
Step 2 List the map-list configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example shows how to enter map-list configuration mode and list the map-list configuration commands. In this example, the static map-list configuration commands are listed. The new prompt Switch(config-map-list)# indicates map-list configuration mode.
Switch(config)# map-list 1
Switch(config-map-list)#?
Static maps list configuration commands: arp IP ARP cdp Cisco Discovery Protocol compressedtcp Compressed TCP default Set a command to its defaults exit-class Exit from static map class configuration mode help Description of the interactive help system ip IP no Negate a command or set its defaults Switch(config-map-list)#
To exit map-list configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The ATM interface allows you to specify traffic parameters that control how much traffic the source switch sends over a switched virtual circuit (SVC).
To define traffic parameters that are associated with a static map for an SVC, use the following map-class global configuration command:
| Task | Command |
|---|---|
Step 3 From global configuration mode, configure an ATM map class. | map-class {atm | dialer | frame-relay} |
Step 4 From map-class configuration mode, configure a map-class and a map-class name. | map-class class class-name1 |
Step 5 List the map-class configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example displays a list of the static map-class configuration commands. The prompt Switch(config-map-class)# indicates map-class configuration mode.
Switch(config)#map-class ?
atm Asynchronous transfer mode dialer Dial on Demand frame-relay Frame Relay Switch(config)# map-class atm example
Switch(config-map-class)#?
Static maps class configuration commands: atm Configure atm static map class dialer Configure dialer static map class exit-class Exit from static map class configuration mode help Description of the interactive help system no Negate or set default values of a command Switch(config-map-class)#
To exit map-class configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The LightStream 1010 ATM switch supports the Private Network-to-Network Interface (PNNI) routing protocol. The atm router pnni command entered from privileged EXEC command mode allows you to change to PNNI router configuration mode.
To access and list the atm router pnni configuration commands, complete the following task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, use the atm router pnni command. | atm router pnni 1 |
Step 2 List the ATM router configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example shows how to enter ATM router PNNI configuration mode and list the ATM router PNNI configuration commands. The new prompt Switch(config-atm-router)# indicates ATM router PNNI configuration mode.
Switch(config)# atm router pnni
Switch(config-atm-router)#?
ATM router configuration commands:
administrative-weight Select mode of administrative weight assignment
background-routes Enable or Disable Background Routes
bg Background SPF Related Parameters
exit Exit from ATM routing protocol configuration
mode
max-admin-weight-percentage Maximum Administrative Weight Percentage
no Negate or set default values of a command
node Configure PNNI node
precedence Define Prefix Priorities For Routing
rm-poll-interval How Often To Poll Resource Manager
statistics Turn on PNNI statistics
Switch(config-atm-router)#
To exit ATM router configuration mode and return to global configuration mode, enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The LightStream 1010 ATM switch supports the PNNI routing protocol. The ATM router PNNI node command, entered from ATM router command mode, allows you to change to PNNI node configuration mode.
To access and list the ATM router PNNI node configuration commands, complete the following task:
| Task | Command |
|---|---|
Step 1 From ATM router configuration mode, use the node command. | node index_number1 |
Step 2 List the PNNI node configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example shows how to enter PNNI node configuration mode for PNNI node index number one and list the ATM router PNNI node configuration commands. The new prompt Switch(config-pnni-node)# indicates PNNI node configuration mode.
Switch(config)# atm router pnni
Switch(config-atm-router)#node 1
Switch(config-pnni-node)#?
PNNI router node configuration commands: auto-summary Automatically summarize switch address prefix exit Exit from PNNI router node configuration mode name Configure Node's Name no Negate or set default values of a command ptse PTSE generation parameters redistribute Route redistribution from another routing protocol scope PNNI Scope summary-address Summarize reachable addresses into PNNI timer PNNI timer variables transit-restricted Transit calls are not allowed Switch(config-pnni-node)#
To exit PNNI node configuration mode and return to ATM router configuration mode, enter the exit command. To exit PNNI node configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The ATM accounting feature allows accounting and billing of virtual circuits (VCs) used on the LightStream 1010 ATM switch. The atm accounting file command allows you to change to ATM accounting file configuration mode.
To access and list the ATM accounting file configuration commands, complete the following task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, configure an ATM accounting file. | atm accounting file file_name1 |
Step 2 List the ATM accounting file configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example shows how to enter ATM accounting file configuration mode for ATM accounting configuration and list the ATM accounting file configuration commands. The new prompt Switch(config-acct-file)# indicates ATM accounting file configuration mode.
Switch(config)# atm accounting file acctng_file1
Switch(config-acct-file)#?
Accounting file subcommands: collection-modes When to write to accounting file default Set a command to its defaults description A short description of the file enable Activate collection in this file exit Leave 'atm accounting file' mode failed-attempts Whether to record failed connection attempts help Description of the interactive help system interval Interval for periodic collection (seconds) min-age Minimum age of a VC (seconds) no Negate a command or set its defaults Switch(config-acct-file)#
To exit ATM accounting file configuration mode, return to global configuration mode and enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The ATM accounting feature is allows accounting and billing of VCs used on the LightStream 1010 ATM switch. The atm accounting selection command allows you to change to ATM accounting selection configuration mode.
To access and list the ATM accounting selection configuration commands, complete the following task:
| Task | Command |
|---|---|
Step 1 From global configuration mode, configure an ATM accounting selection index. | atm accounting selection index_number1 |
Step 2 List the ATM accounting file configuration commands. | ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2) publication. |
The following example shows how to enter ATM accounting selection configuration mode for ATM accounting configuration and list the ATM accounting selection configuration commands. The new prompt Switch(config-acct-sel)# indicates ATM accounting selection configuration mode.
Switch(config)# atm accounting selection 1
Switch(config-acct-sel)#?
Accounting selection subcommands: connect-type Types of connections for accounting default Set a command to its defaults exit Leave 'atm accounting selection' mode help Description of the interactive help system list list of objects to include no Negate a command or set its defaults Switch(config-acct-sel)#
To exit ATM accounting selection configuration mode, return to global configuration mode and enter the exit command. To exit configuration mode and return to privileged EXEC mode, use the end command or press Ctrl-Z.
The user interface provides the first level of help available. Entering a question mark (?) at the system prompt displays a list of commands available for each command mode. You can also obtain a list of keywords and arguments for any command with the context-sensitive help feature.
To get help specific to a command mode, a command, a keyword, or arguments, perform one of the following tasks:
| Task | Command |
|---|---|
Obtain a brief description of the help system in any command mode. | |
Configure a line or lines to receive help for the full set of user-level commands when a user presses ?. | full-help |
Configure a line to receive help for the full set of user-level commands for this exec session. | terminal full-help1 |
Obtain a list of commands that begins with a particular character string. | |
Complete a partial command name. | abbreviated-command-entry<Tab> |
List all commands available for a particular command mode. | |
List a command's associated keywords. | command ? |
List a keyword's associated arguments. | command keyword ? |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2). |
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, type in 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.
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.
You can abbreviate commands and keywords for the 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:
Switch# 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?'.)
As described in the help command output, you can enter a partial command name and a question mark (?) to obtain a list of commands beginning with a particular character set. See "Complete a Partial Command Name" later in this chapter for more detail.
The following example illustrates how the context-sensitive help feature enables you to create an access list from configuration mode. Enter the letters 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.
Switch# 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:
Switch# configure ?
memory Configure from NV memory network Configure from a TFTP network host overwrite-network Overwrite NV memory from TFTP network host terminal Configure from the terminal <cr> Switch(boot)#configure
Enter the terminal keyword to enter configuration mode from the terminal:
Switch# configure terminal
Enter configuration commands, one per line. End with CNTL/Z. Switch(boot)(config)#
Enter the access-list command followed by a space and a question mark (?) to list the command's keywords:
Switch(config)# access-list ?
<1-99> IP standard access list <100-199> IP extended access list
Enter the access list number 99, and then enter another question mark (?) to see the arguments for the keyword and brief explanations:
Switch(config)# access-list 99 ?
deny Specify packets to reject permit Specify packets to forward
Enter the deny argument followed by a question mark (?) to list additional options:
Switch(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 list additional options:
Switch(config)# access-list 99 deny 131.108.134.0 ?
A.B.C.D Wildcard bits <cr>
The <cr> symbol appears in the list, you can press Return to execute the command. You can also add a wildcard mask. Enter the wildcard mask followed by a question mark (?) to list further options.
Switch(config)# access-list 99 deny 131.108.134.0 0.0.0.255 ? <cr> Switch(config)# access-list 99 deny 131.108.134.0 0.0.0.255
The <cr> symbol by itself indicates there are no more keywords or arguments. Press Return to execute the command. 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 error isolation in the form of an error indicator (^). The ^ symbol appears 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.
In the following example, suppose you want to set the switch clock. For example, whe you set the switch clock, use context-sensitive help to check the syntax for setting the clock.
Switch# clock ?
read-calendar Read the hardware calendar into the clock set Set the time and date update-calendar Update the hardware calendar from the clock Switch# clock
The help output shows you that the set keyword is required. Next, check the syntax for entering the time:
Switch# clock set ?
hh:mm:ss Current time Switch# clock set
Enter the current time:
Switch# clock set 13:32:00
% Incomplete command.
The system indicates that you need to provide additional arguments to complete the command. Press Ctrl-P (see the next section, "Use the Command History Features" to automatically repeat the previous command entry then add a space and a question mark (?) to reveal the additional arguments:
Switch# clock set 13:32:00 ?
<1-31> Day of the month January Month of the year February March April May June July August September October November December
Now you can complete the command entry:
Switch# clock set 13:32:00 23 February 93
^ % Invalid input detected at '^' marker.
The caret symbol (^) and help response indicate an error at 93. To list the correct syntax, enter the command where the error occurred and then enter a question mark (?):
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
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:
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, complete the following task in EXEC mode:
| Task | Command |
|---|---|
Enable the command history feature for the current terminal session. | terminal history [size number-of-lines]1 |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2). |
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, complete the following task in line configuration mode:
| Task | Command |
|---|---|
Enable the command history feature. |
| 1The no history command turns off command history for the line. |
To recall commands from the history buffer, perform one of the following 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.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. | Press Ctrl-N or the down arrow key.1 |
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. |
The command history feature is automatically enabled. To disable it during the current terminal session, complete the following task in EXEC mode:
| Task | Command |
|---|---|
Disable the command history feature for the current session. |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2). |
To configure a specific line to disabled the command history feature, complete the following task in line configuration mode:
| Task | Command |
|---|---|
Configure the line to disable the command history feature. |
The current software release 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 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.
Using the editing features you can complete the tasks in the following sections:
Although 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, complete the following task in EXEC mode:
| Task | Command |
|---|---|
Enable the enhanced editing features for the current terminal session. |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2). |
To reconfigure a specific line to have enhanced editing mode, complete the following task in line configuration mode:
| Task | Command |
|---|---|
Enable the enhanced editing features. |
Perform the following tasks to move the cursor around on the command line for corrections or changes:
Move the cursor back one character. Press Ctrl-B or Move the cursor forward one character. Press Ctrl-F or 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.
Task
Keystrokes
press the left arrow key.1
press the right arrow key.1
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. To do so, perform the following task:
| 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:
Switch# conf<Tab>
Switch# configure
If you enter a set of characters that indicates more than one command, the system beeps to indicate an error. Enter a question mark (?) to obtain a list of commands that begins with that set of characters. Do not leave a space between the last letter and the question mark (?).
For example, there are three commands in privileged mode that start with co. To see what they are, type co? at the privileged EXEC prompt:
Switch# co?
configure connect copy Switch# co
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 the following 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 will 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 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 the following task:
| Task | Keystrokes |
|---|---|
Return to the beginning of a command line to verify that you 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.1 |
| 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 in conjunction 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.
Perform any of the following 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 all characters from the cursor to the end of the command line. | Press Ctrl-K. |
Delete all characters 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. |
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 view the next line or screen, complete the following tasks:
| Task | Keystrokes |
|---|---|
Scroll down one line. | Press the Return key. |
Scroll down one screen. | Press the Space bar. |
---More--- prompt is used for any output that has more lines than can be displayed on the terminal screen, including show command output. You can use the keystrokes listed above whenever you see the ---More--- prompt.
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, perform the following task:
| Task | Keystrokes |
|---|---|
Redisplay the current command line. | Press Ctrl-L or Ctrl-R. |
If you have mistyped a command entry, you can transpose the mistyped characters by performing the following task:
| Task | Keystrokes |
|---|---|
Transpose the character to the left of the cursor with the character located at the cursor. | Press Ctrl-T. |
You can capitalize or lowercase words or capitalize a set of letters with simple keystroke sequences. To do so, perform the following task:
| 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. |
If you want to use a particular keystroke as an executable command, insert a system code for this purpose:
| Task | Keystrokes |
|---|---|
Insert a code to indicate to the system that the following keystroke should be treated as a command entry, not an editing key. | Press Ctrl-V or Esc Q. |
To disable enhanced editing mode and revert to the editing mode, perform the following task in EXEC mode:
| Task | Command |
|---|---|
Disable the enhanced editing features for the local line. |
| 1This command is documented in the LightStream 1010 ATM Switch Command Reference (11.2). |
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 using the setup command or other configuration commands, exit the switch and quit the session.
To end a session, perform the following task:
| Task | Command |
|---|---|
Enter the quit EXEC command. | quit |
|
|