Command Reference

This chapter describes each command in the Catalyst 5000 series switch command-line interface and the ATM module. Use these commands to configure and maintain the Catalyst 5000 series switch. Commands valid in both the switch and ATM environments are listed alphabetically, with a switch or ATM extension to distinguish between the two. Table 3-1 lists command aliases that have been defined for ease of use. Like regular commands, aliases are not case sensitive. However, unlike regular commands, some aliases cannot be abbreviated.

Table 3-1: Command Aliases

Alias	Command
?	help
batch	configure
di	show
earl	cam
exit	quit
logout	quit

Switch Command-Line Interface

The command-line interface (CLI) for the Catalyst 5000 series switch is a basic command-line interpreter similar to that of the UNIX C shell. Command line editing is provided, including history substitution and the creation of aliases. Refer to Chapter 1, "Command Line Interfaces," for more information.

ATM Module Command Reference

You access the ATM module by creating a session with it. To open a session with the ATM module, use the session mod_num command from the Console> prompt. After you enter this command, the switch responds with the Enter Password prompt. Enter atm as the default password. At this point, you are at the ATM#> prompt, and you have direct access only to that ATM module.

Once you are connected to the ATM module, a subset of the Cisco Internetwork Operating System configuration commands normally available for Cisco routers is available. Some of these commands have been slightly modified to accommodate the differences specific to the ATM module in the Catalyst 5000 series switch.

The Cisco IOS commands for the Catalyst 5000 series switch ATM module are divided into the following categories:

ATM Module Command Line Interface

: These commands allow you to enter and exit the various Cisco IOS configuration command modes. It provides a description of the help command and help features, lists the command editing keys and functions, and details the command history feature.
: You can abbreviate the syntax of Cisco IOS configuration commands. The ATM module recognizes a command when you enter enough characters of the command to uniquely identify it.
: For user interface task information and examples, see the "Understanding the Command-Line Interfaces" chapter in the Catalyst 5000 Series Advanced Software Configuration Guide.

Configuration Commands

: These commands allow you to configure Flash memory on the ATM module.

ATM Commands

: These commands allow you to configure an ATM interface. For ATM configuration information and examples, refer to the chapter "Configuring the ATM Module" in the Catalyst 5000 Series Advanced Software Configuration Guide.

LAN Emulation Commands

: These commands are used to configure a LAN client on the ATM interface for LAN Emulation (LANE). For ATM LANE configuration information and examples, refer to the "Configuring the ATM Module" chapter in the Catalyst 5000 Series Advanced Software Configuration Guide. Because some LANE commands are used often and others are used very rarely, the command descriptions in this chapter identify the commands you are most likely to use. Look under "Usage Guidelines" for the indicator This command is ordinarily used.

Table 3-2 identifies and defines all the commands in the Catalyst 5000 series switch, including ATM commands. Table 3-2 also specifies the type and mode for each command in the "Type" column.

**Table 3-2: Catalyst 5000 Series Commands (Continued)**
Command	Description	Type¹	Mode²
atm bindpvc vlan	Binds a permanent virtual circuit (PVC) to a specified VLAN.	IOS3/ATM	IC
atm ilmi-keepalive	Enables the Interim Local Management Interface (ILMI) keepalives.	IOS3/ATM	IC
atm preferred phy	Changes the preferred PHY to the one not currently in use.	IOS3/LAN	EXEC
atm pvc	Creates a permanent virtual circuit (PVC) on the Catalyst 5000 series interface.	IOS3/ATM	IC
atm traffic-shape-rate	Configures output throttling on the Catalyst 5000 series ATM module.	IOS3/ATM	IC
atm uni-version	Specifies the User-Network Interface (UNI) version the switch should use.	IOS3/ATM	IC
atm vc-per-vp	Sets the map number of VCIs to support per VCI.	IOS3/ATM	IC
atmsig close	Disconnects the SVC.	IOS3/ATM	EXEC
clear alias	Clears the shorthand name (alias) of a command.	Switch	P
clear arp	Clears ARP table entries.	Switch	P
clear cam	Clears CAM table entries.	Switch	P
clear cgmp statistics	Clears CGMP statistical information.	Switch	P
clear config	Clears configuration and resets the system.	Switch	P
clear counters	Clears MAC and Port counters.	Switch	P
clear help	Shows the clear command menu.	Switch	P
clear ip alias	Clears aliases of IP Addresses.	Switch	P
clear ip dns domain	Clears the default DNS domain name.	Switch	P
clear ip dns server	Clears the IP address of the DNS server.	Switch	P
clear ip route	Clears IP routing table entries.	Switch	P
clear log	Deletes all entries in the system error log.	Switch	P
clear logging server	Deletes a syslog server from the configuration.	Switch	P
clear multicast router	Clears multicast router ports.	Switch	P
clear ntp server	Deletes an NTP server from the server table.	Switch	P
clear port broadcast	Disables broadcast/multicast suppression on one or more ports.	Switch	P
clear snmp trap	Clears SNMP trap receiver address.	Switch	P
clear spantree portvlanpri	Clears spanning tree port VLAN priority.	Switch	P
clear tacacs key	Removes the key setting used for authentication and encryption.	Switch	P
clear tacacs server	Removes a specified host from the list of TACACS+ servers.	Switch	P
clear timezone	Clears NTP time zone information.	Switch	P
clear trunk	Clears trunks.	Switch	P
clear vlan	Deletes a VLAN from a management domain.	Switch	P
clear vmps address	Deletes a VLAN Membership Policy Server (VMPS).	Switch	P
clear vmps statistics	Deletes VMPS statistics.	Switch	P
clear vtp	Deletes VLAN trunk protocol (VTP) statistics.	Switch	P
clear vtp pruneeligible	Turns off the VLAN's pruning eligibility.	Switch	N
client-atm-address name	Adds a LANE address entry to the configuration server's configuration database.	IOS3/LAN	IC
configure	Downloads a configuration file from the network and executes each command in the file.	Switch	P
disable-ATM Command	Exit privileged EXEC mode and return to user EXEC mode.	IOS3/ATM	EXEC
disable-Switch Command	Returns the console interface to normal mode.	Switch	P
disconnect	Closes an active console port or Telnet session.	Switch	P
download	Copies a software image from a specified host to the designated module's flash memory.	Switch	P
download serial	Copies software images to the supervisor card or Flash memory through a serial port.	Switch	P
download vmps	Download VMPS database information.	Switch	P
editing	Enables enhanced editing mode.	IOS3/ATM	Line
enable-ATM Command	Enters privileged EXEC mode.	IOS3/ATM	EXEC
enable-Switch Command	Activates privileged mode.	Switch	N
end	Exits configuration mode.	IOS3/ATM	GC
exit	Exits any command mode or closes an active terminal session and terminates the EXEC.	IOS3/ATM	All ATM
full-help	Retrieves help for the full-set of user-level commands.	IOS3/ATM	All ATM
help-ATM Command	Displays a brief description of the help commands.	IOS3/ATM	All ATM
help-Switch Command	Lists the top-level commands available in the current mode.	Switch	N, P
history-ATM Command	Enables the command history function.	IOS3/ATM	Line
history-Switch Command	Shows the contents of the history substitution buffer.	Switch	N
lane auto-config-atm-address	Specifies that the configuration server ATM address is computed automatically.	IOS3/ATM	IC
lane client	Activates a LANE client on the specified subinterface.	IOS3/LAN	IC
lane client-atm-address	Specifies an ATM address.	IOS3/LAN	IC
lane config-atm-address	Specifies a given configuration server's ATM address.	IOS3/LAN	IC
lane database	Creates a named configuration base that can be associated with a configuration server.	IOS3/LAN	GC
lane le-arp	Adds a static entry to the LE ARP table.	IOS3/LAN	IC
lane register	Registers a LANE client.	IOS3/LAN	IC
lane server-bus	Configures the LAN Emulation Server (LES) and Broadcast Unknown Server (BUS) for the specified emulated LAN on the subinterface.	IOS3/LAN	IC
name server-atm-address	Assigns a unique emulated LAN name to a LAN Emulation server.	IOS3/LAN	IC
ping	Sends ICMP echo request packets to another node on the network.	Switch	N
quit	Exits the administration interface session.	Switch	N
reconfirm vmps	Reconfirms the current dynamic port VLAN membership with VMPS.	Switch	P
reload	Reloads the operating system.	IOS3/Config	EXEC
reset	Sets the system to its default values or configures the system as an individual module.	Switch	P
session	Connects the command line interface to a session on a module (such as an ATM module).	Switch	P
set alias	Creates a shorthand name (alias) for a command.	Switch	P
set arp	Sets an ARP table entry .	Switch	P
set authentication enable	Enables authentication using the TACACS+ server to determine if a user has privileged access permission.	Switch	P
set authentication login	Enables TACACS+ authentication for login.	Switch	P
set banner motd	Allows the user to program a message-of-the-day banner to appear before session login.	Switch	P
set bridge apart	Enables or disables the default translation on FDDI.	Switch	P
set bridge fddicheck	Rejects the learning of MAC addresses that it previously learned.	Switch	P
set bridge help	Lists the set bridge commands.	Switch	P
set bridge ipx 8022toether	Sets the default mode for translating IPX frames from FDDI 802.2 to Ethernet.	Switch	P
set bridge ipx 8023rawtofddi	Sets the default protocol for translating IPX frames from Ethernet 802.3 RAW to FDDI.	Switch	P
set bridge ipx snaptoether	Sets the default protocol for translating IPX FDDI SNAP frames to Ethernet frames.	Switch	P
set cam	Sets a CAM table entry.	Switch	P
set cdp disable	Deactivates Cisco Discovery Protocol information.	Switch	P
set cdp enable	Sets Cisco Discovery Protocol information.	Switch	P
set cdp interval	Sets the number of seconds between Cisco Discovery Protocol messages.	Switch	P
set cgmp	Enables/disables Cisco Group Management Protocol (CGMP) on a device.	Switch	P
set enablepass	Sets the privileged password.	Switch	P
set fddi alarm	Sets the LER-alarm value.	Switch	P
set fddi cutoff	Sets the LER-cutoff value.	Switch	P
set fddi help	Lists the set fddi commands.	Switch	P
set fddi tlmin	Sets the TL_MIN value for an FDDI port.	Switch	P
set fddi tnotify	Sets the T_Notify timer value for an FDDI port.	Switch	P
set fddi treq	Sets the TRequest value for an FDDI MAC.	Switch	P
set fddi userdata	Sets the user-data string in the SMT MIB of an FDDI module.	Switch	P
set help	Shows the set command menu.	Switch	N
set interface	Sets a network interface configuration.	Switch	P
set ip alias	Sets an alias for an IP Address.	Switch	P
set ip dns	Enables or disables DNS.	Switch	P
set ip dns domain	Sets the default DNS domain name.	Switch	P
set ip dns server	Sets the IP address of a DNS server.	Switch	P
set ip fragmentation	Enables or disables the fragmentation of IP packets bridged between FDDI and Ethernet networks.	Switch	P
set ip help	Lists the set ip commands.	Switch	P
set ip redirect	Enables or disables ICMP redirect messages for the switch.	Switch
set ip route	Adds IP addresses or aliases to the IP routing table.	Switch	P
set ip unreachable	Enables or disables ICMP unreachable messages for the switch.	Switch	P
set length	Sets the number of lines in the terminal display screen.	Switch	N
set logging console	Enables and disables system message logging to the console.	Switch	P
set logging level	Sets the facility and severity level used when logging system messages.	Switch	P
set logging server	Enables and disables system message logging to configured syslog servers.	Switch	P
set logout	Sets the number of minutes before an automatic logout.	Switch	P
set module disable	Disables a module.	Switch	P
set module enable	Enables a module.	Switch	P
set module help	Shows the set module command menu.	Switch	P
set module name	Sets module name.	Switch	P
set multicast router	Configures multicast router ports.	Switch	P
set ntp broadcastclient	Enables or disables Network Time Protocol (NTP) in broadcast client mode.	Switch	P
set ntp broadcastdelay	Configures a time-adjustment factor for the receiving of broadcast packets by the Catalyst 5000 series switch.	Switch	P
set ntp client	Enables or disables the Catalyst 5000 series switch as an NTP client.	Switch	P
set ntp server	Configures the IP address of the NTP server.	Switch	P
set password	Sets the console password.	Switch	P
set port broadcast	Sets the broadcast/multicast suppression for one or more ports.	Switch	P
set port disable	Disables a port.	Switch	P
set port duplex	Sets port transmission type (full/half duplex).	Switch	P
set port enable	Enables a port.	Switch	P
set port help	Shows the set port command menu.	Switch	P
set port level	Sets a port's priority level (normal/high).	Switch	P
set port membership	Configures a port as dynamically or statically assigned to a VLAN membership.	Switch	P
set port name	Sets a port name.	Switch	P
set port security	Enables or disables the security feature of a port or range of ports on the Ethernet module.	Switch'	P
set port speed	Sets the port speed.	Switch	P
set port trap	Sets the port up/down trap (enable/disable).	Switch	P
set prompt	Sets the command line interface prompt.	Switch	P
set snmp community	Sets SNMP community string.	Switch	P
set snmp help	Shows the set snmp command menu.	Switch	P
set snmp rmon	Sets the SNMP remote monitoring (RMON) support (enable/disable).	Switch	P
set snmp trap	Sets the SNMP trap receiver address.	Switch	P
set span	Sets the switched port analyzer.	Switch	P
set spantree disable	Disables spanning tree.	Switch	P
set spantree enable	Enables spanning tree.	Switch	P
set spantree fwddelay	Sets spantree forward delay.	Switch	P
set spantree hello	Sets spantree hello time.	Switch	P
set spantree help	Shows the set spantree command menu.	Switch	P
set spantree maxage	Sets spantree maximum aging time.	Switch	P
set spantree portcost	Sets spantree port cost.	Switch	P
set spantree portfast	Sets the spanning tree port fast start (enable/disable).	Switch	P
set spantree portpri	Sets spanning tree port priority.	Switch	P
set spantree portvlanpri	Sets the spanning tree trunk port VLAN priority.	Switch	P
set spantree priority	Sets spantree priority.	Switch	P
set summertime	Enables or disables setting the clock ahead one hour during Daylight Savings Time.	Switch	P
set system baud	Sets the console port baud rate.	Switch	P
set system contact	Sets the system contact.	Switch	P
set system help	Shows the set system command menu.	Switch	P
set system location	Sets the system location.	Switch	P
set system modem	Sets modem control (enable/disable).	Switch	P
set system name	Sets the system name.	Switch	P
set tacacs attempts	Configures the maximum number of login attempts allowed to the TACACS+ server.	Switch	P
set tacacs directedrequest	Enables and disables the TACACS+ directed-request option.	Switch	P
set tacacs key	Sets the key used for TACACS+ authentication and encryption.	Switch	P
set tacacs server	Configures the server on which the TACACS+ server resides.	Switch	P
set tacacs timeout	Sets the response timeout interval for the TACACS+ server daemon.	Switch	P
set time	Sets the system time.	Switch	P
set timezone	Sets the time zone for display purposes.	Switch	P
set trunk	Sets ports to be trunks.	Switch	P
set vlan	Sets virtual LANs on ports.	Switch	P
set vmps address	Groups ports into a virtual LAN.	Switch	P
set vmps state	Enables or disables VMPS.	Switch	P
set vmps storage	Specifies the VMPS storage location.	Switch	P
set vtp	Sets virtual trunk information.	Switch	P
set vtp pruneeligible	Configures pruning eligibility for the device only and displays all pruning-eligible VLANs.	Switch	N
show alias	Shows aliases for commands.	Switch	N
show arp	Shows the ARP table.	Switch	N
show atm interface atm	Displays ATM-specific information about an interface.	IOS3/ATM	EXEC
show atm traffic	Displays the current, global ATM traffic information.	IOS3/ATM	EXEC
show atm vc	Displays all ATM virtual circuits.	IOS3/ATM	EXEC
show atm vlan	Displays the active VLAN-to-PVC bindings.	IOS3/ATM	IC
show bridge	Displays bridge information.	Switch	P
show cam	Shows the CAM table.	Switch	N
show cdp	Shows Cisco Discovery Protocol information.	Switch	N
show cgmp statistics	Displays CGMP statistical information.	Switch	N
show config	Shows the system configuration.	Switch	P
show fddi	Displays the settings of the FDDI/CDDI modules.	Switch	N
show fddicam	Displays the CAM table for the FDDI/CDDI modules.	Switch	N
show flash	Lists flash code information.	Switch	P
show help	Lists and describes the available show commands.	Switch	N
show history	Lists the commands in the current EXEC session.	IOS3/ATM	EXEC
show interface	Shows network interfaces.	Switch	N
show ip alias	Shows aliases for IP Addresses.	Switch	N
show ip dns	Shows the DNS name server and the default domain name.	Switch	N
show ip help	Lists the show ip commands.	Switch	N
show ip route	Displays the IP routing table entries.	Switch	N
show lane	Displays global and per-VCC LANE information.	IOS3/LAN	EXEC
show lane bus	Displays LANE information for the broadcast and unknown servers configured.	IOS3/LAN	EXEC
show lane client	Displays global and per-VCC LANE information.	IOS3/LAN	EXEC
show lane config	Displays LANE information about the LECS.	IOS3/LAN	EXEC
show lane default-atm-addresses	Displays default ATM addresses for dual PHYs connected to the same or different switches.	IOS3/LAN	EXEC
show lane le-arp	Displays the LANE ARP table.	IOS3/LAN	EXEC
show lane-server	Displays LANE information about broadcast and unknown servers.	IOS3/LAN	EXEC
show log	Displays the system or module error log.	Switch	N
show logging	Displays the system message log configuration.	Switch	N
show logging buffer	Displays system messages from the internal buffer.	Switch	N
show mac	Shows MAC information.	Switch	N
show module	Shows module information.	Switch	N
show multicast group	Displays the multicast group configuration.	Switch	N
show multicast router	Displays the multicast router configuration.	Switch	N
show netstat	Shows network statistics.	Switch	N
show ntp	Displays the current NTP status.	Switch	N
show port	Shows port information.	Switch	N
show snmp	Shows SNMP information.	Switch	N
show span	Shows switch port analyzer port monitoring information.	Switch	N
show spantree	Shows spantree information.	Switch	N
show sscop	Displays SSCOP details for all ATM interfaces.	IOS3/ATM	EXEC
show summertime	Displays the current status of the summertime feature.	Switch	N
show system	Shows system information.	Switch	N
show tacacs	Displays the TACACS+ protocol configuration.	Switch	N
show test	Shows results of diagnostic tests.	Switch	N
show time	Shows the current time.	Switch	N
show timezone	Shows the current time zone and offset.	Switch	N
show trunk	Shows trunk information.	Switch	N
show users	Shows active Admin sessions.	Switch	N
show version-ATM Command	Displays the configuration of the system hardware, software version, and sources of configuration files and boot images.	IOS3/Config	EXEC
show version-Switch Command	Shows version information.	Switch	N
show vlan	Shows VLAN information.	Switch	N
show vmps	Displays the current VMPS configuration information and its current operational service.	Switch	N
show vmps address	Displays the VMPS IP address.	Switch	N
show vmps mac	Displays the MAC-address-to-VLAN mapping.	Switch	N
show vmps portgrp	Displays the VLANs in a port group.	Switch	N
show vmps statistics	Displays the VMPS statistics.	Switch	N
show vmps vlan	Displays all the MAC addresses assigned to this VLAN in the VMPS table.	Switch	N
show vmps vlangrp	Displays the VLANs in a group.	Switch	N
show vmps vlanports	Displays the ports belonging to a restricted VLAN or a VLAN group.	Switch	N
show vtp	Shows VLAN trunk protocol (VTP) information.	Switch	N
show vtp help	Displays available VTP commands.	Switch	N
slip	Attaches or detaches SLIP from the console port.	Switch	P
sscop cc-timerr	Changes the connection control timer.	IOS3/ATM	IC
sscop keepalive-timerr	Changes the keepalive timer.	IOS3/ATM	IC
sscop max-cc	Changes the retry count of connection control.	IOS3/ATM	IC
sscop poll-timer	Changes the poll timer.	IOS3/ATM	IC
sscop rcv-window	Changes the receiver window.	IOS3/ATM	IC
sscop send-window	Changes the transmitter window.	IOS3/ATM	IC
telnet	Starts a Telnet connection to a remote host.	Switch	P
terminal	Sets the number of lines displayed.	IOS3/ATM	EXEC
test help	Shows the test command menu.	Switch	P
test snmp trap	Sends trap message to SNMP trap receivers.	Switch	P
upload	Uploads a code image to a network host.	Switch	P
wait	Pauses for a specified number of seconds.	Switch	N
write	Uploads the current configuration to a host or displays it on the terminal.	Switch	P
write erase	Erases the configuration information in nonvolatile memory.	IOS3/Config	EXEC
write memory	Restarts the Catalyst 5000 series switch; use it with the reload command.	IOS3/Config	EXEC
write terminal	Compares the information in running memory to the information stored in NVRAM; use it with the show configuration command.	IOS3/Config	EXEC

¹ Type - indicates whether the command is a switch command or an ATM-specific command. ATM commands include Interface, Configuration, ATM, and LAN Emulation commands.
² Mode - indicates whether a switch command is "Normal" or "Privileged" and whether an ATM command is an interface configuration, privileged, EXEC, global configuration, all ATM, or line command.3. Cisco Internetwork Operating System (Cisco IOS).

atm bind pvc vlan

Use the atm bind pvc vlan command to bind a permanent virtual circuit (PVC) to a specified VLAN.

atm bind pvc vlan <vcd> vlan number

Syntax Description

vcd	Virtual circuit descriptor. A unique number for each Catalyst 5000 series switch that identifies to the switch which virtual path identifier/virtual channel identifier (VPI/VCI) to use for a particular packet. The Catalyst 5000 series switch requires this feature to manage packet transmission. The vcd is not associated with the VPI/VCI used for the ATM network cells.
vlan number	The number of the VLAN.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

You can bind any number of PVCs to the same VLAN. To prevent loops, each PVC must uniquely connect a VLAN group between two Catalyst 5000 series switches.

Example

After entering the atm bind pvc vlan command to bind PVC 10 to VLAN 5 and PVC 11 to VLAN 5, you see the following display:

ATM(config-if)#atm bind pvc vlan 10 5 ATM(config-if)#atm bind pvc vlan 11 5

atm ilmi-keepalive

Use the atm ilmi-keepalive interface configuration command to enable Interim Local Management Interface (ILMI) keepalives. To disable ILMI keepalives, use the no form of this command.

atm ilmi-keepalive seconds

no atm ilmi-keepalive

Syntax Description

seconds

Number of seconds between keepalives.

Default

The default is 3 seconds. Values less than 3 seconds are rounded to 3 seconds, and there is no upper boundary to the range of values.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Example

After entering the atm ilmi-keepalive seconds command to set the number of seconds between ILMI keepalives, you see the following display:

ATM(config)#int atm0 ATM(config-if)#atm ilmi-keepalive 5 ATM(config-if)#end

atm preferred phy

Use the atm preferred phy command to change the preferred PHY to the one not currently in use.

atm preferred phy <A | B>

Syntax Description

A | B

Indicates the specific PHY, either A or B.

Default

The default is PHY A.

Command Type

Cisco IOS dual-PHY ATM command.

Command Mode

Interface configuration.

Usage Guideline

Use this command with dual PHYs connected to the same or to different switches.

Example

To return to PHY A, enter the atm preferred phy A command. You see the following screen:

ATM#configure terminal Enter configuration commands, one per line. End with Ctrl-Z. ATM(config)#interface atm0 ATM(config-subif)#atm preferred phy A ATM(config-subif)#end ATM#

Related Command

show lane default-atm-addresses

atm pvc

Use the atm pvc interface configuration command to create a permanent virtual circuit (PVC) on the Catalyst 5000 series switch interface. The no form of this command deletes the specified PVC.

atm pvc <vcd><vpi><vci> aal-encap [ilmi | qsaal | aal5snap] no atm pvc <vcd><vpi><vci> aal-encap [ilmi | qsaal | aal5snap]
pvc-type [peak] [average] [burst]

Syntax Description

vcd	Virtual circuit descriptor. A unique number for each Catalyst 5000 series switch that identifies to the switch which virtual path identifier/virtual channel identifier (VPI/VCI) to use for a particular packet. The Catalyst 5000 series switch requires this feature to manage packet transmission. The vcd is not associated with the VPI/VCI used for the ATM network cells.
vpi	ATM network virtual path identifier (VPI) of this PVC, in the range from 0 through 255. The VPI is an 8-bit field in the header of the ATM cell. The VPI value is unique only on a single interface, not throughout the ATM network.
vci	ATM network virtual channel identifier (VCI) of this PVC, in the range from 0 through 65535. The VCI is an 16-bit field in the header of the ATM cell. The VCI value is unique only on a single interface, not throughout the ATM network.
aal-encap	The ATM adaptation layer (AAL) and encapsulation type.

Default

If no peak and average rates are specified, the PVC defaults to the highest bandwidth rate-queue available. Peak and average rates are then equal. By default, the VC is configured to run as fast as possible.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

The atm pvc command creates a PVC and attaches it to the VPI and VCI specified. You cannot specify both vpi and vci as 0; if you specify the vpi as 0, you cannot specify the vci as 0, and vice versa. The aal-encap argument determines the AAL mode and the encapsulation method used. The peak and average arguments determine the rate queue used.

If you are configuring a switched virtual circuit (SVC), you must use this command to configure the PVC that handles the SVC call setup and termination. In this case, specify qsaal for any aal-encap argument.

Example

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

atm traffic-shape rate

Use the atm traffic-shape rate command to configure output throttling on your Catalyst 5000 series switch ATM module.

atm traffic-shape rate <1-155> no atm traffic-shape rate <1-155>

Syntax Description

1-155

Number between 1 and 155 indicating Mbps.

Default

The default is 155 Mbps.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

Use the no atm traffic-shape rate to place the output rate to the default of 155 Mbps.

Example

The example below shows how to set the output throttle to 50.

ATM(config)# int atm0 ATM(config-if)# atm traffic-shape rate 50 ATM(config-if)# end

atm uni-version

Use the atm uni-version command to specify the User-Network Interface (UNI) version (3.0 or 3.1) the switch should use when ILMI link autodetermination is unsuccessful or ILMI is disabled. To restore the default value to 3.0, use the no form of this command.

atm uni-version version number no atm uni-version

Syntax Description

version number

UNI version selected on an interface. Valid values are 3.0 or 3.1.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Example

In the following example, the UNI version is set to 3.1

ATM(config)# atm uni-version
ATM(config)# atm uni-version 3.1

atm vc-per-vp

Use the atm vc-per-vp interface configuration command to set the maximum number of VCIs to support per VPI. The no form of this command restores the default value.

atm vc-per-vp number
no atm vc-per-vp

Syntax Description

number

Maximum number of VCIs to support per VPI. Valid values are 32, 64, 128, 256, 512 or 1024.

Default

By default, the maximum number of VCIs to support per VPI is 1024.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guidelines

This command controls the memory allocation in the Catalyst 5000 series switch for the VCI table. It defines the maximum number of VCIs to support per VPI; it does not designate the VCI numbers.

An invalid VCI causes a warning message to be displayed.

Example

In the following example, the maximum number of VCIs to support per VPI is set to 512:

ATM(config-if)# atm vc-per-vp 512

atmsig close

Use the atmsig close EXEC command to disconnect an SVC.

atmsig close atm 0 vcd

Syntax Description

vcd

Virtual circuit descriptor of the SVC to close.

Command Type

Cisco IOS ATM command.

Command Mode

EXEC.

Usage Guidelines

You must execute this command if you want to close a particular SVC. Because VCs are numbered per interface, you must specify 0 as the ATM interface number.

Example

The following example closes SVC 2 on ATM interface 0:

ATM# atmsig close atm0 2

clear alias

Use the clear alias command to clear the shorthand versions of commands.

clear alias all
clear alias name

Syntax Description

all	Identifies every alternate identifier previously created.
name	Identifies the alternate identifier of the command.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to erase the alias called arpdel:

Console> (enable) clear alias arpdel
Command alias deleted.
Console> (enable) clear alias all
Command alias table cleared.
Console> (enable)

Related Command

show alias

clear arp

Use the clear arp command to delete a specific entry or all entries from the Address Resolution Protocol (ARP) table.

clear arp all
clear arp ip_address

Syntax Description

all	Specifies every IP address in the ARP table.
ip_address	IP address in the ARP table to be cleared.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to remove IP address 198.133.219.209 from the ARP table and then remove all entries from the ARP table:

Console> (enable) clear arp 198.133.219.209
ARP entry deleted.
Console> (enable) clear arp all
ARP table cleared.
Console> (enable)

Related Commands

set arp
show arp

clear cam

Use the clear cam command to delete a specific entry or all entries from the Address Recognition Protocol table (identified as the Content Addressable Memory, or CAM table).

clear cam mac_addr [vlan]
clear cam {dynamic | static | permanent} [vlan]

Syntax Description

vlan	The number of the VLAN.
mac_addr	Identifies one or more MAC addresses.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following example shows how to remove MAC address 00-40-0b-a0-03-fa from the CAM table:

Console> (enable) clear cam
Usage: Console> (enable) clear cam 00-40-0b-a0-03-fa
CAM table entry cleared.

The following example shows how to clear dynamic entries from the CAM table:

Console> (enable) clear cam dynamic
Dynamic CAM entries cleared.
Console> (enable)

Related Command

show cam

clear cgmp statistics

Use the clear cgmp statistics command to clear Cisco Group Management Protocol (CGMP) statistical information.

clear cgmp statistics

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to clear CGMP statistical information:

Console> (enable) clear cgmp statistics
Console> (enable)

Related Command

show cgmp statistics

clear config

Use the clear config command to clear the system or module configuration information stored in NVRAM. Use the clear config rmon command to clear all the Remote Network Monitoring (RMON) configurations, which includes the historyControlTable, the alarmTable, the eventTable, and the ringStation ControlTable.

clear config all
clear config mod_num
clear config rmon

Syntax Description

all	Specifies all modules and system information, including the IP address.
mod_num	The number of the module.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to delete the configuration information stored in NVRAM on module 2:

Console> (enable) clear config 2
This command will clear module 2 configuration.
Do you want to continue (y/n) [n]? y
..............................
Module 2 configuration cleared.
Console> (enable) clear config 1
This command will clear module 1 configuration.
Do you want to continue (y/n) [n]? y
......
Module 1 configuration cleared.
host%
Console> (enable) clear config all
This command will clear all configuration in NVRAM.
Do you want to continue (y/n) [n]? y
...........................................
Connection closed by foreign host
host%

Related Commands

configure
show config

clear counters

Use the clear counters command to clear MAC and port counters.

clear counters

Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

This command does not clear counters for the ATM module.

Example

The following example shows how to reset MAC and port counters to zero:

Console> (enable) clear counters
MAC and Port counters cleared.
Console> (enable)

Related Commands

clear help
show mac
show port

clear help

Use the clear help command to list the clear commands with brief descriptions of their functions.

clear help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list all of the clear commands:

Console> (enable) clear help
Clear commands:
----------------------------------------------------------------------
clear alias         Clear aliases of commands
clear arp           Clear ARP table entries
clear cam           Clear CAM table entries
clear cgmp          Clear 
clear config        Clear configuration and reset system
clear counters      Clear MAC and Port counters
clear help          Show this message
clear ip            Clear IP, use 'clear ip help' for more info
clear log           Clear 
clear multicast     Clear 
clear ntp           Clear 
clear port          Clear
clear snmp          Clear SNMP trap receiver address
clear spantree      Clear spantree port vlan priority
clear tacacs        Clear 
clear timezone      Clear 
clear trunk         Clear trunk ports
clear vlan          Clear a VLAN
clear vmps          Clear 
clear vtp           Clear VTP statistics
Console> (enable)

Related Command

set help

clear ip alias

Use the clear ip alias command to clear IP aliases that were set using the set ip alias command.

clear ip alias all
clear ip alias name

Syntax Description

all	Specifies all previously set aliases of IP addresses.
name	Identifies a specific alias of an IP address.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to delete a previously defined IP alias named simba:

Console> (enable) clear ip alias simba
IP alias deleted.

Related Commands

set ip alias
show ip alias

clear ip dns domain

Use the clear ip dns domain command to clear the default DNS domain name.

clear ip dns domain

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following examples show how to clear the default DNS domain name:

Console> (enable) clear ip dns domain
Default DNS domain name hp.com cleared.
Console> (enable) clear ip dns domain
There is no default DNS domain name defined.

Related Commands

set ip dns domain
show ip dns

clear ip dns server

Use the clear ip dns server command to clear the IP address of the DNS server.

clear ip dns server ip_addr

Syntax Description

ip_addr

The IP address of the DNS server.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to clear the default DNS domain server at IP address 198.92.30.32:

Console> (enable) clear ip dns server 198.92.30.32
DNS name server 198.92.30.32 cleared.
Console> (enable)

Related Commands

set ip dns server
show ip dns

clear ip permit

Use the clear ip permit command to remove entries from the IP permit list. This command removes a specified IP address and mask, or all IP addresses and masks from the permit list. The clear ip permit all command clears the permit list, but does not change the state of the IP permit feature. A warning is displayed if the feature is enabled, and all IP addresses are cleared from the permit list. If a mask other than the default (255.255.255.255) has been configured, you must provide both the address and mask to clear a specific entry.

clear ip permit ip address
clear ip permit all

Syntax Description

ip address

The specified IP address to be cleared.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows the screen display after entering the clear ip permit command:

Console> (enable) clear ip permit

Usage: clear ip permit all

clear ip permit <addr> [mask]

(mask is in dotted decimal format e.g. 255.255.0.0)

Console> (enable) clear ip permit 172.100.101.102

172.100.101.102 cleared from IP permit list.

Console> (enable) clear ip permit 172.160.128.0 255.255.192.0

172.160.128.0 with mask 255.255.192.0 cleared from IP permit list.

Console> (enable) clear ip permit all

IP permit list cleared.

WARNING!! IP permit list is still enabled.

Console> (enable)

Related Commands

set ip permit
show ip permit
show snmp
set snmp trap

clear ip route

Use the clear ip route command to delete all IP routing table entries.

clear ip route all
clear ip route destination gateway

Syntax Description

all	Every entry in the IP routing table.
destination	The IP address of the host or network.
gateway	The IP address or alias of the gateway router.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to delete the table entry for destination 134.12.3.0, elvis gateway:

Console> (enable) clear ip route
Usage: clear ip route all
       clear ip route <destination> <gateway>
