|
|
This appendix provides the following information:
This section describes the CLI command mode structure. Command modes support specific Cisco IOS commands. For example, the interface type_number command works only when entered in global configuration mode. The Cisco IOS command modes are as follows:
Table B-1 lists the command modes, how to access each mode, the prompt you will see in that mode, and how to exit that mode. The prompts listed assume the default name ATM.
| Command Mode | Access Method | Prompt | Exit Method |
|---|---|---|---|
Begin a session with the ATM module. | ATM> | Enter the logout command. | |
From user EXEC mode, enter the enable EXEC command. | ATM# | To exit to user EXEC mode, enter the disable command. To enter global configuration mode, enter the configure command. | |
From privileged EXEC mode, enter the configure privileged EXEC command. | ATM (config)# | To exit to privileged EXEC mode, enter the exit or end command, or press Ctrl-Z. To enter interface configuration mode, enter the interface configuration command. | |
From privileged EXEC mode, enter the lane database command. | Switch (lane-config-database)# | (This command mode is not available on these ATM modules. However, it can be used on any other device in your ATM environment.) To exit to LANE database mode, enter the exit or end command, or press Ctrl-Z. To enter interface configuration mode, enter the interface configuration command. | |
From global configuration mode, specify an interface by entering the interface command. | ATM (config-if)# | To exit to global configuration mode, enter the end command. To exit to privileged EXEC mode, enter the exit command, or press Ctrl-Z. To enter subinterface configuration mode, specify a subinterface with the interface command. On the ATM module, the LANE client is considered a subinterface. | |
From global configuration mode, specify an MPOA by entering the mpoa client configuration or mpoa server configuration command. | ATM (mpoa-client-config)#
ATM (mpoa-sever-config)# | To exit to global configuration mode, enter the exit command. To return to privileged EXEC mode, enter the end command, or press Ctrl-Z. | |
From global configuration mode, specify a line by entering the line command. | ATM (config-line)# | To exit to global configuration mode, enter the exit command. To return to privileged EXEC mode, enter the end command, or press Ctrl-Z. |
The list of user EXEC commands displayed in the following example is a subset of the supported commands. The supported commands can vary, depending on the version of IOS Software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.
ATM> ? Exec commands: clear Reset functions disable Turn off privileged commands enable Turn on privileged commands exit Exit from the EXEC help Description of the interactive help system login Log in as a particular user logout Exit from the EXEC show Show running system information terminal Set terminal line parameters ATM>
Because many of the privileged commands configure operating parameters, privileged access should be password-protected to prevent unauthorized use. The privileged command set includes those commands contained in user EXEC mode, as well as the configure command through which you access the remaining command modes.
If your system administrator has set a password, you are prompted to enter it before being granted access to privileged EXEC mode. The password is not displayed on the screen and is case sensitive.
The privileged EXEC mode prompt is as follows:
ATM#
Enter the enable command to access privileged EXEC mode:
ATM> enable ATM#
The list of privileged EXEC commands displayed in the following example is a subset of the supported commands. The supported commands can vary, depending on the version of IOS software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.
ATM# ? Exec commands: clear Reset functions configure Enter configuration mode debug Debugging functions (see also 'undebug') disable Turn off privileged commands enable Turn on privileged commands exit Exit from the EXEC help Description of the interactive help system login Log in as a particular user logout Exit from the EXEC reload Halt and perform a cold restart show Show running system information terminal Set terminal line parameters write Write running configuration to memory, network, or terminal ATM#
To return from privileged EXEC mode to user EXEC mode, enter the disable command.
When you enter the configure command, the console prompts you for the source of the configuration commands:
ATM# configure Configuring from terminal, memory, or network [terminal]?
You can specify either the terminal or NVRAM as the source of configuration commands.
The following example shows you how to access global configuration mode:
ATM# configure terminal Enter configuration commands, one per line. End with CNTL/Z.
The list of global configuration commands displayed in the following example is a subset of the supported commands. The supported commands can vary depending on the version of IOS software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.
ATM(config)# ? Configure commands: alias Create command alias default Set a command to its defaults enable Modify enable password parameters end Exit from configure mode exit Exit from configure mode help Description of the interactive help system hostname Set system's network name interface Select an interface to configure line Configure a terminal line no Negate a command or set its defaults privilege Command privilege parameters username Establish User Name Authentication . ATM(config)#
To exit global configuration command mode and return to privileged EXEC mode, enter the end or exit command, or press Ctrl-Z.
LANE database configuration commands allow you to configure LANE. LANE database configuration commands always follow a global configuration command, which defines the interface type.
Use the lane database command to access LANE database configuration mode. The following example shows you how to access LANE database configuration mode:
ATM(config)# lane database mydatabase
The list of interface configuration commands displayed in the following example is a subset of the supported commands. The supported commands can vary, depending on the version of IOS software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.
ATM(lane-config-database)#? Lane LECS configuration table manipulation commands: client-atm-address the nsap address of LEC default Set a command to its defaults default-name set the default elan display-databases command to display all the lecs database tables exit keyword to leave lane config database mode help Description of the interactive help system mac-address the mac address of LEC name introduce the name of elan being created or changed no Negate a command or set its defaults ATM(lane-config-database)#
To exit interface configuration mode and return to global configuration mode, enter the exit command. To exit interface configuration mode and return to privileged EXEC mode, enter the end command, or press Ctrl-Z.
Use the interface type_number.subif command to access interface configuration mode. In the following example, ATM interface 1 is about to be configured. The new prompt, ATM(config-if)#, indicates interface configuration mode.
The following example shows you how to access interface configuration mode:
ATM(config)# int atm1
The list of interface configuration commands displayed in the following example is a subset of the supported commands. The supported commands can vary, depending on the version of IOS software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.
ATM(config-if)# ? Interface configuration commands: atm Modify ATM parameters default Set a command to its defaults description Interface specific description exit Exit from interface configuration mode lane Modify LANE parameters mtu Set the interface Maximum Transmission Unit (MTU) no Negate a command or set its defaults shutdown Shutdown the selected interface ATM(config-if)#
To exit interface configuration mode and return to global configuration mode, enter the exit command. To exit interface configuration mode and return to privileged EXEC mode, enter the end command, or press Ctrl-Z.
Use the mpoa command to access MPOA configuration mode. The following example shows you how to access MPOA configuration mode:
ATM(config)# mpoa client config name engineering
The list of MPOA configuration commands displayed in the following example is a subset of the supported commands. The supported commands can vary depending on the version of IOS software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.
ATM(mpoa-client-config)#? MPOA client configuration mode subcommands: atm-address specify the control atm address of the MPC default Set a command to its defaults exit exit the MPOA Client config mode no Negate a command or set its defaults shortcut-frame-count specify the shortcut-setup frame count of the MPC shortcut-frame-time specify the shortcut-setup frame time of the MPC ATM(mpoa-client-config)#
To exit MPOA configuration mode and return to global configuration mode, enter the exit command. To exit global configuration mode and return to privileged EXEC mode, enter the end command, or press Ctrl-Z.
Use the line vty line_number [ending_line_number] command to enter line configuration mode. The new prompt, ATM(config-line)#, indicates line configuration mode. The following example shows how to enter line configuration mode for virtual terminal line 7:
ATM(config)# line vty 0 7
The list of line configuration commands displayed in the following example is a subset of the supported commands. The supported commands can vary, depending on the version of IOS software in use. To view a comprehensive list of commands, enter a question mark (?) at the prompt.
ATM(config-line)# ? Line configuration commands: autocommand Automatically execute an EXEC command editing Enable command line editing escape-character Change the current line's escape character exec-banner Enable the display of the EXEC banner exec-timeout Set the EXEC timeout exit Exit from line configuration mode full-help Provide help to unprivileged user help Description of the interactive help system history Enable and control the command historyfunction length Set number of lines on a screen location Enter terminal location description logging Modify message logging facilities login Enable password checking 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 concurrentsessions padding Set padding for a specified output character password Set a password privilege Change privilege level for line refuse-message Define a refuse banner session-timeout Set interval for closing connection when there is no input traffic terminal-type Set the terminal type vacant-message Define a vacant banner width Set width of the display terminal ATM(config-line)#
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, enter the end command, or press Ctrl-Z.
The Cisco IOS software commands in this section are specific to the ATM module.
Use the atm bind interface configuration command to bind a PVC to a VLAN. Use the no form of this command to remove the bind.
atm bind pvc vlan vc_no vlan_idvc_no | Virtual circuit descriptor, a unique number for each switch that identifies which virtual path identifier/virtual channel identifier (VPI/VCI) to use for a particular packet. |
|---|---|
vlan_id | Number of the VLAN. |
None
Interface configuration
You can bind any number of PVCs to the same VLAN. To prevent loops, ensure that each PVC uniquely connects a VLAN group between two Catalyst 2900 XL switches.
The following example shows how to bind PVC 10 to VLAN 5 and PVC 11 to VLAN 5:
ATM(config-if)# atm bind pvc vlan 10 5 ATM(config-if)# atm bind pvc vlan 11 5
show atm vlan
show atm vc
Use the atm pvc interface configuration command to enable the new encapsulation type, AAL5 SNAP, to support RFC-1483. You can specify the traffic-shaping parameters (such as peak rate in kbps, average rate in kbps, and burst-in cell rates) on a permanent virtual circuit (PVC). If you do not specify the traffic-shaping parameters, the default parameters are used. The default value for the peak bandwidth and average bandwidth is the line rate (155 Mbps), and burst cell rate is 4. Use the no form of this command to remove PVCs.
atm pvc vc_no vpi vci encaps [Peak Average [Burst]][OAM time_in_seconds]vc_no | Number of the virtual channel descriptor (VCD). |
vpi | ATM network virtual path identifier (VPI) of this PVC. This value must be 0. |
vci | ATM network virtual channel identifier (VCI) of this PVC, ranging from 1 to 1023. The VCI is a 16-bit field in the header of the ATM cell. The VCI value is unique only on a single link, not throughout the ATM network (it has local significance only). |
encaps | ATM adaptation layer (AAL) and encapsulation type. Possible values are as follows:
|
Peak | Maximum rate (in kbps) at which this virtual circuit can transmit. Valid values range from 130 kbps to 155,000 kbps. If you set this value, you must also specify the average (burst is optional) value. |
Average | Average rate (in kbps) at which this virtual circuit transmits. Valid values are 130 kbps to 155,000 kbps. If you set this value, you must also specify the peak (burst is optional) value. |
Burst | Value that relates to the maximum number of ATM cells the virtual circuit can transmit to the network at the peak rate of the PVC. On the ATM module, burst can range from 1 to 32 cells. |
OAM | Specifies how often to generate an OAM F5 loopback cell from this virtual circuit. |
time_in_seconds | The OAM value. The default value is 10 seconds. |
If peak and average rates are omitted, the PVC defaults to the highest bandwidth rate queue available. Peak and average rates are then equal. By default, the virtual circuit is configured to run as fast as possible.
If the OAM keyword is omitted, OAM cells are not generated. If the OAM keyword is present but the time-in seconds value is omitted, the default value is 10 seconds.
Interface configuration
The following example creates a PVC with VPI 0 and VC 100. The PVC uses RFC-1483 LLC encapsulation.
ATM(config-if)# atm pvc 100 0 100 aal5snap
The following example creates a PVC to be used for ATM signaling for an SVC. It specifies VPI 0 and VCI 5.
ATM(config-if)# atm pvc 1 0 5 qsaal
show atm interface atm
show atm vc
Use the show controllers privileged EXEC command to debug and display local statistics.
show controllers [icache | ecache [ip-addr ip-addr] | imac [mps-id mps-id] | mpc-stats]icache | (Optional) Displays the ingress cache entries. |
ecache | (Optional) Displays the egress cache entries. |
ip-addr | (Optional) Displays entries for a specific IP address. |
ip-addr | The IP address for the ingress cache. |
imac | (Optional) Displays MAC addresses. |
mps-id | (Optional) Displays the ingress cache entries for a specific MPS ID. |
mps-id | The MPS ID for the ingress cache. |
mpc-stats | (Optional) Displays the following information: · Number of ingress packets for shortcut VCs · Number of ingress packets on the default LANE VC · Number of tagged egress packets received · Number of untagged egress packets received · Number of egress MPOA packets dropped |
None
Privileged EXEC, User EXEC
After entering the show controllers command, you see the following display:
ATM> show controllers mpc-stats
MPOA CLIENT Statistics
-----------------------
Eth2AtmMpcStats :
Number of Pkts sent on Shortcut VC : 62725957
Number of Pkts sent on default LANE VC : 689792
Atm2EthMpcStats :
Number of MPOA tagged packets rcvd : 46809422
Number of MPOA untagged packets rcvd : 0
Number of MPOA packets dropped : 0
ATM>
Use the show atm vlan privileged EXEC command to show the relationship between the VLAN and the PVCs.
show atm vlan vlan_idvlan_id | (Optional) Specifies the VLAN number. |
None
Privileged EXEC
If vlan_id is not specified, all active VLAN-to-PVC bindings are displayed.
After entering the show atm vlan command, you see the following display:
ATM# show atm vlan VCD VLAN-ID 10 5 11 5 ATM#
The display shows the VCD of the VC and the VLAN-ID of the VLAN to which the VC belongs.
show atm ilmi-config
show atm ilmi-status
show atm interface
show atm map
show atm signalling
show atm traffic
show atm vc
The Cisco IOS commands listed in Table B-2 are supported by the ATM module. Each command in Table B-2 is in one of the following categories:
| Command | Description | Type1 | Mode2 |
|---|---|---|---|
Creates a shorthand alias. | IOS/ATM | GC | |
Changes the idle timer for SVCs on an interface. | IOS/ATM | IC | |
Enables ILMI keepalives. | IOS/ATM | IC | |
Enables point-to-multipoint signaling to the ATM switch. | IOS/ATM | IC | |
Sets the mode of operation and control type of an ATM cell. | IOS/ATM | EXEC | |
Specifies the UNI version 3.0 or 3.1 the router should use when ILMI link autodetermination is unsuccessful or ILMI is disabled. | IOS/ATM | IC | |
Defines a login banner. | IOS/ATM | EXEC | |
Clears a specified SVC. | IOS/ATM | IC | |
Clears Media Access Control (MAC) and port counters. | IOS/ATM | EXEC | |
Resets the hardware logic on an interface. | IOS/ATM | EXEC | |
Clears the dynamic LANE Address Resolution Protocol (LE_ARP) table or a single LE_ ARP entry of the LANE client. | IOS/LAN | EXEC | |
Returns a terminal to idle state. | IOS/ATM | EXEC | |
Enters global configuration mode. | IOS/ATM | EXEC | |
Adds a description to an interface configuration. | IOS/ATM | IC | |
Displays ATM errors. | IOS/ATM | EXEC | |
Displays ATM events. | IOS/ATM | EXEC | |
Displays information on packets that the network cannot classify. | IOS/ATM | EXEC | |
Enables debugging for the Service Specific Connection Oriented Protocol (SSCOP). | IOS/ATM | EXEC | |
Returns the management console interface to user EXEC mode. | IOS/ATM | EXEC | |
Enables enhanced editing mode for a particular line. | IOS/ATM | LC | |
Enters privileged EXEC mode. | IOS/ATM | EXEC | |
Sets a local password to control access to various privilege levels. | IOS/ATM | GC | |
Exits to configuration mode. | IOS/ATM | GC | |
Retrieves help for the full set of user-level commands. | IOS/ATM | All ATM | |
Displays a brief description of the help system. | Switch | N, P | |
Displays the command history. | IOS/ATM | Line | |
Modifies the host name for the network server. | IOS/ATM | GC | |
Configures an interface type and enters interface configuration mode. | IOS/ATM | GC | |
Specifies an ATM address---and overrides the automatic ATM address assignment---or the broadcast-and-unknown server on the specified subinterface. | IOS/LAN | IC | |
Activates a LANE client on the specified subinterface. | IOS/LAN | IC | |
Specifies an ATM address---and overrides the automatic ATM address assignment---for the LANE client on the specified subinterface. | IOS/LAN | IC | |
Attaches a LANE client to the MPC. | IOS/LAN | IC | |
Specifies a configuration server ATM address explicitly. | IOS/LAN | IC | |
Adds a static entry to the LE_ARP table of the LANE client configured on the specified subinterface. | IOS/LAN | IC | |
Specifies an ATM address---and overrides the automatic ATM address assignment---for the LANE server on the specified subinterface. | IOS/LAN | IC | |
Specifies the LES and BUS for the specified ELAN on the subinterface. | IOS/LAN | IC | |
Enables password checking at login. | IOS/ATM | LC | |
Warns users of a forced timeout. | IOS/ATM | LC | |
Defines an MPC. | IOS/ATM | GC | |
Attaches the MPC to the ATM interface. | IOS/ATM | GC | |
Defines an MPS. | IOS/ATM | GC | |
Attaches the MPS to the ATM interface. | IOS/ATM | GC | |
Specifies a LANE server address in the LECS database. | IOS/ATM | IC | |
Uses the command defaults. | IOS/ATM | LC | |
Sets the privilege level for a command. | IOS/ATM | GC | |
Reloads the operating system. | IOS/Conf | EXEC | |
Displays running system information. | IOS/ATM | EXEC | |
Displays all alias commands or the alias commands in a specified mode. | Switch | N, P | |
Displays ILMI information. | IOS/ATM | EXEC | |
Displays ATM-specific information about an ATM interface. | IOS/ATM | EXEC | |
Displays current global ATM traffic to and from all ATM networks connected to the switch. | IOS/ATM | EXEC | |
Displays all active ATM virtual connections (PVCs and SVCs) and traffic information. | IOS/ATM | EXEC | |
Displays statistics for the buffer pools on the network server. | IOS/ATM | EXEC | |
Displays contents of nonvolatile memory. | IOS/ATM | EXEC | |
Displays the interface controller status. | IOS/ATM | EXEC | |
Shows the address table entries. | IOS/ATM | EXEC | |
Shows the ATM segmentation and reassembly (SAR) counters. | IOS/ATM | EXEC | |
Displays the ingress cache entries. | IOS/ATM | EXEC | |
Displays the MAC counters. | IOS/ATM | EXEC | |
Displays the egress cache entries. | IOS/ATM | EXEC | |
Displays MAC addresses. | IOS/ATM | EXEC | |
Displays the memory buffer pools. | IOS/ATM | EXEC | |
Displays the transmit and receive information for MPC data packets. | IOS/ATM | EXEC | |
Displays the Ethernet-to-ATM and ATM-to-Ethernet relay counters. | IOS/ATM | EXEC | |
Displays the RFC-1483 counters. | IOS/ATM | EXEC | |
Displays the SONET counters. | IOS/ATM | EXEC | |
Displays the switch port information. | IOS/ATM | EXEC | |
Displays information about the types of Cisco Discovery Protocol (CDP) debugging that are enabled for your module. | IOS/ATM | EXEC | |
Lists the commands you have entered in the current EXEC session. | IOS/ATM | EXEC | |
Displays information about the ATM interface. | IOS/ATM | EXEC | |
Displays detailed information for all the LANE components configured on an interface or on an emulated LAN. | IOS/LAN | EXEC | |
Bypasses individual connection client information. | IOS/LAN | EXEC | |
Displays detailed LANE information for all the LANE clients configured on an interface or on an emulated LAN. | IOS/LAN | EXEC | |
Displays the automatically assigned ATM address of each LANE component on a specified interface. | IOS/LAN | EXEC | |
Identifies the interface. | IOS/LAN | EXEC | |
Displays the LANE ARP table of the LANE client configured on an interface or on an emulated LAN. | IOS/LAN | EXEC | |
Identifies the ELAN name. | IOS/ATM | EXEC | |
Displays connection information for a line running in asychronous mode. | IOS/ATM | EXEC | |
Displays the system location. | IOS/ATM | EXEC | |
Displays the state of logging (syslog). | Switch | P | |
Shows statistics about memory, including memory-free pool statistics. | IOS/ATM | EXEC | |
Shows the addresses of the MPC configuration. | IOS/ATM | EXEC | |
Displays your current privilege level. | IOS/ATM | EXEC | |
Displays information about the active processes. | IOS/ATM | EXEC | |
Displays function registry information. | IOS/ATM | EXEC | |
Displays the reload status of the module. | IOS/ATM | EXEC | |
Displays the configuration information currently running on the terminal. | IOS/ATM | EXEC | |
Shows Service-Specific Connection Oriented Protocol (SSCOP) details for all ATM interfaces. | IOS/ATM | EXEC | |
Monitors the stack utilization of processes and interrupt routines. | IOS/ATM | EXEC | |
Displays the contents of NVRAM, if present and valid, or shows the configuration file pointed to by the config_file environment variable. | IOS/ATM | EXEC | |
Displays general system information about the module. | IOS/ATM | EXEC | |
Displays terminal configuration parameters. | IOS/ATM | EXEC | |
Displays information about terminal lines. | IOS/ATM | EXEC | |
Displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images. | IOS/Conf
| IC | |
Disables the interface. | IOS/Conf | IC | |
Changes the keepalive timer. | IOS/ATM | IC | |
Changes the retry count of connection control. | IOS/ATM | IC | |
Identifies the maximum number of retries for connection control operations. | IOS/ATM | IC | |
Changes the poll timer. | IOS/ATM | IC | |
Changes the receiving window. | IOS/ATM | IC | |
Changes the transmitter window. | IOS/ATM | IC | |
Enables enhanced editing mode on the local line. | IOS/ATM | EXEC | |
Enables the command history feature for the current terminal session or changes the size of the command history buffer for the current terminal session. | IOS/ATM | EXEC | |
Sets number of lines on a screen. | IOS/ATM | EXEC | |
Copies debug output to the current terminal line. | IOS/ATM | EXEC | |
Sets the terminal type. | IOS/ATM | EXEC | |
Sets width of the display terminal. | IOS/ATM | EXEC | |
Disables debugging functions. | IOS/ATM | EXEC | |
Erases the configuration information in NVRAM. | IOS/Conf | EXEC | |
Restarts the configuration information stored in NVRAM. | IOS/Conf | EXEC | |
See show running_config command. | IOS/Conf | EXEC |
Posted: Mon Mar 20 11:12:28 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.