Console> (enable) clear ip route 134.12.3.0 elvis
Route deleted.
Console> (enable) clear ip route all
All routes deleted.
Console> (enable)

Related Commands

set ip route
show ip route

clear log

Use the clear log command to delete all entries in the system error log.

clear log [mod_num]

Syntax Description

mod_num

The number of the module.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to clear the system error log:

Console> (enable) clear log
System error log cleared.
Console> (enable)

Related Command

show log

clear logging server

Use the clear logging server command to delete a syslog server from the configuration.

clear logging server ip_addr

Syntax Description

ip_addr

The IP address of the server to be deleted.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to delete a syslog server from the configuration:

Console <enable> clear logging server 171.69.192.207
System log server 171.69.192.207 removed from system log server table.
Console> (enable)

Related Commands

set logging server
show logging

clear multicast router

Use the clear multicast router command to clear multicast router ports.

clear multicast router {all | mod_num/port_num}

Syntax Description

all	All multicast router ports.
mod _num	The number of the module.
port_num	The number of the port on the module.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to clear multicast router ports:

Console> (enable) clear multicast router 3/1
Port 3/1 cleared from multicast router port list.
Console> (enable)

Related Commands

set multicast router
show multicast router

clear ntp server

Use the clear ntp server command to remove one or more servers from the server table.

clear ntp server {ip_addr | all}

Syntax Description

ip_addr	The IP address of the server being removed from the server table.
all	All NTP server addresses in the server table.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following example shows how to remove the NTP server at IP address 172.20.22.191 from the server table:

Console> (enable) clear ntp server 172.20.22.191
NTP server 172.20.22.191 removed.
Console> (enable)

The following example shows how to remove the IP addresses of all NTP servers from the server table:

Console> (enable) clear ntp server all
All NTP servers cleared.
Console> (enable)

Related Commands

set ntp server
show ntp

clear port broadcast

Use the clear port broadcast command to disable broadcast/multicast suppression on one or more ports.

clear port broadcast mod_num/port_num

Syntax Description

mod_num	The number of the module.
port_num	The number of the port on the module.

Default

This default configuration has broadcast/multicast suppression cleared (that is, unlimited broadcast/multicast traffic allowed).

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to clear broadcast/multicast suppression:

Console> (enable) clear port broadcast 2/1
Broadcast traffic unlimited on ports 2/1.
Console> (enable)

Related Commands

set port broadcast
show port

clear snmp trap

Use the clear snmp trap command to clear an entry from the SNMP trap receiver table.

clear snmp trap all
clear snmp trap rcvr_address

Syntax Description

all	Specifies every entry in the SNMP trap receiver table.
rcvr_address	IP alias or IP address of the trap receiver (the SNMP management station).

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to clear the trap for IP address 192.122.173.82:

Console> (enable) clear snmp trap 192.122.173.82
SNMP trap receiver deleted.
Console> (enable)

Related Commands

set snmp trap
show snmp
test snmp trap

clear spantree portvlanpri

Use the clear spantree portvlanpri command to reset the spanning-tree port VLAN priority.

clear spantree portvlanpri mod_num/port_num vlans

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
vlans	One or more VLANs.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to reset the spanning-tree port VLAN priority:

Console> (enable) clear spantree portvlanpri ?
Usage: clear spantree portvlanpri <mod_num/port_num> <vlans>
Console> (enable) clear spantree portvlanpri 1/2 23-40
Port 1/2 vlans 3,6-20,23-1000 using portpri 32
Port 1/2 vlans 1-2,4-5,21-22 using portpri 30

Related Commands

set spantree portvlanpri
show spantree

clear tacacs key

Use the clear tacacs key command to remove the key setting used for authentication and encryption.

clear tacacs key

Syntax Description

This command has no arguments or keywords.

Default

This default value of key is NULL.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to remove the key setting used for authentication and encryption:

Console> (enable) clear tacacs key
Console> (enable)

Related Commands

set tacacs key
show tacacs

clear tacacs server

Use the clear tacacs server command to remove the specified host from the list of terminal access controller access control system plus (TACACS+) servers.

clear tacacs server ip_addr

Syntax Description

ip_addr

The IP address of the server to be removed from the list of TACACS+ servers.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to remove a server from the list of TACACS+ servers:

Console> (enable) clear tacacs server 170.1.2.20
Console> (enable)

Related Commands

set tacacs server
show tacacs

clear timezone

Use the clear timezone command to clear the time zone, or to set the time zone to Coordinated Universal Time (UTC).

clear timezone

Syntax Description

This command has no arguments or keywords.

Default

By default, the time zone is set to UTC.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The clear timezone command is effective only when NTP is running. If you explicitly set the time and NTP is disengaged, the clear timezone command has no effect.

Example

The following example shows how to clear the time zone:

Console> (enable) clear timezone
Timezone name and offset cleared.
Console> (enable)

Related Command

set timezone

clear trunk

Use the clear trunk command to reset trunk ports to bridge ports or to clear partial information in the trunk table.

clear trunk mod_num/port_num [vlans]

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
vlans	(Optional) Identifies one or more VLANs.

Default

If VLANs are specified, they are removed from the list of allowed VLANs on the trunk. If you do not specify a VLAN range, the mode is set to auto for Dynamic Interswitch Link (DISL) trunk ports and off for other trunk ports. Refer to the set trunk command for more information about auto and off modes.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

If VLANs are specified, only the specified VLANs are cleared from the trunk port table. Default VLANs cannot be cleared on the trunk.

Example

The following example shows how to clear the trunk for module 1, port 2:

Console> (enable) clear trunk ?
Usage: clear trunk <mod/ports...> [vlans...]
       (An example of mod/ports is 1/1,2/1-12,3/1-2,4/1-12)
       (vlans = 1..1000
       An example of vlans is 2-10,1000)
Console> (enable) clear trunk 1/2 2-4
Vlan(s) 2-4 cleared from port 1/2.
Console> (enable) clear trunk 1/2
Port 1/2 mode set to auto.
Console> (enable)

Related Commands

set trunk
show trunk

clear vlan

Use the clear vlan command to delete an existing VLAN from a management domain.

clear vlan vlan_num

Syntax Description

vlan_num

The number of the VLAN.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

When a VLAN is cleared, all ports assigned to that VLAN become inactive. However, the VLAN assignments of the ports remain in the cleared VLAN until the ports are moved to another VLAN. If the cleared VLAN is reactivated, all ports still configured on that VLAN are also reactivated. Use a VLAN number within the range of 2 through 1000.

Example

The following example shows how to clear an existing VLAN from a management domain.

Console> (enable) clear vlan ?
Usage: clear vlan <vlan_num> 
(vlan)num should be in the range of 2..1000)
Console> (enable) clear vlan 4
This command will de-activate all ports on vlan 4
in the entire management domain
Do you want to continue(y/n) [n]? y
VTP: VLAN 4 deletion successful

Related Commands

set vlan
show vlan

clear vmps address

Use the clear vmps address command to delete a VLAN Membership Policy Server (VMPS) IP address.

clear vmps address ip_addr

Syntax Description

ip_addr

The VMPS IP address of the server to be deleted.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to clear a VMPS IP address.

console (enable)> clear vmps address help
Usage: clear vmps address <ipaddress>
console (enable)> clear vmps address 172.0.0.1
vmps address 172.0.0.1 cleared from vmps table. 
console (enable)> clear vmps address 182.0.0.1
vmps address 182.0.0.1 not in vmps table.

Related Commands

reconfirm vmps
set vmps address
show vmps address

clear vmps statistics

Use the clear vmps statistics command to remove existing VMPS statistics.

clear vmps statistics

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to remove existing VMPS statistics.

Console> (enable) clear vmps statistics
Console> (enable)

Related Command

show vmps

clear vtp

Use the clear vtp command statistics to clear the Virtual Trunk Protocol (VTP) statistics.

clear vtp statistics

Syntax Description

statistics

Specifies the statistics of the specified VTP.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to clear the VTP statistics.

Console> (enable) clear vtp ?
Usage: Clear vtp statistics
Console> (enable) clear vtp statistics
vtp statistics cleared.
Console> (enable)

Related Commands

set vtp
show vtp
show vtp help

clear vtp pruneeligible

Use the clear vtp pruneeligible command to turn off the VLAN's pruning eligibility.

clear vtp pruneeligible vlan_range

Syntax Description

vlan_range

The range of VLAN numbers.

Default

The pruning function is disabled by default.

Command Type

Switch command.

Command Mode

Normal.

Example

After entering this command for VLANs 1 through 3, VLANs 6 through 8, and VLANs 100 through 200, you see the following screen:

console> clear vtp pruneeligible 2,3,6-8,100-200 Vlans 1-3,6-8,100-200 will not be pruned on this device.

Related Commands

set vtp
set vtp pruneeligible

client-atm-address name

To add a LANE address entry to the configuration server's configuration database, use the client-atm-address database configuration command. To remove a client address entry from the table, use the no form of this command.

client-atm-address atm-address-template name elan-name no client-atm-address atm-address-template

Syntax Description

atm-address-template

Template that explicitly specifies an ATM address or a specific part of an ATM address and uses wildcard characters for other parts of the ATM address, making it easy and convenient to specify multiple addresses matching the explicitly specified part.

Wildcard characters can replace any nibble or group of nibbles in the prefix, the end-system identifier (ESI), or the selector fields of the ATM address.

name elan-name

Name of the emulated LAN. Maximum length is 32 characters.

Default

No address and no emulated LAN name are provided.

Command Mode

Database configuration.

Usage Guidelines

Using this command binds any client whose address matches the specified template into the specified emulated LAN. When a client comes up, it consults the LANE configuration server, which responds with the ATM address of the LANE server for the emulated LAN. The client then initiates join procedures with the LANE server.

Before this command is used, the emulated LAN specified by the elan-name argument must have been created in the configuration server's database by use of the name server-atm-address command.

If an existing entry in the configuration server's database binds the LANE client ATM address to a different emulated LAN, the new command is rejected.

This command affects only the bindings in the named configuration server database. It has no effect on the LANE components themselves.

See the lane database command for information about creating the database and the name server-atm-address command for information about binding the emulated LAN's name to the server's ATM address.

The client-atm-address name command is a subcommand of the global lane database command.

ATM Addresses. A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):

A 13-byte prefix that includes the following fields defined by the ATM Forum: AFI (Authority and Format Identifier) field (1 byte), DCC (Data Country Code) or ICD (International Code Designator) field (2 bytes), DFI (Domain Specific Part Format Identifier) (1 byte), Administrative Authority field (3 bytes), Reserved field (2 bytes), Routing Domain field (2 bytes), and the Area field (2 bytes)
A 6-byte system identifier (ESI)
A 1-byte selector field

Address Templates. LANE ATM address templates can use two types of wildcards: an asterick (*) to match any single character, and an ellipsis (...) to match any number of leading or trailing characters.

In LANE, a prefix template explicitly matches the prefix but uses wildcards for the ESI and selector fields. An ESI template explicitly matches the ESI field but uses wildcards for the prefix and selector.

In our implementation of LANE, the prefix corresponds to the specific subinterface of the interface.

Examples

The following example uses an ESI template to specify the part of the ATM address corresponding to interface. In effect, this example allows any client on any subinterface of the interface that corresponds to the displayed ESI value, no matter which switch the router is connected to, to join the engineering emulated LAN:

ATM(lane-config-database) client-atm-address ...0800.200c.1001.** name engineering

The following example uses a prefix template to specify the part of the ATM address corresponding to the switch. In effect, this example allows any client on the subinterface of any interface connected to the switch that corresponds to the displayed prefix to join the marketing emulated LAN:

ATM(lane-config-database) client-atm-address 47.000014155551212f.00.00... name marketing

Related Commands

default name

lane database

mac-address name

name server-atm-address

configure

Use the configure command to download a configuration file from the network and execute each command in that file.

configure network
configure host file

Syntax Description

network	Interactive prompting for the host and the file.
host	The IP address or IP alias of the host.
file	The name of the file.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

Refer to the "Creating a Configuration File" appendix in the Catalyst 5000 Series Advanced Software Configuration Guide for information about constructing a configuration file to be downloaded using the configure command.

Examples

Following is a sample file called system5.cfg in the tftpboot directory:

begin
show time
set ip alias conc7 198.133.219.207
set ip alias montreux 198.133.119.42
set ip alias cres 192.122.174.42
set prompt system5>
set password
# empty string old password
pingpong
pingpong
end
#

Each line contains a command, except lines that begin with ! or #.

The following example shows how to download the configuration file called system5.cfg from the 192.122.174.42 host:

Console> (enable) configure 192.122.174.42 system5.cfg
Configure using system5.cfg from cres (y/n) [n]? y
/
Done.  Finished Network Download.  (446 bytes)
>> show time
Wed Feb 22 1995, 17:42:50
>> set ip alias conc7 198.133.219.207
IP alias added.
>> set ip alias montreux 198.133.219.40
IP alias added.
>> set ip alias cres 192.122.174.42
IP alias added.
>> set prompt system5>
>> set password
Enter old password: 
Enter new password: pingpong
Retype new password: pingpong
Password changed.
system5> (enable)

Related Command

show config

default-name

Use the default-name database configuration command to provide an emulated LAN name in the configuration server's database for those client MAC addresses and client ATM addresses that do not have explicit emulated LAN name bindings. To remove the default name, use the no form of this command.

default-name elan-name no default name

Syntax Description

elan-name

Default emulated LAN name for any LANE client MAC address or LANE client ATM address not explicitly bound to any emulated LAN name. Maximum length is 32 characters.

Default

No name is provided.

Command Mode

Database configuration.

Usage Guidelines

This command affects only the bindings in the configuration server's database. It has no effect on the LANE components themselves.

The named emulated LAN must already exist in the configuration server's database before this name is used. If the default name-to-emulated LAN name binding already exists, the new binding replaces it.

The default-name command is a subcommand of the global lane database command.

Related Commands

client-atm-address name

lane database

mac-address name

name server-atm-address

disable -ATM Command

Use the disable EXEC command to exit privileged EXEC mode and return to user EXEC mode. After executing this command, the > prompt appears.

disable [level]

Syntax Description

level

Default

This command has no default setting.

Command Type

Cisco IOS ATM module interface command.

Command Mode

EXEC.

Usage Guideline

Use this command with the level option to reduce the privilege level. If a level is not specified, it defaults to the user EXEC mode, which is level 1.

Example

In the following example, entering the disable command causes the system to exit privileged EXEC mode and return to user EXEC mode, as indicated by the angle bracket (>) prompt:

ATM# disable
ATM>

Related Command

enable-ATM Command

dis able-Switch Command

Use the disable command to return the console interface to normal mode.

disable

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to return the console to normal mode:

Console> (enable) disable
Console>

Related Command

enable-Switch Command

disconnect

Use the disconnect command to close an active console port or Telnet session.

disconnect console
disconnect ip_addr

Syntax Description

console	The active console port.
ip_addr	The IP address or IP alias.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

If multiple sessions from the same IP address exist, the disconnect command checks if the current process is also from the same IP address. If it is not, all Telnet sessions from the specified IP address are disconnected. If it is, all sessions, other than the current session, are disconnected. The system prompts whether to disconnect the current Telnet session. You can answer n and remain connected or answer y and be disconnected.

Example

The following example shows how to close a Telnet session with a host with IP address 198.134.214.4:

Console> (enable) disconnect 198.134.214.4
Telnet session from 198.134.214.4 disconnected. (1)
Console> (enable) disconnect console
Console session disconnected.

Related Command

telnet

download

Use the download command to copy a software image from a specified host to the Flash memory of a designated module.

download host file [module_num]

Syntax Description

host	The name or IP address of host.
file	The name of file to be downloaded.
module_num	(Optional) Number of the module.

Default

If a module number is not specified, module_num downloads all images.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The Catalyst 5000 series switches support two ways to download new code to the processors: TFTP network download through any network port, and Kermit serial download through the EIA/TIA-232 console port. Only the first applies to the ATM module. The ATM module has processors that will require field upgrades.

This command downloads code to the module Flash memory. Catalyst 5000 software rejects an image if it is not a valid image for the module.

When downloading to the ATM module, the supervisor module acts as a TFTP gateway, forwarding TFTP packets to the ATM module through an in-band interprocessor communication (IPC) method.

Examples

The following example shows how to download the c5000_spv11.bin file from the mercury host:

Console> (enable) download mercury c5000_spv11.bin
Download image c5000_spv11.bin from mercury to module 1FLASH (y/n) [n]? y
\
Done.  Finished Network Download.  (100604 bytes)
host%
intelquery: id=0x89898989 code=0xa2a2a2a2
FLASH on Synergy:
Type            Address             Location
Intel 28F008    20000000            NMP (P3) 4MB SIM
erase(b=14, c=1): block(s): 14 Erase done
Programming Flash:  Flash Programming Complete
erase(b=2, c=4): block(s): 2 3 4 5 Erase done
Programming Flash:  Flash Programming Complete
System must be reset to run new image

The following example shows how to download the fddi_1113.cpi code from the mercury host:

Console> (enable) download mercury fddi_1113.cbi 4
This command will reset Module 4.
Download image fddi_1113.cbi from mercury to Module 4 FLASH (y/n) [n]? y
|
Finished network download.  (1064876 bytes)
...............................................................................n
Console> (enable)

The following example shows how to download the acpflash_1111.bbi code from the mercury host:

Console> (enable) download mercury acpflash_1111.bbi 3
This command will reset Module 3.
Download image acpflash_1111.bbi from mercury to Module 3 FLASH (y/n) [n]? y
/
Done.  Finished network download.  (1964012 bytes)
Console> (enable)

Related Commands

reset
show flash
show version-Switch Command
upload

download serial

Use the download serial command to copy software images to the supervisor card or Flash memory through a serial port.

download serial

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

This command uses Kermit protocol through the serial EIA/TIA-232 console port. The download serial command is not allowed from a Telnet session.

Caution After starting the serial download using Kermit, do not attempt to abort the serial download by using Ctrl-C. This command will interrupt the download process and leave the switch in an undesirable state. However, if this occurs, reboot the switch.

Example

In the following example, a tty port is connected to the command line interface port on the Catalyst 5000 series switch. Following is a sample session showing a connection to a remote terminal from a Sun workstation and the use of the serial download command to copy a software image to the supervisor card:

[At local Sun workstation]
host% kermit
C-Kermit 5A(172) ALPHA, 30 Jun 95, SUNOS 4.0 (BSD)
Type ? or 'help' for help
C-Kermit> set line /dev/ttyb
C-Kermit> c     
Connecting to /dev/ttyb, speed 9600.
The escape character is ^ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
 
Console> enable
Enter Password: 
Console> (enable) set system baud 19200
^\C
[Back at local Sun workstation]
C-Kermit> set speed 19200
/dev/ttyb, 19200 bps
C-Kermit> c
Connecting to /dev/ttyb, speed 19200.
The escape character is ^ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
 
Console> (enable) download serial
Download Supervisor image via console port (y/n) [n]? y
Concentrator Boot ROM (Ver 1.00)
 
Waiting for DOWNLOAD!!
Return to your local Machine by typing its escape sequence
Issue Kermit send command from there[ Send 'Filename']
 
^\C
[Back at Local System]
C-Kermit> send c5000_xx.bin
                          SF
c5000_xx.bin => C5000_XX.BIN, Size: 1233266
 
X to cancel file,  CR to resend current packet
Z to cancel group, A for status report
E to send Error packet, Ctrl-C to quit immediately: ..........................
...............................................................................

...... [OK]
ZB
C-Kermit> quit
host%

download vmps

Use the download vmps command to download VMPS database information from a TFTP server.

download vmps

Syntax Description

This command has no arguments or keywords.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

Before you can successfully execute the download vmps command, you must use the set vmps storage command to configure the IP address of the TFTP server and the name of the VMPS configuration file on that server. If the IP address of the TFTP server is not configured, the download vmps command reports an error. If the configuration file name is not configured, the download vmps command uses the default filename vmps-config-database.1.

After a successful download, the new VMPS information replaces any existing information. If there are not enough resources to build the new configuration database, the VMPS is made inactive.

Examples

The following examples show the download vmps command and typical system responses:

Console> (enable) download vmps
TFTP server IP address is not configured
Console> (enable) download vmps
Unable to contact the TFTP server 198.4.254.222
Console> (enable) download vmps
File "vmps_configuration.db" not found on the TFTP server 198.4.254.222
Console> (enable) download vmps
Enable failed due to insufficient resources. VMPS running with existing database.
Console> (enable) download vmps
Insufficient resources to build the new configuration database. VMPS is made inactive..

Related Commands

set vmps storage
show vmps

editing

Use the editing line configuration command to enable enhanced editing mode. To disable the enhanced editing mode, use the no form of this command.

editing
no editing

Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS ATM module interface command.

Default

Enabled.

Command Mode

Line configuration.

Usage Guidelines

Table 3-3 provides a description of the keys used to enter and edit commands. Ctrl indicates the Control key. It must be pressed simultaneously with its associated letter key. Esc indicates the Escape key. It must be pressed first, followed by its associated letter key. Keys are not case sensitive.

**Table 3-3: Editing Keys and Functions**
Keys	Function
Tab	Completes a partial command name entry. When you enter a unique set of characters and press the Tab key, the system completes the command name. If you enter a set of characters that could indicate more than one command, the system beeps to indicate an error. Enter a question mark (?) immediately following the partial command (no space). The system provides a list of commands that begin with that string.
Delete or Backspace	Erases the character to the left of the cursor.
Return	At the command line, pressing the Return key processes a command. At the "---More---" prompt on a terminal screen, pressing the Return key scrolls down a line.
Spacebar	Allows you to see more output on the terminal screen. Press the Spacebar when you see "---More---" on the screen to display the next screen.
Left Arrow¹	Moves the cursor one character to the left. When you enter a command that extends beyond a single line, you can press the Left Arrow key repeatedly to scroll back toward the system prompt and verify the beginning of the command entry.
Right Arrow1	Moves the cursor one character to the right.
Up Arrow1 or Ctrl-P	Recalls commands in the history buffer, beginning with the most recent command. Repeat the key sequence to recall successively older commands.
Down Arrow1 or Ctrl-N	Returns to more recent commands in the history buffer after recalling commands with the Up Arrow or Ctrl-P. Repeats the key sequence to recall successively more recent commands.
Ctrl-A	Moves the cursor to the beginning of the line.
Ctrl-B	Moves the cursor back one character.
Ctrl-D	Deletes the character at the cursor.
Ctrl-E	Moves the cursor to the end of the command line.
Ctrl-F	Moves the cursor forward one character.
Ctrl-K	Deletes all characters from the cursor to the end of the command line.
Ctrl-L or Ctrl-R	Redisplays the system prompt and command line.
Ctrl-T	Transposes the character to the left of the cursor with the character located at the cursor.
Ctrl-U or Ctrl-X	Deletes all characters from the cursor back to the beginning of the command line.
Ctrl-V or Esc Q	Inserts a code to indicate to the system that the keystroke immediately following should be treated as a command entry, not as an editing key.
Ctrl-W	Deletes the word to the left of the cursor.
Ctrl-Y	Recalls the most recent entry in the delete buffer. The delete buffer contains the last ten items you have deleted or cut. Ctrl-Y can be used in conjunction with Esc Y.
Ctrl-Z	Ends configuration mode and returns to the EXEC prompt.
Esc B	Moves the cursor back one word.
Esc C	Capitalizes from the cursor to the end of the word.
Esc D	Deletes from the cursor to the end of the word.
Esc F	Moves the cursor forward one word.
Esc L	Changes to lowercase from the cursor to the end of the word.
Esc U	Capitalizes from the cursor to the end of the word.
Esc Y	Recalls the next buffer entry. The buffer contains the last ten items you have deleted. Press Ctrl-Y first to recall the most recent entry. Then press Esc Y up to nine times to recall the remaining entries in the buffer. If you bypass an entry, continue to press Esc Y to cycle back to it.

¹ The arrow keys function only with ANSI-compatible terminals.

Example

In the following example, enhanced editing mode is disabled on virtual terminal line 3:

ATM# config terminal
Enter configuration commands, one per line.  End with Ctrl-Z.
ATM(config)# line vty 3
ATM(config-line)# no editing
ATM(config-line)#

enable -ATM Command

Use the enable EXEC command to enter privileged EXEC mode.

enable

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Cisco IOS ATM module interface command.

Command Mode

EXEC.

Usage Guidelines

Because many of the privileged commands set operating parameters, privileged access should be password-protected to prevent unauthorized use. If the system administrator has set a password with the enable password global configuration command, you are prompted to enter the password before being allowed access to privileged EXEC mode. The password is case sensitive. The factory default password on the ATM module is atm.

Example

In the following example, the user enters the enable command and is prompted to enter a password. The password is not displayed on the screen. After entering the password, the system enters privileged command mode as indicated by the pound sign (#).

ATM> enable
Password:
ATM#

Related Command

disable-ATM Command

enable-Switch Command

Use the enable command to activate privileged mode. In privileged mode, certain commands are available, and certain displays have extra information.

enable

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guideline

The designation (enable) indicates that the system is in privileged mode and that privileged commands can be entered.

Example

The following example shows how to enter privileged mode:

Console> enable
Enter password:
Console> (enable)

Related Command

disable-Switch Command

end

Use the end global configuration command to exit configuration mode.

end

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Cisco IOS ATM module interface command.

Command Mode

Global configuration.

Usage Guideline

You can also press Ctrl-Z to exit configuration mode.

Example

In the following example, the switch name is changed to george using the hostname global configuration command. Entering the end command causes the system to exit configuration mode and return to EXEC mode.

ATM (config)# write memory
Remote host [0.0.0.0]? 131.108.1.111
Name of configuration file to write [Catalyst-confg]?
Write file Catalyst-confg on host 131.108.1.111? [confirm]
#
Writing Router-confg !! [OK]
ATM (config)#
write terminal
ATM(config)# hostname george
ATM(config)# end
ATM#

Related Command

exit

exit

Use the exit command at the system prompt to exit any command mode or close an active terminal session and terminate the EXEC.

exit

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Cisco IOS ATM module interface command.

Command Mode

Available in all command modes.

Usage Guidelines

When you enter the exit command at the EXEC level, the EXEC mode is ended. Use the exit command at the configuration level to return to privileged EXEC mode. Use the exit command in interface and line command modes to return to global configuration mode. Use the exit command in subinterface configuration mode to return to interface configuration mode. You can also press Ctrl-Z from any configuration mode to return to privileged EXEC mode.

Example

The following example shows how to exit an active session:

ATM> exit

Related Commands

enable-ATM Command
end

full-help

Use the full-help command to get help for the full set of user-level commands.

full-help

Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS ATM module interface command.

Default

Disabled.

Command Mode

Available in all ATM command modes.

Usage Guidelines

The full-help command enables (or disables) an unprivileged user to see all of the help messages available. It is used with the show ? command.

Example

The following example is output for show ? with the full-help command disabled:

ATM> show ?
  atm 	ATM information
  clock¹	Display the system clock
  history 	Display the session command history
  hosts¹ 	IP domain-name, lookup style, nameservers, and host table
  lane 	LAN Emulation information
  sessions 	Information about telnet connections
  terminal 	Display terminal configuration parameters
  users 	Display information about terminal lines
  version 	System hardware and software status

1. Although this command appears, it is not supported in this software release.

Related Command

help-ATM Command

help -ATM Command

Use the help command to display a brief description of the help system.

help

Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS ATM module interface command.

Command Mode

Available in all ATM command modes.

Usage Guidelines

The help command provides a brief description of the context-sensitive help system:

To list all commands available for a particular command mode, enter a question mark (?) at the system prompt.
To obtain commands that begin with a particular character string, enter the abbreviated command entry immediately followed by a question mark (?). This form of help is called word help, because it lists only the keywords or arguments that begin with the abbreviation you entered.
To list associated keywords or arguments for a command, enter a question mark (?) in place of a keyword or argument on the command line. This form of help is called command syntax help, because it lists the keywords or arguments that apply based on the command, keywords, and arguments you have already entered.

Examples

Enter the help command for a brief description of the help system:

ATM# 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 backup 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?'.)

The following example shows how to use word help to display all the privileged EXEC commands that begin with the letters co:

ATM# co?
configure connect copy

Related Command

full-help

help -Switch Command

Use the help command to list the top-level commands available in the current mode.

help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal and privileged.

Usage Guidelines

In normal mode, the help command provides a list of the top-level commands available in normal mode. In privileged mode, this command provides a list of the top-level commands available in privileged mode.

Examples

The following example shows how to list the top-level commands available in normal mode:

Console> (enable) help
Commands:
----------------------------------------------------------------------
clear               Clear, use 'clear help' for more info
configure           Configure system from terminal/network
disable             Disable privileged mode
disconnect          Disconnect user session
download            Download code to a processor
enable              Enable privileged mode
help                Show this message
history             Show contents of history substitution buffer
ping                Send echo packets to hosts
quit                Exit from the Admin session
reset               Reset system or module
session             Tunnel to ATM module
set                 Set, use 'set help' for more info
show                Show, use 'show help' for more info
slip                Attach/detach Serial Line IP interface
telnet              Telnet to a remote host
test                Test, use 'test help' for more info
upload              Upload code from a processor
wait                Wait for x seconds
write               Write system configuration to terminal/network
Console> (enable)

The following example shows how to list the top-level commands available in privileged mode:

Console> (enable) help
Commands:
----------------------------------------------------------------------
clear               Clear, use 'clear help' for more info
configure           Configure system from terminal/network
disable             Disable privileged mode
disconnect          Disconnect user session
download            Download code to a processor
enable              Enable privileged mode
help                Show this message
history             Show contents of history substitution buffer
ping                Send echo packets to hosts
quit                Exit from the Admin session
reset               Reset system or module
session             Tunnel to ATM module
set                 Set, use 'set help' for more info
show                Show, use 'show help' for more info
slip                Attach/detach Serial Line IP interface
telnet              Telnet to a remote host
test                Test, use 'test help' for more info
upload              Upload code from a processor
wait                Wait for x seconds
write               Write system configuration to terminal/network
Console> (enable)

Related Commands

disable-Switch Command
enable-Switch Command

history -ATM Command

Use the history line configuration command to enable the command history function or to change the command history buffer size for a particular line. To disable the command history feature, use the no form of this command.

history [size number-of-lines]
no history [size number-of-lines]

Syntax Description

size number-of-lines

(Optional) Specifies the number of command lines that the system will record in its history buffer. The range is 0 to 256.

Default

By default, number-of-lines is set to 10.

Command Type

Cisco IOS ATM module interface command.

Command Mode

Line configuration.

Usage Guidelines

The history command, without the size keyword and the number-of-lines argument, enables the history function with the last buffer size specified or with the default of ten lines if there was not a prior setting.

The no history command, without the size keyword and the number-of lines argument, disables the history feature but remembers the buffer size if it was something other than the default. The no history size command resets the buffer size to ten lines.

The command history feature provides a record of EXEC commands you have entered. This feature is particularly useful for recalling long or complex commands or entries, including access lists.

Table 3-4 lists the keys and functions you can use to recall commands from the command history buffer.

Table 3-4: History Keys

Key	Function
Up Arrow or Ctrl-P ¹	Recalls commands in the history buffer in a backward sequence, beginning with the most recent command. Repeat the key sequence to recall successively older commands.
Down Arrow or Ctrl-N1	Returns to more recent commands in the history buffer after recalling commands with the Up Arrow or Ctrl-P. Repeat the key sequence to recall successively more recent commands.

¹ The arrow keys function only with ANSI-compatible terminals such as VT100s.

Example

In the following example, virtual terminal line 4 is configured with a history buffer size of 35 lines:

ATM# config terminal
Enter configuration commands, one per line. End with Ctrl-Z.
ATM(config)# line vty 4
ATM(config-line)# history size 35
ATM(config-line)#

Related Command

show history

history -Switch Command

The history command shows the contents of the history substitution buffer. Refer to the "Command Line Interfaces" chapter for details about the history substitution buffer.

history

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guideline

The history buffer size is fixed at 20 commands.

Example

In the following example, the history command lists the contents of the history substitution buffer:

Console> history
       1 help
       2 history
Console> !2
Console> history
       1 help
       2 history
       3 history

lane auto-config-atm-address

Use the lane auto-config-atm-address interface configuration command to specify that the configuration server ATM address is computed by our automatic method. To remove the previously assigned ATM address, use the no form of this command.

lane auto-config-atm-address no lane auto-config-atm-address

Syntax Description

This command has no keywords or arguments.

Default

No specific ATM address or method is set.

Command Type

Cisco IOS ATM module interface command.

Command Mode

Interface configuration.

Usage Guidelines

When applied to a subinterface, this command causes the LANE server and LANE client on the subinterface to use the automatically assigned ATM address (rather than the ATM address provided by the ILMI) to locate the configuration server.

If applied to a LANE configuration server on a major interface, this command assigns an ATM address to the configuration server configured on the interface.

Multiple commands that assign ATM addresses to the LANE configuration server can be issued on the same interface to assign different ATM addresses to the configuration server. Commands that assign ATM addresses to the LANE configuration server include lane auto-config-atm-address, lane config-atm-address, and lane fixed-config-atm-address.

The lane config command and at least one command that assigns an ATM address to the LANE configuration server are required to activate a LANE configuration server.

Example

The following example associates the LANE configuration server with the database name network1 and specifies that the configuration server's ATM address will be assigned by using our automatic method.

lane database network1
name eng server-atm-address 39.0000014155551211.0800.AA00.1001.02
name mkt server-atm-address 39.0000014155551211.0800.AA00.4001.01
lane config network1
lane auto-config-atm-address

Related Commands

lane config

lane config-atm-address

lane fixed-config-atm-address

lane client

Use the lane client interface configuration command to activate a LANE client on the specified subinterface. To remove a previously activated LANE client on the subinterface, use the no form of this command.

lane client ethernet vlan# [elan-name]
no lane client [ethernet vlan# [elan-name]]

Syntax Description

ethernet	The type of emulated LAN attached to this subinterface.
elan-name	(Optional) Name of the emulated LAN. This argument is optional because the client obtains its emulated LAN name from the configuration server. Maximum length is 32 characters.
vlan#	The number of the VLAN that corresponds to the specified emulated LAN.

Default

None.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

Interface configuration.

Usage Guidelines

This command is ordinarily used.

If a lane client command has already been entered on the subinterface for a different emulated LAN, the client initiates termination procedures for that emulated LAN and joins the new emulated LAN.

If you do not provide an elan-name value, the client contacts the server to find which emulated LAN to join. If you do provide an emulated LAN name, the client consults the configuration server to ensure that no conflicting bindings exist.

Example

In the following example, the LANE client is activated for a VLAN 3 called eng:

ATM(config-if)# lane client ethernet vlan 3 eng

Related Command

lane client-atm-address

lane client-atm-address

Use the lane client-atm-address interface configuration command to specify an ATM address and override the automatic ATM address assignment for the LANE client on the specified subinterface. To remove the ATM address previously specified for the LANE client on the specified subinterface and revert to the automatic address assignment, use the no form of this command.

lane client-atm-address atm-address-template
no client-atm-address [atm-address-template]

Syntax Description

atm-address-template

ATM address or a template in which wildcard characters are replaced by any nibble or group of nibbles of the prefix bytes, the ESI bytes, or the selector byte of the automatically assigned ATM address.

Default

Automatic ATM address assignment.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

Interface configuration.

Usage Guidelines

Use of this command on a selected subinterface, but with a different ATM address than was used previously, replaces the LANE client's ATM address.

ATM Addresses. A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):

A 13-byte prefix that includes the following fields defined by the ATM Forum: AFI (Authority and Format Identifier) field (1 byte), DCC (Data Country Code) or ICD (International Code Designator) field (2 bytes), DFI field (Domain Specific Part Format Identifier) (1 byte), Administrative Authority field (3 bytes), Reserved field (2 bytes), Routing Domain field (2 bytes), and Area field (2 bytes).
A 6-byte end-system identifier (ESI).
A 1-byte selector field.

Address Templates. LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character and an ellipsis (...) to match any number of leading or trailing characters. The values of the characters replaced by wildcards come from the automatically assigned ATM address.

In LANE, a prefix template explicitly matches the ATM address prefix but uses wildcards for the ESI and selector fields. An ESI template explicitly matches the ESI field but uses wildcards for the prefix and selector.

In Cisco's implementation of LANE, the prefix corresponds to the switch, the ESI corresponds to the ATM interface, and the Selector field corresponds to the specific subinterface of the interface.

For a discussion of Cisco's method of automatically assigning ATM addresses, refer to the "Configuring LAN Emulation" chapter in the Router Products Configuration Guide.

Examples

The following example uses an ESI template to specify the part of the ATM address corresponding to the interface; the remaining parts of the ATM address come from automatic assignment:

ATM(config-if)# lane client-atm-address...0800.200C.1001.**

The following example uses a prefix template to specify the part of the ATM address corresponding to the switch; the remaining parts of the ATM address come from automatic assignment:

ATM(config-if)# lane client-atm-address 47.000014155551212f.00.00...

Related Command

lane client

lane config-atm-address

Use the lane config-atm-address interface configuration command to specify a given configuration server's ATM address. To remove an assigned ATM address, use the no form of this command.

lane config-atm-address atm-address-template
no lane config-atm-address [atm-address-template]

Syntax Description

atm-address-template

Default

No specific ATM address or method is set.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

Interface configuration.

Usage Guidelines

This command causes the LANE client on the subinterface to use the specified ATM address (rather than the ATM address provided by the ILMI) to locate the configuration server.

ATM Addresses. A LANE ATM address has the same syntax as an NSAP (but it is not a network-level address):

A 13-byte prefix that includes the following fields defined by the ATM Forum: AFI (Authority and Format Identifier) field (1 byte), DCC (Data Country Code) or ICD (International Code Designator) field (2 bytes), DFI field (Domain Specific Part Format Identifier) (1 byte), Administrative Authority field (3 bytes), Reserved field (2 bytes), Routing Domain field (2 bytes), and Area field (2 bytes).
A 6-byte end-system identifier (ESI).
A 1-byte selector field.

Address Templates. LANE ATM address templates can use two types of wildcards: an asterisk (*) to match any single character, and an ellipsis (...) to match any number of leading or trailing characters. The values of the characters replaced by wildcards come from the automatically assigned ATM address.

In Cisco's implementation of LANE, the prefix corresponds to the switch, the ESI corresponds to the ATM interface, and the Selector field corresponds to the specific subinterface of the interface.

For a discussion of Cisco's method of automatically assigning ATM addresses, refer to the "Configuring ATM LAN Emulation Module Software" chapter in the XXXX.

Example

The following example specifies the LANE configuration server's ATM address:

ATM(config-subif)# lane config-atm-address 39.000000000000014155551211.0800200c1001.00

Related Command

show lane

lane config database

To associate a named configuration table (database) with the configuration server on the selected ATM interface, use the lane config database interface configuration command. To remove the association between a named database and the configuration server on the specified interface, use the no form of this command.

lane config database database-name

no lane config database

Syntax Description

database-name

Name of the LANE database.

Default

No configuration server is defined, and no database name is provided.

Command Mode

Interface configuration.

Usage Guidelines

This command is valid only on a major interface, not a subinterface, because only one LANE configuration server can exist for a switch cloud.

The named database must exist before the lane config database command is entered. Refer to the lane database command for more information.

Multiple lane config database commands cannot be entered on the same interface. You must delete an existing association by using the no form of this command before you can enter a new association on the specified interface.

Activating a LANE client requires the lane config database command and one of the following commands: lane fixed-config-atm-address, lane auto-config-atm-address, or lane config-atm address.

Example

In this example, the database name is test.

ATM(config)# int atm0 ATM(config-if)# lane config database test ATM(config-if)# end

Related Commands

lane auto-config-atm-address

lane config-atm-address

lane database

lane fixed-config-atm-address

lane database

Use the lane database global configuration command to create a named configuration database that can be associated with a configuration server when one is configured. The no form of this command deletes all entries in the specified database.

lane database database-name no lane database database-name

Syntax Description

database-name

Database name (32 characters maximum)

Default

No name is provided.

Command Mode

Global configuration.

Usage Guidelines

LANE clients consult the LANE configuration server for information such as the location of the LANE server. The configuration server looks up the configuration information in its named database.

A database contains entries that bind an emulated LAN name to the ATM address of the LANE server, bind LANE client MAC addresses to an emulated LAN name, and bind LANE client ATM address templates to an emulated LAN name.

Use of the lane database command places you in database configuration mode, in which you can use the client-atm-address name, default name, mac-address name, and name server-atm-address commands to create entries in the specified database. When you are done creating entries, type ^Z or exit to return to global configuration mode.

Example

This example creates a configuration database named test.

ATM(config)# int atm0 ATM(config-if)# lane database test ATM(lane-config-database)# end

Related Commands

client-atm-address name

default name

mac-address name

name server-atm-address

lane le-arp

Use the lane le-arp interface configuration command to add a static entry to the LE ARP table of the LANE client configured on the specified subinterface. To remove a static entry from the LE ARP table of the LANE client on the specified subinterface, use the no form of this command.

lane le-arp mac-address atm-address
no lane le-arp mac-address atm-address

Syntax Description

mac-address	MAC address to bind to the specified ATM address.
atm-address	ATM address.

Default

No static address bindings are provided.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

Interface configuration.

Usage Guidelines

This command only adds or removes a static entry binding a MAC address to an ATM address. It does not add or remove dynamic entries. Removing the static entry for a specified ATM address from an LE ARP table does not release Data Direct VCCs established to that ATM address. However, clearing a static entry clears any fast-cache entries that were created from the MAC address-to-ATM address binding.

Static LE ARP entries are not aged and are not removed automatically.

To remove dynamic entries from the LE ARP table of the LANE client on the specified subinterface, use the clear lane le-arp command.

Example

The following command adds a static entry to the LE ARP table:

ATM(config-if)# lane le-arp 0800.aa00.0101 47.000014155551212f.00.00.0800.200C.1001.01

Related Command

show lane le-arp

lane register

Use the lane register interface configuration command to register a LANE client that is connected by PVC to the LANE server on the specified subinterface. To remove a prior entry, use the no form of this command.

lane register vcd mac-address atm-address
no lane register vcd [mac-address atm-address]

Syntax Description

vcd	Virtual channel descriptor of the Server Direct PVC through which the LANE client is connected to the LANE server.
mac-address	MAC address of the LANE client.
atm-address	ATM address of the LANE client.

Defaults

No PVC is defined. No MAC address and ATM address are provided.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

Interface configuration.

Usage Guidelines

Ordinarily, SVCs are used instead of PVCs for communications within emulated LANs, and registration occurs dynamically via the LANE protocol. This command is used only when PVCs are used.

When PVCs are used instead of SVCs for Server Direct circuits between the LANE server and LANE clients, use this command on the LANE server to identify the MAC address and the ATM address of the LANE client at the other end of a virtual circuit. If the client at the other end has a different ATM address, it is not allowed to join the emulated LAN. This can function as a security check.

Use the lane pvc command on a LANE client and the lane register command on a LANE server to enable use of PVCs, instead of SVCs alone, for LANE. The vcd value in the lane register command must match the vcd value in a lane pvc command and in an atm pvc command.

If you use PVCs for the Control Direct VCCs, you must also use PVCs for the Control Distribute VCCs. If you use PVCs for the Multicast Send VCCs, you must also use PVCs for the Multicast Forward VCCs

Related Command

show lane

lane server-bus

Use the lane server-bus command to configure the LAN Emulation Server (LES) and Broadcast and Unknown Server (BUS) for the specified emulated LAN on the subinterface.

lane server-bus {ethernet | token ring} elan name

no lane server-bus {ethernet | token ring} elan name

Note Only emulated Ethernet LANs are supported in the current software version.

Default

The default is Ethernet.

Syntax Description

elan name

Name of the emulated LAN.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

Interface configuration.

Usage Guideline

In the current software version, the LES and BUS of an emulated LAN must be colocated. The no lane server-bus command deletes the specified LES/BUS.

Example

The following command configures the LES and BUS for the default ELAN.

ATM(config)# int atm0.1 ATM(config-subif)# lane server-bus ethernet default ATM(config-subif)# end

name server-atm-address

Use the name server-atm-address command to assign a unique emulated LAN name to a LAN Emulation server. The no form of this command deletes the corresponding emulated LAN name.

name <elan name> server-atm-address <atm-address> no name <elan name> server-atm-address <atm-address>

Syntax Description

elan name	Name of the emulated LAN.
atm-address	ATM address of the LANE client.

Command Type

Cisco IOS ATM command.

Command Mode

Database configuration.

Usage Guideline

Use this command when setting up the LECS database on Catalyst 5000 series switches or when configuring the address of a LES/BUS.

Example

The following command configures the LES ATM NSAP address for the default ELAN.

ATM# config terminal
Enter configuration commands, one per line.  End with Ctrl-Z.
ATM(lane-config-database)# name default server-atm-address

47.0091810000000061705b7701.00400BFF0011.00

ATM(lane-config-database)# end

The ELAN name is default. The LES ATM NSAP address is 47.0091810000000061705b7701.00400BFF0011.00.

Related Commands

lane database database-name
default-name elan-name

ping

Use the ping command to send Internet Control Message Protocol (ICMP) echo request packets to another node on the network.

ping host
ping -s host [packet_size] [packet_count]

Syntax Description

-s	Command option that causes ping to send one datagram per second, printing one line of output for every response received. The ping command does not return any output when no response is received.
host	The IP address or IP alias of the host.
packet_size	(Optional) The number of bytes in a packet, from 1 to 2000 bytes; the default is 56 bytes. The actual packet size will be eight bytes larger because the switch adds header information.
packet_count	(Optional) The number of packets to send.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

Press Ctrl-C to stop pinging.

Following are sample results of the ping command:

Normal response--The normal response occurs in 1 to 10 seconds, depending on network traffic.
Destination does not respond--If the host does not respond, a "no answer message" appears in 10 seconds.
Destination unreachable--The gateway given in the route table for this destination indicates that the destination is unreachable.
Network or host unreachable--The switch found no corresponding entry in the route table.

Example

The following example shows how to ping a host with IP alias elvis a single time, then ping it once per second until you press Ctrl-C to stop pinging:

Console> ping elvis
elvis is alive
Console> ping -s elvis
ping elvis: 56 data bytes
64 bytes from elvis: icmp_seq=0. time=11 ms
64 bytes from elvis: icmp_seq=1. time=8 ms
64 bytes from elvis: icmp_seq=2. time=8 ms
64 bytes from elvis: icmp_seq=3. time=7 ms
64 bytes from elvis: icmp_seq=4. time=11 ms
64 bytes from elvis: icmp_seq=5. time=7 ms
64 bytes from elvis: icmp_seq=6. time=7 ms
^C
----elvis PING Statistics----
7 packets transmitted, 7 packets received, 0% packet loss
round-trip (ms)  min/avg/max = 7/8/11
Console>

Related Commands

set interface
set ip route
show interface
show ip route

quit

Use the quit command to exit a command line interface session.

quit

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

The exit and logout commands perform the same function as the quit command.

Example

The following example shows how to close a connection with the command line interface:

Console> quit
Connection closed by foreign host.
host%

Related Command

exit

reconfirm vmps

Use the reconfirm vmps command to reconfirm the current dynamic port VLAN membership with VMPS.

reconfirm vmps

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

VMPS database changes are not automatically conveyed to dynamic port entities; therefore, after making a VMPS database change, the user can apply the change to the dynamic port entity on a device.

Example

The following example illustrates how to reconfirm the current dynamic port VLAN membership with VMPS:

console (enable)> reconfirm vmps
console (enable)> reconfirm vmps
Reconfirmation in progress ...
Reconfirmation done.

Related Commands

clear vmps address
set vmps address
show vmps address

reload

Use the reload EXEC command to reload the operating system.

reload

Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS Configuration command.

Command Mode

EXEC.

Usage Guidelines

The reload command halts the ATM module. If the ATM module is set to restart on error, it robots itself. Use the reload command after configuration information is entered into a file and saved to the startup configuration.

You cannot reload from a virtual terminal if the system is not set up for automatic booting. This prevents the system from dropping to the ROM monitor and thereby taking the system out of the remote user's control.

If you modify your configuration file, the system prompts you to save the configuration. During a save operation, the system asks you if you want to proceed with the save if the CONFIG_FILE environment variable points to a startup configuration file that no longer exists. If you say "yes" in this situation, the system goes to setup mode upon reload.

Example

The following example illustrates how to enter the reload command at the privileged EXEC prompt:

ATM> reload

reset

Use the reset command to restart the system or an individual line card.

reset system
reset mod_num

Syntax Description

system	Keyword used to reset the system to its default values.
mod_num	The number of the module to be restarted.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

If no module number or module 1 is specified, the command resets the entire system.

You can use the reset mod_num command to switch to the standby supervisor engine, where mod_num is the slot number of the active supervisor.

Examples

The following example shows how to reset the supervisor engine module on a Catalyst 5500 switch with redundant supervisors.

Console> (enable) reset 1
----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
This command will force a switch-over to the standby supervisor module
and disconnect your telnet session.
Do you want to continue (y/n) [n]? y
Connection closed by foreign host.
host%

The following example shows how to reset module 4:

Console> (enable) reset 4
This command will reset module 4.
Do you want to continue (y/n) [n]? y
Run time configuration and nvram configuration on ATM card 4 differs.
Do you wish to perform "write memory" (y/n) [n]? y
Resetting module 4...
Console> (enable)

session

Use the session command to access the ATM commands, which allow you to configure the ATM module.

session
session mod_num

Syntax Description

mod_num

The number of the module.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal and privileged.

Usage Guidelines

After you enter this command, the system responds with the Enter Password: prompt. Enter atm as the password. This password can be changed; however, there is no need to change this password because the switch is already protected by an access password and a password for entering privileged command mode.

To end the session with the ATM module, enter the exit, quit, or logout command.

Example

The following example shows how to access the ATM commands:

Console> session
Usage: session <mod_num>
Console> session 4
End ATM session with exit, quit or logout.
ATM> enable
Enter Password:
ATM-# exit
Console> (enable)

set alias

Use the set alias command to define shorthand versions of commands.

set alias name command [parameter] [parameter]

Syntax Description

name	The alias being created.
command	The command for which the alias is being created.
parameter	(Optional) Parameters that apply to the command for which an alias is being created. See the specific command for information about parameters that apply.

Default

No aliases configured.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The name all cannot be defined as an alias.

Example

The following example shows how to set arpdel as the alias for the clear arp command:

Console> (enable) set alias arpdel clear arp
Command alias added.
Console> (enable)

Related Commands

clear alias
show alias

set arp

The set arp command adds entries into the Address Resolution Protocol (ARP) table and sets the ARP aging time for the table.

set arp agingtime agingtime
set arp ip_addr hw_addr

Syntax Description

agingtime	The number of seconds (from 1 to 1000000) that entries will remain in the ARP table before being deleted. Setting this value to 0 disables aging.
ip_addr	The IP address or IP alias of the physical unit.
hw_addr	The MAC address of the physical unit.

Default

No ARP table entries exist, and ARP aging is set to 1200 seconds.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the aging time for the ARP table to 1800 seconds and add an entry for a physical unit with IP address 198.133.219.232 and a MAC address of 00-00-0c-40-0f-bc to the ARP table:

Console> (enable) set arp agingtime 1800
ARP aging time set to 1800 seconds.
Console> (enable) set arp 198.133.219.232 00-00-0c-40-0f-bc
ARP entry added.
Console> (enable)

Related Commands

clear arp
show arp

set authentication enable

The set authentication enable command enables authentication using the TACACS+ server to determine if a user has privileged access permission.

set authentication enable <tacacs | local> <enable | disable>

Syntax Description

tacacs	Keyword that tells the command to use the TACACS+ server to determine if the user has privileged access permission.
local	Keyword that tells the command to use the local password to determine if the user has privileged access permission.
enable \| disable	Keywords used to enable or disable TACACS+ authentication for login.

Default

The default setting of this command is local authentication enabled and TACACS+ authentication disabled.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following example shows how to enable authentication using the TACACS+ server to determine if a user has privileged access permission:

Console> (enable) set authentication enable tacacs enable
Console> (enable)

The following example shows how to use the local password to determine if the user has privileged access permission:

Console> (enable) set authentication enable local enable
Console> (enable)

Related Commands

set authentication login
show tacacs

set authentication login

The set authentication login command enables TACACS+ authentication for login.

set authentication login <tacacs | local> <enable | disable>

Syntax Description

tacacs	Keyword that tells the command to use the TACACS+ server password to determine if the user has access permission to the switch.
local	Keyword that tells the command to use the local password to determine if the user has access permission to the switch.
enable \| disable	Keyword that enables or disables TACACS+ authentication for login.

Default

The default setting of this command is local authentication enabled and TACACS+ authentication disabled.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following example shows how to enable the TACACS+ server to authenticate access permission to the switch:

Console> (enable) set authentication login tacacs enable
Console> (enable)

The following example shows how to use the local password to authenticate access permission to the switch:

Console> (enable) set authentication login local enable
Console> (enable)

Related Commands

set authentication enable
show tacacs

set banner motd

The set banner motd command allows you to program a message-of-the-day banner to appear before session login.

set banner motd <c> [text] <c>

Syntax Description

<c>	A delimiting character used to end the message.
text	The message of the day.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following example shows how to set the message of the day using the pound sign (#) as the delimiting character:

Console> (enable) set banner motd #
** System upgrade at 6:00am Tuesday.
** Please log out before leaving on Monday. #
MOTD banner set.
Console> (enable) exit
Console> (enable)

The following example shows how to clear the message of the day:

Console> (enable> set banner motd ""
MOTD banner cleared.
Console> (enable>

Related Commands

clear arp
show arp

set bridge apart

Use the set bridge apart command to enable or disable the default translation on FDDI.

set bridge apart enable | disable

Syntax Description

enable	Keyword that activates the default translation on FDDI.
disable	Keyword that deactivates the default translation on FDDI.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to disable set bridge apart.

Console> (enable) set bridge apart disable
APaRT disabled
Console> (enable)

Related Commands

set bridge fddicheck
set bridge help

set bridge fddicheck

Use the set bridge fddicheck command to reject the learning of MAC addresses that it previously learned from an Ethernet interface the default translation on FDDI.

set bridge fddicheck enable | disable

Syntax Description

enable	Keyword that activates FDDI to learn new addresses.
disable	Keyword that deactivates FDDI to learn new addresses.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

This command requires information from the CAM. Therefore, disabling APART also automatically disables fddicheck. To enable fddicheck, first enable APART.

Example

The following example shows how to enable the set bridge fddicheck command.

Console> (enable) set bridge fddicheck enable
FDDICHECK enabled
Console> (enable)

Related Commands

set bridge apart
set bridge help

set bridge help

Use the set bridge help command to list the set bridge commands with brief descriptions of their functions.

set bridge help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list all of the set bridge commands:

Console> (enable) set bridge help
Commands:
----------------------------------------------------------------------
set bridge apart	Dis/Enable default translation on FDDI
set bridge help	Show 'set bridge' command menu
set bridge ipx	Set default IPX translation
set bridge fddicheck	Dis/Enable FDDI to learn new addresses
Console> (enable)

set bridge ipx 8022toether

Use the set bridge ipx 8022toether command to set the default mode for translating IPX packets from FDDI 802.2 to Ethernet. This default translation is used only until the real protocol types are learned.

set bridge ipx 8022toether {8023 | SNAP | EII | 8023RAW}

Syntax Description

8023	Keyword that specifies Ethernet 802.3 as the default protocol.
SNAP	Keyword that specifies Ethernet SNAP as the default protocol.
EII	Keyword that specifies Ethernet II as the default protocol.
8023RAW	Keyword that specifies Ethernet 802.3 RAW as the default protocol.

Default

The default value for the set bridge ipx 8022toether command is 8023 (Ethernet 802.3).

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the default protocol to SNAP for translating IPX packets between FDDI 802.2 and Ethernet networks:

Console> (enable) set bridge ipx 8022toether snap
Module 4 8022toether translation set.
Console> (enable)

Related Command

set bridge help

set bridge ipx 8023rawtofddi

Use the set bridge ipx 8023rawtofddi command to set the default protocol for translating IPX packets from Ethernet 802.3 to FDDI. This default translation is used only until the real protocol types are learned.

set bridge ipx 8023rawtofddi {8022 | SNAP | FDDIRAW}

Syntax Description

8022	Keyword that specifies FDDI 802.2 as the default protocol.
SNAP	Keyword that specifies FDDI SNAP as the default protocol.
FDDIRAW	Keyword that specifies FDDI RAW as the default protocol.

Default

The default value for the set bridge ipx 8023rawtofddi command is SNAP (FDDI SNAP).

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the default mode to SNAP for translating IPX packets between Ethernet 802.2 RAW and FDDI networks:

Console> (enable) set bridge ipx 8023rawtofddi snap
Module 4 8023rawtofddi translation set.
Console> (enable)

Related Command

set bridge help

set bridge ipx snaptoether

Use the set bridge ipx snaptoether command to set the default protocol for translating IPX FDDI SNAP frames to Ethernet frames. This default translation is used for all broadcast IPX SNAP frames and for any unlearned Ethernet MAC addresses.

set bridge ipx snaptoether {8023 | SNAP | EII | 8023RAW}

Syntax Description

8023	Keyword that specifies Ethernet 802.3 as the default frame type.
SNAP	Keyword that specifies Ethernet SNAP as the default frame type.
EII	Keyword that specifies Ethernet II as the default frame type.
8023RAW	Keyword that specifies Ethernet 802.3 RAW as the default frame type.

Default

The default value for set bridge ipx snaptoether command is 8023RAW (Ethernet 802.3 RAW).

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the default protocol for translating IPX FDDI SNAP packets to Ethernet SNAP.

Console> (enable) set bridge ipx snaptoether snap
Module 4 snaptoether translation set
Console> (enable)

Related Command

set bridge help

set cam

Use the set cam command to add entries into the Content Addressable Memory (CAM) table and to set the aging time for the table. The default configuration has a local MAC address(es), spanning-tree address (01-80-c2-00-00-00), and CDP multicast address for destination port 1/3 (the NMP).

Note Although this command refers to the CAM table, the table is an EARL table.

set cam agingtime vlan agingtime
set cam {dynamic | static | permanent} unicast_mac mod/ports [vlan]
set cam {dynamic | static | permanent} multicast_mac mod/ports [vlan]

Syntax Description

vlan	The number of the VLAN. When setting aging time and when setting CAM entries to dynamic, static, or permanent for a trunk port, the VLAN number is required. Otherwise, the VLAN number is optional.
agingtime	(Optional) The number of seconds (0 to 1000000) that entries remain in the table before being deleted.
dynamic	Keyword that specifies that entries are subject to aging.
static	Keyword that specifies that entries are not subject to aging. Static (nonpermanent) entries will remain in the EARL table until the system is reset.
permanent	Keyword that specifies that static (permanent) entries are stored in NVRAM until they are removed by the clear cam or clear config command.
unicast_mac	The MAC address of the destination host used for a unicast.
mod	The number of the module.
ports	The numbers of the ports.
multicast_mac	The MAC address of the destination host used for a multicast.

Default

The default aging time for all configured VLANs is 300 seconds. Setting aging time to 0 disables aging.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

If the given MAC address is a multicast (xn-xx-xx-xx-xx-xx where n is xxx1 [that is, the least significant bit of the most significant byte is set to 1]) or broadcast address (ff-ff-ff-ff-ff-ff) and multiple ports are specified, the ports must all be in the same VLAN. If the given address is a unicast address and multiple ports are specified, the ports must be in different VLANs.

Example

The following example shows how to set the CAM table aging time to 300 seconds; how to add a unicast entry to the table for module 2, port 9; and how to add a permanent multicast entry to the table for module 1, port 1, and module 2, ports 1, 3, and 8 through 12.

Console> (enable) set cam
Usage: set cam agingtime <vlan> <agingtime>
       set cam <dynamic|static|permanent> <unicast_mac> <mod/port> [vlan]
       set cam <static|permanent> <multicast_mac> <mod/ports..> [vlan]
       (agingtime = 0..1000000 seconds, 0 to disable
        vlan = 1..1000 
        Ports of a multicast group must be of the same VLAN.
        Must specify vlan if port(s) are trunk ports.)
Console> (enable) set cam agingtime 1 300
Vlan 1 CAM aging time set to 300 seconds.
Console> (enable) Console
Console> (enable) set cam agingtime 1 300
CAM table aging time set.
Console> (enable) set cam static 00-00-0c-a0-03-fa 2/9
Static unicast entry added to CAM table.
Console> (enable) set cam permanent 01-40-0b-a0-03-fa 1/1,2/1,2/3,2/8-12
Permanent multicast entry added to CAM table.
Console> (enable)

Related Commands

clear cam
show cam

set cdp disable

Use the set cdp disable command to disable the Cisco Discovery Protocol (CDP) information display on specified ports. If enable or disable is not specified, the current setting remains active.

set cdp disable mod_num/port_num
set cdp disable all

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
all	All ports.

Default

The default system configuration has CDP enabled with a message interval of 60 seconds for every port.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

When enabling or disabling CDP and the message interval is not specified, the existing message interval is used.

The ATM module does not support CDP.

Example

The following example shows how to disable the CDP message display for port 1 on module 2:

Console> (enable) set cdp 2/1 disable
Port 2/1 CDP disabled.
Console> (enable)

Related Commands

set cdp enable
set cdp interval

set cdp enable

Use the set cdp enable command to enable the Cisco Discovery Protocol (CDP) information display. If enable or disable is not specified, the current setting remains active.

set cdp enable mod_num/port_num
set cdp enable all

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
all	All ports.

Default

The default system configuration has CDP enabled with a message interval of 60 seconds for every port.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

When enabling or disabling CDP and the message interval is not specified, the existing message interval is used.

Example

The following example shows how to enable the CDP message display for port 1 on module 2:

Console> (enable) set cdp 2/1 enable
Port 2/1 CDP enabled.
Console> (enable)

Related Commands

set cdp disable
set cdp interval

set cdp interval

Use the set cdp interval command to set the message interval for Cisco Discovery Protocol (CDP) on each port.

set cdp interval mod_num/port_num interval
set cdp interval all

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
interval	The number of seconds (5 to 900) the system waits before sending a message.
all	All ports.

Default

The default system configuration has CDP enabled with a message interval of 30 seconds for every port.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

You can set the message interval within the range of 5 to 900 seconds.

Example

The following example shows how to set the CDP message interval for port 10 on module 2 to
60 seconds:

Console> (enable) set cdp interval
Usage: set cdp interval all <interval>
       set cdp interval <mod/ports...> <interval>
      (interval = 5..900 seconds.)
Console> (enable) set cdp interval 2/10 60
CDP message interval set to 60 seconds for port 2/10.
Console> (enable)

Related Commands

set cdp disable
set cdp enable

set cgmp

Use the set cgmp command to enable/disable Cisco Group Management Protocol (CGMP) on a device.

set cgmp {enable | disable}

Syntax Description

enable	Keyword used to enable CGMP on a device.
disable	Keyword used to disable CGMP on a device.

Default

By default, CGMP is disabled.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

CGMP filtering requires a network connection from the Catalyst 5000 series switch to an external router running the CGMP.

Examples

The following examples show how to enable and disable CGMP on a device:

Console> (enable) set cgmp enable
CMGP support for IP multicast enabled.
Console> (enable) 
console> (enable) set cgmp disable
CMGP support for IP multicast disabled.

Related Commands

set multicast router
clear multicast router
show multicast router
show multicast group

set enablepass

The set enablepass command changes the password for the privileged level on the command-line interface.

set enablepass

Syntax Description

This command has no arguments or keywords.

Default

The default configuration does not have enable password configured.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The command prompts you for the old password. If this password is valid, you are then prompted twice to enter a new password. A zero-length password is allowed.

Example

The following example shows how to establish a new password:

Console> (enable) set enablepass
Enter old password:
Enter new password:
Retype new password: 
Password changed.
Console> (enable)

Related Commands

enable-Switch Command
set password

set fddi alarm

Use the set fddi alarm command to change the LER-alarm value for an FDDI port. The value defines the link error rate (LER) at which a link connection exceeds a preset alarm threshold. This value is used in the link-error-rate threshold test.

set fddi alarm mod_num/port_num value

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
value	The exponential value for the LER-Alarm parameter (that is, 10¯value link errors per second). Valid values are between 7 and 15.

Default

The default value for LER-alarm is 8 (10¯8) milliseconds.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

Set the LER-alarm value for a FDDI port within the range of 7 to 15 microseconds.

Example

The following example shows how to change the LER-alarm value to 11 for port 1 on module 4:

Console> (enable) set fddi alarm
Usage: set fddi alarm <mod_num/port_num> <value>
       (value = 7..15)
Console> (enable) set fddi alarm 4/1 11
Port 4/1 alarm value set to 11.
Console> (enable)

Related Commands

set fddi cutoff
set fddi help
set fddi tlmin
set fddi tnotify
set fddi treq
set fddi userdata

set fddi cutoff

Use the set fddi cutoff command to change the LER-cutoff value for an FDDI port. This value determines the link error rate (LER) at which a connection is flagged as faulty. This value is used in the link-error-rate threshold test.

set fddi cutoff mod_num/port_num value

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
value	The exponential value for the LER-cutoff parameter (that is, 10¯value link errors per second). Valid values are between 7 and 15.

Default

The default value for LER-cutoff is 7 (10¯7) seconds.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to change the LER-cutoff value to 10¯10 seconds for port 1 on module 4:

Console> (enable) set fddi cutoff
Usage: set fddi cutoff <mod_num/port_num> <value>
       (value = 7..15)
Console> (enable) set fddi cutoff 4/1 10
Port 4/1 cutoff value set to 10.
Console> (enable)

Related Commands

set fddi alarm
set fddi help
set fddi tlmin
set fddi tnotify
set fddi treq
set fddi userdata

set fddi help

Use the set fddi help command to list the set fddi commands with brief descriptions of their functions.

set fddi help

Syntax Description

This command has no arguments or keywords.

Command Type

Switch command.

Default

This command has no default setting.

Command Mode

Privileged.

Example

The following example shows how to list the set fddi commands:

Console> (enable) set fddi help
Commands:
----------------------------------------------------------------------
set fddi alarm       Set port LER-Alarm
set fddi cutoff      Set port LER-Cutoff
set fddi help        Show this message
set fddi tlmin       Set port tl_min
set fddi tnotify     Set module SMT T-Notify
set fddi treq        Set MAC T-Request
set fddi userdata    Set module SMT User Data
Console> (enable)

Related Commands

set fddi alarm
set fddi cutoff
set fddi tlmin
set fddi tnotify
set fddi treq
set fddi userdata

set fddi tlmin

Use the set fddi tlmin command to change the TL_MIN value for an FDDI port. The TL_MIN parameter sets the minimum time to transmit a physical sublayer (PHY) line state before advancing to the next physical connection management (PCM) state. This setting affects the station and switch interoperability and might hinder the implementation of FDDI repeaters. By default, the TL_MIN parameter is set to 40 microseconds.

set fddi tlmin mod_num/port_num usecs

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
usecs	The number of microseconds for the TL_MIN parameter.

Default

The default value for TL_MIN is 40 microseconds.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to change the TL_MIN value to 80 microseconds for port 1 on module 4:

Console> (enable) set fddi tlmin 4/1 80
Port 4/1 tlmin set to 80.

Related Commands

set fddi alarm
set fddi cutoff
set fddi help
set fddi tnotify
set fddi treq
set fddi userdata

set fddi tnotify

Use the set fddi tnotify command to change the TNotify timer value for a FDDI port.

set fddi tnotify mod_num time

Syntax Description

mod_num	The number of the module.
time	The number of seconds for the TNotify timer. Valid times are from 2 to 30 seconds.

Default

The default value for the TNotify timer is 30 seconds.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The TNotify parameter sets the interval (in seconds) between neighbor notification frames. These frames are sent out to notify neighboring devices of FDDI module MAC addresses. Usually, the default setting is sufficient.

Example

The following example shows how to change the TNotify timer value to 16 seconds for module 4:

Console> (enable) set fddi tnotify 4 16
Port 4/1 tnotify set to 16.
Console> (enable)

Related Commands

set fddi alarm
set fddi cutoff
set fddi help
set fddi tlmin
set fddi treq
set fddi userdata

set fddi treq

Use the set fddi treq command to change the TRequest value for a FDDI MAC.

set fddi treq mod_num time

Syntax Description

mod_num	The number of the module.
time	The number of seconds for the TRequest value. Valid times are from 2502 to 165,000 microseconds.

Default

The default value for the TRequest is 165,000 microseconds.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The TRequest parameter specifies the FDDI station's desired value for the Token Ring Timer (TRT) for negotiating the TRT with other stations. The TRT is used to control ring scheduling during normal operation and to detect and recover from serious ring error situations. Whenever the TRT value expires, the station uses the TRequest value to negotiate with other stations for the lowest value. The default setting of 165,000 microseconds is sufficient for most networks.

Example

The following example shows how to change the TRequest value to 3500 microseconds for
module 4:

Console> (enable) set fddi treq 4 3500
Mac 4/1 T-request set to 3500 usec.
Console> (enable)

Related Commands

set fddi alarm
set fddi cutoff
set fddi help
set fddi tlmin
set fddi tnotify
set fddi userdata

set fddi userdata

Use the set fddi userdata command to configure the user-data string in the SMT MIB of an FDDI module.

set fddi userdata mod_num userdata_string

Syntax Description

mod_num	The number of the module.
userdata_string	A character string that identifies the node in a meaningful way.

Default

The default value for the FDDI user data string is "Catalyst 5000."

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The user data string is useful for identifying the FDDI module or Catalyst 5000 series switch when using a management tool to configure and maintain an internetwork or when accessing the FDDI module remotely. The user data string might be a term identifying the function of the network node or the users connected to the network node.

Example

The following example shows how to change the user data string to "Engineering" for module 4:

Console> (enable) set fddi userdata 4 Engineering
Module 4 userdata set to Engineering.
Console> (enable)

Related Commands

set fddi alarm
set fddi cutoff
set fddi help
set fddi tlmin
set fddi tnotify
set fddi treq

set help

Use the set help command to list the set commands with brief descriptions of their functions.

set help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal and privileged.

Usage Guidelines

In normal mode, the set help command lists the set commands available in normal mode. In privileged mode, the set help command lists the set commands available in privileged mode.

Examples

The following example shows how to list the set commands available in normal mode:

Console> set help
Commands:
------------------------------------------------------------------------------
set help            Show this message
set length          Set number of lines in display (0 to disable 'more')
Console>

The following example shows how to list the set commands available in privileged mode:

Console> (enable) set help
Set commands:
------------------------------------------------------------------------
set alias           Set alias for command
set arp             Set ARP table entry
set bridge          Set bridge, use 'set bridge' for more info
set cam             Set CAM table entry
set cdp             Set cdp, use 'set cdp help' for more info
set enablepass      Set privilege mode password
set fddi            Set FDDI, use 'set fddi' for more info
set help            Show this message
set interface       Set network interface configuration
set ip              Set IP, use 'set ip help' for more info
set length          Set number of lines in display (0 to disable 'more')
set logout          Set number of minutes before automatic logout
set module          Set module, use 'set module help' for more info
set password        Set console password
set port            Set port, use 'set port help' for more info
set prompt          Set prompt
set snmp            Set SNMP, use 'set snmp help' for more info
set span            Set switch port analyzer
set spantree        Set spantree, use 'set spantree help' for more info
set system          Set system, use 'set system help' for more info
set time            Set time
set trunk           Set trunk ports
set vlan            Set Virtual LAN information
set vtp             Set Virtual Trunk Information
Console> (enable)

Related Commands

disable-Switch Command
enable-Switch Command

set interface

Use the set interface command to configure network interfaces.

set interface sc0/sl0 {up | down}
set interface sc0 [vlan vlan_num] [ip_address [netmask [broadcast]]]
set interface sl0 slip_address dest_address

Syntax Description

sc0	In-band interface.
sl0	SLIP interface.
up	Keyword used to bring the interface into operation.
down	Keyword used to bring the interface out of operation.
vlan	Keyword used with the vlan_num value.
vlan_num	The number of the VLAN on which to store the IP address.
ip_address	IP address.
netmask	(Optional) The subnet mask.
broadcast	(Optional) The broadcast mask.
slip_address	IP address of the console port.
dest_address	IP address of the host to which the console port will be connected.

Default

The default configuration is sc0 and sl0 with IP address, netmask, and broadcast set as 0.0.0.0. The destination address for sl0 is also 0.0.0.0.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The set interface command can be used to assign network addresses administratively, subnet masks for the Catalyst 5000 interfaces, and destination addresses for SLIP interfaces. It can also be used administratively to bring the interfaces up or down. There are two configurable network interfaces to a Catalyst 5000 series switch: in-band (sc0) and SLIP (sl0). Once you assign an IP address to sc0, the Catalyst 5000 becomes accessible through Ethernet and FDDI interfaces.

Examples

The following example shows how to set interface sc0 and interface sl0 from the console port. It also shows how to administratively bring down interface sc0 using a console terminal:

Console> (enable) set interface sc0 192.200.11.44 255.255.255.0
Interface sc0 IP address and netmask set.
Console> (enable) set interface sl0 192.200.10.45 192.200.10.103
Interface sl0 SLIP and destination address set.
Console> (enable) set interface sc0 down.
Interface sc0 administratively down.
Console> (enable)

The following example shows how to set the IP address for sc0 through a Telnet session:

Console> (enable) set interface sc0 192.200.11.40
This command may disconnect active telnet sessions.
Do you want to continue (y/n) [n]? y
Interface sc0 IP address set.
<lost connection, hangs until timeout or until sc0 is back to its original IP address again>

The following example shows how to take the interface out of operation through a Telnet session:

Console> (enable) set interface sc0 down
This command will inactivate telnet sessions.
Do you want to continue (y/n) [n]? y
Interface sc0 administratively down.

The following example shows how to identify the VLAN on which to store the IP address:

Console> (enable) set interface sc0 5
Interface sc0 vlan set.
Console> (enable)
Console> (enable) set interface sc0 200
Vlan is not active, user needs to set vlan 200 active
Interface sc0 vlan set.
Console> (enable)

The interface hangs until timeout or until sc0 is up again.

Related Command

show interface

set ip alias

Use the set ip alias command to add aliases of IP addresses.

set ip alias name ip_addr

Syntax Description

name	The name of the alias being defined.
ip_addr	The IP address of the alias being defined.

Default

The default configuration has one IP alias (0.0.0.0) configured as the default.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to define an IP alias of mercury for IP address 192.122.174.234:

Console> (enable) set ip alias mercury 192.122.174.234
IP alias added.
Console> (enable)

Related Commands

clear ip alias
show ip alias

set ip dns

Use the set ip dns command to enable or disable Domain Name System (DNS).

set ip dns {enable | disable}

Syntax Description

enable	Enable DNS.
disable	Disable DNS.

Default

By default, DNS is disabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following examples show how to enable and disable DNS:

Console> (enable) set ip dns enable 
DNS enabled.
Console> (enable)
Console> (enable) set ip dns disable
DNS disabled.
Console> (enable)

Related Command

show ip dns

set ip dns domain

Use the set ip dns domain command to set the default Domain Name System (DNS) domain name.

set ip dns domain name

Syntax Description

name

The default DNS domain name.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

If you specify a specific domain name on the command line, the program will attempt to resolve the host name as entered. If the program cannot resolve the host name as entered, it appends the default DNS domain name as defined with the set ip dns domain command. If you specify a domain name with a trailing dot, the program considers this name an absolute domain name.

Example

The following example shows how to set the default DNS domain name:

Console> (enable) set ip dns domain hp.com
Default DNS domain name set to hp.com.
Console> (enable)

Related Commands

clear ip dns domain
show ip dns

set ip dns server

Use the set ip dns server command to set the IP address of a Domain Name System (DNS) server.

set ip dns server ip_addr [primary]

Syntax Description

ip_addr	The IP address of the DNS server.
primary	(Optional) Keyword used to configure a DNS server as the primary server.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can configure up to three DNS name servers for backup. You can also configure any DNS server as the primary server. The primary server is the first one to be queried. If the primary server fails, the backup servers are queried.

If DNS is disabled, you must use the IP address with all commands that require explicit IP addresses or define an alias for that address. The alias has priority over DNS.

Examples

The following examples show how to set the IP address of a DNS server:

Console> (enable) set ip dns server 198.92.30.32 
DNS name server set to 198.92.30.32 as primary.
Console> (enable) set ip dns server 171.69.2.132 primary 
DNS name server set to 198.92.30.35 as primary.
Console> (enable) set ip dns server 161.44.128.70
Table is full. DNS name server 161.44.128.70 not added.

Related Commands

clear ip dns server
show ip dns

set ip fragmentation

Use the set ip fragmentation command to enable or disable the fragmentation for IP packets bridged between FDDI and Ethernet networks. Note that FDDI and Ethernet networks have different maximum transmission units (MTUs).

set ip fragmentation {enable | disable}

Syntax Description

enable	Keyword that allows fragmentation for IP packets bridged between FDDI and Ethernet networks, which have different MTUs.
disable	Keyword that disallows fragmentation for IP packets bridged between networks with different MTUs. Packets are dropped.

Default

The default value is IP fragmentation enabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to disable IP fragmentation:

Console> (enable) set ip fragmentation disable
IP fragmentation disabled for module 4
Console> (enable)

Related Commands

show ip route
show bridge

set ip help

Use the set ip help command to list the set ip commands.

set ip help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list the set ip commands:

Console> (enable) set ip help
Set ip commands:
----------------------------------------------------------------------
set ip alias               Set alias for IP Address
set ip dns                 Set DNS enable/disable
set ip fragmentation       Set IP fragmentation enable/disable
set ip help                Show this message
set ip redirect            Set ICMP redirect enable/disable
set ip route               Set IP routing table entry
set ip unreachable         Set ICMP unreachable messages
Console> (enable)

Related Commands

set ip alias
set ip redirect
set ip route

set ip permit

Use the set ip permit command to enable or disable the IP permit list. You can configure up to 10 entries in the permit list. If the IP permit list is enabled, but the permit list has no entries configured, you see a caution displayed on the screen. Use the set ip permit ip_address command to specify the IP address to be added to the permit list.

set ip permit {enable | disable}
set ip permit ip_address

Syntax Description

enable	Keyword used to enable the IP permit list.
disable	Keyword used to disable the IP permit list.
ip_address	The specified IP address to be added to the IP permit list.

Default

By default, the set ip permit command is disabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows a sample session using IP permit list commands.

Console> (enable) set ip permit help

Usage: set ip permit <enable|disable>

set ip permit <addr> [mask]

(mask is in dotted decimal format e.g. 255.255.0.0)

Console> (enable) set ip permit enable

IP permit list enabled.

WARNING!! IP permit list has no entries.

Console> (enable) set ip permit 172.100.101.102

172.100.101.102 added to IP permit list.

Console> (enable) set ip permit batboy

batboy added to IP permit list.

Console> (enable) set ip permit 172.160.161.0 255.255.192.0

172.160.128.0 with mask 255.255.192.0 added to IP permit list.

Console> (enable) set ip permit enable

IP permit list enabled.

Console> (enable) set ip permit disable

IP permit list disabled.

Related Commands

clear ip permit
set ip permit
show ip permit
show snmp
set snmp trap

set ip redirect

Use the set ip redirect command to enable or disable ICMP redirect messages for the Catalyst 5000 series switch.

set ip redirect {enable | disable}

Syntax Description

enable	Keyword that activates ICMP redirect messages to sender.
disable	Keyword that deactivates ICMP redirect messages to sender.

Default

The default configuration has ICMP redirect enabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to deactivate the redirection of ICMP messages:

Console> (enable) set ip redirect disable
ICMP redirect messages disabled.
Console> (enable)

Related Commands

show ip route
show netstat

set ip route

The set ip route command adds IP addresses or aliases to the IP routing table.

set ip route destination gateway [metric]

Syntax Description

destination	The IP address or IP alias of the network or specific host.
gateway	The IP address or IP alias of the router.
metric	(Optional) Value used to indicate whether the destination network is local or remote. Use 0 for local and 1 for remote.

Default

The default configuration routes the local network through the sc0 interface with metric 0 as soon as sc0 is configured.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the default route to 192.122.173.42:

Console> (enable) set ip route default 192.122.173.42
Route added.
Console> (enable)

Related Commands

clear ip route
show snmp
show ip route

set ip unreachable

Use the set ip unreachable command to enable or disable Internet Control Message Protocol (ICMP) unreachable messages for the switch.

set ip unreachable {enable | disable}

Syntax Description

enable	Keyword that allows IP unreachable messages to be returned to the Internet source host.
disable	Keyword that disallows IP unreachable messages to be returned to the Internet source host.

Default

The default is ICMP unreachable messages enabled.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

When enabled, the switch returns an ICMP unreachable message to the Internet source host whenever it receives an IP datagram that it cannot deliver. When disabled, the switch does not notify the Internet source host when it receives an IP datagram that it cannot deliver.

For example, a switch has the ICMP unreachable message function enabled and IP fragmentation disabled. If a FDDI packet is received and needs to be transmitted to an Ethernet port, the switch will not be able to fragment the packet; the switch will drop the packet and return an IP unreachable message to the Internet source host.

Example

The following example shows how to disable ICMP unreachable messages:

Console> (enable) set ip unreachable disable
ICMP unreachable message disabled for module 4
Console> (enable)

Related Command

show ip route

set length

Use the set length command to configure the number of lines in the terminal display screen.

set length number (in normal mode)
set length number [default] (in privileged mode only)

Syntax Description

number	Number of lines to display on the screen (0 to 512).
default	Keyword that sets the number of lines in the terminal display screen for the current administration session and all other sessions.

Default

The default value is 24 lines upon starting a session. When the value is changed in a session, it applies only to that administration session. When you use the clear config command, the number of lines in the terminal display screen is reset to the factory default of 100.

Command Type

Switch command.

Command Mode

Normal and privileged.

Usage Guidelines

Output from a single command that overflows a single display screen is followed by the "--More--" prompt. At the "--More--" prompt, you can press Ctrl-C, q, or Q to quit, press the Spacebar to display an additional screen of output, or press Return to display one more line of output. Setting the screen length to 0 turns off the scrolling feature and causes the entire output to be displayed at once. Unless a default value is specified, a value that is changed in an administration session only applies to the current session.

Examples

The following example shows how to use normal mode to set the screen length to 24 lines:

Console> set length
Usage: set length <screenlength>
       (screenlength = 5..512, 0 to disable 'more' feature)
Console> set length 24
Screen length for this session set to 24.
Console>

The following example shows how to use privileged mode to set the screen length to 24 lines for the current administration session and all other sessions:

Console> (enable) set length
Usage: set length <screenlength> [default]
       (screenlength = 5..512, 0 to disable 'more' feature)
Console> (enable) set length 24 default
Screen length default for new sessions set to 24.
Console> (enable)

Related Command

clear config

set logging console

Use the set logging console command to enable and disable system message logging to the console.

set logging {enable | disable}

Syntax Description

enable	Keyword used to enable system message logging to the console.
disable	Keyword used to disable system message logging to the console.

Default

By default, system message logging to the console is enabled.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following examples show how to enable and disable the system message log feature to the console:

Console <enable> set logging console enable
System logging messages will be sent to the console.
Console <enable> set logging console disable
System logging messages will not be sent to the console.

Related Commands

show logging
show logging buffer

set logging level

Use the set logging level command to set the facility and severity level used when logging system messages.

set logging level facility severity default

Syntax Description

facility	Value that specifies the type of system messages to be captured. (See Table 3-5.)
severity	Value that specifies the severity level of system messages to be captured. (See Table 3-6.)

Table 3-5: Facility Definitions

Facility Name	Definition
cdp	Cisco Delivery Protocol
cgmp	Cisco Group Management Protocol
disl	Dynamic Inter-Switch Link
dvlan	Dynamic Virtual Local Area Network
earl	Encoded Address Recognition Logic
fddi	Fiber Distributed Data Interface
ip	Internet Protocol
snmp	Simple Network Management Protocol
spantree	Spanning-Tree Protocol
sys	System
tac	Terminal Access Controller
tcp	Transmission Control Protocol
telnet	Terminal emulation protocol
tftp	Trusted File Transfer Protocol
vmps	VLAN Membership Policy Server
vtp	Virtual Terminal Protocol

Table 3-6: Severity Level Definitions

Severity Level	Keyword	Description
0	emergencies	System unusable
1	alerts	Immediate action required
2	critical	Critical condition
3	errors	Error conditions
4	warnings	Warning conditions
5	notifications	Normal bug significant condition
6	informational	Informational messages
7	debugging	Debugging messages

Default

By default, facility is set to all and level is set to 0.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the facility and severity level for system message logging:

Console <enable> set logging level snmp 2 default
System logging facility <snmp> set to severity 2(critical).

Related Commands

show logging
show logging buffer

set logging server

Use the first form of the set logging server command to enable and disable system message logging to configured syslog servers. Use the second form of the command to add a syslog server to the configuration.

set logging server {enable | disable} set logging server ip_addr

Syntax Description

enable	Keyword used to enable system message logging to configured syslog servers.
disable	Keyword used to disable system message logging to configured syslog servers.
ip_addr	IP address of the syslog server to be added to the configuration.

Default

By default, no syslog servers are configured to receive system messages.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following examples show how to enable the system message log feature to the console and add a syslog server to the configuration:

Console <enable> set logging server enable
System logging messages will be sent to the configured syslog servers.
Console <enable> set logging server 171.69.192.205
171.69.192.205 added to the System logging server table.

Related Command

show logging

set logout

Use the set logout command to set the number of minutes until the system automatically disconnects an idle session.

set logout timeout

Syntax Description

timeout

The number of minutes until the system automatically disconnects an idle session.

Default

The default value is 20 minutes.

Command Type

Switch command.

Usage Guidelines

You can specify a timeout period from 0 to 10,000 minutes. Setting the value to 0 disables the automatic disconnection of idle sessions.

Command Mode

Privileged.

Example

The following example shows how to set the number of minutes until the system automatically disconnects an idle session:

Console> (enable) set logout
Usage: set logout <timeout>
       timeout = 0..10000 minutes; 0 disables automatic logout
Console> (enable) set logout 20 
Sessions will be automatically logged out after 20 minutes of idle time.
Console> (enable) set logout 0
Sessions will not be automatically logged out.
Console> (enable)

set module disable

Use the set module disable command to disable a module.

set module disable mod_num

Syntax Description

mod_num

The number of the module. You can specify a series of modules by entering a comma between each module number (for example 2,3,5). You can specify a range of modules by entering a dash between module numbers (for example, 2-5).

Default

The default configuration has all modules enabled.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

Avoid disabling a module through a Telnet session because your Telnet session might be established on the module being disabled and the Telnet session will hang. The supervisor module cannot be disabled.

Examples

The following example shows how to disable module 3 through the console port:

Console> (enable) set module disable 3
Module 3 disabled.
Console> (enable)

The following example shows how to disable module 2 through a Telnet session:

Console> (enable) set module disable 2
This command may disconnect your telnet session.
Do you want to continue (y/n) [n]? y
Module 2 disabled.

Related Commands

set module enable
show module

set module enable

Use the set module enable command to enable a module.

set module enable module_num

Syntax Description

module_num

The number of the module.

Default

The default setting has all modules enabled.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

If an individual port on a module was previously disabled, enabling the module does not enable the disabled port.

Example

The following example shows how to enable module 2:

Console> (enable) set module enable 2
Module 2 enabled.
Console> (enable)

Related Commands

set module disable
show module

set module help

Use the set module help command to list the set module commands.

set module help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list the set module commands:

Console> (enable) set module help
Commands:
------------------------------------------------------------------------------
set module disable  Disable a module
set module enable   Enable a module
set module help     Show this message
set module name     Set module name
Console> (enable)

Related Commands

set module disable
set module enable
set module name

set module name

Use the set module name command to set the name for a module.

set module name module_num [module_name]

Syntax Description

module _num	The number of the module.
module_name	(Optional) The name being created for the module.

Default

The default configuration has no module names configured for any modules.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

If the module name is not specified, it is cleared.

Example

The following example shows how to set the name for module 1 to Supervisor:

Console> (enable) set module name 1 Supervisor
Module name set.
Console> (enable)

Related Command

show module

set multicast router

Use the set multicast router command to assign CGMP-capable routers to specific ports on the Catalyst 5000 series switch.

set multicast router mod_num/port_num

Syntax Description

mod _num	The number of the module.
port_num	The number of the port on the module.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to configure multicast router ports:

Console> (enable) set multicast router 3/1
Port 3/1 added to multicast router port list.
Console> (enable)

Related Commands

set cgmp
show multicast group
show multicast router

set ntp broadcastclient

Use the set ntp broadcastclient command to enable or disable Network Time Protocol (NTP) in broadcast client mode.

set ntp broadcastclient {enable | disable}

Syntax Description

enable	Keyword used to enable NTP in broadcast client mode.
disable	Keyword used to disable NTP in broadcast client mode.

Default

Disabled

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The broadcast client mode assumes that a broadcast server, such as a router, is regularly sending time-of-day information to the Catalyst 5000 series switch.

Example

The following examples show how to enable and disable an NTP broadcast client:

Console> (enable) set ntp broadcastclient enable
NTP Broadcast Client mode enabled.

Console> (enable) set ntp broadcastclient disable
NTP Broadcast Client mode disabled.

Related Command

show ntp

set ntp broadcastdelay

Use the set ntp broadcastdelay command to configure a time-adjustment factor for the receiving of broadcast packets by the Catalyst 5000 series switch.

set ntp broadcastdelay microseconds

Syntax Description

microseconds

The estimated round-trip time, in microseconds, for NTP broadcasts. The allowable range is from 1 to 999,999.

Default

By default, NTP broadcast delay is set to 3000.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the NTP broadcast delay to 4000 microseconds:

Console> (enable) set ntp broadcastdelay 4000
NTP broadcast delay set to 4000 microseconds.
Console> (enable)

Related Command

show ntp

set ntp client

Use the set ntp client command to enable or disable the Catalyst 5000 series switch as an NTP client.

set ntp client {enable | disable}

Syntax Description

enable	Keyword used to enable the Catalyst 5000 series switch to act as an NTP client.
disable	Keyword used to disable the Catalyst 5000 series switch from acting as an NTP client.

Default

Disabled

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can configure NTP in either broadcast client mode or client mode. The broadcast client mode assumes that a broadcast server, such as a router, is regularly sending time-of-day information to the Catalyst 5000 series switch. The client mode assumes that the client, or Catalyst 5000 series switch, is regularly indicating time-of-day requests to the NTP server.

Example

The following example shows how to enable NTP client mode:

Console> (enable) set ntp client enable
NTP client mode enabled.
Console> (enable)

Related Command

show ntp

set ntp server

Use the set ntp server command to configure the IP address of the NTP server.

set ntp server ip_addr

Syntax Description

ip_addr

The IP address of the NTP server providing the clock synchronization.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The client mode assumes that the client, or Catalyst 5000 series switch, is regularly initiating time-of-day requests to the NTP server. A maximum of ten servers per client is allowed.

Example

The following example shows how to configure the NTP server at IP address 172.20.22.191:

Console> (enable) set ntp server 172.20.22.191
NTP server 172.20.22.191 added.
Console> (enable)

Related Commands

clear ntp server
show ntp

set password

Use the set password command to change the initial level password on the command line interface.

set password

Syntax Description

This command has no arguments or keywords.

Default

The default configuration has no password configured.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The command prompts you for the old password. If this old password is valid, the command then prompts you twice to enter a new password. A zero length password is allowed.

Example

The following example shows how to set an initial password:

Console> (enable) set password
Enter old password:
Enter new password:
Retype new password:
Password changed.
Console> (enable)

Related Command

set cdp interval

set port broadcast

Use the set port broadcast command to set the broadcast/multicast suppression for one or more ports.

set port broadcast mod_num/port_num threshold [%]

Syntax Description

mod _num	The number of the module.
port_num	The number of the port.
threshold	The number of packets-per-second of broadcast/multicast traffic allowed on the port, or the percentage of total available bandwidth that can be used by broadcast/multicast traffic.
%	Symbol used if the threshold is expressed as a percentage of total available bandwidth that can be used by broadcast/multicast traffic.

Note The following Catalyst 5000 series switching module supports hardware broadcast/multicast suppression: Group Switching Fast Ethernet Module (100BaseTX 24 Port)--WS-X5223. Software broadcast/multicast suppression is supported in all Ethernet line cards that support hardware broadcast/multicast suppression. For more information on the broadcast/multicast suppression feature, see the Catalyst 5000 Series Advanced Software Configuration Guide.

Default

The default system configuration has broadcast/multicast suppression disabled.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following example shows how to limit broadcast traffic to 500 packets per second on ports 2/1-3/24:

Console> (enable) set port broadcast 2/1-3/24 500
Ports 2/1-3/24 broadcast traffic limited to 500 packets.

The following example shows how to limit broadcast traffic to 20 percent to all ports on module 4:

Console> (enable) set port broadcast 4/3 20%
Port 4/1-24 broadcast traffic limited to 20%.

Note

set port broadcast

mod_num

port_num threshold

4/3

The following example shows how to allow unlimited broadcast traffic to all ports on module 4:

Console> (enable) set port broadcast 4/3 100%
Port 4/1-24 broadcast traffic unlimited.

Related Commands

clear port broadcast
show port

set port disable

Use the set port disable command to disable a port.

set port disable mod_num/port_num

Syntax Description

mod _num	The number of the module.
port_num	The number of the port.

Default

The default system configuration has all ports enabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to take port 10 on module 5 out of service:

Console> (enable) set port disable 5/10
Port 5/10 disabled.
Console> (enable)

Related Commands

set port enable
show port

set port duplex

Use the set port duplex command to configure the transmission type of an Ethernet or Fast Ethernet interface.

set port duplex mod num/port num {full | half | auto}

Syntax Description

mod num	The number of the module.
port num	The number of the port.
full	Full-duplex.
half	Half-duplex.
auto	The port is in autosensing mode and has not yet determined the port duplex

Default

The default configuration for 10-Mbps and 100-Mbps modules has all Ethernet ports set to half duplex. The default configuration for 10/100-Mbps Fast Ethernet modules has all ports set to auto.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

Ethernet and Fast Ethernet interfaces can be configured to either full duplex or half duplex. When a port is in autosensing mode, enabled by the set port speed command, both its speed and duplex are determined by autosensing. The following type of error messages is therefore generated if you attempt to set the transmission type of autosensing Fast Ethernet ports to half- or full-duplex mode:

cat4-lnf> (enable) set port duplex 2/1 full (1 port - failed)
Port 2/1 is in auto-sensing mode.

The set port duplex command is not valid on the 48-port module.

Example

The following example shows how to set port 1 on module 2 to full duplex:

Console> (enable) set port duplex 2/1 full
Port 2/1 set to full-duplex.
Console> (enable)

Related Command

show port

set port enable

Use the set port enable command to enable or disable a port.

set port enable mod_num/port_num

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.

Default

All ports enabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to enable port 3 on module 2:

Console> (enable) set port enable 2/3
Port 2/3 enabled.
Console> (enable)

Related Commands

set port disable
show port

set port help

Use the set port help command to list the set port commands.

set port help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list the set port commands:

Console> (enable) set port help
Set port commands:
----------------------------------------------------------------------
set port broadcast       Set 
set port disable         Disable a port
set port duplex          Set port transmission type (full/half duplex)
set port enable          Enable a port
set port help            Show this message
set port level           Set port priority level (normal/high)
set port name            Set port name
set port security
set port speed           Set port transmission speed (10/100 Mbps)
set port trap            Set port up/down trap (enable/disable)
Console> (enable)

Related Commands

set port disable
set port duplex
set port level
set port enable
set port name
set port speed
set port trap
show port

set port level

Use the set port level command to set the priority level of the port on the switching bus.

set port level mod_num/port_num {normal | high}

Syntax Description

mod_num	The number of the module.
port_num	The number of the port on the module.
normal	Keyword used to indicate that packets traveling through ports set at normal priority are served after packets traveling through ports set at high priority.
high	Keyword used to indicate that packets traveling through the specified port are served first.

Default

The default configuration has all ports at normal priority level.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the priority level for port 2 on module 1 to high:

Console> (enable) set port level 1/2 high
Port 1/2 port level set to high.
Console> (enable)

Related Commands

set port disable
set port duplex
set port enable
set port help
set port name
set port speed
set port trap
show port

set port membership

Use the set port membership command to configure a port as dynamically or statically assigned to a VLAN membership.

set port membership mod_num/port_num.. {dynamic | static}

Syntax Description

mod_num	The module number.
port_num	The port number.
dynamic	Keyword used to dynamically assign VLAN membership to a port.
static	Keyword used to statically assign VLAN membership to a port.

Default

Default port membership is static.

Command Type

Switch command.

Command Mode

Privileged.

Example

console (enable) > set port membership 3/1-3 dynamic
Ports 3/1-3 vlan assignment set to dynamic.
Spantree port fast start option enabled for ports 3/1-3.
console (enable) > set port membership 1/2 dynamic
Trunking port 1/2 vlan assignment cannot be set to dynamic.
console (enable) > set port membership 2/1 dynamic
ATM LANE port 2/1 vlan assignment can not be set to dynamic.
console (enable) > set port membership 3/4 dynamic
Static Secure Port 3/4 vlan assignment can not be set to dynamic.
console (enable) > set port membership 4/2 dynamic
Ports 4/1-12 vlan assignment set to dynamic.
console (enable) > set port membership 5/1 dynamic
FDDI port 5/1 vlan assignment can not be set to dynamic.

The VLAN assigned to the port will be qualified as dynamic and, if the dynamic port is shut down by VMPS, its status will be shown as shutdown.

console> show port
Port Name	Status	Vlan	Level	Duplex	Speed	Type 
------------------------------	--------------	------------	-----------	--------------
1/1	connect 	dyn-3	normal	full 	100 	100 BASE-TX
1/2	connect	trunk	normal	half    	100 	100 BASE-TX
2/1	connect	trunk	normal	full	155	OC3 MMF ATM
3/1	connect 	dyn-5	normal	half    	10 	10 BASE-T
3/2	connect 	dyn-5	normal	half    	10	10 BASE-T
3/3	connect	dyn-5	normal	half    	10	10 BASE-T
3/4	connect	1 	normal	half    	10	10 BASE-T
3/5	shutdown	1 	normal	half    	10 	10 BASE-T
3/6	shutdown	5 	normal	half    	10 	10 BASE-T
3/7	shutdown	1 	normal	half    	10 	10 BASE-T
3/8 	shutdown	1 	normal	half    	10 	10 BASE-T
3/9	shutdown	1 	normal	half    	10 	10 BASE-T
3/10	shutdown	1 	normal	half    	10 	10 BASE-T
3/11	shutdown	dyn-6 	normal	half    	10 	10 BASE-T
3/12	shutdown	1 	normal	half    	10 	10 BASE-T
3/13	connect 	3 	normal	half    	10 	10 BASE-T
3/14	connect 	3 	normal 	half    	10 	10 BASE-T
3/15	not-connected	dyn- 	normal	half    	10 	10 BASE-T
. . .
. . .
4/1	connected	dyn-5	normal	half    	10 	10 BASE-T
4/2	connected	dyn-5	normal	half    	10 	10 BASE-T
. . .
. . .
. . .
4/12	not-connected	dyn-5	normal	half    	10 	10 BASE-T
4/13	not-connected	4	normal	half    	10 	10 BASE-T
4/14	connected	4	normal	half    	10 	10 BASE-T
. . .
. . .
. . .
. . .
4/48	connected	8	normal	half    	10 	10 BASE-T
5/1-2	connected	trunk(5)	normal	full 	100	FDDI

Related Commands

set port help
show port

set port name

Use the set port name command to configure a name for a port.

set port name mod_num/port_num [name_string]

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
name_string	(Optional) A description of the port.

Default

The default configuration has no port name configured for any port.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

If the name string is not specified, the port name is cleared.

Example

The following example shows how to set port 1 on module 4 to Fred Grover:

Console> (enable) set port name 4/1 Fred Grover
Port 4/1 name set.
Console> (enable)

Related Commands

set port disable
set port duplex
set port enable
set port help
set port level
set port speed
set port trap
show port

set port security

Use the set port security command to configure the security feature of a port or range of ports on the Ethernet module.

set port security mod_num/port_num [enable | disable] mac_addr

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
enable \| disable	Keyword used to enable or disable port security.
mac_addr	The secure MAC address of the enabled port.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

If the MAC address is not given, the command turns on learning mode so that the first MAC address seen on the port becomes the secure MAC address.

Examples

The following example shows how to set port security on port 3/1 with a learned MAC address:

Console> (enable) set port security 3/1 enable
Port 3/1 port security enabled with the learned mac address.

The following example shows how to set port security on port 3/1 with a specific MAC address:

Console> (enable) set port security 3/1 enable 01-02-03-04-05-06
Port 3/1 port security enabled with 01-02-03-04-05-06 as the secure mac address.

Related Commands

set port help
show port

set port speed

Use the set port speed command to configure the speed of a Fast Ethernet interface.

set port speed mod num/port num {10 | 100 | auto}

Syntax Description

mod num	The number of the module.
port num	The number of the port.
10	Keyword used to set the port speed to 10 Mbps.
100	Keyword used to set the port speed to 100 Mbps.
auto	Keyword used to set the port speed to autosensing mode.

Default

The default configuration has all 10/100-Mbps Fast Ethernet Switching Module ports set to auto.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

Fast Ethernet interfaces on the 10/100-Mbps Fast Ethernet Switching module can be configured to either 10 Mbps or 100 Mbps. They can also be set to autosensing mode, allowing them to sense and distinguish between 10-Mbps and 100-Mbps port transmission speeds and full-duplex or half-duplex port transmission types at a remote port connection. Set at autosensing mode, the interfaces automatically configure themselves to operate at the proper speed and transmission type.

Example

The following example show how to set port 1 on module 2 to autosensing mode, configured to either 10 Mbps or 100 Mbps:

Console> (enable) set port speed
Usage: set port speed <mod_num/port_num> <10|100|auto>
Console> (enable) set port speed 2/1 auto
Port 2/1 speed set to auto-sensing mode.
Console> (enable) set port speed 2/2 10
Port 2/2 speed set to 10 Mbps.
Console> (enable) set port speed 2/3 100
Port 2/3 speed set to 100 Mbps.

Related Commands

set port disable
set port duplex
set port enable
set port help
set port level
set port name
set port trap
show port

set port trap

Use the set port trap command to enable or disable the standard SNMP link trap operation (up or down) for a port.

set port trap mod_num/port_num {enable | disable}

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
enable	Keyword used to activate the SNMP link trap.
disable	Keyword used to deactivate the SNMP link trap.

Default

The default configuration has all port traps disabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to enable the SNMP link trap for module 1, port 2.

Console> (enable) set port trap
Usage: set port trap <mod_num/port_num> <enable|disable>
Console> (enable) set port trap 1/2 enable
Port 1/2 up/down trap enabled.
Console> (enable)

Related Commands

set port disable
set port duplex
set port enable
set port help
set port level
set port name
set port speed
show port

set prompt

Use the set prompt command to change the prompt for the command line interface.

set prompt prompt_string

Syntax Description

prompt_string The text that is to appear in place of the default prompt Console>.

Default

The default configuration has the prompt Console>.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the prompt to "system100>":

Console> (enable) set prompt system100>
system100> (enable)

set snmp community

Use the set snmp community command to set one of the three SNMP community strings.

set snmp community access_type [community_string]

Syntax Description

access_type	Option used to identify the type of access available to the SNMP community. Specify read-only, `read-write`, or `read-write all.`
community_string	(Optional) Option used to identify the name of the SNMP community.

Default

The following communities with preestablished access types have been set as defaults:

public--read-only
private--read-write
secret--read-write-all

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the SNMP community called hocuspocus to read-write access type:

Console> (enable) set snmp community read-write hocuspocus
SNMP read-write community string set.
Console> (enable) set snmp community read-only
SNMP read-only community string cleared.
Console> (enable)

Related Command

show snmp

set snmp help

Use the set snmp help command to list the set snmp commands.

set snmp help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list the set snmp commands:

Console> (enable) set snmp help
Set snmp commands:
----------------------------------------------------------------------
set snmp community       Set SNMP community string
set snmp help            Show this message
set snmp rmon            Set SNMP RMON
set snmp trap            Set SNMP trap information
Console> (enable)

Related Commands

set snmp community
set snmp rmon
set snmp trap
show snmp

set snmp rmon

Use the set snmp rmon command to enable or disable SNMP remote monitoring (RMON) support.

set snmp rmon {enable | disable}

Syntax Description

enable	Keyword used to activate SNMP remote monitoring support.
disable	Keyword used to deactivate SNMP remote monitoring support.

Default

The default for remote monitoring support is enabled.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The following configurations and implementations are supported:

Remote monitoring statistics are collected on a segment basis instead of a repeater port basis for the Catalyst 5000 Series Group Switching Ethernet Module (10BaseT 48-port).
The remote monitoring feature deinstalls all of the domains for all of the interfaces on an Ethernet module that has been removed from the system.
RMON is only enabled for Ethernet ports.
Supported RMON groups enabled are Ethernets, history, alarm, and events as specified in
RFC 1757.
Use of this command requires a separate software license.

Example

The following example shows how to enable and disable remote monitoring support:

Console> (enable) set snmp rmon
Usage: set snmp rmon <enable|disable>
Console> (enable) set snmp rmon enable
SNMP RMON support enabled.
Console> (enable) set snmp rmon disable
SNMP RMON support disabled.

Related Command

show snmp

set snmp trap

Use the set snmp trap command to enable, disable, or add an entry into the SNMP authentication trap receiver table or to enable or disable other specific types of traps on the system.

Syntax Description

enable	Keyword used to activate SNMP authentication trap.
disable	Keyword used to deactivate SNMP authentication trap.
all	All types of traps.
module	Keyword used to indicate the moduleUp and moduleDown traps from the CISCO-STACK-MIB.
chassis	Keyword used to indicate the chassisAlarmOn and chassisAlarmOff traps from the CISCO-STACK-MIB.
bridge	Keyword used to indicate the newRoot and topologyChange traps from RFC 1493 (the BRIDGE-MIB).
repeater	Keyword used to indicate the rptrHealth,rptrGroupChange, and rptrResetEvent traps from RFC 1516 (the SNMP-REPEATER-MIB).
auth	Keyword used to indicate the authenticationFailure trap from RFC 1157.
vtp	Option used to indicate the VTP from the CISCO-VTP-MIB.
rcvr_address	The IP address or IP alias of the trap receiver.
rcvr_community	The community string to use when sending authentication traps.

Default

The default configuration has the SNMP authentication trap disabled.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

An IP permit trap is sent when unauthorized access based on the IP permit list is attempted.

Examples

The following example shows how to enable an entry in the SNMP trap receiver table:

Console> (enable) set snmp trap
Usage: set snmp trap <enable|disable> [all|module|chassis|bridge|repeater|auth]
       set snmp trap <rcvr_address> <rcvr_community>
       (rcvr_address is ipalias or IP address, rcvr_community is string)
Console> (enable) set snmp trap enable chassis
SNMP chassis alarm traps enabled.
Console> (enable)

The following example shows how to add an entry in the SNMP trap receiver table:

Console> (enable) set snmp trap 192.122.173.42 public
SNMP trap receiver added.
Console> (enable)

Related Commands

clear snmp trap
show snmp
test snmp trap
set ip permit
clear ip permit
show ip permit

set span

Use the set span command to set up the port analyzer.

set span enable
set span disable
set span src_mod/src_port dest_mod/dest_port [rx | tx | both]
set span src_vlan dest_mod/dest_port [rx | tx | both]

Syntax Description

enable	Port monitoring is enabled.
disable	Port monitoring is disabled.
src_mod	The monitored module (source).
src_port	The monitored port (source).
dest_mod	The monitoring module (destination).
dest_port	The monitoring port (destination).
src_vlan	The monitored VLAN (source).
rx	Information received at the destination is monitored.
tx	Information transmitted from the source is monitored.
both	Information that is both transmitted from the source and received at the destination is monitored.

Default

The default configuration has port monitoring disabled, port 1/1 as the monitoring port (destination), VLAN 1 as the monitored VLAN (source), and both transmit and receive packets monitored. If the parameter rx, tx, or both is not specified, the default is both.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

After the port analyzer is enabled and the defaults set up, subsequent commands replace source ports, VLANs, and destination ports.

Use either a dedicated remote monitor probe or a Sniffer analyzer to monitor ports.

The following SPAN configurations and implementations are supported:

You can configure a trunk port as a source or destination port. If the destination port is a trunk port, all outgoing packets through the SPAN carry an ISL header.
The SPAN feature operates on a port basis on the Catalyst 5000 Fast Ethernet Module
(10/100 TX or 100BaseFX port). Source and destination ports cannot be in the same repeater segment.
When a switch port is configured as a destination SPAN port, it is no longer a normal switch port; only monitored traffic through the SPAN port is displayed.
When SPAN is enabled, if you disable a source or destination port, the SPAN functionality stops operating until both the source and destination ports are again enabled.
You can configure a disabled port to be a source or destination port, but the SPAN function does not take effect until both source and destination ports are enabled.
When SPAN is enabled for monitoring a VLAN, if you move a switched port into or out of the monitored VLAN, the number of monitored ports changes.
FDDI ports can be source ports; however, FDDI packets and ATM cells are not forwarded to the destination ports. FDDI and ATM cells are translated to Ethernet and forwarded to the destination port.
Source and destination ports cannot be the same port.
Source and destination ports must be the same VLAN type.
ATM and FDDI ports cannot be configured as destination ports.
A trunk port cannot be one of the monitored ports if the SPAN is enabled to monitor VLAN traffic.

Example

The following example shows how to enable set span monitoring of ports 2 and 3 and transmitting by ports 2 and 4.

----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
Console> (enable) set span
Usage: set span enable
       set span disable
       set span <src_mod/src_port> <dest_mod/dest_port> [rx|tx|both]
       set span <src_vlan> <dest_mod/dest_port> [rx|tx|both]
Console> (enable) set span 2/3 2/4 tx
Enabled monitoring of ports 2/3 transmit traffic by ports 2/4.
Console> (enable) set span enable
span enabled.
Console> (enable)

Related Commands

clear config
show span

set spantree disable

Use the set spantree disable command to disable the spanning-tree algorithm for a VLAN.

set spantree disable [vlan]

Syntax Description

vlan

(Optional) The number of the VLAN. If the VLAN number is not specified, the default, VLAN 1, is used.

Default

The default configuration has all spanning trees enabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to disable the spanning-tree algorithm for VLAN 1:

Console> (enable) set spantree disable 1
VLAN 1 bridge spanning tree disabled.
Console> (enable)

Related Commands

set spantree enable
show spantree

set spantree enable

Use the set spantree enable command to enable the spanning-tree algorithm for a VLAN.

set spantree enable [vlan]

Syntax Description

vlan

(Optional) The number of the VLAN. If a VLAN number is not specified, the default,VLAN 1, is used.

Default

The default configuration has all spanning trees enabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to activate the spanning-tree algorithm for VLAN 1:

Console> (enable) set spantree enable 1
VLAN 1 bridge spanning tree enabled.
Console> (enable)

Related Commands

show spantree
set spantree disable

set spantree fwddelay

Use the set spantree fwddelay command to set the bridge forward delay for a VLAN.

set spantree fwddelay delay [vlan]

Syntax Description

delay	The number of seconds (4 to 30) for the bridge forward delay.
vlan	(Optional) The number of the VLAN. If a VLAN number is not specified, VLAN 1 is assumed.

Default

The default configuration has fwddelay set to 15 seconds for all VLANs.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the bridge forward delay for VLAN 1000 to 16 seconds:

Console> (enable) set spantree fwddelay 16 1000
VLAN 1000 bridge forward delay set to 16 seconds.
Console> (enable)

Related Command

show spantree

set spantree hello

Use the set spantree hello command to set the bridge hello time for a VLAN.

set spantree hello interval [vlan]

Syntax Description

interval	The number of seconds (1 to 10) the system waits before sending a multicast message indicating that it is present.
vlan	(Optional) The number of the VLAN. If a VLAN number is not specified, VLAN 1 is assumed.

Default

The default configuration has hello time set to 2 seconds for all VLANs.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the spantree hello time to 2 seconds for VLAN 1000:

Console> (enable) set spantree hello 2 1000
VLAN 1000 bridge hello time set to 2.
Console> (enable)

Related Command

show spantree

set spantree help

Use the set spantree help command to list the available set spantree commands.

set spantree help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list the set spantree commands:

Console> (enable) set spantree ?
Set spantree commands:
----------------------------------------------------------------------
set spantree disable   Disable spanning tree
set spantree enable    Enable spanning tree
set spantree fwddelay  Set spantree forward delay
set spantree hello     Set spantree hello interval
set spantree help      Show this message
set spantree maxage    Set spantree max aging time
set spantree portcost  Set spantree port cost
set spantree portfast  Set spantree port fast start
set spantree portpri   Set spantree port priority
set spantree priority  Set spantree priority
set spantree portvlanpri  Set spantree port vlan priority
Console> (enable)

Related Command

show spantree

set spantree maxage

Use the set spantree maxage command to set the bridge maximum aging time for a VLAN.

set spantree maxage agingtime [vlan]

Syntax Description

agingtime	The maximum number of seconds (6 to 40) that the system retains the information received from other bridges through Spanning-Tree Protocol.
vlan	(Optional) The number of the VLAN. If a VLAN number is not specified, VLAN 1 is assumed.

Default

The default configuration is 20 seconds.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the maximum aging time for VLAN 1000 to 20 seconds:

Console> (enable) set spantree maxage 20 1000
VLAN 1000 bridge max aging time set to 20.
Console> (enable)

Related Command

show spantree

set spantree portcost

Use the set spantree portcost command to set the bridge path cost for a port.

set spantree portcost mod_num/port_num cost

Syntax Description

mod_num	The number of the module.
port_num	The number of the port on the module.
cost	A number from 0 to 65535 that indicates the cost of the path. Zero (0) is a low cost, and 65535 is a high cost.

Default

The default configuration is as follows:

100BaseTX Ethernet port cost = 10
10BaseT Ethernet port cost = 100
FDDI port cost = 10
ATM port cost = 6

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the port cost for port 1 on module 4 to 10:

Console> (enable) set spantree portcost 4/1 10
Bridge port 4/1 path cost set to 10.
Console> (enable)

Related Command

show spantree

set spantree portfast

Use the set spantree portfast command to allow a port that is connected to a single workstation or PC to start faster when it is connected.

set spantree portfast mod_num/port_num {enable | disable}

Syntax Description

mod_num	The number of the module.
port_num	The number of the port on the module.
enable	Keyword used to enable the spanning-tree bridge portfast for a port.
disable	Keyword used to disable the spanning-tree bridge portfast for a port.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

When you use the spantree portfast enable command on a port, when the port is connected it immediately enters the spanning-tree forwarding state rather than going through the normal spanning-tree states such as listening and learning. Use this command on ports that are connected to a single workstation or PC only; do not use it on ports that are connected to networking devices such as hubs, routers, switches, bridges, or concentrators.

Example

The following example shows how to set the spanning-tree bridge portfast for port 2 on module 1.

Console> (enable) set spantree portfast
Usage: set spantree portfast <mod_num/port_num> <enable|disable>
Console> (enable) set spantree portfast 1/2 enable
Warning: Spantree port fast start should only be enabled on ports connected to a single host. Connecting hubs, concentrators, switches, bridges, etc. to a fast start port can cause temporary spanning tree loops. Use with caution.
Spantree port 1/2 fast start enabled.
Console> (enable) set spantree portfast 1/2 disable
Spantree port 1/2 fast start disabled.
Console> (enable)

Related Command

show spantree

set spantree portpri

Use the set spantree portpri command to set the bridge priority for a port in spanning-tree algorithm.

set spantree portpri mod_num/port_num priority

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
priority	A number that represents the cost of a link in a spanning-tree bridge. The priority level is from 0 to 63, with 0 indicating high priority and 63 indicating low priority.

Default

The default configuration has all ports with bridge priority set to 32. The port priority applies to all emulated LANs on an ATM port.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the priority of port 1 on module 4 to 63:

Console> (enable) set spantree portpri 4/1 63
Bridge port 4/1 priority set to 63.
Console> (enable)

Related Command

show spantree

set spantree portvlanpri

Use the set spantree portvlanpri command to set the port priority for a subset of VLANs in the trunk port.

set spantree portvlanpri mod_num/port_num priority [vlans]

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
priority	A number that represents the cost of a link in a spanning-tree bridge. The priority level is from 0 to 63, with 0 indicating high priority and 63 indicating low priority.
vlans	The identity of the VLANs to use the priority level set by the set spantree portvlanpri command.

Default

The default configuration has the port VLAN priority set to 0, with no VLANs using this priority level. Subsequent calls to this command add VLANs to a specified port priority level. Additionally, subsequent calls to this command do not replace VLANs that are set at a specified port priority level.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

Set the port priority within the range of 0 to 63.

Example

The following example shows how to set the port priority for module 1, port 2, on VLANs 21 to 40:

Console> (enable) set spantree portvlanpri ?
Usage: set spantree portvlanpri <mod_num/port_num> <priority> [vlans]
      (priority = 0..63)
Console> (enable) set spantree portvlanpri 1/2 16 21-40
Port 1/2 vlans 3,6-20,41-1000 using portpri 32
Port 1/2 vlans 1-2,4-5,21-40 using portpri 16
Console> (enable)

Related Commands

clear spantree portvlanpri
show spantree

set spantree priority

Use the set spantree priority command to set the bridge priority for a VLAN.

set spantree priority bridge_priority [vlan]

Syntax Description

bridge_priority	A number representing the priority of the bridge. The priority level is from 0 to 65535, with 0 being high priority and 65535 being low priority.
vlan	(Optional) The number of the VLAN. If a VLAN number is not specified, VLAN 1 is used.

Default

The default configuration has the bridge priority set to 32768.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the bridge priority of VLAN 1 to 4096:

Console> (enable) set spantree priority 4096
VLAN 1 bridge priority set to 4096.
Console> (enable)

Related Command

show spantree

set summertime

Use the set summertime command to enable or disable setting the clock ahead one hour during Daylight Savings Time.

set summertime {enable | disable} zone

Syntax Description

enable	Keyword used to enable setting the clock ahead one hour during Daylight Savings Time.
disable	Keyword used to disable setting the clock ahead one hour during Daylight Savings Time.
zone	The time zone used by the set summertime command.

Default

By default, the set summertime command is disabled.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

This command uses regulations that advance the clock one hour on the first Sunday in April at 2:00 a.m. and move back the clock one hour on the last Sunday in October at 2:00 a.m.

Examples

The following example shows how to enable setting the clock ahead one hour during Daylight Savings Time:

Console> (enable) set summertime enable PDT
Summertime is enabled and set to "PDT".
Console> (enable)

The following example shows how to disable setting the clock ahead one hour during Daylight Savings Time:

Console> (enable) set summertime disable
Summertime disabled.
Console> (enable)

Related Command

show summertime

set system baud

Use the set system baud command to set the console port baud rate.

set system baud rate

Syntax Description

rate

The baud rate. Valid rates are 600, 1200, 2400, 4800, 9600, 19200, and 38400.

Default

The default value is 9600 baud.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the system baud rate to 19200:

Console> (enable) set system baud 19200
System console port baud rate set.
Console> (enable)

Related Command

show system

set system contact

Use the set system contact command to set the system contact string.

set system contact [contact_string]

Syntax Description

contact_string

(Optional) User-definable text, usually containing the name of the person to contact for system administration. If no contact string is specified, the system contact string is cleared.

Default

The default configuration has no system contact configured.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the system contact string to Luis x5529:

Console> (enable) set system contact Luis x5529
System contact set.
Console> (enable)

Related Command

show system

set system help

Use the set system help command to list the set system commands.

set system help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list the set system commands:

Console> (enable) set system help
Commands:
------------------------------------------------------------------------------
set system baud     Set system console port baud rate
set system contact  Set system contact
set system help     Show this message
set system location Set system location
set system modem    Set system modem control (enable/disable)
set system name     Set system name
Console> (enable)

Related Command

show system

set system location

Use the set system location command to set the system location string.

set system location [location_string]

Syntax Description

location_string

(Optional) A word or phrase that indicates where the system is located. If no location string is specified, the system location is cleared.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the system location string to "Closet 230 4/F":

Console> (enable) set system location Closet 230 4/F
System location set.
Console> (enable)

Related Command

show system

set system modem

Use the set system modem command to enable or disable modem control lines on the console port.

set system modem {enable | disable}

Syntax Description

enable	Keyword used to activate modem control lines on the console port.
disable	Keyword used to deactivate modem control lines on the console port.

Default

The default configuration has modem control lines disabled.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to disable the modem control lines on the console port:

Console> (enable) set system modem disable
Modem control lines disabled on console port.
Console> (enable)

Related Command

show system

set system name

Use the set system name command to configure a name for the system.

set system name [name_string]

Syntax Description

name_string

(Optional) A word or phrase that identifies the system. If no name is specified, the system name is cleared.

Default

The default configuration has no system name configured.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the system name to "Support Group":

Console> (enable) set system name Support Group
System name set.
Console> (enable)

Related Command

show system

set tacacs attempts

Use the set tacacs attempts command to configure the maximum number of login attempts allowed to the TACACS+ server.

set tacacs attempts count

Syntax Description

count

The number of login attempts allowed.

Default

The default value for this command is 3.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The value of count must be from 1 to 10.

Example

The following example shows how to configure the TACACS+ server to allow a maximum of 6 login attempts:

Console> (enable) set tacacs attempts 6 
Console> (enable)

Related Command

show tacacs

set tacacs directedrequest

Use the set tacacs directedrequest command to enable and disable the TACACS+ directed-request option. When enabled, you can direct a request to any of the configured TACACS+ servers and only the username will be sent to the specified server.

set tacacs directedrequest {enable | disable}

Syntax Description

enable	Keyword used to send the portion of the address before the @ sign (the username) to the host specified after the @ sign.
disable	Keyword used to send the entire address string to the default TACACS+ server.

Default

This feature is disabled by default.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

When tacacs directedrequest is enabled, you can only specify configured TACACS+ servers after the @ sign. If the specified host name does not match the IP address of a configured TACACS+ server, the request is rejected. When tacacs directedrequest is disabled, the Catalyst 5000 series switch queries the list of servers beginning with the first server in the list and then sends the entire string, accepting the first response from the server. This command is useful for sites that have developed their own TACACS+ server software to parse the entire address string and make decisions based on the contents of the string.

Example

The following example shows how to enable the tacacs directedrequest option:

Console> (enable) set tacacs directedrequest enable
Console> (enable)

Related Command

show tacacs

set tacacs key

Use the set tacacs key command to set the key used for TACACS+ authentication and encryption.

set tacacs key key

Syntax Description

key

The printable ASCII characters used for authentication and encryption.

Default

The default value of key is NULL.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The key must be the same as the key used on the TACACS+ server. All leading spaces are ignored. Spaces within the key and at the end of the key are included. Double quotation marks are not required, even if there are spaces between words in the key, unless the quotation marks themselves are part of the key. Key length is limited to 100 characters. The key can consist of any printable ASCII characters except the tab character.

Example

The following example shows how to set the authentication and encryption key to Who Goes There:

Console> (enable) set tacacs key Who Goes There
Console> (enable)

Related Commands

clear tacacs key
show tacacs

set tacacs server

Use the set tacacs server command to configure the server on which the TACACS+ server resides.

set tacacs server ip_addr [primary]

Syntax Description

host	The IP address of the server on which the TACACS+ server resides.
primary	Keyword used to designate the server as the primary TACACS+ server.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

A maximum of three servers can be configured. The primary server, if configured, is contacted first. If no primary server is configured, the first server configured becomes the primary server.

Example

The following example shows how to configure the server on which the TACACS+ server resides and to designate it as the primary server:

Console> (enable) set tacacs server 170.1.2.20 primary
Console> (enable)

Related Commands

clear tacacs server
show tacacs

set tacacs timeout

Use the set tacacs timeout command to set the response timeout interval for the TACACS+ server daemon.

set tacacs timeout seconds

Syntax Description

seconds

The timeout response interval in seconds.

Default

The default value for this command is 5 seconds.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The value of seconds must be from 1 to 255.

Example

The following example shows how to set the response timeout interval for the TACACS+ server to 8 seconds:

Console> (enable) set tacacs timeout 8
Console> (enable)

Related Command

show tacacs

set time

Use the set time command to change the time of day in the system clock.

set time [day_of_week] [mm/dd/yy] [hh:mm:ss]

Syntax Description

day_of_week	(Optional) The day of the week.
mm/dd/yy	(Optional) The month, day, and year.
hh:mm:ss	(Optional) The current time in 24-hour format.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to set the system clock to Wednesday, May 17, 1995,
1:25:55 p.m.:

Console> (enable) set time wed 5/17/95 13:25:55
Wed Feb 22 1995, 13:25:55
Console> (enable)

Related Command

show time

set timezone

Use the set timezone command to set the time zone for display purposes.

set timezone zone hours [minutes]

Syntax Description

zone	The name of the time zone to be displayed.
hours	The number of hours offset from Coordinated Universal Time (UTC).
minutes	The number of minutes offset from UTC.*

* If the hours value is a negative number, then the minutes value is assumed to be negative.

Default

By default, the time zone is set to UTC.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The set timezone command is effective only when NTP is running. If you explicitly set the time and NTP is disengaged, the set timezone command has no effect. If you have enabled NTP and have not entered the set timezone command, your Catalyst 5000 series switch displays UTC by default.

Example

The following example shows how to set the time zone to Pacific Standard Time with an offset of minus 8 hours from UTP:

Console> (enable) set timezone PST -8
Timezone set to "PST", offset from UTC is -8 hours.
Console> (enable)

Related Command

clear timezone

set trunk

Use the set trunk command to configure trunk ports.

set trunk mod_num/port_num [on | off | desirable | auto] [vlan_range]

Syntax Description

mod_num	The number of the module.
port_num	The number of the port.
on	This parameter puts the port into permanent ISL trunking mode and negotiates to convert the link into a trunk port. Moreover, the port becomes a trunk port even if the other end of the link does not agree to the change.
off	This parameter negotiates to convert the link into a nontrunk port. Moreover, the port converts to a nontrunk port even if the other end of the link does not agree to the change. This is the default mode for FDDI trunks. This option is not allowed for ATM ports.
desirable	This parameter triggers negotiations to switch the state of the link from a nontrunk to a trunk port. This option is not allowed on FDDI and ATM ports.
auto	This parameter indicates that the port is willing to become a trunk port if another device on that link desires to be a trunk. This option is not allowed on FDDI and ATM ports. This is the default mode for Fast Ethernet ports.
vlan_range	The VLANs specified are added to the list of allowed VLANs on the trunk. The VLAN range is 2 to 1000.

Default

All ports are nontrunk ports by default. The default vlan_range is 1 to 1005.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

Trunking capabilities are hardware dependent. The set trunk command adds VLANs and ports to existing trunk groups; the command does not replace existing VLANs and ports with new VLANs and ports. VLAN numbers must be in the range from 1 to 1005.

When a Catalyst 5000 port that is configured to auto detects a link bit, and it determines that the other end of the link is a trunk port, the Catalyst 5000 automatically converts the port configured to auto into trunking mode. The trunk port reverts to a nontrunk port when its link goes down.

For trunking to take effect with Fast Ethernet ports, the ports must be in the same domain. However, you can use the on mode to force a port to become a trunk, even if it is in a different domain.

To return a trunk to a normal switched port, use the clear trunk command.

Example

The following example shows how to set port 2 on module 1 as a trunk port:

Console> (enable) set trunk
Usage: set trunk <mod_num/port_num> [on|off|desirable|auto] [vlan_range]
       (vlans = 1..1000
       An example of vlans is 2-10,1000)
Console> (enable) set trunk 1/2 1-5
Port 1/2 allowed vlans modified to 1-1000.
Console> (enable) set trunk 1/2 on
Port 1/2 mode set to on.
Console> (enable)

Related Commands

clear trunk
show trunk

show vtp

set vtp

set vlan

Use the set vlan command to group ports into a virtual LAN.

set vlan vlan_num mod/ports ...
set vlan vlan_num [name name] [type type] [mtu mtu] [said said] [state state] [ring ring_number] [bridge bridge_number] [parent vlan_num] [stp stp_type] [translation vlan_num]

Syntax Description

vlan_num	The number of the VLAN.
mod	The number of the module.
ports	The number of the port on the module.
name	The name of the VLAN.
type	The VLAN type (Ethernet, FDDI, Token Ring, FDDI NET, or TR NET).
mtu	The maximum transmission unit (packet size, in bytes) that the VLAN can use.
said	Security association identifier.
state	The VLAN is either active or suspended.
ring_number	Ring number for Token Ring VLANs.
bridge_number	The identification number of the bridge.
stp_type	1-Source routing transparent, 2-Source routing porting.

Default

The default configuration has all switched Ethernet ports and Ethernet repeater ports in VLAN 1. The default SAID for VLAN 1 is 100001, for VLAN 2 is 100002, for VLAN 3 is 100003, and so on. The default type is Ethernet. The default mtu is 1500 bytes. The default state is "active."

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

You cannot set multiple VLANs for ISL ports using this command. The VLAN name can be
from 1 to 32 characters in length. The VLAN number must be within the range 1 to 1005.

Example

The following example shows how to set VLAN 1000 to include ports 1 and 2 on module 1 and
port 1 on module 2:

Console> (enable) set vlan
Usage:
set vlan <vlan_num> <mod/ports...>
set vlan <vlan_num> [name <name>][type <type>][mtu <mtu>][said <said>]
         [state <state>] [ring <ring_number>]
         [bridge <bridge_number>] [parent <vlan_num>]
         [stp <stp_type>] [translation <vlan_num>]
         (An example of mod/ports is 1/1,2/1-12,3/1-2,4/1-12 
          type = (ethernet, fddi, token_ring, fddi_net, tr_net) 
          name = 1..32 characters, status = (active, suspend) 
          vlan_num = 1..1005)
Console> (enable) set vlan 1000 1/1,1/2,2/1
VLAN 1000 created.
VLAN 1 modified.
VLAN 3 modified.
VLAN    Mod/Ports
----    ----------------------------
1000    1/1-2
        2/1
Console> (enable) set vlan 3 name catbox type ethernet mtu 1500 said 3
VLAN 3 Added
Console> (enable)

Related Commands

clear vlan
show vlan

set vmps address

Use the set vmps address command to configure the IP address of the VMPS client to be queried.

set vmps address ip_addr [primary]

Syntax Description

ip_addr

The IP address of the VMPS client.

Default

If no IP address is specified, VMPS uses the local VMPS configuration.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

You can configure up to three VMPS IP addresses for backups.

You can specify any VMPS address as the primary VMPS address.

If the primary VMPS client is down, all subsequent queries go to a secondary VMPS client. VMPS checks on the primary client's availability once every 5 minutes. When the primary VMPS client comes back online, subsequent VMPS queries are directed back to the primary VMPS client.

In order to use a co-resident VMPS (when VMPS is enabled in a device), configure one of the three VMPS addresses to be the interface sc0 IP address.

Examples

The following examples show how to specify a VMPS client at IP address 192.0.0.6 as the primary client.

console (enable)> set vmps address help
Usage: set vmps address <ipaddress> [primary]
console (enable)> set vmps address 192.0.0.6
vmps address 192.0.0.6 added to vmps table as primary vmps.
console (enable)> set vmps address 192.0.0.1 primary
vmps address 192.0.0.1 added to vmps table as primary vmps.

Related Commands

show vmps
show vmps address

set vmps state

Use the set vmps state command to enable or disable VMPS.

set vmps state {enable | disable}

Syntax Description

enable	Keyword used to enable VMPS.
disable	Keyword used to disable VMPS.

Default

By default, VMPS is disabled.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

Before using the set vmps state command, you must use the set vmps storage command to specify the IP address of the server from which the VMPS database is downloaded.

Examples

The following examples show the set vmps state enable and set vmps state disable commands and the system's responses to these commands.

Console> (enable) set vmps state enable
Vlan membership Policy Server enabled.
Console> (enable) set vmps state enable
TFTP server IP address is not configured
Console> (enable) set vmps state enable
Unable to contact the TFTP server 198.4.254.222
Console> (enable) set vmps state enable
File "vmps_configuration.db" not found on the TFTP server 198.4.254.222
Console> (enable) set vmps state enable
Enable failed due to insufficient resources.
Console> (enable) set vmps state disable
All the VMPS configuration information will be lost and the resources released on disable.
Do you want to continue (y/n[n]):y
VLAN Membership Policy Server disabled.

Related Command

show vmps

set vmps storage

Use the set vmps storage command to specify the IP address of the server from which the VMPS database is downloaded.

set vmps storage ip_addr [filename]

Syntax Description

ip_addr	IP address of the TFTP server from which the configuration database is downloaded.
filename	(Optional) The VMPS configuration file name on the TFTP server.

Default

If filename is not specified, the set vmps storage command uses the default file name vmps-config-database.1.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example specifies the IP address of the TFTP server as 198.4.254.220 and the configuration file name as vmps_config1.

Console> (enable) set vmps storage 198.4.254.220 vmps_config.1
Console> (enable)

Related Commands

set vmps state
show vmps

set vtp

Use the set vtp command to set the management domain name, VLAN trunk protocol mode of operation, advertisement interval, password values, and the pruning option.

set vtp [domain domain_name] [mode mode] [interval interval] [passwd passwd] [pruning {enable | disable}]

Syntax Description

domain_name	The name that identifies the VLAN management domain (1 to 32 characters in length).
mode	The mode of operation (client, server, or transparent).
interval	The rate at which periodic advertisements are generated (in seconds from 120 to 600).
passwd	The VLAN trunk protocol password (8 to 64 characters).
pruning enable	The option that enables VTP pruning in the entire management domain.
pruning disable	The option that disables VTP pruning in the entire management domain.

Default

The default interval is 5 minutes.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The interval range is from 120 to 600 seconds. The password must be at least eight characters in length.

Example

After entering the set vtp command, you see the following screen:

Console (enable) set vtp
Usage:
set vtp [domain <name>][mode <mode>][interval <interval>][passwd <passwd>] [pruning {enable | disable}]
(name: 1-32 characters, mode = (client, server, transparent), 
 interval = 120-600 sec, passwd : 0-64 characters)
Console> (enable) set vtp domain catbox mode client interval 160
VTP: domain catbox modified
Console> (enable)

Related Commands

clear vtp
show vtp

set vtp pruneeligible

Use the set vtp pruneeligible command to configure pruning eligibility only for the device and to display all pruning-eligible VLANs.

set vtp pruneeligible vlan_range

Syntax Description

vlan_range

The range of VLAN numbers.

Default

The pruning function is disabled by default.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

VTP pruning does not take effect on a vlan_range that is not eligible for pruning. You can invoke this command independently of the pruning mode. By default, VLAN 1 is not eligible for pruning.

Example

After entering the set vtp pruneeligible command for VLANs 120 and 150, you see the following screen:

Console> set vtp pruneeligible 120,150
Vlans 4-5,9-99,120,150,201-1000 eligible for pruning on this device.

Related Command

clear vtp pruneeligible

show alias

Use the show alias command to display shorthand versions of command invocations.

show alias [name]

Syntax Description

name

(Optional) The name of the alias to be displayed.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display all aliases:

Console> show alias
arpdelete     clear arp
resetclr      clear config

Related Commands

clear alias
session

show arp

Use the show arp command to display the Address Recognition Protocol (ARP) table.

[show arp noalias]

Syntax Description

noalias

(Optional) Indicates display only the IP address, not the IP alias.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the ARP table:

Console> show arp
ARP Aging time = 1200 sec
strauss-fddi    at 00-40-0b-40-40-8f
198.133.219.209 at 00-40-0b-40-cc-31
198.133.219.40  at 08-00-20-08-f1-ac
Console>

Related Commands

clear arp
set arp

show atm interface atm

Use the show atm interface atm privileged EXEC command to display ATM-specific information about an interface.

show atm interface atm 0

Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS ATM command.

Command Mode

EXEC.

Example

The following is sample output from the show atm interface atm command to display statistics on the ATM module:

ATM# show atm interface atm 0 
ATM interface ATM0:
AAL enabled:  AAL5 , Maximum vmps: 1024, Current vmps: 6
Tx buffers 32, Rx buffers 32, Exception Queue: 32, Raw Queue: 32
VP Filter: 0x0, VCIs per VPI: 1024, Max. Datagram Size:1580
PLIM Type:INVALID, No Framing, TX clocking: LINE
881 input, 880 output, 0 IN fast, 0 OUT fast
New Config. is ACTIVE in -3700 seconds
ATM#

Table 3-7 describes the fields shown in the display.

**Table 3-7: show atm interface atm Command Field Descriptions-show atm traffic**
Field	Description
ATM interface	The ATM interface is 0.
AAL enabled	Type of AAL.
Maximum vmps	Maximum number of virtual circuits this interface can support.
Current vmps	Number of active virtual circuits.
Tx buffers, Rx buffers	Number of buffers.
VCIs per VPI	Maximum number of VCIs to support per VPI, as configured by the atm vc-per-vp command.
PLIM Type	Physical Layer Interface Module (PLIM) type.
input	Number of packets received from process switch.
output	Number of packets sent from process switch.
Config.	ACTIVE or VALID in n SECONDS. ACTIVE indicates that the current Catalyst 5000 configuration has been loaded into the Catalyst 5000 and is being used. There is a 5-second inactive period whenever a new configuration is sent to the Catalyst 5000 series switch.

Use the show atm traffic privileged EXEC command to display current, global ATM traffic information to and from all ATM networks connected to the ATM module.

show atm traffic

Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS ATM command.

Command Mode

Privileged EXEC.

Example

The following is sample output from the show atm traffic command:

ATM# show atm traffic
949 Input packets
948 Output packets
0 Broadcast packets
0 Packets for non-existent VC
0 OAM cells received
0 OAM cells sent
ATM#

show atm vc

Use the show atm vc privileged EXEC command to display all active ATM virtual circuits (PVCs and SVCs) and traffic information.

show atm vc [vcd]

Syntax Description

vcd

(Optional) Specifies the VC about which information is displayed.

Command Type

Cisco IOS ATM command.

Command Mode

Privileged EXEC.

Usage Guidelines

If no vcd is specified, the command displays information for all SVCs. The output is in summary form (one line per VC).

Example

The following is sample output from the show atm vc command when no vcd is specified, displaying statistics for all VCs:

ATM# show atm vc
Intfc.      VCD   VPI   VCI    Type   AAL/Encaps    Peak   Avg.   Burst
ATM0        1     0     5      PVC    AAL5-SAAL     0      0      0   
ATM0        2     0     16     PVC    AAL5-ILMI     0      0      0   
ATM0        9     0     32     SVC    LANE-LEC      0      0      0   
ATM0        10    0     33     SVC    LANE-LEC      0      0      0   
ATM0        11    0     34     SVC    LANE-LEC      0      0      0   
ATM0        12    0     35     SVC    LANE-LEC      0      0      0   
ATM#

show atm vlan

Use the show atm vlan command to display the active VLAN-to-PVC bindings.

show atm vlan show atm vlan [vlan number]

Command Type

Cisco IOS ATM command.

Command Mode

EXEC.

Usage Guidelines

To display all active VLAN-to-PVC bindings, use the show atm vlan command. Use the show atm vlan [vlan number] command to display the VLAN-to-PVC binding for a specified VLAN.

Example

After entering the show vlan command, you see the following screen:

ATM# show atm vlan VCD VLAN-ID 10 5 11 5

show bridge

Use the show bridge command to display bridge information.

show bridge

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to display bridge information:

Console> (enable) show bridge
APaRT Enabled
FDDICHECK Enabled
IP fragmentation Enabled
Default IPX translations:
    FDDI SNAP  to Ethernet     8023raw
    FDDI 802.2 to Ethernet     8023raw
    Ethernet 802.3 Raw to FDDI snap
Console> (enable)

Related Commands

set bridge help
set bridge ipx 8022toether
set bridge ipx 8023rawtofddi
set bridge ipx snaptoether
set ip fragmentation

show cam

Use the show cam command to display the CAM table.

show cam {dynamic | static | permanent | system} [vlan]
show cam {dynamic | static | permanent} mod_num/port_num
show cam mac_addr [vlan]

Syntax Description

dynamic	Keyword used to specify that entries are subject to aging.
static	Keyword used to specify that entries are not subject to aging.
permanent	Keyword used to specify that static (permanent) entries will be stored in NVRAM until they are removed by the clear cam or clear config command.
system	Keyword used to specify the system.
vlan	(Optional) Number of the VLAN. If a VLAN is not specified, all VLANs are displayed.
mod_num	The number of the module.
port_num	The number of the port.
mac_addr	The MAC address.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

To view the CAM aging time for a specific VLAN, use the show cam vlan command; to view aging time for all configured VLANs, use the show config command.

Example

The following example shows how to display dynamic CAM entries for VLAN 1:

Console> (enable) show cam dynamic 1
VLAN 1 Aging time = 15 sec
VLAN  Destination MAC      Destination Ports or VCs
----  ------------------   ----------------------------------------------------
1     00-40-0b-60-cd-96    1/1
1     00-40-0b-b0-0b-8e    1/1
1     00-40-0b-60-d7-3c    1/1
1     00-00-0c-35-7f-42    1/1
Matching CAM Entries = 4
Console> (enable)

Related Commands

clear cam
set bridge help
show config

show cdp

Use the show cdp command to display Cisco Discovery Protocol (CDP) information.

show cdp neighbors [mod_num] [detail]
show cdp neighbors [mod_num/port_num] [detail]
show cdp port [mod_num]
show cdp port [mod_num/port_num]

Syntax Description

neighbors	Keyword used to show CDP information about all Cisco products connected to the switch.
mod_num	(Optional) The number of the module about which CDP information is to be displayed.
detail	(Optional) Keyword used to show descriptive information about neighboring Cisco products.
port_num	(Optional) The number of the port on the module about which CDP information is to be displayed.
port	Keyword used to show CDP port settings.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Examples

The following example shows how to display CDP information about neighboring systems:

Console> (debug-eng) show cdp neighbor
Port Device-ID               Port-ID           Platform              Capability
---- ----------------------- ----------------- --------------------- -----------
4/2  000041770(Workgroup Swi 5                 WS-C1201              T          
4/4  000102703               2/2               WS-C5000              S

The next example shows how to display detailed CDP information:

Console> (enable) show cdp neighbor detail
Device-ID: 000041770(Workgroup Switch)
Device Addresses:
  IP Address: 198.133.219.222
Holdtime: 127 sec
Capabilities: TRANSPARENT_BRIDGE 
Version: 
  WS-C1201 Software, Version DmpSW: 3.208 NmpSW: 3.208
  Copyright (c) 1994,1995 by Cisco Systems
  DMP S/W compiled on Jan 27 1995 08:52:48
  NMP S/W compiled on Jan 27 1995 08:42:46
  
  System Bootstrap Version: 1.1
  
  Hardware Version: 2.0  Model: WS-C1201  Serial #: 000041770
  1 FDDI interface
  8 10BaseT interfaces
  
  Uptime is 0 day, 5 hours, 22 minutes
Platform: WS-C1201
Port-ID (Port on Device): 5
Port (Our Port): 4/2
___________________________________________________________________________
Device-ID: 000102703
Device Addresses:
  IP Address: 198.133.219.225
Holdtime: 130 sec
Capabilities: SWITCH 
Version: 
  WS-C5000 Software, Version McpSW: 1.113 NmpSW: 1.1
  Copyright (c) 1995 by Cisco Systems
  MCP S/W compiled on Apr 21 1995, 10:08:16
  NMP S/W compiled on Apr 22 1995, 18:57:03
  
  System Bootstrap Version: 1.1
  
  WS-X5009 Hardware Version: 1.402  Model: WS-X5009  Serial #: 000102703
  
  Module Ports Model     Serial No  Hw     Fw     Sw
  ------ ----- --------- ---------- ------ ------ ------
       1     2 WS-X5009   000102703  1.402  1.113 1.1
       2    24 WS-X5010   000133119  1.302  1.113  0.0  
  
  WS-X5009 Uptime is 0 day, 0 hour, 19 minutes
Platform: WS-C5000
Port-ID (Port on Device): 2/2
Port (Our Port): 4/4
Console> (enable)

The following example shows how to display CDP information for a particular port:

Console> (enable) show cdp port 2/1
Port  CDP Status  Message-Interval
----  ----------  ----------------
2/1   enabled     60
Console> (enable)

Related Commands

set cdp disable
set cdp enable

show cgmp statistics

Use the show cgmp statistics command to display Cisco Group Management Protocol (CGMP) statistical information.

show cgmp statistics [vlan_id]

Syntax Description

vlan_id

The VLAN number.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows the contents of a configuration file:

console> (enable) show cgmp statistics 2
CGMP enabled
CGMP statistics for vlan 2:
No of valid rx pkts rcvd: 20
No of invalid rx pkts rcvd: 0
No of valid join msgs rcvd: 15
No of valid leave msgs rcvd: 5
No of failures to add 	 to EARL: 0
No of topology notifications rcvd: 0
Console> (enable>

Related Command

clear cgmp statistics

show config

Use the show config command to display the current system configuration.

show config

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows the contents of a configuration file:

Console> show config
begin
set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
set prompt Console>
!
#system
set system baud 9600
set system modem  disable
set system name  Catalyst 5000
set system location  Sunnyvale, CA
set system contact Bob Lewis
!
#snmp
set snmp rmon  enable
set snmp community read-only public
set snmp community read-write private
set snmp community read-write-all secret
set snmp trap  171.69.194.181 public
set snmp trap  disable
!
#vlan/trunk
clear trunk all
!
set vlan 1    1/1-2,2/1-24
!
#trunks
!
#MAC filters
clear filter all
!
#cam
set cam agingtime 0
!
#spantree
#vlan 1
set spantree enable         1
set spantree fwddelay 20    1
set spantree hello    2     1
set spantree maxage   20    1
set spantree priority 45    1
set spantree portpri  1/1  32
set spantree portcost 1/1  100
set spantree portpri  1/2  32
set spantree portcost 1/2  100
set spantree portpri  2/1  32
set spantree portcost 2/1  100
.
.
.
set spantree portpri  2/24 32
set spantree portcost 2/24 100
!
#vlan trunk/monitor
!
#ip
set interface sc0 192.122.174.220 255.255.255.0 192.122.174.255
set redirect enable
set route 0.0.0.0 192.122.174.102 1
set arp agingtime 1200
!
#cdp
set cdp 1/1  enable  60
set cdp 1/2  enable  60
set cdp 2/1  enable  60
set cdp 2/2  enable  60
set cdp 2/3  enable  60
.
.
.
set cdp 2/24 enable  60
!
#ipalias
set ipalias default 0.0.0.0
set ipalias cres 192.122.173.42
set ipalias calypso 171.69.194.181
!
#alias
!
#port monitoring
set monitor 1 1/1  both
set monitor disable
!
#module 1 
set port enable    1/1
set port name      1/1  
set port duplex    1/1  half
set port speed     1/1  -1315
set port level     1/1  high
set port enable    1/2
set port name      1/2  
set port duplex    1/2  half
set port speed     1/2  504
set port level     1/2  normal
!
#module 2 
set module enable  2
!
set port enable    2/1
set port name      2/1  network
set port duplex    2/1  half
set port level     2/1  normal
set port enable    2/2
set port name      2/2  
set port duplex    2/2  half
set port level     2/2  normal
.
.
.
set port enable    2/24
set port name      2/24 
set port duplex    2/24 half
set port level     2/24 normal
!
#module 3 empty
!
#module 4 empty
!
#module 5 empty
end

Related Commands

clear config
write

show fddi

Use the show fddi command to display the setting for the FDDI/CDDI modules.

show fddi

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the FDDI settings:

console> show fddi 
Mod  SMT User-Data               T-Notify  TReq
---  --------------------------  --------  -------
2    Engineering                 30        165000
5    abc                         20        150000
 
Port   Tlmin     Ler-CutOff  Ler-Alarm
-----  --------  ----------  ---------
2/1    40        7           8
2/2    40        7           8
5/1    40        10          11
5/2    40        9           12
console>

Related Commands

clear cam
set bridge help
show config

show fddicam

Use the show fddicam command to display the FDDI module CAM table.

show fddicam mod_num mac_addr

Syntax Description

mod_num	The number of the module.
mac_addr	The MAC addresses.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the FDDI CAM table for module 4:

Console> (enable) show fddicam 4
MAC Address        VLAN   Protocol Type
-----------------  ----   -------------
00-40-0b-d0-00-2b     1   FDDI
Total FDDI CAM entries = 1
Console> (enable)

Related Commands

clear cam
set bridge help
show config

show flash

Use the show flash command to list Flash code information, such as file code names, version numbers, and sizes.

show flash

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to list the Flash code versions:

Console> (enable) show flash ?
Usage: show flash
Console> (enable) show flash
File            Version            Size (bytes)
--------------  -----------------  -------------
c5009 nmp       2.142(Eng)          789921
      mcp       2.139                25773
      lcp       2.139                24786
      atm/fddi  2.139                22272
      lcp 64k   2.139                35663
Console> (enable)

Related Commands

download
reset
show version-Switch Command
upload

show help

Use the show help command to list the available show commands.

show help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to list the show commands:

Console> show help
Show commands:
--------------------------------------------------------------------------------
show alias	Show aliases for commands
show arp	Show ARP table
show bridge	Show bridge information
show cam	Show CAM table
show cdp	Show Cisco Discovery Protocol Information
show cgmp statistics	Show CGMP statistical information
show config	Shows the system configuration
show fddi	Show FDDI module entries
show fddicam	Show FDDI module CAM table
show flash	Show system flash information
show help	Show this message
show interface	Show network interfaces
show ip	Show IP Information
show logging	Show the system message log configuration
show logging buffer	Show system messages from the internal buffer
show mac	Show MAC information
show module	Show module information
show multicast group	Show the multicast group configuration
show multicast router	Show the multicast router configuration
show netstat	Show network statistics
show ntp	Show the current NTP status
show port	Show port information
show snmp	Show SNMP information
show span	Show switch port analyzer information
show spantree	Show spantree information
show summertime	Show the current status of the summertime feature
show system	Show system information
show tacacs	Show the TACACS+ protocol configuration
show test	Show results of diagnostic tests
show time	Show time of day
show timezone	Show the current timezone and offset
show trunk	Show trunk ports
show users	Show active Admin sessions
show version	Show version information
show vlan	Show Virtual LAN information
show vmps	Show the current VMPS configuration information and its
	current operational service
show vmps address	Show the VMPS IP address
show vmps mac	Show the MAC-address-to-VLAN mapping
show vmps portgrp	Show the VLANs in a port group
show vmps statistics	Show the VMPS statistics
show vmps vlan	Show all the MAC addresses assigned to this VLAN in the VMPS
	table
show vmps vlangrp	Show the VLANs in a group
show vmps vlanports	Show the ports belonging to a restricted VLAN or a VLAN group
show vtp 	Show VTP Information
Console>

show history

Use the show history EXEC command to list the commands you have entered in the current EXEC session.

show history

Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS ATM module Interface command.

Command Mode

EXEC.

Usage Guidelines

The command history feature provides a record of EXEC commands you have entered. The number of commands the history buffer records is determined by the history size line configuration command or the terminal history size EXEC command.

Table 3-8 lists the keys and functions you can use to recall commands from the command history buffer.

Table 3-8: History Keys

Key	Function
Up Arrow or Ctrl-P ¹	Recalls commands in the history buffer in a backward sequence, beginning with the most recent command. Repeat the key sequence to recall successively older commands.
Down Arrow or Ctrl-N ¹	Returns to more recent commands in the history buffer after recalling commands with Ctrl-P or the Up Arrow. Repeat the key sequence to recall successively more recent commands.

¹ The arrow keys function only with ANSI-compatible terminals such as VT100s.

Example

The following is sample output from the show history command, which lists the commands the user has entered in EXEC mode for this session:

ATM# show history
help
  where
  show hosts
  show history
ATM#

show interface

Use the show interface command to display network interfaces.

show interface

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display sl0 and sc0:

Console> show interface
sl0: flags=51<UP,POINTOPOINT,RUNNING>
        slip 0.0.0.0 dest 0.0.0.0
sc0: flags=63<UP,BROADCAST,RUNNING>
        vlan 1 inet 172.20.25.130 netmask 255.255.0.0 broadcast 172.20.255.255
Console>

Related Command

set interface

show ip alias

The show ip alias command shows aliases of IP addresses.

show ip alias [name]

Syntax Description

name

(Optional) The name of the host.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display all IP aliases:

Console> (enable) show ip alias
elvis        192.122.174.11
mercury      192.122.174.234
neptune      198.211.203.44

show ip dns

Use the show ip dns command to show the DNS name server and the default domain name.

show ip dns

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the DNS name server and the default domain name:

Console> (enable) show ip dns
DNS is currently enabled.
The default DNS domain name is: hp.com
DNS name server	status
---------------	-------
198.92.30.32
171.69.2.132	primary
161.44.128.70
Console> (enable)

Related Commands

clear ip dns domain
clear ip dns server
set ip dns
set ip dns domain
set ip dns server

show ip help

Use the show ip help command to list the show ip commands.

show ip help

Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to list the show ip commands:

Console> (enable) show ip help
Show ip commands:
----------------------------------------------------------------------
show ip alias       Show aliases for IP Addresses
show ip route       Show IP routing table
Console> (enable)

Related Commands

show ip alias
show ip route

show ip permit

Use the show ip permit command to display the IP permit list feature information.

show ip permit

Syntax Description

This command has no arguments or keywords.

Default

This command has no default value.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

If noalias is specified, IP addresses are displayed.

Example

This example shows a sample session of the show ip permit command.

Console> (enable) show ip permit help

Usage: show ip permit [noalias]

Console> (enable) show ip permit

IP permit list feature enabled.

Permit List Mask

---------------- ---------------

batboy

172.100.101.102

172.101.102.0 255.255.255.0

128.0.103.0 192.0.255.0

Denied IP Address Last Accessed Time Type

----------------- ---------------- ------

172.100.101.104 01/20/97,07:45:20 SNMP

172.187.206.222 01/21/97,14:23:05 Telnet

Console> (enable)

Related Commands

clear ip permit
set ip permit
show snmp
set snmp trap

show ip route

Use the show ip route command to display IP routing table entries.

show ip route [noalias]

Syntax Description

noalias

(Optional) Keyword used to indicate not to display the IP alias, only the IP address.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guideline

If the noalias keyword is specified, IP aliases are not displayed; IP addresses only are displayed.

Example

The following example shows how to display the established routes:

Console> (enable) show ip route
Fragmentation   Redirect   Unreachable
-------------   --------   -----------
disabled        enabled    disabled
Destination     Gateway         Flags   Use         Interface
--------------- --------------- ------  ----------  ---------
172.20.0.0      172.20.22.181   U                0  sc0
default         default         UH               0  sl0
Console> (enable)

Related Commands

clear ip route
set ip route
set ip fragmentation
set ip redirect
set ip unreachable

show lane

Use the show lane EXEC command to display global and per-VCC LANE information for all the LANE components configured on an interface or any of its subinterfaces, on a specified subinterface, or on an emulated LAN.

show lane [interface atm 0 [.subinterface-number] | name elan-name] [brief]

Syntax Description

interface atm 0	(Optional) ATM interface 0.
.subinterface-number	(Optional) Subinterface number. (The period (.) is required.)
name elan-name	(Optional) Name of emulated LAN. Maximum length is 32 characters.
brief	(Optional) Keyword used to display the global information, but not the per-VCC information.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

EXEC.

Usage Guideline

Entering the show lane command is equivalent to entering the show lane client commands.

Example

The following is sample output of the show lane command:

ATM# show lane
LE Client ATM0.2  ELAN name: blue  Admin: up  State: operational
Client ID: 1              
HW Address: 0040.0bf0.0020   Type: ethernet             Max Frame Size: 1516
ATM Address: 39.000000550055005500550055.00400BF00020.02
 
 VCD  rxFrames  txFrames  Type       ATM Address
 0         0         0  configure 39.000000550055005500550055.00000C0425C2.00
 14        3         4  direct    39.000000550055005500550055.00000C0425C0.01
 15        1         0  distribute39.000000550055005500550055.00000C0425C0.01
 16        0         8  send      39.000000550055005500550055.00000C0425C1.01
 17        14        0  forward   39.000000550055005500550055.00000C0425C1.01
 18        25        28 data      39.000000550055005500550055.00400BF00420.00
 
ATM#

Table 3-9 describes significant fields in the example.

Table 3-9: show lane Command Field Descriptions

Field	Description
LE Client	Identifies the following lines as applying to a LANE client. These lines are also displayed in output from the show lane client command.
ATM 0.1	Interface or subinterface this LANE client is on.
ELAN name	Name of the emulated LAN this client is linked to.
State	Status of this LANE client. Possible states include initialState, lecsConnect, configure, join, busConnect, and operational.
HW Address	MAC address, in dotted hexadecimal notation, assigned to this LANE client.
Type	Type of emulated LAN.
Max Frame Size	Maximum frame size on this type of LAN.
ATM Address	ATM address of this LANE client.
VCD	Virtual channel descriptor for each of the VCCs established for this LANE client.
rxFrames	Number of frames received on the VCC.
txFrames	Number of frames transmitted on the VCC.
Type	Type of VCC; same as the SVC and PVC types. Possible VCC types are configure, direct, distribute, send, forward, and data.
ATM Address	ATM address of the LANE component at the other end of the VCC.

show lane bus

Use the show lane bus EXEC command to display LANE information for the broadcast and unknown servers configured on all servers, on a specified interface, or on an emulated LAN.

show lane bus [brief] show lane bus [interface subinterface-name] [brief] show lane bus [name elan-name] [brief]

Syntax Description

interface subinterface-name	Subinterface name.
name elan-name	Name of emulated LAN. Maximum length is 32 characters.
brief	Keyword used to display the global information, but not the per-VCC information.

Default

show lane bus

Command Type

Cisco IOS LAN Emulation command.

Command Mode

EXEC.

Usage Guideline

The show lane bus [brief] command displays information about all LANE BUSes. The show lane bus [interface subinterface-name] [brief] command displays all information about a BUS on a specified interface. The show lane bus [name elan-name] [brief] command displays all information about a BUS on a specified ELAN.

Examples

The following is sample output of the show lane bus command:
ATM#show lane bus LE BUS ATM0.1 ELAN name: default Admin: up State: operational type: ethernet Max Frame Size: 1516 ATM address: 47.0091810000000061705B8301.00400B020012.01 data forward: vcd 16, 4 members, 31324 packets, 0 unicasts lecid vcd pkts ATM Address 1 13 0 47.0091810000000061705B8301.00400B020010.01 2 19 0 47.0091810000000061705B8301.00400B010040.01 3 22 31321 47.0091810000000061705B8301.00400BC5D430.01 4 171 3 47.0091810000000061705B8301.0060705B8302.00
The following is sample output of the show lane bus command:
ATM#show lane bus brief LE BUS ATM0.1 ELAN name: default Admin: up State: operational type: ethernet Max Frame Size: 1516 ATM address: 47.0091810000000061705B8301.00400B020012.01 data forward: vcd 16, 4 members, 31342 packets, 0 unicasts
show lane client

Use the show lane client EXEC command to display global and per-VCC LANE information for all the LANE clients configured on an interface or any of its subinterfaces, on a specified subinterface, or on an emulated LAN.
show lane client [interface atm 0 [.subinterface-number] | name elan-name] [brief]
Syntax Description

interface atm 0 (Optional) ATM interface 0.
.subinterface-number (Optional) Subinterface number. (The period (.) is required.)
name elan-name (Optional) Name of the emulated LAN. Maximum length is
32 characters.
brief (Optional) Keyword used to display the global information, but not the per-VCC information.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

EXEC.

Example

The following is sample output from the show lane client command:

Router# show lane client LE Client ATM0.2 ELAN name: blue Admin: up State: operational Client ID: 1 HW Address: 0040.0bf0.0020 Type: ethernet Max Frame Size: 1516 ATM Address: 39.000000550055005500550055.00400BF00020.02 VCD rxFrames txFrames Type ATM Address 0 0 0 configure 39.000000550055005500550055.00000C0425C2.00 14 3 4 direct 39.000000550055005500550055.00000C0425C0.01 15 1 0 distribute39.000000550055005500550055.00000C0425C0.01 16 0 8 send 39.000000550055005500550055.00000C0425C1.01 17 14 0 forward 39.000000550055005500550055.00000C0425C1.01 18 25 28 data 39.000000550055005500550055.00400BF00420.00 ATM#

Table 3-10 describes significant fields in the example.

Table 3-10: show lane client Command Field Descriptions
Field Description
LE Client Identifies the following lines as applying to a LANE client. These lines are also displayed in output from the show lane client command.
ATM 0.1 Interface or subinterface this LANE client is on.
ELAN name Name of the emulated LAN this client is linked to.
State Status of this LANE client. Possible states include initialState, lecsConnect, configure, join, busConnect, and operational.
HW Address MAC address, in dotted hexadecimal notation, assigned to this LANE client.
Type Type of emulated LAN.
Max Frame Size Maximum frame size on this type of LAN.
ATM Address ATM address of this LANE client.
VCD Virtual channel descriptor for each of the VCCs established for this LANE client.
rxFrames Number of frames received on the VCC.
txFrames Number of frames transmitted on the VCC.
Type Type of VCC; same as the SVC and PVC types. Possible VCC types are configure, direct, distribute, send, forward, and data.
ATM Address ATM address of the LANE component at the other end of the VCC.

show lane config

Use the show lane config EXEC command to display LANE information about the LANE configuration server (LECS).
show lane config [brief] show lane config [interface interface-name] [brief]
Syntax Description

interface interface-name Interface name.
brief Keyword used to display the global information, but not the per-VCC information.

Default

show lane config

Command Type

Cisco IOS LAN Emulation command.

Command Mode

EXEC.

Usage Guideline

The show lane config [brief] command displays information about the LECS on all active interfaces. The show lane config [interface interface-name] [brief] command displays all information about a LECS on a specified interface.

Example

The following is sample output of the show lane config command:
ATM#show lane config LE Config Server ATM0 config table: test Admin: up State: operational LECS Mastership State: active master list of global LECS addresses (0 seconds to update): 47.0091810000000061705B8301.00400B020013.00 <-------- me 47.0091810000000061705B8301.00400B010043.00 connected outgoing call (vcd 24) ATM Address of this LECS: 47.0091810000000061705B8301.00400B020013.00 (auto) vcd rxCnt txCnt callingParty 7 4 4 47.0091810000000061705B8301.00400B020011.01 LES default 0 active 26 0 0 47.0091810000000061705B8301.00400B010041.01 LES default 1 backup cumulative total number of unrecognized packets received so far: 0 cumulative total number of config requests received so far: 151 cumulative total number of config failures so far: 143 cause of last failure: no configuration culprit for the last failure: 47.0091810000000061705B8301.0060705B8302.00
The following is sample output of the show lane config brief command:
ATM#show lane config brief LE Config Server ATM0 config table: test Admin: up State: operational LECS Mastership State: active master list of global LECS addresses: 47.0091810000000061705B8301.00400B020013.00 47.0091810000000061705B8301.00400B010043.00 ATM Address of this LECS: 47.0091810000000061705B8301.00400B020013.00 (auto)
show lane default-atm-addresses

Use the show lane default-atm-addresses EXEC command to display default ATM addresses for the LANE components, namely the LEC, LES/BUS, and the LECS.
show lane default-atm-addresses
Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

EXEC.

Usage Guidelines

If the two PHYs of the ATM Dual PHY card are connected to different switches, and if the ATM card is configured to have a LES/BUS or LECS, you must determine the addresses to be used if the first PHY goes down. Refer to the atm preferred phy <A or B> command in this manual.

Example

After entering the show lane default-atm-addresses command, you see the following display:
ATM#show lane default-atm-addresses interface ATM0: LANE Client: 47.00918100000000613E5D1101.00400BF00440.** LANE Server: 47.00918100000000613E5D1101.00400BF00441.** LANE Bus: 47.00918100000000613E5D1101.00400BF00442.** LANE Config Server: 47.00918100000000613E5D1101.00400BF00443.00
where ** is the subinterface number byte in hexadecimal format.

Related Commands

atm preferred phy
show interface

show lane le-arp

Use the show lane le-arp EXEC command to display the LANE ARP table of the LANE client configured on an interface or any of its subinterfaces, on a specified subinterface, or on an emulated LAN.
show lane le-arp [interface atm 0 [.subinterface-number] | name elan-name]
Syntax Description

interface atm 0 (Optional) ATM interface 0.
.subinterface-number Subinterface number. (The period (.) is required.)
name elan-name (Optional) Keyword and value used to specify the name of the emulated LAN. Maximum length is 32 characters.

Command Type

Cisco IOS LAN Emulation command.

Command Mode

EXEC.

Example

The following is sample output of the show lane le-arp command:

ATM# show lane le-arp Hardware Addr ATM Address VCD Interface 0000.0c15.a2b5 39.000000000000000000000000.00000C15A2B5.01 39 ATM 0.1 0000.0c15.f3e5 39.000000000000000000000000.00000C15F3E5.01 25* ATM 0.1

Table 3-11 describes significant fields shown in the display.

Table 3-11: show lane le-arp Command Field Descriptions
Field Description
Hardware Addr The MAC address, in dotted hexadecimal notation, assigned to the LANE component at the other end of this VCD.
ATM Address ATM address of the LANE component at the other end of this VCD.
VCD Virtual circuit descriptor.
Interface Interface or subinterface used to reach the specified component.

show lane server

Use the show lane server EXEC command to display LANE information for the broadcast and unknown servers configured on all servers, on a specified interface, or on an emulated LAN.
show lane server [brief] show lane server [interface subinterface-name] [brief] show lane server [name elan-name] [brief]
Syntax Description

interface subinterface-name Subinterface name.
name elan-name Name of emulated LAN. Maximum length is 32 characters.
brief Keyword used to display the global information, but not the per-VCC information.

Default

show lane server

Command Type

Cisco IOS LAN Emulation command.

Command Mode

EXEC.

Usage Guideline

The show lane server [brief] command displays information about all LANE servers. The show lane server [interface subinterface-name] [brief] command displays all information about a server on a specified subinterface. The show lane server [name elan-name] [brief] command displays all information about a server on a specified ELAN.

Examples

The following is sample output of the show lane server command:
ATM# show lane server LE Server ATM0.1 ELAN name: default Admin: up State: operational type: ethernet Max Frame Size: 1516 ATM address: 47.0091810000000061705B8301.00400B020011.01 LECS used: 47.0091810000000061705B8301.00400B020013.00 connected, vcd 8 control distribute: vcd 12, 4 members, 9086 packets proxy/ (ST: Init, Conn, Waiting, Adding, Joined, Operational, Reject, Term) lecid ST vcd pkts Hardware Addr ATM Address 1P O 9 2 0040.0b02.0010 47.0091810000000061705B8301.00400B020010.01 2P O 18 2 0040.0b01.0040 47.0091810000000061705B8301.00400B010040.01 3P O 21 9084 0040.0bc5.d430 47.0091810000000061705B8301.00400BC5D430.01 4 O 170 2 0060.705b.8302 47.0091810000000061705B8301.0060705B8302.00
The following is sample output of the show lane server brief command:
ATM# show lane server brief LE Server ATM0.1 ELAN name: default Admin: up State: operational type: ethernet Max Frame Size: 1516 ATM address: 47.0091810000000061705B8301.00400B020011.01 LECS used: 47.0091810000000061705B8301.00400B020013.00 connected, vcd 8 control distribute: vcd 12, 4 members, 9089 packets
show log

Use the show log command to display the system or module error log.
show log [mod_num]
Syntax Description

mod_num (Optional) The number of the module.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows typical output from the show log command with no arguments:

Console> (enable) show log Network Management Processor (ACTIVE NMP) Log:   Reset count:                591   Re-boot History:           Jan 13 1995 18:49:04, Jan 13 1995 14:17:29                              Jan 13 1995 14:09:17, Jan 13 1995 13:58:49                              Jan 10 1995 17:30:09, Jan 13 1995 16:21:24                              Jan 10 1995 16:08:24, Jan 13 1995 16:06:37                              Jan 10 1995 11:40:18, Jan 13 1995 17:44:06   Bootrom Checksum Failures:    2   UART Failures:             0   Flash Checksum Failures:      0   Flash Program Failures:    0   Power Supply 1 Failures:      0   Power Supply 2 Failures:   0   DRAM Failures:                0   Exceptions:                  36     Last Exception occurred on Jan 13 1995 13:58:33 ...     PC:  0118B674,  Status:  2200,  Vector:  0010     sp+00:  2200 0118 B674 0010 0129 0002 0118 B640     sp+10:  0118 12C9 0000 0007 0000 007F 0137 9E10     sp+20:  0118 1328 0118 12C9 0122 4A40 0137 9E28     sp+30:  0118 13EE 013A 5040 0000 0020 0122 0370     sp+40:  0129 2480 0137 9E60 0118 1908 013A 5040     sp+50:  0122 49D0 0000 0001 0000 0000 0129 1B0C     D0:  00000001, D1:  00000001, D2:  011812C9, D3:  01290002     D4:  00000139, D5:  00005400, D6:  00000001, D7:  00000300     A0:  013D63EE, A1:  01291E0C, A2:  01291700, A3:  013A5040     A4:  013A5040, A5:  01800000, A6:  01379E00, sp:  01379DE4 Module 2 FDDI Control Processor (FCP) Log:   Reset count:                591   Re-boot History:           Jun 13 1994 18:49:04, Jun 13 1994 14:17:29                              Jun 13 1994 14:09:17, Jun 13 1994 13:58:49                              Jun 10 1994 17:30:09, Jun 10 1994 16:21:42                              Jun 10 1994 16:08:24, Jun 10 1994 16:06:37                              Jun 10 1994 11:40:18, Jun 09 1994 17:44:06   Bootrom Checksum Failures:    2   UART Failures:             0   Flash Checksum Failures:      0   Flash Program Failures:    0   DRAM Failures:                0   Exceptions:                  36     Last Exception occurred on Jun 13 1994 13:58:33 ...     PC:  0118B674,  Status:  2200,  Vector:  0010     sp+00:  2200 0118 B674 0010 0129 0002 0118 B640     sp+10:  0118 12C9 0000 0007 0000 007F 0137 9E10     sp+20:  0118 1328 0118 12C9 0122 4A40 0137 9E28     sp+30:  0118 13EE 013A 5040 0000 0020 0122 0370     sp+40:  0129 2480 0137 9E60 0118 1908 013A 5040     sp+50:  0122 49D0 0000 0001 0000 0000 0129 1B0C     D0:  00000001, D1:  00000001, D2:  011812C9, D3:  01290002     D4:  00000139, D5:  00005400, D6:  00000001, D7:  00000300     A0:  013D63EE, A1:  01291E0C, A2:  01291700, A3:  013A5040     A4:  013A5040, A5:  01800000, A6:  01379E00, sp:  01379DE4 Module 2 Data Movement Processor (DMP) Log:   Flash Checksum Failures:      1   Flash Program Failures:    0   DRAM Failures:                0   SRAM Failures:             0   Exceptions:                  13     Last Exception occurred on Feb 04 1994 18:24:28 ...     pc:  B1000DEC, status:  20600010, cause:  80000230     r0:  00000000, at:  00000001, v0:  00000003, v1:  00000002     a0:  7FFFFFFC, a1:  0000000C, a2:  AE28DDF8, a3:  A8800260     t0:  00000001, t1:  0000000A, t2:  A3000000, t3:  00000000     t4:  0000000C, t5:  00000000, t6:  AE28D800, t7:  87106C82     s0:  A9010A48, s1:  00000000, s2:  81047758, s3:  00000010     s4:  8523EDFA, s5:  C7AD2FCB, s6:  7D09F464, s7:  4E7287A7     t8:  00000001, t9:  107E8210, k0:  80000230, k1:  AE3FFF70     gp:  810461E0, sp:  7FFFF4C8, s8:  00000000. ra:  BFC00C5C Console> (enable)

Related Command

clear log

show logging

Use the show logging command to display the system message log configuration.
show logging
Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows the default System Message Log configuration:

Console <enable> show logging Logging console: enabled Logging server: disabled Facility Server/Default Severity Current Session Severity -------- --------------------- ------------------------ cdp 2 2 cgmp 2 2 disl 5 5 earl 2 2 fddi 2 2 ip 2 2 pruning 2 2 snmp 2 2 spantree 2 2 sys 5 5 tac 2 2 0(emergencies) 1(alerts) 2(critical) 3(errors) 4(warnings) 5(notifications) 6(information) 7(debugging)

Related Commands

clear logging server
show logging buffer

show logging buffer

Use the show logging buffer command to display system messages from the internal buffer.
show logging {N | -N}
Syntax Description

N The number of messages to be displayed starting from the beginning of the buffer.
-N The number of messages to be displayed starting from the end of the buffer.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display system messages from the internal buffer in the Catalyst 5000 series switch.

Console <enable> show logging buffer 411/4/96,13:52:46:SYS-5:Module 1 is online 11/4/96,13:52:52:SYS-5:Module 5 is online 11/4/96,13:52:54:SYS-5:Module 3 failed due to CBL0, CBL1, or CBL2 Error 11/4/96,13:52:54:SYS-5:Module 3 failed configuration Console <enable> show logging buffer -411/4/96,13:52:54:SYS-5:Module 3 failed configuration 11/4/96,13:53:04:SYS-5:Module 4 is online 11/4/96,13:53:31:SNMP-6:Subagent 2 connected 11/4/96,13:54:45:SNMP-5:Cold Start Trap

Related Command

show logging

show mac

Use the show mac command to display MAC counters.
show mac
show mac mod_num
show mac mod_num/port_num
Syntax Description

mod_num The number of the module. If a number is not specified, all modules are shown.
port_num The number of the port on the module.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display MAC information:

Console> (enable) show mac MAC Rcv-Frms Xmit-Frms Rcv-Multi Xmit-Multi Rcv-Broad Xmit-Broad ------- ---------- ---------- ---------- ---------- ---------- ---------- 1/1 0 0 0 0 0 0 1/2 0 0 0 0 0 0 2/1 0 0 0 0 0 0 2/2 0 0 0 0 0 0 2/3 0 0 0 0 0 0 2/4 0 0 0 0 0 0 2/5 0 0 0 0 0 0 2/6 0 0 0 0 0 0 2/7 0 0 0 0 0 0 2/8 0 0 0 0 0 0 2/9 0 0 0 0 0 0 2/10 0 0 0 0 0 0 2/11 0 0 0 0 0 0 2/12 0 0 0 0 0 0 2/13 0 0 0 0 0 0 2/14 0 0 0 0 0 0 2/15 0 0 0 0 0 0 2/16 0 0 0 0 0 0 2/17 0 0 0 0 0 0 2/18 0 0 0 0 0 0 2/19 0 0 0 0 0 0 2/20 0 0 0 0 0 0 2/21 0 0 0 0 0 0 2/22 870865 70101 47507 70091 55755 0 2/23 0 0 0 0 0 0 2/24 0 0 0 0 0 0 4/1 0 2933 0 1007 0 1926 MAC Dely-Exced MTU-Exced In-Discard Lrn-Discrd In-Lost Out-Lost ------- ---------- ---------- ---------- ---------- ---------- ---------- 1/1 0 0 0 0 0 0 1/2 0 0 0 0 0 0 2/1 0 0 0 0 0 0 2/2 0 0 0 0 0 0 2/3 0 0 0 0 0 0 2/4 0 0 0 0 0 0 2/5 0 0 0 0 0 0 2/6 0 0 0 0 0 0 2/7 0 0 0 0 0 0 2/8 0 0 0 0 0 0 2/9 0 0 0 0 0 0 2/10 0 0 0 0 0 0 2/11 0 0 0 0 0 0 2/12 0 0 0 0 0 0 2/13 0 0 0 0 0 0 2/14 0 0 0 0 0 0 2/15 0 0 0 0 0 0 2/16 0 0 0 0 0 0 2/17 0 0 0 0 0 0 2/18 0 0 0 0 0 0 2/19 0 0 0 0 0 0 2/20 0 0 0 0 0 0 2/21 0 0 0 0 0 0 2/22 0 0 0 0 0 0 2/23 0 0 0 0 0 0 2/24 0 0 0 0 0 0 4/1 0 0 0 0 0 0 MAC SMT-Address Curr-Path TReq TNeg TMax TVX --- ----------------- ---------- -------- -------- -------- -------- 4/1 00:02:d0:0b:00:d4 isolated 3500 3500 165004 2509 MAC Upstream-Nbr Downstream-Nbr Old-Upstream-Nbr Old-Downstream-Nbr --- ----------------- ----------------- ----------------- ------------------ 4/1 00:00:1f:00:00:00 00:00:1f:00:00:00 00:00:1f:00:00:00 00:00:1f:00:00:00 MAC Rcv-Smt Xmit-Smt Rcv-llc Xmit-llc Tvx-Exp-Ct RingOp-Ct --- ---------- ---------- ---------- ---------- ---------- ---------- 4/1 0 1930 0 1003 0 4 Last-Time-Cleared -------------------------- Sun Aug 27 1995, 13:57:58 Console> (enable)

Related Command

clear counters

show module

Use the show module command to display module status and information.
show module
Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display module status and information:

Console> show module Mod Module-Name Ports Module-Type Model Serial-Num Status --- ------------------- ----- --------------------- -------- --------- ------- 1 Supervisor 2 100BaseTX Supervisor WS-X5009 002650014 ok 2 Management 24 10BaseT Ethernet WS-X5010 002475046 ok 4 Marketing 48 4 Segment 10BaseT Eth WS-X5020 002135955 ok Mod MAC-Address(es) Hw Fw Sw --- ---------------------------------------- ------ ------ ---------------- 1 00-40-0b-ac-80-00 thru 00-40-0b-ac-83-ff 1.6 1.4 2.113(Eng) 2 00-40-0b-4c-92-58 thru 00-40-0b-4c-92-6f 1.0 1.4 2.106 4 00-40-0b-14-00-20 thru 00-40-0b-14-00-23 0.1 1.4369 2.106 Mod SMT User-Data T-Notify CF-St ECM-St Bypass --- --------------------------- -------- -------- --------- ------- 4 Catalyst-5000 16 c-Wrap-B in absent Console>

Related Commands

set fddi userdata
set fddi tnotify
set module disable
set module enable
set module help
set module name

show multicast group

Use the show multicast group command to display the multicast group configuration.
show multicast group [cgmp] [mac_addr] [vlan_id]
Syntax Description

cgmp Keyword used to display only the information learned through Cisco Group Management Protocol (CGMP).
mac_addr The destination MAC address.
vlan_id The number of the VLAN.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following examples show how to display the multicast group configuration:

console> (enable) show multicast group cgmp 5CGMP enabled Vlan Destination MAC Destination Ports or VC's ---- ----------------- -------------------------- 5 01-00-5E-00-00-5C 3/1, 3/9 5 01-00-5E-00-00-FF 3/7, 3/9 console> (enable) show multicast group 01-00-5E-00-00-5C 5CGMP enabled Vlan Destination MAC Destination Ports or VC's ---- ----------------- ------------------------ 5 01-00-5E-00-00-5C 3/1, 3/9

Related Commands

set cgmp
set multicast router
clear multicast router
show multicast router

show multicast router

Use the show multicast router command to display which ports have CGMP-capable routers assigned to them.
show multicast router [cgmp] mod_num/port_num [vlan_id]
Syntax Description

cgmp Keyword used to display only the configuration information learned through Cisco Group Management Protocol (CGMP).
mod_num The number of the module.
port_num The number of the port on the module.
vlan_id The number of the VLAN.

Default

There is no default setting for this command.

Command Type

Switch command.

Command Mode

Privileged.

Examples

The following examples show how to display the multicast router configuration:

Console> (enable) show multicast router 4/9CGMP enabled Port Vlan ----- ----------------------- 4/9 1,5,200-203 Total Number of Entries = 1 console> (enable) show multicast router 5CGMP enabled Port Vlan ----- ----------------------- 3/1 5 4/9 5 Total Number of Entries = 2 console> (enable) show multicast router cgmp 5CGMP enabled Port Vlan ----- ----------------------- 4/9 5 Total Number of Entries = 1

Related Commands

set cgmp
set multicast router
clear multicast router
show multicast group

show netstat

Use the show netstat command to display statistics for the various protocols in the TCP/IP protocol stack. This command is also used to display the state of network connections currently active on the system.
show netstat [stats | tcp | udp | ip | icmp | interfaces | routes]
Syntax Description

stats (Optional) Keyword used to show TCP, UDP, IP, and ICMP statistics.
tcp (Optional) Keyword used to show TCP statistics.
udp (Optional) Keyword used to show UDP statistics.
ip (Optional) Keyword used to show IP statistics.
icmp (Optional) Keyword used to show ICMP statistics.
interfaces (Optional) Keyword used to show interface statistics.
routes (Optional) Keyword used to show the IP routing table.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Examples

The following example shows how to display default (TCP and UDP) statistics:

Console> show netstat Active Internet connections (including servers) Proto Recv-Q Send-Q Local Address Foreign Address (State) tcp 0 128 192.122.174.221.23 192.122.174.40.1064 ESTABLISHED tcp 0 0 *.23 *.* LISTEN udp 0 0 *.161 *.* Console>

The following example shows how to display TCP statistics:

Console> (enable) show netstat tcp tcp: 619 packets sent 586 data packets (33863 bytes) 16 data packets (2133 bytes) retransmitted 17 ack-only packets (11 delayed) 0 URG only packets 0 window probe packets 0 window update packets 0 control packets 806 packets received 595 acks (for 34475 bytes) 5 duplicate acks 0 acks for unsent data 329 packets (1082 bytes) received in-sequence 0 completely duplicate packets (0 bytes) 1 packet with some dup. data (1 byte duped) 3 out-of-order packets (0 bytes) 0 packets (0 bytes) of data after window 0 window probes 3 window update packets 0 packets received after close 0 discarded for bad checksums 0 discarded for bad header offset fields 0 discarded because packet too short 0 connection requests 4 connection accepts 4 connections established (including accepts) 3 connections closed (including 0 drops) 0 embryonic connections dropped 577 segments updated rtt (of 592 attempts) 13 retransmit timeouts 0 connections dropped by rexmit timeout 0 persist timeouts 0 keepalive timeouts 0 keepalive probes sent 0 connections dropped by keepalive Console> (enable)

The following example shows how to display UDP statistics:

Console> show netstat udp udp: 0 incomplete headers 0 bad data length fields 0 bad checksums 0 socket overflows 1116 no such ports Console>

The following example shows how to display IP statistics:

Console> show netstat ip ip: 957 total packets received 0 bad header checksums 0 with size smaller than minimum 0 with data size < data length 0 with header length < data size 0 with data length < header length 0 fragments received 0 fragments dropped (dup or out of space) 0 fragments dropped after timeout 0 packets forwarded 376 packets not forwardable 0 redirects sent Console>

The following example shows how to display ICMP statistics:

Console> show netstat icmp icmp: Redirect enabled 0 calls to icmp_error 0 errors not generated 'cuz old message was icmp 0 messages with bad code fields 0 messages < minimum length 0 bad checksums 0 messages with bad length 0 message responses generated Console>

The following example shows how to display the IP routing table:

Console> show netstat routes DESTINATION GATEWAY FLAGS USE INTERFACE 0.0.0.0 192.122.174.40 UG 13 sc0 192.122.174.0 192.122.174.221 U 457 sc0 Console>

The following example shows how to display interface statistics:

Console> show netstat interface Interface InPackets InErrors OutPackets OutErrors sl0 0 0 0 0 sc0 599 0 74 0 Console>

Related Commands

set ip help
set ip route
set interface

show ntp

Use the show ntp command to display the current NTP status.
show ntp
Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the current NTP status:

Console> show ntp Broadcast client mode: disabled Broadcast delay: 4000 microseconds Client mode: enabled Server 172.20.22.191 172.20.22.192 172.20.22.193 Timezone: "PST", offset from UTC is -8 hours Summertime: "PDT", enabled

Related Commands

clear ntp server
set ntp broadcastclient
set ntp broadcastdelay
set ntp client
set ntp server

show port

Use the show port command to display port status and counters.
show port
show port mod_num
show port mod_num/port_num
Syntax Description

mod_num The number of the module.
port_num The number of the port on the module.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the status and counters for all ports on module 4:

Console> (enable) show port Port Name Status Vlan Level Duplex Speed Type ---- -------------------- ---------- ---------- ------ ------ ----- -------------- 1/1 Fred Flintstone connected trunk normal half 100 100BaseTX 1/2 notconnect 1 normal half 100 100BaseTX 2/1 notconnect 1 normal half 10 10BaseT 2/2 inactive 3 normal half 10 10BaseT 2/3 notconnect 2 normal half 10 10BaseT 2/4 notconnect 2 normal half 10 10BaseT 2/5 notconnect 2 normal half 10 10BaseT 2/6 notconnect 2 normal half 10 10BaseT 2/7 notconnect 2 normal half 10 10BaseT 2/8 notconnect 1 normal half 10 10BaseT 2/9 notconnect 1 normal half 10 10BaseT 2/10 notconnect 1 normal half 10 10BaseT 2/11 notconnect 1 normal half 10 10BaseT 2/12 notconnect 1 normal half 10 10BaseT 2/13 notconnect 1 normal half 10 10BaseT 2/14 notconnect 1 normal half 10 10BaseT 2/15 notconnect 1 normal half 10 10BaseT 2/16 notconnect 1 normal half 10 10BaseT 2/17 notconnect 1 normal half 10 10BaseT 2/18 notconnect 1 normal half 10 10BaseT 2/19 notconnect 1 normal half 10 10BaseT 2/20 notconnect 1 normal half 10 10BaseT 2/21 notconnect 1 normal half 10 10BaseT 2/22 notconnect 1 normal half 10 10BaseT 2/23 notconnect 1 normal half 10 10BaseT 2/24 notconnect 1 normal half 10 10BaseT 4/1 notconnect 1 normal half 10 10BaseT 4/2 notconnect 1 normal half 10 10BaseT 4/3 notconnect 1 normal half 10 10BaseT 4/4 notconnect 1 normal half 10 10BaseT 4/5 notconnect 1 normal half 10 10BaseT 4/6 notconnect 1 normal half 10 10BaseT 4/7 notconnect 1 normal half 10 10BaseT 4/8 notconnect 1 normal half 10 10BaseT 4/9 notconnect 1 normal half 10 10BaseT 4/10 notconnect 1 normal half 10 10BaseT 4/11 notconnect 1 normal half 10 10BaseT 4/12 notconnect 1 normal half 10 10BaseT 4/13 notconnect 1 normal half 10 10BaseT 4/14 notconnect 1 normal half 10 10BaseT 4/15 notconnect 1 normal half 10 10BaseT 4/16 notconnect 1 normal half 10 10BaseT 4/17 notconnect 1 normal half 10 10BaseT 4/18 notconnect 1 normal half 10 10BaseT 4/19 notconnect 1 normal half 10 10BaseT 4/20 notconnect 1 normal half 10 10BaseT 4/21 notconnect 1 normal half 10 10BaseT 4/22 notconnect 1 normal half 10 10BaseT 4/23 notconnect 1 normal half 10 10BaseT 4/24 notconnect 1 normal half 10 10BaseT 4/25 inactive 3 normal half 10 10BaseT 4/26 inactive 3 normal half 10 10BaseT 4/27 inactive 3 normal half 10 10BaseT 4/28 inactive 3 normal half 10 10BaseT 4/29 inactive 3 normal half 10 10BaseT 4/30 inactive 3 normal half 10 10BaseT 4/31 inactive 3 normal half 10 10BaseT 4/32 inactive 3 normal half 10 10BaseT 4/33 inactive 3 normal half 10 10BaseT 4/34 inactive 3 normal half 10 10BaseT 4/35 inactive 3 normal half 10 10BaseT 4/36 inactive 3 normal half 10 10BaseT 4/37 notconnect 1 normal half 10 10BaseT 4/38 notconnect 1 normal half 10 10BaseT 4/39 notconnect 1 normal half 10 10BaseT 4/40 notconnect 1 normal half 10 10BaseT 4/41 notconnect 1 normal half 10 10BaseT 4/42 notconnect 1 normal half 10 10BaseT 4/43 notconnect 1 normal half 10 10BaseT 4/44 notconnect 1 normal half 10 10BaseT 4/45 notconnect 1 normal half 10 10BaseT 4/46 notconnect 1 normal half 10 10BaseT 4/47 notconnect 1 normal half 10 10BaseT 4/48 notconnect 1 normal half 10 10BaseT Port Align-Err FCS-Err Xmit-Err Rcv-Err ---- ---------- ---------- ---------- ---------- 1/1 0 0 0 0 1/2 0 0 0 0 2/1 0 0 0 0 2/2 0 0 0 0 2/3 0 0 0 0 2/4 0 0 0 0 2/5 0 0 0 0 2/6 0 0 0 0 2/7 0 0 0 0 2/8 0 0 0 0 2/9 0 0 0 0 2/10 0 0 0 0 2/11 0 0 0 0 2/12 0 0 0 0 2/13 0 0 0 0 2/14 0 0 0 0 2/15 0 0 0 0 2/16 0 0 0 0 2/17 0 0 0 0 2/18 0 0 0 0 2/19 0 0 0 0 2/20 0 0 0 0 2/21 0 0 0 0 2/22 0 0 0 0 2/23 0 0 0 0 2/24 0 0 0 0 Port Single-Col Multi-Coll Late-Coll Excess-Col Carri-Sens Runts Giants ---- ---------- ---------- ---------- ---------- ---------- --------- --------- 1/1 0 0 0 0 0 0 - 1/2 0 0 0 0 0 0 - 2/1 0 0 0 0 0 0 0 2/2 0 0 0 0 0 0 0 2/3 0 0 0 0 0 0 0 2/4 0 0 0 0 0 0 0 2/5 0 0 0 0 0 0 0 2/6 0 0 0 0 0 0 0 2/7 0 0 0 0 0 0 0 2/8 0 0 0 0 0 0 0 2/9 0 0 0 0 0 0 0 2/10 0 0 0 0 0 0 0 2/11 0 0 0 0 0 0 0 2/12 0 0 0 0 0 0 0 2/13 0 0 0 0 0 0 0 2/14 0 0 0 0 0 0 0 2/15 0 0 0 0 0 0 0 2/16 0 0 0 0 0 0 0 2/17 0 0 0 0 0 0 0 2/18 0 0 0 0 0 0 0 2/19 0 0 0 0 0 0 0 2/20 0 0 0 0 0 0 0 2/21 0 0 0 0 0 0 0 2/22 0 0 0 0 0 0 0 2/23 0 0 0 0 0 0 0 2/24 0 0 0 0 0 0 0 Port Auto-Parts Giants Data-Rate FCS-Err Runts Rcv-frms Src-Addr Mismatch Changes ---- ---------- ---------- ---------- ---------- ---------- ---------- -------- 4/1 0 0 0 0 0 0 0 4/2 0 0 0 0 0 0 0 4/3 0 0 0 0 0 0 0 4/4 0 0 0 0 0 0 0 4/5 0 0 0 0 0 0 0 4/6 0 0 0 0 0 0 0 4/7 0 0 0 0 0 0 0 4/8 0 0 0 0 0 0 0 4/9 0 0 0 0 0 0 0 4/10 0 0 0 0 0 0 0 4/11 0 0 0 0 0 0 0 4/12 0 0 0 0 0 0 0 4/13 0 0 0 0 0 0 0 4/14 0 0 0 0 0 0 0 4/15 0 0 0 0 0 0 0 4/16 0 0 0 0 0 0 0 4/17 0 0 0 0 0 0 0 4/18 0 0 0 0 0 0 0 4/19 0 0 0 0 0 0 0 4/20 0 0 0 0 0 0 0 4/21 0 0 0 0 0 0 0 4/22 0 0 0 0 0 0 0 4/23 0 0 0 0 0 0 0 4/24 0 0 0 0 0 0 0 4/25 0 0 0 0 0 0 0 4/26 0 0 0 0 0 0 0 4/27 0 0 0 0 0 0 0 4/28 0 0 0 0 0 0 0 4/29 0 0 0 0 0 0 0 4/30 0 0 0 0 0 0 0 4/31 0 0 0 0 0 0 0 4/32 0 0 0 0 0 0 0 4/33 0 0 0 0 0 0 0 4/34 0 0 0 0 0 0 0 4/35 0 0 0 0 0 0 0 4/36 0 0 0 0 0 0 0 4/37 0 0 0 0 0 0 0 4/38 0 0 0 0 0 0 0 4/39 0 0 0 0 0 0 0 4/40 0 0 0 0 0 0 0 4/41 0 0 0 0 0 0 0 4/42 0 0 0 0 0 0 0 4/42 0 0 0 0 0 0 0 4/43 0 0 0 0 0 0 0 4/44 0 0 0 0 0 0 0 4/45 0 0 0 0 0 0 0 4/46 0 0 0 0 0 0 0 4/47 0 0 0 0 0 0 0 4/48 0 0 0 0 0 0 0 Port Rcv-Multi Rcv-Broad Good-Bytes Align-Err Short-Evnt Late-Coll Collision ---- ---------- ---------- ---------- ---------- ---------- --------- --------- 4/1 0 0 0 0 0 0 0 4/2 0 0 0 0 0 0 0 4/3 0 0 0 0 0 0 0 4/4 0 0 0 0 0 0 0 4/5 0 0 0 0 0 0 0 4/6 0 0 0 0 0 0 0 4/7 0 0 0 0 0 0 0 4/8 0 0 0 0 0 0 0 4/9 0 0 0 0 0 0 0 4/10 0 0 0 0 0 0 0 4/11 0 0 0 0 0 0 0 4/12 0 0 0 0 0 0 0 4/13 0 0 0 0 0 0 0 4/13 0 0 0 0 0 0 0 4/14 0 0 0 0 0 0 0 4/15 0 0 0 0 0 0 0 4/16 0 0 0 0 0 0 0 4/17 0 0 0 0 0 0 0 4/18 0 0 0 0 0 0 0 4/19 0 0 0 0 0 0 0 4/20 0 0 0 0 0 0 0 4/21 0 0 0 0 0 0 0 4/22 0 0 0 0 0 0 0 4/23 0 0 0 0 0 0 0 4/24 0 0 0 0 0 0 0 4/25 0 0 0 0 0 0 0 4/26 0 0 0 0 0 0 0 4/27 0 0 0 0 0 0 0 4/28 0 0 0 0 0 0 0 4/29 0 0 0 0 0 0 0 4/30 0 0 0 0 0 0 0 4/31 0 0 0 0 0 0 0 4/32 0 0 0 0 0 0 0 4/33 0 0 0 0 0 0 0 4/34 0 0 0 0 0 0 0 4/35 0 0 0 0 0 0 0 4/36 0 0 0 0 0 0 0 4/37 0 0 0 0 0 0 0 4/38 0 0 0 0 0 0 0 4/39 0 0 0 0 0 0 0 4/40 0 0 0 0 0 0 0 4/41 0 0 0 0 0 0 0 4/42 0 0 0 0 0 0 0 4/43 0 0 0 0 0 0 0 4/44 0 0 0 0 0 0 0 4/45 0 0 0 0 0 0 0 4/46 0 0 0 0 0 0 0 4/47 0 0 0 0 0 0 0 4/48 0 0 0 0 0 0 0 Last-Time-Cleared -------------------------- Mon May 20 1996, 11:32:28 Console> (enable)

Related Commands

clear counters
set port disable
set port enable
set port level
set port name
set vlan

show snmp

Use the show snmp command to display the SNMP information.
show snmp [noalias]
Syntax Description

noalias (Optional) Keyword used to indicate not to display the IP alias, only the IP address.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal and privileged.

Usage Guideline

If noalias is specified, IP aliases are not displayed; otherwise, IP addresses are shown.

Examples

The following example shows how to display the community strings in normal mode:

Console> show snmp RMON: Enabled Traps Enabled: Chassis Port Traps Enabled: None Community-Access Community-String ---------------- -------------------- read-only public Trap-Rec-Address Trap-Rec-Community ---------------- -------------------- 192.122.173.42 public Console>

The following example shows how to display the community strings in privileged mode:

Console> (enable) show snmp show snmp RMON: Enabled Traps Enabled: Chassis Port Traps Enabled: None Community-Access Community-String ---------------- -------------------- read-only public Trap-Rec-Address Trap-Rec-Community ---------------- -------------------- 192.122.173.42 public Console> (enable)

Related Commands

set snmp community
set snmp help
set snmp rmon
set snmp trap

show span

Use the show span command to display switched port analyzer information.
show span
Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guideline

The Switched Port Analyzer analyzes the traffic through a switch port in the system. It also analyzes the traffic of a particular VLAN through all switch ports in the system.

Example

The following example shows how to display port monitoring information.

Console> show span Source Destination Direction Status ------------ ------------ ---------------- -------- Port 2/3 Port 2/4 transmit enabled Console>

Related Commands

clear config
set span

show spantree

Use the show spantree command to display spanning-tree information for a VLAN.
show spantree vlan]
show spantree mod_num/port_num
Syntax Description

vlan (Optional) The number of the VLAN. If the VLAN number is not specified, the default is VLAN 1.
mod_num The number of the module.
port_num The number of the port on the module.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Examples

The following example shows how to display the spantree syntax structure and options:

Console> show spantree ? Usage: show spantree [vlan] show spantree <mod_num/port_num>

The following example shows how to display the spantree configuration:

Console> (enable) show spantree 1 VLAN 1 Spanning tree enabled Designated Root 00-1f-00-40-0b-90-c9-00 Designated Root Priority 45 Designated Root Cost 0 Designated Root Port 1/0 Root Max Age 20 sec Hello Time 2 sec Forward Delay 20 sec Bridge ID MAC ADDR 00-40-0b-90-c9-00 Bridge ID Priority 45 Bridge Max Age 20 sec Hello Time 2 sec Forward Delay 20 sec Port Vlan Port-State Cost Priority Fast-Start -------- ---- ------------- ----- -------- ---------- 1/1 1 forwarding 10 32 disabled 2/3 1 not-connected 100 32 disabled 2/4 1 not-connected 100 32 disabled 2/5 1 not-connected 100 32 disabled 2/6 1 not-connected 100 32 disabled 2/7 1 not-connected 100 32 disabled 2/8 1 forwarding 100 32 disabled 2/9 1 not-connected 100 32 disabled 2/10 1 not-connected 100 32 disabled 2/11 1 not-connected 100 32 disabled 2/12 1 not-connected 100 32 disabled 2/13 1 Learning 100 32 disabled 2/14 1 not-connected 100 32 disabled 2/15 1 not-connected 100 32 disabled 2/16 1 not-connected 100 32 disabled 2/17 1 not-connected 100 32 disabled 2/18 1 not-connected 100 32 disabled 2/19 1 not-connected 100 32 disabled 2/20 1 not-connected 100 32 disabled 2/21 1 not-connected 100 32 disabled 2/22 1 not-connected 100 32 disabled 2/23 1 not-connected 100 32 disabled 2/24 1 not-connected 100 32 disabled 4/13-24 1 not-connected 100 32 disabled 4/25-36 1 not-connected 100 32 disabled 4/37-48 1 not-connected 100 32 disabled Console> (enable)

The following example shows how to display the spantree configuration for module 1, ports 1 and 2, and module 2, ports 1 through 4:

Console> show spantree 1/1-2,2/1-4 Port Vlan Port-State Cost Priority Fast-Start -------- ---- ------------- ----- -------- ---------- 1/1 1 forwarding 10 32 disabled 1/1 3 forwarding 10 32 disabled 1/1 44 forwarding 10 32 disabled 1/1 55 forwarding 10 32 disabled 1/1 66 not-connected 10 32 disabled 1/1 77 forwarding 10 32 disabled 1/1 88 not-connected 10 32 disabled 1/1 99 not-connected 10 32 disabled 1/2 1000 inactive 10 32 disabled 2/1 1000 inactive 100 32 disabled 2/2 1000 inactive 100 32 disabled 2/3 1 not-connected 100 32 disabled 2/4 1 not-connected 100 32 disabled Console>

Related Commands

set spantree disable
set spantree enable
set spantree fwddelay
set spantree hello
set spantree maxage
set spantree portcost
set spantree portpri
set spantree priority

show sscop

Use the show sscop privileged EXEC command to show Service-Specific Connection Oriented Protocol (SSCOP) details for all ATM interfaces.
show sscop
Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS ATM command.

Command Mode

Privileged EXEC.

Example

The following is sample output from the show sscop command:

synergy atm interface# show sscop SSCOP details for interface 0 Current State = Data Transfer Ready Send Sequence Number: Current = 2, Maximum = 9 Send Sequence Number Acked = 3 Rcv Sequence Number: Lower Edge = 2, Upper Edge = 2, Max = 9 Poll Sequence Number = 1876, Poll Ack Sequence Number = 2 Vt(Pd) = 0    Connection Control: timer = 1000 Timer currently Inactive Keep Alive Timer = 30000 Current Retry Count = 0, Maximum Retry Count = 10       Statistics - Pdu's Sent = 0, Pdu's Received = 0, Pdu's Ignored = 0 Begin = 0/1, Begin Ack = 1/0, Begin Reject = 0/0 End = 0/0, End Ack = 0/0 Resync = 0/0, Resync Ack = 0/0 Sequenced Data = 2/0, Sequenced Poll Data = 0/0 Poll = 1591/1876, Stat = 0/1591, Unsolicited Stat = 0/0 Unassured Data = 0/0, Mgmt Data = 0/0, Unknown Pdu's = 0

Table 3-12 describes the fields shown in the display. Interpreting this output requires a thorough understanding of SSCOP; it is usually displayed by Cisco technicians to help diagnose network problems.

Table 3-12: show sscop Command Field Descriptions
Field Description
SSCOP details for interface Interface slot and port.
Current State SSCOP state for the interface.
Send Sequence Number Current and maximum send sequence number.
Send Sequence Number Acked Sequence number of packets already acknowledged.
Rcv Sequence Number Sequence number of packets received.
Poll Sequence Number Current poll sequence number.
Poll Ack Sequence Number Poll sequence number already acknowledged.
Vt(Pd) Number of Pd frames sent which triggers a sending of a Poll frame.
Connection Control Timer used for establishing and terminating SSCOP.
Keep Alive Timer Timer used to send keepalives on an idle link.
Current Retry Count Current count of the retry counter.
Maximum Retry Count Maximum value the retry counter can take.
Pdu's Sent Total number of SSCOP frames sent.
Pdu's Received Total number of SSCOP frames received.
Pdu's Ignored Number of invalid SSCOP frames ignored.
Begin Number of Begin frames sent/received.
Begin Ack Number of Begin Ack frames sent/received.
Begin Reject Number of Begin Reject frames sent/received.
End Number of End frames sent/received.
End Ack Number of End Ack frames sent/received.
Resync Number of Resync frames sent/received.
Resync Ack Number of Resync Ack frames sent/received.
Sequenced Data Number of Sequenced Data frames sent/received.
Sequenced Poll Data Number of Sequenced Poll Data frames sent/received.
Poll Number of Poll frames sent/received.
Stat Number of Stat frames sent/received.
Unsolicited Stat Number of Unsolicited Stat frames sent/received.
Unassured Data Number of Unassured Data frames sent/received.
Mgmt Data Number of Mgmt Data frames sent/received.
Unknown Pdu's Number of Unknown SSCOP frames sent/received.

show summertime

Use the show summertime command to display the current status of the summertime feature.
show summertime
Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the current status of the summertime feature:

Console> show summertime
Summertime is enabled and set to "PDT". Console>
Related Command

set summertime

show system

Use the show system command to display the power supply, fan, temperature alarm, system, and modem status; the number of days, hours, minutes, and seconds since the last system restart; the baud rate; the MAC address range; and the system name, location, and contact.
show system
Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows the system status and other information:

Console> show system PS1-Status PS2-Status Fan-Status Temp-Alarm Sys-Status Uptime d,h:m:s Logout ---------- ---------- ---------- ---------- ---------- -------------- --------- ok none ok off ok 1,01:24:18 none PS1-Type PS2-Type Modem Baud Traffic Peak Peak-Time ---------- ---------- ------- ----- ------- ---- ------------------------- WS-C5008 none disable 9600 0% 0% Thu Mar 7 1996, 21:38:14 System Name System Location System Contact ------------------------ ------------------------ ------------------------ Abu-Catalyst-5000 5 Closet 202 1/F Jeff x2529

Related Commands

set system baud
set system contact
set system location
set system modem
set system name

show tacacs

Use the show tacacs command to display the TACACS+ protocol configuration.
show tacacs
Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to display the TACACS+ protocol configuration:

Console> (enable) show tacacs login authentication tacacs: enabled login authentication local: disabled enable authentication tacacs: enabled enable authentication local: disabled tacacs-server hosts: 192.20.22.7 tacacs-server key: Who Goes There tacacs-server login attempts: 3 tacacs-server timeout: 5 seconds tacacs-server directed-request: disabled

Related Commands

set tacacs attempts
set tacacs directedrequest
set tacacs server
set tacacs key
set tacacs timeout

show test

Use the show test command to display the results of diagnostic tests.
show test mod_num
Syntax Description

mod_num The number of the module. If no number is specified, module 1 is used.

Default

This command has no default setting.

Command Mode

Privileged.

Usage Guidelines

The Network Management Protocol only applies to module 1; therefore, only the display for module 1 includes the NMP status. If other modules are specified, the NMP status is not displayed.

Example

The following example shows how to display the test results for all tested modules:

Console> (enable) show test Network Management Processor (NMP) Status: (. = Pass, F = Fail, U = Unknown) ROM: . RAM: . DUART: . Flash-EEPROM: . Ser-EEPROM: . NVRAM: . FAN . Temperature: . MCP Comm: . PS (3.3V): . PS (12V): . PS (24V): . 8051 Diag Status for Module 1 (. = Pass, F = Fail, N = N/A) CPU : . Ext Ram 0: . Ext Ram 1: . Ext Ram 2: N DPRAM : . LTL Ram 0: . LTL Ram 1: N LTL Ram 2: N BootChecksum: . CBL Ram 0: . CBL Ram 1: N CBL Ram 2: N Saints : . Pkt Bufs : . Repeaters: N Sprom : . SAINT/SAGE Status : Ports 1 2 3 -------------- . . .

Packet Buffer Status : Ports 1 2 3 -------------- . . . System Diagnostic Status : (. = Pass, F = Fail, N = N/A) Module 1 : MCP EARL Status : NewLearnTest: . IndexLearnTest: . DontForwardTest: . MonitorTest . DontLearn: . FlushPacket: . ConditionalLearn: . EarlLearnDiscard: . PMD Loopback Status : Ports 1 2 3 -------------- . . . Console> (enable) Console> (enable) show test 3 Module 3 : ATM Module Status: (. = Pass, F = Fail) ATM Control Processor (ACP) Status: ROM Chksum: . DRAM: . FLASH: . FLASH Chksum: . DPRAM: . NVRAM: . TxSAR RAM: . RxSAR RAM: . PMD SPROM: . FRAME BUFFER: . TxSAR COMM:. RxSAR COMM: . SAR Loopback: . . . . RxSAR Status: 2nd Port RAM: . FRAME BUFFER: . VCR DMA: . BIGA ACC: . TxSAR Status: 2nd Port RAM: . FRAME BUFFER: . VCR DMA: . BIGA ACC: . CAM: . . . . 8051 Diag Status for Module 3 (. = Pass, F = Fail, N = N/A) CPU : . Ext Ram 0: . Ext Ram 1: . Ext Ram 2: N DPRAM : . LTL Ram 0: . LTL Ram 1: N LTL Ram 2: N BootChecksum: . CBL Ram 0: . CBL Ram 1: N CBL Ram 2: N Saints : . Pkt Bufs : . Repeaters: N Sprom : . SAINT/SAGE Status : Ports 1 -------- . Packet Buffer Status : Ports 1 -------- . System Diagnostic Status : (. = Pass, F = Fail, N = N/A) Module 3 : ATM Line Card removed Console> (enable) Console> (enable) show test 4 Module 4 : FDDI Module Status: (. = Pass, F = Fail, U = Unknown) FDDI Control Processor (FCP) Status: ROM: . RAM: . Flash-EEPROM: . Dpram: . Switch Memory Status: RAM: . Cache-SRAM: . DmpCom: . Loadgen: . FDDI Status: Port A Access: . Port B Access: . Port A Loopback: . Port B Loopback: . MAC Access: . MAC Buffer R/W: . MAC Internal LB: . MAC External LB: . CAM: . . . . . . . . . . . . . . . . Data Movement Processor (DMP) Status: Flash-EEPROM: . RAM: . SRAM: . COMM: . Switch Memory Status: RAM: . Cache-SRAM: . DmpCom: . Loadgen: . FDDI Status: MAC Access: . MAC Buffer R/W: . MAC Internal LB: . MAC External LB: . LoadGen:. FBIGA Access: . FBIGA->MAC Buffer R/W: . FBIGA->MAC TxDMA: . FBIGA->MAC RxDMA: . FBIGA->MAC Internal LB:. FBIGA->MAC External LB:. LoadGen:. Bus Interface Status: SBIGA Access: . SBIGA->SAGE RxDMA: . SBIGA<-SAGE TxDMA:. 8051 Diag Status for Module 4 (. = Pass, F = Fail, N = N/A) CPU : . Ext Ram 0: . Ext Ram 1: . Ext Ram 2: N DPRAM : . LTL Ram 0: . LTL Ram 1: N LTL Ram 2: N BootChecksum: . CBL Ram 0: . CBL Ram 1: N CBL Ram 2: N Saints : . Pkt Bufs : . Repeaters: N Sprom : . SAINT/SAGE Status : Ports 1 -------- . Packet Buffer Status : Ports 1 -------- . System Diagnostic Status : (. = Pass, F = Fail, N = N/A) Module 4 :FDDI Line Card FDDI Line Card 1 Port Ports External Loopback Status Ports 1 -------- . Console> (enable) Console> (enable) show test 5 Repeater Port Status: Ports: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 ------------------------------------------------------------------------------ . . . . . . . . . . . . . . . . . . . . . . . . Ports: 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 ------------------------------------------------------------------------------ . . . . . . . . . . . . . . . . . . . . . . . . 8051 Diag Status for Module 3 (. = Pass, F = Fail, N = N/A) CPU : . Ext Ram 0: . Ext Ram 1: . Ext Ram 2: . DPRAM : N LTL Ram 0: . LTL Ram 1: N LTL Ram 2: N BootChecksum: . CBL Ram 0: N CBL Ram 1: N CBL Ram 2: N Saints : . Pkt Bufs : . Repeaters: . Sprom : . SAINT/SAGE Status : Saints 1 2 3 4 ----------------- . . . . Packet Buffer Status : Saints 1 2 3 4 ----------------- . . . . System Diagnostic Status : (. = Pass, F = Fail, N = N/A) Module 3 : LCP Repeater Card SAINT External Loopback Status : SAINTs 1 2 3 4 ----------------- . . . . Console> (enable)

show time

Use the show time command to display the current time of day in the system clock.
show time
Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the current time:

Console> show time Wed Feb 22 1995, 18:32:36 Console>

Related Command

set time

show timezone

Use the show timezone command to display the current time zone and offset.
show timezone
Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the current time zone and offset:

Console> show timezone
Timezone set to "PST", offset from UTC is -8 hours. Console>
Related Commands

clear timezone
set timezone

show trunk

Use the show trunk command to display Inter-Switch Link (ISL), 802.10/FDDI, and ATM information, including whether a trunk port is in trunking or nontrunking mode, the number of allowed VLANs, and the number of active VLANs.
show trunk
Syntax Description

This command has no arguments or keywords.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

To show the VLAN status for specified trunk ports on the device, enter the show trunk command. After entering this command, you see the following example screen for port 2/2:
Console> (enable) show trunk 2/2 Port Mode Status -------- --------- ------------ 2/2 on trunking Port Vlans allowed on trunk -------- ----------------------------------------------- 2/2 1-1000 Port Vlans allowed and active in management domain -------- ----------------------------------------------- 2/2 1,10,20,30,40,50,100 Port Vlans supported on trunk after pruning -------- -------------------------------------------------- 2/2 1,40,50
Related Commands

set tacacs server
set trunk

show users

The show users command shows if the console port is active or not and lists all active Telnet sessions with the IP address or IP alias of the originating host.
show users [noalias]
Syntax Description

noalias (Optional) Keyword used to indicate, not to display, the IP alias; the IP address is displayed.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the users of the active Telnet sessions:

Console> show users Console Port ------------ Active Telnet Sessions --------------- mercury 199.132.34.7 Console>

Related Command

disconnect

show version-ATM Command

Use the show version EXEC command to display the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images.
show version
Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS LAN Emulation.

Command Mode

EXEC.

Example

The following is sample output from the show version command:

ATM> show version Cisco Internetwork Operating System Software IOS (tm) cisco Software, Version 11.0(3340) [integ 103] Copyright (c) 1986-1995 by cisco Systems, Inc. Compiled Tue 29-Aug-95 14:36 Image text-base: 0x40010000, data-base: 0x401843F0 ROM: System Bootstrap, Version 4.4(1023), SOFTWARE ATM uptime is 42 minutes System restarted by power-on Running default software cisco SYNALC (68360) processor (revision 0x00) with 1059840K/512K bytes of memory. Processor board serial number 01244583 1 Ethernet/IEEE 802.3 interface. 1 ATM network interface. 127K bytes of non-volatile configuration memory. Configuration register is 0x1900 ATM>

Table 3-13 describes significant fields shown in the display.

Table 3-13: show version Field Descriptions
Field Description
IOS Software, Version X.X Always specify the complete version number when reporting a possible software problem.
System Bootstrap, Version Bootstrap version string.
ATM Module uptime is N minutes Amount of time the system has been up and running.
System restarted by power-on Log of how the system was last booted, both as a result of normal system startup and of system error. For example, information can be displayed to indicate a bus error that is generally the result of an attempt to access a nonexistent address, as follows:
System restarted by bus error at PC 0xC4CA, address 0x210C0C0

Running default software If the software was booted over the network, the Internet address of the boot host is shown. If the software was loaded from onboard ROM, this line reads "running default software." In addition, the names and sources of the host and network configuration files are shown.
cisco.... The remaining output shows the hardware configuration and any nonstandard software options. The configuration register contents are displayed in hexadecimal notation.
The output of the show version EXEC command can also provide certain messages, such as bus error messages. If such error messages appear, report the complete text of this message to your technical support specialist.

show version -Switch Command

Use the show version command to display software and hardware version information.
show version
Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guideline

The show version command is used for switching and supervisor modules only.

Example

The following example shows how to display the software and hardware versions:

Console> (enable) show version WS-C5000 Software, Version McpSW: 2.106 NmpSW: 2.113(Eng) Copyright (c) 1995,1996 by Cisco Systems NMP S/W compiled on Mar 5 1996, 17:20:56 MCP S/W compiled on Feb 13 1996, 11:35:40 System Bootstrap Version: 1.4 Hardware Version: 1.6 Model: WS-X5009 Serial #: 002650014 Module Ports Model Serial # Hw Fw Fw1 Sw ------ ----- ---------- --------- ------ ------ ------ -------------------- 1 2 WS-X5009 002650014 1.6 1.4 1.4 2.113(Eng) 2 24 WS-X5010 002475046 1.0 1.4 2.106 4 48 WS-X5020 002135955 0.1 1.4369 2.106 8191K bytes of DRAM memory. 4096K bytes of FLASH memory. 128K bytes of non-volatile configuration memory. Uptime is 1 day, 4 hours, 12 minutes Console> (enable)

show vlan

Use the show vlan command to display virtual LAN information.
show vlan [trunk]
show vlan vlan [notrunk]
Syntax Description

trunk (Optional) Keyword used to display trunk ports.
vlan The number of the VLAN to display.
notrunk (Optional) Keyword used to not display trunk ports.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guideline

Each Ethernet switch port and Ethernet repeater group belongs to only one VLAN. Trunk, FDDI/CDDI, and ATM ports can be on multiple VLANs. To display trunk ports, enter the show vlan [trunk] command.

Example

The following example shows how to display the ports assigned to all VLANs:

Console> (enable) show vlan VLAN Name Type Status Mod/Ports ---- -------------------------- ----- --------- ---------------- 1 default enet active 2/1-24 3/1-12 4/13-48 3 vlan3 enet active 55 vlan55 enet active 66 vlan66 fddi active 88 vlan88 tring active 99 vlan99 fddi active 1002 fddi-default fddi active 1003 token-ring-default tring active 1004 fddinet-default fdnet active 1005 trnet-default trnet active VLAN SAID MTU RingNo BridgeNo StpNo Parent Trans1 Trans2 ---- ---------- ----- ------ -------- ----- ------ ------ ------ 1 100001 1500 0 0 0 0 0 0 3 100003 1500 0 0 0 0 0 0 55 100055 1500 0 0 0 0 0 0 66 100066 4500 5000 0 0 5000 0 0 88 100088 1500 0 0 0 0 0 0 99 100099 1500 0 0 0 0 0 0 1002 101002 4500 0 0 0 0 1 1003 1003 101003 4500 0 0 0 0 1 1002 1004 101004 4500 0 1004 0 0 0 0 1005 101005 4500 0 1005 0 0 0 0 Console>

Related Commands

set vlan
set trunk
show trunk

show vmps

Use the show vmps command to display the current VMPS configuration information and its current operational service.
show vmps
Syntax Description

This command has no arguments or keywords.

Default

This command has no default settings.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

The state indicates your configured value.

The operational status indicates the current state of the VMPS. It can be active, inactive, or downloading.

Example

The following example shows how to display the current VMPS configuration information and current operational service:

Console> show vmps VMPS configuration: management Domain:Synergy Software State:enabled Operational Status:active TFTP Server:198.4.254.222 TFTP File:vmps_configuration.db Fallback VLAN:default Secure Mode:enabled

show vmps address

Use the show vmps address command to display the VMPS IP address.
show vmps address
Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the VMPS IP address:

console (enable)> show vmps address vmps IP address vmps status ------------------- -------------- 192.0.0.6 192.0.0.1 primary 192.0.0.9

Related Command

set vmps address

show vmps mac

Use the show vmps mac command to display the MAC-address-to-VLAN mapping.
show vmps mac [mac_address]
Syntax Description

mac_address MAC address.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

If no MAC address is specified, the entire MAC-address-to-VLAN mapping table is displayed.

Example

The following example shows the entire MAC-address-to-VLAN mapping table.

Console> show vmps mac MAC address VLAN Name Last Requestor Port ID Last Accessed Last Response ------------------ ---------- -------------- ------- ------------- ------------- 00-00-c0-23-c8-34 Hardware 198.4.222.111 3/5 0, 01:25:30 Success 00-00-c0-25-c9-42 --NONE-- 198.4.222.111 2/1 0, 05:20:00 Denied

Related Command

show vmps

show vmps portgrp

Use the show vmps portgrp command to display the VLANs in a port group.
show vmps portgrp [port_group]
Syntax Description

port_group Port group name.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

If port_group is not specified, all the port groups are displayed.

Example

The following example shows the VLANs in the WiringCloset1 port group:

Console> show vmps portgrp WiringCloset1 Port Group Device ID Port ID ------------- --------------- ---------- WiringCloset1 172.20.220.110 2/4

Related Command

show vmps

show vmps statistics

Use the show vmps statistics command to display the VMPS statistics.
show vmps statistics
Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

The show vmps statistics command displays the following statistics:

Statistic Definition
last_restart Value of sysUpTime when the VMPS was enabled.
config_reqs Number of configuration requests.
in_config_errors Number of improperly formatted configuration requests.
out_config_fails Number of responses with an error status.
out_config_denies Number of responses with a "deny" error status.
last_fail_macaddr MAC-address of the last failed request.

Example

The following example shows typical output from the show vmps statistics command:

Console> show vmps statistics Console>

Related Command

show vmps

show vmps vlan

Use the show vmps vlan command to display all the MAC addresses assigned to a VLAN in the VMPS table.
show vmps vlan [vlan_name]
Syntax Description

vlan_name The name of the VLAN.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display all MAC addresses assigned to the Hardware VLAN in the VMPS table:

Console> show vmps vlan Hardware MAC address VLAN Name Last Requestor Port ID Last Accessed Last Response ----------------- --------- -------------- ------- ------------- ------------- 00-00-c0-23-c8-34 Hardware 198.4.222.111 3/5 0, 01:25:30 Success

Related Command

show vmps

show vmps vlangrp

Use the show vmps vlangrp command to display the VLANs in a group.
show vmps vlangrp [vlan_group]
Syntax Description

vlan_group The name of the VLAN group.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Usage Guidelines

If vlan_group is not specified, the entire group table is displayed.

Example

The following example shows how to display all VLANs in a group:

Console> show vmps vlangrp VLAN Group VLAN names ------------ ------------------------- Engineering Hardware, CAD, Software Marketing ProductMktg, CustomerMktg

Related Command

show vmps

show vmps vlanports

Use the show vmps vlanports command to display ports belonging to a restricted VLAN or a VLAN group.
show vmps vlanports {vlan_name | vlan_group}
Syntax Description

vlan_name The name of the VLAN.
vlan_group The name of the VLAN group.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to display the VLAN ports in the Engineering VLAN group:

Console> show vmps vlanports Engineering VLAN/VLAN Group Device Id Port ID --------------- ---------------- --------- Engineering 172.20.220.110 2/4

Related Command

show vmps

show vtp

Use the show vtp command to display Vlan Trunk Protocol (VTP) information.
show vtp
show vtp [domain]
show vtp [statistics]
Syntax Description

domain Keyword used to display VTP domain information.
statistics Keyword used to display VTP statistics.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Examples

This example shows how to display Virtual Trunk Protocol information.

Console> show vtp Show vtp commands: ----------------------------------------------------------- show vtp domain Show VTP domain information show vtp help Show this message show vtp statistics Show VTP statistics

This example shows how to display Virtual Trunk Protocol information with domain information.

console> show vtp domain Domain Name Domain Index VTP Version Local Mode ----------- ------------ ----------- ----------- WBU 1 1 client Advt Interval Vlan-count Max-vlan-storage Config Revision Notifications -------------- ----------- ---------------- --------------- ------------- 300 6 1023 23 disabled Last Updater Pruning PruneEligible on Vlans ------------- ------- ------------------------ 172.20.26.151 enabled 4-5,9-99,120,150,201-1000

This example shows how to display Virtual Trunk Protocol information with statistics.

console> show vtp statistics VTP statistics: summary advts received 17 subset advts received 20 request advts received 0 summary advts transmitted 5 subset advts transmitted 14 request advts transmitted 4 No of config revision errors 0 No of config digest errors 0 VTP pruning statistics: Summary advts received from Trunk Join transmitted Join received non-pruning-capable device 1/1 303 312 0 1/2 353 0 8

Related Commands

set vtp
show vtp help

show vtp help

Use the show vtp command to display available Virtual Trunk Protocol (VTP) commands.

show vtp help

Syntax Description

help Keyword used to display available VTP commands.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

This example shows how to display VTP commands.

Console> show vtp help Show vtp commands: ----------------------------------------------------------- show vtp domain Show VTP domain information show vtp help Show this message show vtp statistics Show VTP statistics

Related Commands

show vtp
show vtp help

slip

Use the slip command to attach or detach Serial Line Interface Protocol (SLIP) for the console port.
slip {attach | detach}
Syntax Description

attach Keyword used to activate SLIP for the console port.
detach Keyword used to deactivate SLIP for the console port.

Default

By default, SLIP is not active (detached).

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

You can use the slip command from a console port session or a Telnet session.

Examples

The following example shows how to enable SLIP for a console port during a console port session:

Console> (enable) slip attach Console port now running SLIP. <console port running SLIP>

The following example shows how to disable SLIP for a console port during a Telnet session:

Console> (enable) slip attach Console port now running SLIP. <console port running SLIP> Console> (enable) slip detach SLIP detached on Console port. <console port back to RS-232 Console> Console> (enable)

Related Command

set interface

sscop cc-timer

Use the sscop cc-timer interface configuration command to change the connection control timer. The no form of this command restores the default value.
sscop cc-timer seconds
no sscop cc-timer
Syntax Description

seconds The number of seconds between Begin messages.

Default

10 seconds.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

The connection control timer determines the time between transmission of BGN, END, or RS PDUs as long as an acknowledgment has not been received.

Example

In the following example, the connection control timer is set to 15 seconds:

ATM(config-if)# sscop cc-timer 15

Related Command

sscop max-cc

sscop keepalive-timer

Use the sscop keepalive-timer interface configuration command to change the keepalive timer. The no form of this command restores the default value.
sscop keepalive-timer seconds
no sscop keepalive-timer seconds
Syntax Description

seconds The number of seconds the ATM module waits between transmission of POLL PDUs when no SD or SDP PDUs are queued for transmission or are outstanding pending acknowledgments.

Default

30 seconds.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Example

In the following example, the keepalive timer is set to 15 seconds:

ATM(config-if)# sscop keepalive-timer 15

sscop max-cc

Use the sscop max-cc interface configuration command to change the retry count of connection control. The no form of this command restores the default value.
sscop max-cc retries
no sscop max-cc
Syntax Description

retries The number of times that SSCOP will retry to transmit BGN, END, or RS PDUs as long as an acknowledgment has not been received. Valid range is 1 to 6000.

Default

10 retries.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Example

In the following example, the retry count of the connection control is set to 20:

ATM(config-if)# sscop max-cc 20

Related Command

sscop cc-timer

sscop poll-timer

Use the sscop poll-timer interface configuration command to change the poll timer. The no form of this command restores the default value.
sscop poll-timer seconds
no sscop poll-timer
Syntax Description

seconds The number of seconds the ATM module waits between transmission of POLL PDUs.

Default

10 seconds.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Usage Guideline

The poll timer controls the maximum time between transmission of POLL PDUs when SD or SDP PDUs are queued for transmission or are outstanding pending acknowledgments.

Example

In the following example, the poll timer is set to 15 seconds:

ATM(config-if)# sscop poll-timer 15

sscop rcv-window

Use the sscop rcv-window interface configuration command to change the receiver window. The no form of this command restores the default value.
sscop rcv-window packets
no sscop rcv-window
Syntax Description

packets The number of packets the interface can receive before it must send an acknowledgment to the ATM switch. Valid range is 1 to 6000.

Default

7 packets.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Example

In the following example, the receiver's window is set to 10 packets:

ATM(config-if)# sscop rcv-window 10

sscop send-window

Use the sscop send-window interface configuration command to change the transmitter window. The no form of this command restores the default value.
sscop send-window packets
no sscop send-window
Syntax Description

packets The number of packets the interface can send before it must receive an acknowledgment from the ATM switch. Valid range is 1 to 6000.

Default

7 packets.

Command Type

Cisco IOS ATM command.

Command Mode

Interface configuration.

Example

In the following example, the transmitter's window is set to 10 packets:

ATM(config-if)# sscop send-window 10

telnet

Use the telnet command to start a Telnet connection to a remote host.
telnet host [port]
Syntax Description

host The remote host to which you connect.
port A specific port connection on the remote host.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following screen shows the display after entering the telnet help command.

Console> (enable) telnet help Usage: telnet <host> [port] (host is ipalias or IP address in dot notation: a.b.c.d) Console> (enable) telnet elvis Trying 192.122.174.11... Connected to elvis. Escape character is '^]'. UNIX(r) System V Release 4.0 (elvis) login: fred Password: Last login: Thu Feb 15 09:25:01 from forster.cisc.rum Sun Microsystems Inc. SunOS 5.4 Generic July 1994 You have new mail. % logout Console> (enable)

Related Command

disconnect

terminal

Use the terminal command to set the number of lines displayed.
terminal length screen-length
terminal no length
Syntax Description

screen length (Optional) Value used to specify the desired number of lines. The default length is 24 lines. A value of 0 disables pausing between screens of output.

Command Type

Cisco IOS ATM module interface command.

Command Mode

EXEC.

Example

In the following example, the terminal is set to 0 so that output scrolls on the screen without pausing.

ATM> terminal length 0

test help

Use the test help command to display the test commands.
test help
Syntax Description

This command has no keywords or arguments.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to list the test commands:

Console> (enable) test help Test commands: ------------------------------------------------------------------------- test help Show this message test snmp Send trap message to SNMP trap receivers Console> (enable)

test snmp trap

Use the test snmp trap command to send an SNMP trap message to the trap receivers.
test snmp trap trap_number [specific_number]
Syntax Description

trap_number The number of the trap.
specific_number (Optional) The number of a predefined trap.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to run trap 0:

Console> (enable) test snmp trap 0 SNMP trap message sent. (4) Console> (enable)

Related Commands

clear snmp trap
set snmp trap
show snmp
test help

upload

Use the upload command to upload a code image to a network host.
upload host file [module_num]
Syntax Description

host The IP address or IP alias of the host.
file The name of the file.
module_num (Optional) The number of the module. If no number is specified, the default is module 1.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Example

The following example shows how to upload the supervisor image to the c5009_11.bin file on the mercury host:

Console> (enable) upload mercury c5009_11.bin 3 Upload Module 1 image to c5009_11.bin on mercury (y/n) [n]? y / Done. Finished Network Upload. (153908 bytes) Console> (enable)

Related Command

download

wait

Use the wait command to pause the command line interface to pause for a specified number of seconds. This command might be included in a configuration file.
wait seconds
Syntax Description

seconds The number of seconds for the command line interface to wait.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Normal.

Example

The following example shows how to pause the command line interface for 5 seconds:

Console> wait 5 Console>

write

Use the write command to upload the current configuration to a host or display it on the terminal.
write network
write terminal
write host file
Syntax Description

network Keyword used to initiate a script that prompts for the IP address or IP alias of the host and the file name to upload.
terminal Keyword used to display the configuration file on the terminal.
host The IP address or IP alias of the host.
file The name of the file.

Default

This command has no default setting.

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The write terminal command is exactly the same as the show config command. The write host file command is a shorthand version of the write network command.

The write terminal command is equivalent to the ATM-specific command write terminal.

You cannot use the write network command to upload software to the ATM module.

With the write network command, the file must exist on the host, "touch filename."

Examples

The sample session assumes that module 1 is a 2-port supervisor module, module 2 is a 12-port 10/100BaseT switched Ethernet module, module 3 is a 24-port 10BaseT Ethernet module, module 4 is empty, and module 5 is empty. Details of the ATM configuration must be accessed through the special module mode.

The following example shows how to upload the system5.cfg file from the mercury host using the write network command:

Console> (enable) write network IP address or name of host? mercury Name of configuration file to write? system5.cfg Upload configuration to system5.cfg on mercury (y/n) [y]? y / Done. Finished Network Upload. (9003 bytes) Console> (enable)

The following example shows how to upload the system5.cfg file to the mercury host using the write host file command as a shorthand method:

Console> (enable) write mercury system5.cfg Upload configuration to system5.cfg on mercury (y/n) [y]? y / Done. Finished Network Upload. (9003 bytes) Console> (enable)

The following example shows how to use the write terminal command to display the configuration file on the terminal:

Console> (enable) write terminal begin set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70 set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70 set prompt Console> ! #system set system baud 9600 set system modem disable set system name set system location set system contact ! #snmp set snmp community read-only public set snmp community read-write private set snmp community read-write-all secret set snmp trap disable ! #vlan/trunk set vlan 1 1/1-2,4/1 set vlan 2 2/1-5 ! #trunks ! #cam set cam agingtime 1 300 set cam agingtime 2 300 ! #ip set interface sc0 0.0.0.0 0.0.0.0 0.0.0.0 set interface sl0 0.0.0.0 0.0.0.0 set ip redirect enable set ip unreachable disable set ip fragmentation enable set ip alias default 0.0.0.0 set arp agingtime 1200 ! #bridge set bridge ipx snaptoether 8023raw set bridge ipx 8022toether 8023 set bridge ipx 8023rawtofddi snap ! #Command alias ! #cdp set cdp enable 1/1-2,2/1-5,4/1 set cdp interval 1/1 60 set cdp interval 1/2 60 set cdp interval 2/1 60 set cdp interval 2/2 60 set cdp interval 2/3 60 set cdp interval 2/4 60 set cdp interval 2/5 60 set cdp interval 4/1 60 ! #spantree #vlan 1 set spantree enable 1 set spantree fwddelay 15 1 set spantree hello 2 1 set spantree maxage 20 1 set spantree priority 32768 1 set spantree portpri 1/1 32 set spantree portcost 1/1 10 set spantree portpri 1/2 32 set spantree portcost 1/2 10 set spantree portpri 4/1 32 set spantree portcost 4/1 10 #vlan 2 set spantree enable 2 set spantree fwddelay 15 2 set spantree hello 2 2 set spantree maxage 20 2 set spantree priority 32768 2 set spantree portpri 2/1 32 set spantree portcost 2/1 100 set spantree portpri 2/2 32 set spantree portcost 2/2 100 set spantree portpri 2/3 32 set spantree portcost 2/3 100 set spantree portpri 2/4 32 set spantree portcost 2/4 100 set spantree portpri 2/5 32 set spantree portcost 2/5 100 ! #trunk ! #module 1 set module name 1 set port enable 1/1 set port name 1/1 set port duplex 1/1 half set port level 1/1 normal set port enable 1/2 set port name 1/2 set port duplex 1/2 half set port level 1/2 normal ! #module 2 set module name 2 set module enable 2 ! set port enable 2/1 set port name 2/1 set port duplex 2/1 half set port level 2/1 normal set port enable 2/2 set port name 2/2 set port duplex 2/2 half set port level 2/2 normal set port enable 2/3 set port name 2/3 set port duplex 2/3 half set port level 2/3 normal set port enable 2/4 set port name 2/4 set port duplex 2/4 half set port level 2/4 normal set port enable 2/5 set port name 2/5 set port duplex 2/5 half set port level 2/5 normal ! #module 3 empty ! #module 4 set module name 4 set module enable 4 ! set fddi userdata 4 WorkGroup Stack set fddi tnotify 4 30 set fddi treq 4 5000 set port enable 4/1 set port name 4/1 set port level 4/1 normal set fddi tlmin 4/1 40 set port enable 4/2 set port name 4/2 set port level 4/2 normal set fddi tlmin 4/2 40 ! #module 5 empty end Console> (enable)

Related Command

show config

write erase

Use the write erase EXEC command to erase the configuration information in nonvolatile memory. The NVRAM will then be filled with the default configuration.
write erase
Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS Configuration command.

Command Mode

EXEC.

Example

The following example illustrates how to erase the configuration in nonvolatile memory:

ATM# write erase

To copy the current configuration information to nonvolatile memory, use the write memory EXEC command:

ATM# write memory

write memory

Use the write memory EXEC command in conjunction with the reload command to restart the Catalyst 5000 series switch with the configuration information stored in NVRAM.

Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS Configuration command.

Command Mode

EXEC.

Usage Guidelines

If you issue the write memory command from a bootstrap system image, a displayed warning states that the previous NVRAM configuration will be overwritten and some of the configuration commands will be lost unless you answer no. This warning does not display if NVRAM does not contain a valid configuration or if the previous configuration in NVRAM was generated by a bootstrap system image.

Example

The following example illustrates how to copy the current configuration information to nonvolatile memory:

ATM# write memory ### [OK]

Related Command

reload

write terminal

Use the write terminal EXEC command in conjunction with the show configuration command to compare the information in running memory to the information stored in NVRAM.
write terminal
Syntax Description

This command has no arguments or keywords.

Command Type

Cisco IOS Configuration command.

Command Mode

EXEC.

Example

The following example illustrates how to display the current configuration information:
ATM# write terminal

interface atm 0	(Optional) ATM interface 0.
.subinterface-number	(Optional) Subinterface number. (The period (.) is required.)
name elan-name	(Optional) Name of the emulated LAN. Maximum length is 32 characters.
brief	(Optional) Keyword used to display the global information, but not the per-VCC information.

interface interface-name	Interface name.
brief	Keyword used to display the global information, but not the per-VCC information.

Field	Description
Hardware Addr	The MAC address, in dotted hexadecimal notation, assigned to the LANE component at the other end of this VCD.
ATM Address	ATM address of the LANE component at the other end of this VCD.
VCD	Virtual circuit descriptor.
Interface	Interface or subinterface used to reach the specified component.

N	The number of messages to be displayed starting from the beginning of the buffer.
-N	The number of messages to be displayed starting from the end of the buffer.

mod_num	The number of the module. If a number is not specified, all modules are shown.
port_num	The number of the port on the module.

cgmp	Keyword used to display only the information learned through Cisco Group Management Protocol (CGMP).
mac_addr	The destination MAC address.
vlan_id	The number of the VLAN.

cgmp	Keyword used to display only the configuration information learned through Cisco Group Management Protocol (CGMP).
mod_num	The number of the module.
port_num	The number of the port on the module.
vlan_id	The number of the VLAN.

stats	(Optional) Keyword used to show TCP, UDP, IP, and ICMP statistics.
tcp	(Optional) Keyword used to show TCP statistics.
udp	(Optional) Keyword used to show UDP statistics.
ip	(Optional) Keyword used to show IP statistics.
icmp	(Optional) Keyword used to show ICMP statistics.
interfaces	(Optional) Keyword used to show interface statistics.
routes	(Optional) Keyword used to show the IP routing table.

Field	Description
SSCOP details for interface	Interface slot and port.
Current State	SSCOP state for the interface.
Send Sequence Number	Current and maximum send sequence number.
Send Sequence Number Acked	Sequence number of packets already acknowledged.
Rcv Sequence Number	Sequence number of packets received.
Poll Sequence Number	Current poll sequence number.
Poll Ack Sequence Number	Poll sequence number already acknowledged.
Vt(Pd)	Number of Pd frames sent which triggers a sending of a Poll frame.
Connection Control	Timer used for establishing and terminating SSCOP.
Keep Alive Timer	Timer used to send keepalives on an idle link.
Current Retry Count	Current count of the retry counter.
Maximum Retry Count	Maximum value the retry counter can take.
Pdu's Sent	Total number of SSCOP frames sent.
Pdu's Received	Total number of SSCOP frames received.
Pdu's Ignored	Number of invalid SSCOP frames ignored.
Begin	Number of Begin frames sent/received.
Begin Ack	Number of Begin Ack frames sent/received.
Begin Reject	Number of Begin Reject frames sent/received.
End	Number of End frames sent/received.
End Ack	Number of End Ack frames sent/received.
Resync	Number of Resync frames sent/received.
Resync Ack	Number of Resync Ack frames sent/received.
Sequenced Data	Number of Sequenced Data frames sent/received.
Sequenced Poll Data	Number of Sequenced Poll Data frames sent/received.
Poll	Number of Poll frames sent/received.
Stat	Number of Stat frames sent/received.
Unsolicited Stat	Number of Unsolicited Stat frames sent/received.
Unassured Data	Number of Unassured Data frames sent/received.
Mgmt Data	Number of Mgmt Data frames sent/received.
Unknown Pdu's	Number of Unknown SSCOP frames sent/received.

Field	Description
IOS Software, Version X.X	Always specify the complete version number when reporting a possible software problem.
System Bootstrap, Version	Bootstrap version string.
ATM Module uptime is N minutes	Amount of time the system has been up and running.
System restarted by power-on	Log of how the system was last booted, both as a result of normal system startup and of system error. For example, information can be displayed to indicate a bus error that is generally the result of an attempt to access a nonexistent address, as follows: `System restarted by bus error at PC 0xC4CA, address 0x210C0C0`
Running default software	If the software was booted over the network, the Internet address of the boot host is shown. If the software was loaded from onboard ROM, this line reads "running default software." In addition, the names and sources of the host and network configuration files are shown.
cisco....	The remaining output shows the hardware configuration and any nonstandard software options. The configuration register contents are displayed in hexadecimal notation.

trunk	(Optional) Keyword used to display trunk ports.
vlan	The number of the VLAN to display.
notrunk	(Optional) Keyword used to not display trunk ports.

Statistic	Definition
last_restart	Value of sysUpTime when the VMPS was enabled.
config_reqs	Number of configuration requests.
in_config_errors	Number of improperly formatted configuration requests.
out_config_fails	Number of responses with an error status.
out_config_denies	Number of responses with a "deny" error status.
last_fail_macaddr	MAC-address of the last failed request.

vlan_name	The name of the VLAN.
vlan_group	The name of the VLAN group.

domain	Keyword used to display VTP domain information.
statistics	Keyword used to display VTP statistics.

attach	Keyword used to activate SLIP for the console port.
detach	Keyword used to deactivate SLIP for the console port.

host	The remote host to which you connect.
port	A specific port connection on the remote host.

trap_number	The number of the trap.
specific_number	(Optional) The number of a predefined trap.

network	Keyword used to initiate a script that prompts for the IP address or IP alias of the host and the file name to upload.
terminal	Keyword used to display the configuration file on the terminal.
host	The IP address or IP alias of the host.
file	The name of the file.

Table of Contents