To set the terminal screen length, use the length command in line configuration mode. To restore the default value, use the no form of this command.
lengthscreen-length
nolength
Syntax Description
screen-length
The number of lines on the screen. A value of zero disables pausing between screens of output.
Command Default
Screen length of 24 lines
Command Modes
Line configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
The Cisco IOS software uses the value of this command to determine when to pause during multiple-screen output. Not all commands recognize the configured screen length. For example, the showterminal command assumes a screen length of 24 lines or more.
Examples
In the following example, the terminal type is specified and the screen pause function is disabled for the terminal connection on line 6:
Router(config)# line 6
Router(config-line)# terminal-type VT220
Router(config-line)# length 0
Related Commands
Command
Description
terminallength
Sets the number of lines on the current terminal screen for the current session.
load-interval
To change the length of time for which data is used to compute load statistics, use theload-interval command in interface configuration mode or Frame Relay DLCI configuration mode. To revert to the default setting, use the
noform of this command.
load-intervalseconds
noload-intervalseconds
Syntax Description
seconds
Length of time for which data is used to compute load statistics. Value is a multiple of 30, from 30 to 600 (30, 60, 90, 120, and so on). The default is 300 seconds.
This command was made available in Frame Relay DLCI configuration mode.
12.2(18)SXF
Support for this command was introduced on the Supervisor Engine 720.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
15.1(2)SNG
This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines
To make computations more reactive to short bursts of traffic, you can shorten the length of time over which load averages are computed.
If the load interval is set to 30 seconds, new data is used for load calculations over a 30-second period. This data is used to compute load statistics, including the input rate in bits and packets per second, the output rate in bits and packets per second, the load, and reliability.
Load data is gathered every five seconds. This data is used for a weighted-average calculation in which recent load data has more weight in the computation than older load data. If the load interval is set to 30 seconds, the average is computed for the last 30 seconds of load data.
If you change the calculation interval from the default of five minutes to a shorter period of time, the input and output statistics that are displayed by theshowinterface command or the
showframe-relaypvc command will be more current and will be based on more nearly instantaneous data, rather than reflecting the average load over a longer period of time.
This command is often used for dial backup purposes to increase or decrease the likelihood of implementation of a backup interface, but it can be used on any interface.
Examples
Examples
In the following example, the default average of five minutes is changed to a 30-second average. A burst in traffic that would not trigger a dial backup for an interface configured with the default five-minute interval might trigger a dial backup for this interface, which is set for the shorter 30-second interval.
Router(config)# interface serial 0
Router(config-if)# load-interval 30
Examples
In the following example, the load interval is set to 60 seconds for a Frame Relay PVC with the DLCI 100:
Displays statistics for all interfaces configured on the router or access server.
location
To provide a description of the location of a serial device, use the location command in line configuration mode. To remove the description, use the no form of this command.
locationtext
nolocation
Syntax Description
text
Location description.
Command Default
A location description is not provided.
Command Modes
Line configuration (config-line)
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
The location command enters information about the device location and status. Use theshowusersall EXEC command to display the location information.
Examples
In the following example, the location description for the console line is given as “Building 3, Basement”:
Router(config)# line console
Router(config-line)# location Building 3, Basement
Related Commands
Command
Description
showusers
Displays information about the active lines on a router.
lock
To configure a temporary password on a line, use the lockcommand in EXEC mode.
lock
Syntax Description
This command has no arguments or keywords.
Command Default
Not locked
Command Modes
EXEC
Command History
Release
Modification
10.0
This command was introduced in a release prior to Cisco IOS Release 10.0.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
You can prevent access to your session while keeping your connection open by setting up a temporary password. To lock access to the terminal, perform the following steps:
Enter the lock command. The system prompts you for a password.
Enter a password, which can be any arbitrary string. The system will prompt you to confirm the password. The screen then clears and displays the message “Locked.”
To regain access to your sessions, reenter the password.
The Cisco IOS software honors session timeouts on a locked lines. You must clear the line to remove this feature. The system administrator must set the line up to
allow use of the temporary locking feature by using the lockable line configuration command.
Examples
The following example shows configuring the router as lockable, saving the configuration, and then locking the current session for the user:
To enable use of the lock EXEC command, use the lockablecommand in line configuration mode. To reinstate the default (the terminal session cannot be locked), use the noform of this command.
lockable
nolockable
Syntax Description
This command has no arguments or keywords.
Command Default
Sessions on the line are not lockable (the lock EXEC command has no effect).
Command Modes
Line configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command enables use of temporary terminal locking, which is executed using the lock EXEC command. Terminal locking allows a user keep the current session open while preventing access by other users.
Examples
In the following example, the terminal connection is configured as lockable, then the current connection is locked:
Suppresses the display of password information in configuration log files.
loggingenable
Enables the logging of configuration changes.
loggingsize
Specifies the maximum number of entries retained in the configuration log.
notifysyslog
Enables the sending of notifications of configuration changes to a remote syslog.
showarchivelogconfig
Displays entries from the configuration log.
logging buginf
To allow debug messages to be generated for the standard system logging buffer, use the loggingbuginfcommand in global configuration mode. To disable the logging for debugging functionality, use the no form of this command.
loggingbuginf
nologgingbuginf
Syntax Description
This command has no arguments or keywords.
Command Default
Debug messages are not suppressed.
Command Modes
Global configuration (config)
Command History
Release
Modification
15.0(1)M
This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
12.2(33)SRC
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SRC.
12.2(33)SXI
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SXI.
Cisco IOS XE Release 2.1
This command was integrated into Cisco IOS XE Release 2.1.
Usage Guidelines
Thenologgingbuginfcommand is used to avoid a situation where a large amount of debug messages might overload the processor (CPU hog condition). This condition differs from the use of the undebugallcommand wherein all debugging calls are disabled in the Cisco IOS software. No debug reporting is available, even if debugging is enabled. Note that even though debugging has been completely disabled in the system, other message reporting, including error reporting, is still available.
Examples
The following example shows how to enable buginf logging for debugging:
Displays the state of system logging (syslog) and the contents of the standard system logging buffer.
logging enable
To enable the logging of configuration changes, use the loggingenable command in configuration change logger configuration mode. To disable the logging of configuration changes, use the no form of this command.
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB and implemented on the Cisco 10000 series.
Cisco IOS XE Release 3.9S
This command was integrated into Cisco IOS XE Release 3.9S.
Usage Guidelines
Use this command if you want to log configuration changes. If you disable configuration logging, all configuration log records that were collected are purged.
Examples
The following example shows how to enable configuration logging:
Specifies the maximum number of entries retained in the configuration log.
notifysyslog
Enables the sending of notifications of configuration changes to a remote syslog.
showarchivelogconfig
Displays entries from the configuration log.
logging esm config
To permit configuration changes from Embedded Syslog Manager (ESM) filters, use the loggingesmconfig command in global configuration mode. To disable the configuration, use the no form of this command.
loggingesmconfig
nologgingesmconfig
Syntax Description
This command has no arguments or keywords.
Command Default
ESM filters are enabled.
Command Modes
Global configuration (config)
Command History
Release
Modification
15.0(1)M
This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
12.2(33)SRC
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SRC.
12.2(33)SXI
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SXI.
Cisco IOS XE Release 2.1
This command was integrated into Cisco IOS XE Release 2.1.
Usage Guidelines
You can use the nologgingesmconfig command to disallow configuration changes from ESM filters.
Examples
The following example shows how to configure the ESM filters:
Specifies a syslog filter module to be used by the ESM.
logging event bundle-status
To enable message bundling, use the
loggingeventbundle-status command in interface configuration mode. To disable message bundling, use the
no form of this command.
loggingeventbundle-status
nologgingeventbundle-status
Syntax Description
default
Enables system logging of interface state-change events on all interfaces in the system.
boot
Enables system logging of interface state-change events on all interfaces in the system during system initialization.
Command Default
Message bundling does not occur.
Command Modes
Global configuration
Command History
Release
Modification
12.2(14)SX
Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB
Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
The logging event bundle-status command is not applicable on Port Channel or Ether-Channel interfaces.
Examples
This example shows how to enable the system logging of the interface state-change events on all interfaces in the system:
Router(config)# logging event bundle-status
Router(config)# end
Router # show logging event bundle-status
*Aug 4 17:36:48.240 UTC: %EC-SP-5-UNBUNDLE: Interface FastEthernet9/23 left the port-channel Port-channel2
*Aug 4 17:36:48.256 UTC: %LINK-SP-5-CHANGED: Interface FastEthernet9/23, changed state to administratively down
*Aug 4 17:36:47.865 UTC: %EC-SPSTBY-5-UNBUNDLE: Interface FastEthernet9/23 left the port-channel Port-channel2
Router # show logging event bundle-status
*Aug 4 17:37:35.845 UTC: %EC-SP-5-BUNDLE: Interface FastEthernet9/23 joined port-channel Port-channel2
*Aug 4 17:37:35.533 UTC: %EC-SPSTBY-5-BUNDLE: Interface FastEthernet9/23 joined port-channel Port-channel2
Related Commands
Command
Description
showrunning-config
Displays the status and configuration of the module or Layer 2 VLAN.
logging event link-status (global configuration)
To change the default or set the link-status event messaging during system initialization, use the
loggingeventlink-status command in global configuration mode. To disable the link-status event messaging, use the
no form of this command.
loggingeventlink-status
{ default | boot }
nologgingeventlink-status
{ default | boot }
Syntax Description
default
Enables system logging of interface state-change events on all interfaces in the system.
boot
Enables system logging of interface state-change events on all interfaces in the system during system initialization.
Command Default
Interface state-change messages are not sent.
Command Modes
Global configuration
Command History
Release
Modification
12.2(14)SX
Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB
Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
You do not have to enter the
loggingeventlink-statusboot command to enable link-status messaging during system initialization. The
loggingeventlink-statusdefault command logs system messages even during system initialization.
If you enter both the
loggingeventlink-statusdefault and the
nologgingeventlink-statusbootcommands, the interface state-change events are logged after all modules in the Cisco 7600 series router come online after system initialization. The
loggingeventlink-statusdefault and the
nologgingeventlink-statusboot commands are saved and retained in the running configuration of the system.
When both the
loggingeventlink-statusdefault and the
nologgingeventlink-statusbootcommands are present in the running configuration and you want to display the interface state-change messages during system initialization, enter the
loggingeventlink-statusboot command.
Examples
This example shows how to enable the system logging of the interface state-change events on all interfaces in the system:
To enable link-status event messaging on an interface, use the
loggingeventlink-status command in interface configuration mode. To disable link-status event messaging, use the
no form of this command.
(Optional) Logs B-channel status messages. This keyword is available only for integrated services digital network (ISDN) serial interfaces.
dchan
(Optional) Logs D-channel status messages. This keyword is available only for ISDN serial interfaces.
nfas
(Optional) Logs non-facility associated signaling (NFAS) D-channel status messages. This keyword is available only for ISDN serial interfaces.
Command Default
Interface state-change messages are not sent.
Command Modes
Interface configuration (config-if)
Command History
Release
Modification
12.2(14)SX
This command was introduced on the Supervisor Engine 720.
12.2(17d)SXB
This command was modified to support the Supervisor Engine 2.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
To enable system logging of interface state-change events on a specific interface, enter the
loggingeventlink-status command.
Examples
The following example shows how to enable link-status event messaging on an interface:
Router(config-if)# logging event link-status
This example shows how to disable link-status event messaging on an interface:
Router(config-if)# no logging event link-status
logging event subif-link-status
To enable the link-status event messaging on a subinterface, use the
loggingeventsubif-link-status command in interface configuration mode. To disable the link-status event messaging on a subinterface, use the
no form of this command.
loggingeventsubif-link-status
nologgingeventsubif-link-status
Syntax Description
This command has no arguments or keywords.
Command Default
Subinterface state-change messages are not sent.
Command Modes
Interface configuration
Command History
Release
Modification
12.2(17d)SXB
Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 720.
To enable system logging of interface state-change events on a specific subinterface, enter the
loggingeventsubif-link-status command.
To enable system logging of interface state-change events on a specific interface, enter the
loggingeventlink-status command.
To enable system logging of interface state-change events on all interfaces in the system, enter the
loggingeventlink-status command.
Examples
This example shows how to enable the system logging of the interface state-change events on a subinterface:
This example shows how to disable the system logging of the interface state-change events on a subinterface:
Router(config-if)# no logging event subif-link-status
Router(config-if)#
Related Commands
Command
Description
showrunning-config
Displays the status and configuration of the module or Layer 2 VLAN.
logging event trunk-status
To enable trunk status messaging, use the loggingeventtrunk-status command in interface configuration mode. To disable trunk status messaging, use the no form of this command.
loggingeventtrunk-status
nologgingeventtrunk-status
Syntax Description
This command has no keywords or variables.
Command Default
This command has no default settings.
Command Modes
Interface configuration mode
Command History
Release
Modification
12.2(14)SX
Support for this command was introduced.
Usage Guidelines
The logging event bundle-status command is not applicable on Port Channel or Ether-Channel interfaces.
Examples
This example shows how to enable the trunk status messaging on physical ports:
Router(config)# logging event trunk-status
Router(config)# end
Router# show logging event trunk-status
*Aug 4 17:27:01.404 UTC: %DTP-SPSTBY-5-NONTRUNKPORTON: Port Gi3/3 has become non-trunk
*Aug 4 17:27:00.773 UTC: %DTP-SP-5-NONTRUNKPORTON: Port Gi3/3 has become non-trunk
Router#
logging reload
To set the reload logging level, use the loggingreloadcommand in global configuration mode. To disable the reload logging, use the no form of this command.
(Optional) Sets the limit on the number of messages that can be logged during reload.
number
Number of messages. The range is from 1 to 4294967295.
severity-level
(Optional) Logging severity level. The range is from 0 to 7.
alerts
(Optional) Specifies that an immediate action is needed.
critical
(Optional) Specifies the critical conditions.
debugging
(Optional) Displays the debugging messages
emergencies
(Optional) Specifies that the system is unusable.
errors
(Optional) Specifies error conditions
informational
(Optional) Specifies error informational messages
notifications
(Optional) Specifies normal but significant conditions.
warnings
(Optional) Specifies warning conditions.
Command Default
The logging reload message limit is 1000 notifications.
Command Modes
Global configuration (config)
Command History
Release
Modification
15.0(1)M
This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
12.2(33)SRC
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SRC.
12.2(33)SXI
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SXI.
Cisco IOS XE Releas e2.1
This command was integrated into Cisco IOS XE Release 2.1.
Usage Guidelines
The default setting is recommended. Setting the message-limit too low may result in losing important messages during reload. If the loggingreload command is not enabled, logging is turned off during reload.
Examples
The following example shows how to set the limit on number of messages that can be logged during reload to 100:
Displays the state of system logging (syslog) and the contents of the standard system logging buffer.
logging ip access-list cache (global configuration)
To configure the Optimized ACL Logging (OAL) parameters, use the
loggingipaccess-listcache command in global configuration mode. To return to the default settings, use the
no form of this command.
Specifies the maximum number of log entries that are cached in the software; valid values are from 0 to 1048576 entries.
intervalseconds
Specifies the maximum time interval before an entry is sent to syslog; valid values are from 5 to 86400 seconds.
rate-limitpps
Specifies the number of packets that are logged per second in the software; valid values are from 10 to 1000000 pps.
thresholdpackets
Specifies the number of packet matches before an entry is sent to syslog; valid values are from 1 to 1000000 packets.
Command Default
The defaults are as follows:
entries--8000 entries.
seconds--300 seconds (5 minutes).
rate-limitpps--0 (rate limiting is off) and all packets are logged.
thresholdpackets--0 (rate limiting is off) and the system log is not triggered by the number of packet matches.
Command Modes
Global configuration
Command History
Release
Modification
12.2(17d)SXB
Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is supported on Cisco 7600 series routers that are configured with a Supervisor Engine 720 only.
OAL is supported on IPv4 unicast traffic only.
You cannot configure OAL and VACL capture on the same chassis. OAL and VACL capture are incompatible. With OAL configured, use SPAN to capture traffic.
If the entry is inactive for the duration that is specified in the
update-intervalseconds command, th e entry is removed from the cache.
If you enter the
nologgingipaccess-listcache command without keywords, all the parameters are returned to the default values.
You must set ICMP unreachable rate limiting to 0 if the OAL is configured to log denied packets.
When enabling the IP "too short" check using the mls verify ip length minimum command, valid IP packets with with an IP protocol field of ICMP(1), IGMP(2), IP(4), TCP(6), UDP(17), IPv6(41), GRE(47), or SIPP-ESP(50) will be hardware switched. All other IP protocol fields are software switched.
Caution
Using optimized access-list logging (OAL) and the mls verify ip length minimum command together can cause routing protocol neighbor flapping as they are incompatible
Examples
This example shows how to specify the maximum number of log entries that are cached in the software:
Router(config)#
logging ip access-list cache entries 200
This example shows how to specify the maximum time interval before an entry is sent to the system log:
Router(config)#
logging ip access-list cache interval 350
This example shows how to specify the number of packets that are logged per second in the software:
Router(config)#
logging ip access-list cache rate-limit 100
This example shows how to specify the number of packet matches before an entry is sent to the system log:
Router(config)#
logging ip access-list cache threshold 125
Related Commands
Command
Description
clearloggingipaccess-listcache
Clears all the entries from the OAL cache and sends them to the syslog.
loggingipaccess-listcache(interfaceconfiguration)
Enables an OAL-logging cache on an interface that is based on direction.
showloggingipaccess-list
Displays information about the logging IP access list.
update-intervalseconds
Removes entries from the cache that are inactive for the duration that is specified in the command.
logging ip access-list cache (interface configuration)
To enable an Optimized ACL Logging (OAL)-logging cache on an interface that is based on direction, use the
loggingipaccess-listcache command in interface configuration mode. To disable OAL, use the
no form of this command.
loggingipaccess-listcache
[ in | out ]
nologgingipaccess-listcache
Syntax Description
in
(Optional) Enables OAL on ingress packets.
out
(Optional) Enables OAL on egress packets.
Command Default
Disabled
Command Modes
Interface configuration
Command History
Release
Modification
12.2(17d)SXB
Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is supported on Cisco 7600 series routers that are configured with a Supervisor Engine 720 only.
This command is supported on traffic that matches the
log keyword in the applied ACL. You must set ICMP unreachable rate limiting to 0 if the OAL is configured to log denied packets.
On systems that are configured with a PFC3A, support for the egress direction on tunnel interfaces is not supported.
OAL is supported on IPv4 unicast traffic only.
You cannot configure OAL and VACL capture on the same chassis. OAL and VACL capture are incompatible. With OAL configured, use SPAN to capture traffic.
If the entry is inactive for the duration that is specified in the
update-intervalseconds command, th e entry is removed from the cache.
If you enter the
nologgingipaccess-listcache command without keywords, all the parameters are returned to the default values.
When enabling the IP "too short" check using the mls verify ip length minimum command, valid IP packets with with an IP protocol field of ICMP(1), IGMP(2), IP(4), TCP(6), UDP(17), IPv6(41), GRE(47), or SIPP-ESP(50) will be hardware switched. All other IP protocol fields are software switched.
Caution
Using optimized access-list logging (OAL) and the mls verify ip length minimum command together can cause routing protocol neighbor flapping as they are incompatible
Examples
This example shows how to enable OAL on ingress packets:
Router(config-if)#
logging ip access-list cache in
This example shows how to enable OAL on egress packets:
Router(config-if)#
logging ip access-list cache out
Related Commands
Command
Description
clearloggingipaccess-listcache
Clears all the entries from the OAL cache and sends them to the syslog.
loggingipaccess-listcache(globalconfiguration)
Configures the OAL parameters.
showloggingipaccess-list
Displays information about the logging IP access list.
update-intervalseconds
Removes entries from the cache that are inactive for the duration that is specified in the command.
logging persistent (config-archive-log-cfg)
To enable the configuration logging persistent feature and to select how the configuration commands are to be saved to the Cisco IOS secure file system, use the loggingpersistent command in the log config submode of archive configuration mode. To disable this capability, use the no form of this command.
loggingpersistent
{ auto | manual }
nologgingpersistent
{ auto | manual }
Syntax Description
auto
Specifies that each configuration command will be saved automatically to the Cisco IOS secure file system.
manual
Specifies that each configuration command must be saved manually to the Cisco IOS secure file system.
Command Default
The configuration commands are not saved to the Cisco IOS secure file system.
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(11)T
This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB.
Usage Guidelines
When you use the manualkeyword, you must save each configuration command manually to the Cisco IOS secure file system. To do this, you must use the archivelogconfigpersistentsave command.
Examples
The following example automatically saves the configuration commands to the Cisco IOS secure file system:
To sequentially apply the configuration commands saved in the configuration logger database (since the last writememorycommand) to the running-config file after a reload, use the loggingpersistentreload command in configuration change logger configuration mode in archive configuration mode. To disable this capability, use the no form of this command.
loggingpersistentreload
nologgingpersistentreload
Syntax Description
This command has no arguments or keywords.
Command Default
The configuration commands saved in the configuration logger database are not applied to the running-config file.
Enables the configuration logging persistent feature.
logging size
To specify the maximum number of entries retained in the configuration log, use the loggingsize command in configuration change logger configuration mode. To reset the default value, use the no form of this command.
loggingsizeentries
nologgingsize
Syntax Description
entries
The maximum number of entries retained in the configuration log. Valid values range from 1 to 1000. The default value is 100 entries.
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB and implemented on the Cisco 10000 series.
Cisco IOS XE Release 3.9S
This command was integrated into Cisco IOS XE Release 3.9S.
Usage Guidelines
When the configuration log is full, the oldest log entry is removed every time a new entry is added.
Note
If a new log size is specified that is smaller than the current log size, the oldest entries will be immediately purged until the new log size is satisfied, regardless of the age of the log entries.
Examples
The following example shows how to specify that the configuration log may have a maximum of 200 entries:
The following example shows how to clear the configuration log by reducing the log size to 1, then resetting the log size to the desired value. Only the most recent configuration log file will be saved.
Enables the sending of notifications of configuration changes to a remote syslog.
showarchivelogconfig
Displays entries from the configuration log.
logging synchronous
To synchronize unsolicited messages and debug output with solicited Cisco IOS software output and prompts for a specific console port line, auxiliary port line, or vty, use the
loggingsynchronous command in line configuration mode. To disable synchronization of unsolicited messages and debug output, use the no form of this command.
loggingsynchronous
[ levelseverity-level | all ]
[ limitnumber-of-lines ]
nologgingsynchronous
[ levelseverity-level | all ]
[ limitnumber-of-lines ]
Syntax Description
levelseverity-level
(Optional) Specifies the message severity level. Messages with a severity level equal to or higher than this value are printed asynchronously. Low numbers indicate greater severity and high numbers indicate lesser severity. The default value is 2.
all
(Optional) Specifies that all messages are printed asynchronously, regardless of the severity level.
limitnumber-of-lines
(Optional) Specifies the number of buffer lines to be queued for the terminal, after which new messages are dropped. The default value is 20.
Command Default
This command is disabled.
If you do not specify a severity level, the default value of 2 is assumed.
If you do not specify the maximum number of buffers to be queued, the default value of 20 is assumed.
Command Modes
Line configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines
When synchronous logging of unsolicited messages and debug output is turned on, unsolicited Cisco IOS software output is displayed on the console or printed after solicited Cisco IOS software output is displayed or printed. This keeps unsolicited messages and debug output from being interspersed with solicited software output and prompts.
Tip
This command is useful for keeping system messages from interrupting your typing. By default, messages will appear immediately when they are processed by the system, and the CLI cursor will appear at the end of the displayed message. For example, the line “Configured by console from console” may be printed to the screen, interrupting whatever command you are currently typing. The loggingsynchronous command allows you to avoid these potentially annoying interruptions without have to turn off logging to the console entirely.
When this command is enabled, unsolicited messages and debug output are displayed on a separate line than user input. After the unsolicited messages are displayed, the CLI returns to the user prompt.
Note
This command is also useful for allowing you to continue typing when debugging is enabled.
When specifying a severity level number, consider that for the logging system, low numbers indicate greater severity and high numbers indicate lesser severity.
When a message queue limit of a terminal line is reached, new messages are dropped from the line, although these messages might be displayed on other lines. If messages are dropped, the notice “
%SYS-3-MSGLOST number-of-messages due to overflow” follows any messages that are displayed. This notice is displayed only on the terminal that lost the messages. It is not sent to any other lines, any logging servers, or the logging buffer.
Caution
By configuring abnormally large message queue limits and setting the terminal to “terminal monitor” on a terminal that is accessible to intruders, you expose yourself to “denial of service” attacks. An intruder could carry out the attack by putting the terminal in synchronous output mode, making a Telnet connection to a remote host, and leaving the connection idle. This could cause large numbers of messages to be generated and queued, and these messages could consume all available RAM. You should guard against this type of attack through proper configuration.
Examples
In the following example, a system message appears in the middle of typing the show running-config command:
Router(config-line)# end
Router# show ru
2w1d: %SYS-5-CONFIG_I: Configured from console by consolenning-config
.
.
.
The user then enables synchronous logging for the current line (indicated by the * symbol in the showline command), after which the system displays the system message on a separate line, and returns the user to the prompt to allow the user to finish typing the command on a single line:
Router# show line
Tty Typ Tx/Rx A Modem Roty AccO AccI Uses Noise Overruns Int
* 0 CTY - - - - - 0 3 0/0 -
.
.
.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# line 0
Router(config-line)# logging syn
<tab>
Router(config-line)# logging synchronous
Router(config-line)# end
Router# show ru
2w1d: %SYS-5-CONFIG_I: Configured from console by console
Router# show running-config
In the following example, synchronous logging for line 4 is enabled with a severity level of 6. Then synchronous logging for line 2 is enabled with a severity level of 7 and is specified with a maximum number of buffer lines of 1,000.
Router(config)# line 4
Router(config-line)# logging synchronous level 6
Router(config-line)# exit
Router(config)# line 2
Router(config-line)# logging synchronous level 7 limit 1000
Router(config-line)# end
Router#
Related Commands
Command
Description
line
Identifies a specific line for configuration and starts the line configuration command collection mode.
loggingon
Controls logging of error messages and sends debug or error messages to a logging process, which logs messages to designated locations asynchronously to the processes that generated the messages.
logging system
To enable System Event Archive (SEA) logging, use the loggingsystemcommand in global configuration mode. To disable SEA logging, use the no form of this command.
loggingsystem
[ diskname ]
nologgingsystem
Syntax Description
diskname
(Optional) Stores the system event archive (system event log file) in the specified disk. The specified disk must be already have been configured to allow for the storage of the system event archive.
Command Default
By default, SEA logging feature is enabled, and the events are logged to a file on a persistent storage device (bootflash: or disk:).
Command Modes
Global configuration (config)
Command History
Release
Modification
12.2(33)SXH
This command was introduced.
12.2(33)SCC
The command was introduced for the Cisco uBR10012 router in the Cisco IOS Software Release 12.2(33)SCC.
Usage Guidelines
SEA is supported on switches that have a Supervisor Engine 32 or Supervisor Engine 720 with a compact flash adapter and a Compact Flash card (WS-CF-UPG= for Supervisor Engine 720).
To stop SEA logging to a specified disk, use the defaultloggingsystem command.
For documentation of the configuration tasks associated with this feature, see the chapter “Configuring the System Event Archive” in the Catalyst 6500 Release 12.2SX Software Configuration Guide
.
Cisco Universal Broadband Router 100112
The SEA feature is used to address the deficiencies of the debug trace and system console. Support for SEA feature was introduced on Cisco uBR10012 Router in the Cisco IOS Release 12.2(33)SCC. Use the loggingsystemdisk command to change the location of the disk used to store the sea_log.dat file.
Note
To store the system event logs, the SEA requires either PCMCIA ATA disk or Compact Flash disk in compact flash adapter for PRE2.
Examples
The following example shows how to specify that the SEA log file should be written to the disk “disk1:”:
Router(config)# logging system disk disk1:
Router(config)# end
Related Commands
clearloggingsystem
Clears the event records stored in the SEA.
copyloggingsystem
Copies the archived system event log to another location.
showloggingsystem
Displays the SEA logging system disk.
logout
To close an active terminal session by logging off the router, use the logout command in user EXEC mode.
logout
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
User EXEC
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples
In the following example, the exit (global) command is used to move from global configuration mode to privileged EXEC mode, the disable command is used to move from privileged EXEC mode to user EXEC mode, and the logout command is used to log off (exit from the active session):
To warn users of an impending forced timeout, use the logout-warningcommand in line configuration mode. To restore the default, use the no form of this command.
logout-warning [seconds]
logout-warning
Syntax Description
seconds
(Optional) Number of seconds that are counted down before session termination. If no number is specified, the default of 20 seconds is used.
Command Default
No warning is sent to the user.
Command Modes
Line configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command notifies the user of an impending forced timeout (set using the absolute-timeout command).
Examples
In the following example, a logout warning is configured on line 5 with a countdown value of 30 seconds:
Router(config)# line 5
Router(config-line)# logout-warning 30
Related Commands
Command
Description
absolute-timeout
Sets the interval for closing user connections on a specific line or port.
session-timeout
Sets the interval for closing the connection when there is no input or output traffic.
macro (global configuration)
To create a global command macro, use themacrocommand in global configuration mode. To remove the macro, use the no form of this command.
Provides a description of the macros applied to the switch.
tracemacro-name
Applies a specified macro with trace enabled.
keyword-to-value
(Optional) Keyword to replace with a value.
value-first-keyword
Value of the first keyword to replace.
value-second-keyword
Value of the second keyword to replace.
value-third-keyword
Value of the third keyword to replace.
namemacro-name
Specifies the name of a macro.
Command Default
This command has no default setting.
Command Modes
Global configuration (config)
Command History
Release
Modification
12.2(33)SXH
This command was introduced.
15.0(1)M
This command was integrated into a release earlier than Cisco IOS Release 15.0(1)M.
Usage Guidelines
You can enter up to three keyword pairs using the macroglobaltrace command.
You can enter the macroglobaldescriptioncommand on the switch stack or on a standalone switch.
Use thedescriptiontextkeyword and argument to associate the comment text, or the macro name with a switch. When multiple macros are applied on a switch, the description text is used from the last applied macro. You can verify the global description settings by using the showparsermacrodescription command.
To find the syntax or configuration errors, enter the macroglobaltracemacro-name command to apply and debug the macro.
To display a list of any keyword-value pairs defined in the macro, enter the macroglobalapplymacro-name? command.
You can delete a global macro-applied configuration on a switch only by entering the no version of each command that is in the macro.
Keyword matching is case sensitive.
When a macro is applied on the commands, all matching occurrences of keywords are replaced with the corresponding values.
The no form of themacroname command deletes only the macro definition. It does not affect the configuration of the interfaces on which the macro is already applied.
Examples
The following example shows how to apply the macro called snmp to set the hostname address to “test-server” and to set the IP precedence value to 7:
Router(config)# macro global apply snmp ADDRESS test-server VALUE 7
The following example shows how to debug the macro called snmp by using the macroglobaltrace command to find the syntax or configuration errors in the macro when it is applied to a switch:
Router(config)# macro global trace snmp VALUE 7 VALUE 8 VALUE 9
Applying command...`snmp-server enable traps port-security'
Applying command...`snmp-server enable traps linkup'
Applying command...`snmp-server enable traps linkdown'
Applying command...`snmp-server host'
%Error Unknown error.
Applying command...`snmp-server ip precedence 7'
Router(config)#
Related Commands
Command
Description
macro(interfaceconfiguration)
Creates an interface-specific command macro.
showparsermacro
Displays the smart port macros.
macro (interface configuration)
To create an interface-specific command macro, use the macro command in interface configuration mode. To remove the macro, use the no form of this command.
Specifies a description about the macros that are applied to the interface.
tracemacro-name
Applies a specified macro with trace enabled.
keyword-to-value
(Optional) Keyword to replace with a value.
value-first-keyword
Value of the keyword to replace.
Command Default
This command has no default setting.
Command Modes
Interface configuration (config-if)
Command History
Release
Modification
12.2(33)SXH
This command was introduced.
Usage Guidelines
You can enter up to three keyword changes using the macrotrace command.
You can enter the macrodescription command on the switch stack or on a standalone switch.
Use the descriptiontext keyword and argument to associate comment text, or the macro name, with a switch. When multiple macros are applied on a switch, the description text will be from the last applied macro. You can verify thedescription settings by entering the showparsermacrodescription command.
To find any syntax or configuration errors, enter the macrotracemacro-name command to apply and debug the macro.
To display a list of any keyword-value pairs defined in the macro, enter the macroapplymacro-name? command.
To successfully apply the macro, you must enter any required keyword-value pairs.
Keyword matching is case sensitive.
In the commands that the macro applies, all matching occurrences of keywords are replaced with the corresponding values.
You can delete all configuration on an interface by entering the defaultinterfaceinterfaceinterface configuration command.
Examples
The following example shows how to apply the user-created macro called desktop-config and to verify the configuration:
To set the maximum number of archive files of the running configuration to be saved in the Cisco configuration archive, use the maximum command in archive configuration mode. To reset this command to its default, use the no form of this command.
maximumnumber
nomaximumnumber
Syntax Description
number
Maximum number of archive files of the running configuration to be saved in the Cisco configuration archive. You can archive from 1 to 14 configuration files. The default is 10.
Command Default
By default, a maximum of 10 archive files of the running configuration are saved in the Cisco configuration archive.
Command Modes
Archive configuration (config-archive)
Command History
Release
Modification
12.3(7)T
This command was introduced.
12.2(25)S
This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2
This command was implemented on the Cisco 10000 series.
12.2(33)SXH
This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(33)SB
This command was integrated into Cisco IOS Release 12.2(33)SB and implemented on the Cisco 10000 series.
Cisco IOS XE Release 3.9S
This command was integrated into Cisco IOS XE Release 3.9S.
Usage Guidelines
Note
Before using this command, you must configure the path command to specify the location and filename prefix for the files in the Cisco configuration archive.
After the maximum number of files are saved in the Cisco configuration archive, the oldest file is automatically deleted when the next, most recent file is saved.
Note
This command should only be used when a local writable file system is specified in the url argument of the path command. Network file systems may not support deletion of previously saved files.
Examples
In the following example, a value of 5 is set as the maximum number of archive files of the running configuration to be saved in the Cisco configuration archive:
configure terminal
!
archive
path disk0:myconfig
maximum 5
end
Related Commands
Command
Description
archiveconfig
Saves a copy of the current running configuration to the Cisco configuration archive.
configureconfirm
Confirms replacement of the current running configuration with a saved Cisco configuration file.
configurereplace
Replaces the current running configuration with a saved Cisco configuration file.
path
Specifies the location and filename prefix for the files in the Cisco configuration archive.
showarchive
Displays information about the files saved in the Cisco configuration archive.
time-period
Sets the time increment for automatically saving an archive file of the current running configuration in the Cisco configuration archive.
memory cache error-recovery
To trace error recovery in memory using caches, use the
memorycacheerror-recoverycommand in global configuration mode. To disable the memory
cache error recovery mechanisms, use the
no form of this command.
Traces error recovery in memory using caches through set
options.
memory cache error-recovery options
To trace error recovery in memory using caches through set options, use the memorycacheerror-recoveryoptionscommand in global configuration mode. To disable the set memory cache error recovery mechanisms, use the no form of this command.
To configure a router to issue system logging message notifications when available memory falls below a specified threshold, use the memoryfreelow-watermarkcommand in global configuration mode. To disable memory threshold notifications, use the no form of this command.
Sets the processor memory threshold in kilobytes. When available processor memory falls below this threshold, a notification message is triggered. Valid values are 1 to 4294967295.
iothreshold
Sets the input/output (I/O) memory threshold in kilobytes. When available I/O memory falls below this threshold, a notification message is triggered. Valid values are 1 to 4294967295.
Command Default
Memory threshold notifications are disabled.
Command Modes
Global configuration
Command History
Release
Modification
12.2(18)S
This command was introduced.
12.0(26)S
This command was integrated into Cisco IOS Release 12.0(26)S.
12.3(4)T
This command was integrated into Cisco IOS Release 12.3(4)T.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Using this command, you can configure a router to issue a system logging message each time available free memory falls below a specified threshold (“low-watermark”). Once available free memory rises to 5 percent above the threshold, another notification message is generated.
Examples
The following example specifies a free processor memory notification threshold of 20000 KB:
To enable the memory allocation lite (malloc_lite) feature, use the memorylite command in global configuration mode. To disable this feature, use the no form of this command.
memorylite
nomemorylite
Syntax Description
This command has no arguments or keywords.
Command Default
This command is enabled by default.
Command Modes
Global configuration
Command History
Release
Modification
12.3(11)T
This command was introduced.
Usage Guidelines
The malloc_lite feature was implemented to avoid excessive memory allocation overhead for situations where less than 128 bytes were required. This feature is supported for processor memory pools only.
The malloc_lite feature is enabled by default. If the malloc_lite feature is disabled using the nomemorylitecommand, you can re-enable the feature by entering the memorylite command.
Examples
The following example shows how to disable the malloc_lite feature:
no memory lite
Related Commands
Command
Description
schedulerheapcheckprocess
Performs a “sanity check” for corruption in memory blocks when a process switch occurs.
memory reserve
To reserve a specified amount of memory in kilobytes for console access and critical notifications, use the memoryreserve command in global configuration mode. To disable the configuration, use the no form of this command.
Syntax for Releases 15.0(1)M and 12.2(33)SRC and Later Releases
Syntax for Releases 12.2(33)SXI, Cisco IOS XE Release 2.1 and Later Releases
memoryreservecritical [total-size]
nomemoryreservecritical
Syntax Description
console
Reserves the memory size for a console session.
size
Amount of memory to be reserved, in kilobytes. The range is from 1 to 4096.
critical
Reserves the memory for critical notifications.
total-size
(Optional) Total amount of memory to be reserved, in kilobytes. The range is from 1 to 4294967295.
Command Modes
Global configuration (config)
Command Default
256 KB is reserved for console memory access.
100 KB is reserved for cricial memory access.
Command History
Release
Modification
15.0(1)M
This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
12.2(33)SRC
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SRC.
12.2(33)SXI
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SXI.
Cisco IOS XE Release 2.1
This command was implemented on the Cisco ASR 1000 Series Aggregation Services Routers.
Usage Guidelines
The memoryreserveconsole command reserves enough memory to ensure console access to a Cisco IOS device for administrative and troubleshooting purposes. This feature is especially beneficial when the device runs low on memory.
The memoryreservecritical command reserves the specified amount of memory in kilobytes so that the router can issue critical notifications. The amount of memory reserved for critical notifications cannot exceed 25 percent of the total available memory.
Examples
The following example shows how to reserve a specified amount of memory in kilobytes for console access:
Configures a router to issue system logging message notifications when available memory falls below a specified threshold.
memory reserve critical
Note
Effective with Cisco IOS Release 12.4(15)T1, the memoryreservecritical command is replaced by the memoryreserve command. See the memoryreserve command for more information.
To configure the size of the memory region to be used for critical notifications (system logging messages), use the memoryreservecriticalcommand in global configuration mode. To disable the reservation of memory for critical notifications, use the no form of this command.
memoryreservecriticalkilobytes
nomemoryreservecritical
Syntax Description
kilobytes
Specifies the amount of memory to be reserved in kilobytes. Valid values are 1 to 4294967295, but the value you specify cannot exceed 25 percent of total memory. The default is 100 kilobytes.
Command Default
100 kilobytes of memory is reserved for the logging process.
Command Modes
Global configuration (config)
Command History
Release
Modification
12.2(18)S
This command was introduced.
12.0(26)S
This command was integrated into Cisco IOS Release 12.0(26)S.
12.3(4)T
This command was integrated into Cisco IOS Release 12.3(4)T.
12.2(27)SBC
This command was integrated into Cisco IOS Release 12.2(27)SBC.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(15)T1
This command was replaced by the memoryreserve command.
Usage Guidelines
This command reserves a region of memory on the router so that, when system resources are overloaded, the router retains enough memory to issue critical system logging messages.
Note
Once the size of the reserved memory region is specified, any change to the specified value takes effect only after the current configuration is saved and the system has been reloaded.
Examples
The following example shows how to reserve 1,000 KB of system memory for logging messages at the next system restart:
Router(config)# memory reserve critical 1000
Related Commands
Command
Description
memoryfreelow-watermark
Configures a router to issue syslog notifications when available memory falls below a specified threshold.
memory sanity
To perform a “sanity check” for corruption in buffers and queues, use the memorysanity command in global configuration mode. To disable this feature, use the no form of this command.
memorysanity
[ buffer | queue | all ]
nomemorysanity
Syntax Description
buffer
(Optional) Specifies checking all buffers.
queue
(Optional) Specifies checking all queues.
all
(Optional) Specifies checking all buffers and queues.
Command Default
This command is not enabled by default.
If the buffer or queue keyword is not specified, a sanity check will be performed on all buffers and queues.
Command Modes
Global configuration
Command History
Release
Modification
12.2(15)T
This command was introduced.
Usage Guidelines
When the memorysanitybuffer command is enabled, a sanity check is performed on buffers when a packet buffer is allocated or when a packet buffer is returned to the buffer pool. This command also time-stamps the buffer, which may be useful when tracking the age of a buffer.
The memorysanity command can be saved in the startup configuration file and, therefore, it is not necessary to reconfigure this command each time the router is reloaded. Like the schedulerheapcheckprocessmemory command, the memorysanity command can check for corruption in the I/O memory block.
Enabling the memorysanity command may result in slight router performance degradation.
Examples
The following example shows how to perform a sanity check for corruption in all buffers and queues:
memory sanity all
Related Commands
Command
Description
schedulerheapcheckprocessmemory
Performs a “sanity check” for corruption in memory blocks when a process switch occurs.
memory scan
To enable the Memory Scan feature, use the memory scan command in global configuration mode. To restore the router configuration to the default, use the no form of this command.
memoryscan
nomemoryscan
Syntax Description
This command has no arguments or keywords.
Command Default
This command is disabled by default.
Command Modes
Global configuration
Command History
Release
Modification
12.0(4)XE
This command was introduced.
12.0(7)T
This command was integrated in Cisco IOS Release 12.0 T for the Cisco 7500 series only.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
The Memory Scan feature adds a low-priority background process that searches all installed dynamic random-access memory (DRAM) for possible parity errors. If errors are found in memory areas that are not in use, this feature attempts to scrub (remove) the errors. The time to complete one memory scan and scrub cycle can range from 10 minutes to several hours, depending on the amount of installed memory. The impact of the Memory Scan feature on the central processing unit (CPU) is minimal. To view the status of the memory scan feature on your router, use the showmemoryscan command in EXEC mode.
Examples
The following example enables the Memory Scan feature on a Cisco 7500 series router:
Router(config)# memory scan
Related Commands
Command
Description
showmemoryscan
Displays the number and type of parity errors on your system.
memory-size iomem
To reallocate the percentage of DRAM to use for I/O memory and processor memory, use the
memory-sizeiomem command in global configuration mode. To revert to the default memory allocation, use the
no form of this command.
memory-sizeiomemi/o-memory-percentage
nomemory-sizeiomem
Syntax Description
i/o-memory-percentage
The percentage of DRAM allocated to I/O memory, in bytes. The values permitted are
5,
10,
15,
20,
25,
30,
40, and
50 . A minimum of 4 MB of memory is required for I/O memory.
Command Default
The default memory allocation is 25 percent of the DRAM to I/O memory and 75 percent of the DRAM to processor memory.
Note
If thesmartinitprocess has been enabled, the default memory allocation of 25 percent to the I/O memory does not apply. Instead,
smartinitexamines the network modules, and then calculates the memory allocation for the I/O memory.
Command Modes
Global configuration (config)
Command History
Release
Modification
11.2 P
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(15)T1
This command was integrated into Cisco IOS Release 12.4(15)T1.
Usage Guidelines
When you specify the percentage of I/O memory in the command line, the processor memory automatically acquires the remaining percentage of the DRAM memory.
Examples
The following example allocates 40 percent of the DRAM memory to I/O memory and the remaining 60 percent to the processor memory:
Router#configure terminal
Router(config)#memory-size iomem 40
Smart-init will be disabled and new I/O memory size will take effect upon reload.
menu (EXEC)
To display a preconfigured user menu, use the menu command in user EXEC or privileged EXEC mode.
menumenu-name
Syntax Description
menu-name
The name of the menu.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
A user menu is a type of user interface where text descriptions of actions to be performed are displayed to the user. The user can use the menu to select services and functions without having to know the details of command-line interface (CLI) commands.
Menus can be created for users in global configuration mode, using the commands listed in the “Related Commands” section.
A menu can be invoked at either the user or privileged EXEC level, but if an item in the menu contains a privileged EXEC command, the user must be logged in at the privileged level for the command to succeed.
Examples
The following example invokes a menu named OnRamp:
Router> menu OnRamp
Welcome to OnRamp Internet Services
Type a number to select an option;
Type 9 to exit the menu.
1 Read email
2 UNIX Internet access
3 Resume UNIX connection
6 Resume next connection
9 Exit menu system
Related Commands
Command
Description
menuclear-screen
Clears the terminal screen before displaying a menu.
menucommand
Specifies underlying commands for user interface menus.
menudefault
Specifies the menu item to use as the default.
menuline-mode
Requires the user to press Enter after specifying an option number.
menuoptions
Sets options for items in user interface menus.
menuprompt
Specifies the prompt for a user interface menu.
menusingle-space
Displays menu items single-spaced rather than double-spaced.
menustatus-line
Displays a line of status information about the current user at the top of a menu.
menutext
Specifies the text of a menu item in a user interface menu.
menutitle
Creates a title, or banner, for a user menu.
nomenu
Deletes a specified menu from a menu configuration.
menu menu-name single-space
To display
menu items single-spaced rather than double-spaced, use the menu<menu-name>single-spacecommand in global configuration mode.
menumenu-namesingle-space
Syntax Description
menu-name
Name of the menu this command should be applied to.
Command Default
Enabled for menus with more than nine items; disabled for menus with nine or fewer items.
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
When more than nine menu items are defined, the menu is displayed single-spaced. To configure the menus with nine or fewer items to display single-spaced, use this command.
Examples
In the following example, single-spaced menu items are displayed for the menu named Access1:
menu Access1 single-space
Related Commands
Command
Description
menu(EXEC)
Invokes a user menu.
menuclear-screen
Clears the terminal screen before displaying a menu.
menucommand
Specifies underlying commands for user menus.
menudefault
Specifies the menu item to use as the default.
menuline-mode
Requires the user to press Enter after specifying an item.
menuoptions
Sets options for items in user menus.
menuprompt
Specifies the prompt for a user menu.
menustatus-line
Displays a line of status information about the current user at the top of a menu.
menutext
Specifies the text of a menu item in a user menu.
menutitle
Creates a title, or banner, for a user menu.
menu clear-screen
To clear the terminal screen before displaying a menu, use the
menuclear-screen command in global configuration mode.
menuclear-screenmenu-nameclear-screen
Syntax Description
menu-name
Name of the menu this command should be applied to.
Command Default
Disabled
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command uses a terminal-independent mechanism based on termcap entries defined in the router and the configured terminal type for the user. This command allows the same menu to be used on multiple types of terminals instead of having terminal-specific strings embedded within menu titles. If the termcap entry does not contain a clear string, the menu system enters 24 new lines, causing all existing text to scroll off the top of the terminal screen.
Examples
In the following example, the terminal screen is cleared before displaying the menu named Access1:
Router(config)# menu Access1 clear-screen
Related Commands
Command
Description
menu(EXEC)
Invokes a user menu.
menucommand
Specifies underlying commands for user menus.
menudefault
Specifies the menu item to use as the default.
menuline-mode
Requires the user to press Enter after specifying an item.
menuoptions
Sets options for items in user menus.
menuprompt
Specifies the prompt for a user menu.
menusingle-space
Displays menu items single-spaced rather than double-spaced.
menustatus-line
Displays a line of status information about the current user at the top of a menu
menutext
Specifies the text of a menu item in a user menu.
menutitle
Creates a title, or banner, for a user menu.
nomenu
Deletes a specified menu from a menu configuration.
menu command
To specify underlying commands for user menus, use the
menucommand command in global configuration mode.
Name of the menu. You can specify a maximum of 20 characters.
menu-item
Number, character, or string used as the key for the item. The key is displayed to the left of the menu item text. You can specify a maximum of 18 menu entries. When the tenth item is added to the menu, the line-mode and single-space options are activated automatically.
command
Command to issue when the user selects an item.
menu-exit
Provides a way for menu users to return to a higher-level menu or exit the menu system.
Command Default
Disabled
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Use this command to assign actions to items in a menu. Use the
menutext global configuration command to assign text to items. These commands must use the same menu name and menu selection key.
The
menucommand command has a special keyword for the
command argument,
menu-exit, that is available only within menus. It is used to exit a submenu and return to the previous menu level, or to exit the menu altogether and return to the EXEC command prompt.
You can create submenus that are opened by selecting entries in another menu. Use the
menuEXEC command as the
command for the submenu item.
Note
If you nest too many levels of menus, the system prints an error message on the terminal and returns to the previous menu level.
When a menu allows connections (their normal use), the command for an entry activating the connection should contain a
resumecommand, or the line should be configured to prevent users from escaping their sessions with the
escape-charnonecommand. Otherwise, when they escape from a connection and return to the menu, there will be no way to resume the session and it will sit idle until the user logs out.
Specifying the
resume command as the action that is performed for a selected menu entry permits a user to resume a named connection or connect using the specified name, if there is no active connection by that name. As an option, you can also supply the connect string needed to connect initially. When you do not supply this connect string, the command uses the specified connection name.
You can also use the
resume/next command, which resumes the next connection in the user’s list of connections. This function allows you to create a single menu entry that steps through all of the user’s connections.
Note
A menu should not contain any exit paths that leave users in an unfamiliar interface environment.
When a particular line should always display a menu, that line can be configured with an
autocommand line configuration command. Menus can be run on a per-user basis by defining a similar
autocommandcommand for that local username. For more information about the
autocommand command, refer to the
Cisco IOS Dial Technologies Configuration Guide.
Examples
In the following example, the commands to be issued when the menu user selects option 1, 2, or 3 are specified for the menu named Access1:
menu Access1 command 1 tn3270 vms.cisco.com
menu Access1 command 2 rlogin unix.cisco.com
menu Access1 command 3 menu-exit
The following example allows a menu user to exit a menu by entering Exit at the menu prompt:
menu Access1 text Exit Exit
menu Access1 command Exit menu-exit
Related Commands
Command
Description
autocommand
Configures the Cisco IOS software to automatically execute a command when a user connects to a particular line.
menu(EXEC)
Invokes a user menu.
menuclear-screen
Clears the terminal screen before displaying a menu.
menudefault
Specifies the menu item to use as the default.
menuline-mode
Requires the user to press Enter after specifying an item.
menuoptions
Sets options for items in user menus.
menuprompt
Specifies the prompt for a user menu.
menusingle-space
Displays menu items single-spaced rather than double-spaced.
menustatus-line
Displays a line of status information about the current user at the top of a menu
menutext
Specifies the text of a menu item in a user menu.
menutitle
Creates a title, or banner, for a user menu.
menu default
To specify the menu item to use as the default, use the
menudefault command in global configuration mode.
menumenu-namedefaultmenu-item
Syntax Description
menu-name
Name of the menu. You can specify a maximum of 20 characters.
menu-item
Number, character, or string key of the item to use as the default.
Command Default
Disabled
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Use this command to specify which menu entry is used when the user presses Enter without specifying an item. The menu entries are defined by the
menucommandand
menutext global configuration commands.
Examples
In the following example, the menu user exits the menu when pressing Enter without selecting an item:
menu Access1 9 text Exit the menu
menu Access1 9 command menu-exit
menu Access1 default
9
Related Commands
Command
Description
menu(EXEC)
Invokes a preconfigured user menu.
menucommand
Specifies underlying commands for user menus.
menuprompt
Specifies the prompt for a user menu.
menutext
Specifies the text of a menu item in a user menu.
menutitle
Creates a title, or banner, for a user menu.
menu line-mode
To require the user to press Enter after specifying an item, use the
menuline-modecommand in global configuration mode.
menumenu-nameline-mode
Syntax Description
menu-name
Name of the menu this command should be applied to.
Command Default
Enabled for menus with more than nine items. Disabled for menus with nine or fewer items.
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
In a menu of nine or fewer items, you ordinarily select a menu item by entering the item number. In line mode, you select a menu entry by entering the item number and pressing Enter. Line mode allows you to backspace over the selected number and enter another number before pressing Enter to issue the command.
This option is activated automatically when more than nine menu items are defined but also can be configured explicitly for menus of nine or fewer items.
In order to use strings as keys for items, the
menuline-mode command must be configured.
Examples
In the following example, the line-mode option is enabled for the menu named Access1:
menu Access1 line-mode
Related Commands
Command
Description
menu(EXEC)
Invokes a preconfigured user menu.
menuclear-screen
Clears the terminal screen before displaying a menu.
menucommand
Specifies underlying commands for a user menu.
menudefault
Specifies the menu item to use as the default.
menuoptions
Sets options for items in user menus.
menuprompt
Specifies the prompt for a user menu.
menusingle-space
Displays menu items single-spaced rather than double-spaced.
menustatus-line
Displays a line of status information about the current user at the top of a menu.
menutext
Specifies the text of a menu item in a user menu.
menu options
To set options for items in user menus, use the
menuoptions command in global configuration mode.
Cisco IOS Release 10.0, 12.2(33)SRA, 12.2(33)SXI , and Later Releases
menumenu-nameoptionsmenu-item [login] [pause]
Cisco IOS XE Release 3.1S and Later Releases
menumenu-nameoptionsmenu-item
{ login | pause }
Syntax Description
menu-name
The name of the menu. You can specify a maximum of 20 characters.
menu-item
Number, character, or string key of the item affected by the option.
login
(Optional) Configures the router to request a login before issuing the command.
pause
(Optional) Configures the router to pause after issuing the command and before redrawing the menu.
Command Default
The menu options are disabled.
Command Modes
Global configuration (config)
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXI
This command was integrated into a release earlier than Cisco IOS Release 12.2(33)SXI.
Cisco IOS XE Release 3.1S
This command was integrated into a release earlier than Cisco IOS Release 3.1S.
Usage Guidelines
Use the
menucommandand
menutext commands to define a menu entry.
Examples
The following example shows how to configure the router to request a login before issuing the command specified by menu entry 3 of the menu named Access1:
Router(config)#
menu Access1 options 3 login
Related Commands
Command
Description
menu(EXEC)
Invokes a user menu.
menuclear-screen
Clears the terminal screen before displaying a menu.
menucommand
Specifies underlying commands for user menus.
menudefault
Specifies the menu item to use as the default.
menuline-mode
Requires the user to press Enter after specifying an item.
menuprompt
Specifies the prompt for a user menu.
menusingle-space
Displays menu items single-spaced rather than double-spaced.
menustatus-line
Displays a line of status information about the current user at the top of a menu.
menutext
Specifies the text of a menu item in a user menu.
menutitle
Creates a title, or banner, for a user menu.
menu prompt
To specify the prompt for a user menu, use the
menuprompt command in global configuration mode.
menumenu-namepromptdpromptd
Syntax Description
menu-name
Name of the menu. You can specify a maximum of 20 characters.
d
A delimiting character that marks the beginning and end of a title. Text delimiters are characters that do not ordinarily appear within the text of a title, such as slash ( / ), double quote ("), and tilde (~). ^C is reserved for special use and should not be used in the text of the title.
prompt
Prompt string for the menu.
Command Default
Disabled
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Press Enter after entering the first delimiter. The router will prompt you for the text of the prompt. Enter the text followed by the delimiter, and press Enter.
Use the
menucommandand
menutext commands to define the menu selections.
Examples
In the following example, the prompt for the menu named Access1 is configured as “Select an item.”:
Router(config)# menu Access1 prompt /
Enter TEXT message. End with the character '/'.
Select an item. /
Router(config)#
Related Commands
Command
Description
menu(EXEC)
Invokes a user menu.
menucommand
Specifies underlying commands for user menus.
menudefault
Specifies the menu item to use as the default.
menutext
Specifies the text of a menu item in a user menu.
menutitle
Creates a title, or banner, for a user menu.
menu status-line
To display a line of status information about the current user at the top of a menu, use the menustatus-linecommand in global configuration mode.
menumenu-namestatus-line
Syntax Description
menu-name
Name of the menu this command should be applied to.
Command Default
Disabled
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command displays the status information at the top of the screen before the menu title is displayed. This status line includes the router’s host name, the user’s line number, and the current terminal type and keymap type (if any).
Examples
In the following example, status information is enabled for the menu named Access1:
menu Access1 status-line
Related Commands
Command
Description
menu(EXEC)
Invokes a user menu.
menuclear-screen
Clears the terminal screen before displaying a menu.
menucommand
Specifies underlying commands for user menus.
menudefault
Specifies the menu item to use as the default.
menuline-mode
Requires the user to press Enter after specifying an item in a menu.
menuoptions
Sets options for items in user menus.
menuprompt
Specifies the prompt for a user menu.
menusingle-space
Displays menu items single-spaced rather than double-spaced.
menutext
Specifies the text of a menu item in a user menu.
menutitle
Creates a title, or banner, for a user menu.
menu text
To specify th
e text of a menu item in a user menu, use the menutextcommand in global configuration mode.
menumenu-nametextmenu-itemmenu-text
Syntax Description
menu-name
Name of the menu. You can specify a maximum of 20 characters.
menu-item
Number, character, or string used as the key for the item. The key is displayed to the left of the menu item text. You can specify a maximum of 18 menu items. When the tenth item is added to the menu, the menuline-mode and menusingle-space commands are activated automatically.
menu-text
Text of the menu item.
Command Default
No text appears for the menu item.
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Use this command to assign text to items in a menu. Use the menucommand command to assign actions to items. These commands must use the same menu name and menu selection key.
You can specify a maximum of 18 items in a menu.
Examples
In the following example, the descriptive text for the three entries is specified for options 1, 2, and 3 in the menu named Access1:
menu Access1 text 1 IBM Information Systems
menu Access1 text 2 UNIX Internet Access
menu Access1 text 3 Exit menu system
Related Commands
Command
Description
menu(EXEC)
Invokes a user menu.
menuclear-screen
Clears the terminal screen before displaying a menu.
menucommand
Specifies underlying commands for user menus.
menudefault
Specifies the menu item to use as the default.
menuline-mode
Requires the user to press Enter after specifying an item.
menuoptions
Sets options for items in user menus.
menuprompt
Specifies the prompt for a user menu.
menusingle-space
Displays menu items single-spaced rather than double-spaced.
menustatus-line
Displays a line of status information about the current user at the top of a menu.
menutitle
Creates a title, or banner, for a user menu.
menu title
To create a t
itle (banner) for a user menu, use the menutitle command in global configuration mode.
menumenu-nametitledmenu-titled
Syntax Description
menu-name
Name of the menu. You can specify a maximum of 20 characters.
d
A delimiting character that marks the beginning and end of a title. Text delimiters are characters that do not ordinarily appear within the text of a title, such as slash ( / ), double quote ("), and tilde (~). ^C is reserved for special use and should not be used in the text of the title.
menu-title
Lines of text to appear at the top of the menu.
Command Default
The menu does not have a title.
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
The menutitle command must use the same menu name used with the menutext and menucommand commands used to create a menu.
You can position the title of the menu horizontally by preceding the title text with blank characters. You can also add lines of space above and below the title by pressing Enter.
Follow the title keyword with one or more blank characters and a delimiting character of your choice. Then enter one or more lines of text, ending the title with the same delimiting character. You cannot use the delimiting character within the text of the message.
When you are configuring from a terminal and are attempting to include special control characters, such as a screen-clearing string, you must use Ctrl-V before the special control characters so that they are accepted as part of the title string. The string ^[[H^[[J is an escape string used by many VT100-compatible terminals to clear the screen. To use a special string, you must enter Ctrl-V before each escape character.
You also can use the menuclear-screen global configuration command to clear the screen before displaying menus and submenus, instead of embedding a terminal-specific string in the menu title. The menuclear-screen command allows the same menu to be used on different types of terminals.
Examples
In the following example, the title that will be displayed is specified when the menu named Access1 is invoked. Press Enter after the second slash (/) to display the prompt.
Router(config)# menu Access1 title /^[[H^[[J
Enter TEXT message. End with the character '/'.
Welcome to Access1 Internet ServicesType a number to select an option;Type 9 to exit the menu./
Router(config)#
Related Commands
Command
Description
menu(EXEC)
Invokes a user menu.
menuclear-screen
Clears the terminal screen before displaying a menu.
menucommand
Specifies underlying commands for user menus.
menudefault
Specifies the menu item to use as the default.
menuline-mode
Requires the user to press Enter after specifying an item.
menuoptions
Sets options for items in user menus.
menuprompt
Specifies the prompt for a user menu.
menusingle-space
Displays menu items single-spaced rather than double-spaced.
menustatus-line
Displays a line of status information about the current user at the top of a menu.
menutext
Specifies the text of a menu item in a user menu.
microcode (12000)
To load a Cisco IOS software image on a line card from Flash memory or the GRP card on a Cisco 12000 series Gigabit Switch Router (GSR), use the
microcode command in global configuration mode. To load the microcode bundled with the GRP system image, use the
no form of this command.
Specifies the device and filename of the image file to download from Flash memory. A colon (:) must separate the device and filename (for example, slot0:gsr-p-mz). Valid devices include:
bootflash:--Internal Flash memory.
slot0:--First PCMCIA slot.
slot1:--Second PCMCIA slot.
slot
(Optional) Slot number of the line card that you want to copy the software image to. Slot numbers range from 0 to 11 for the Cisco 12012 router and 0 to 7 for the Cisco 12008 router. If you do not specify a slot number, the Cisco IOS software image is downloaded on all line cards.
system
Loads the image from the software image on the GRP card.
Command Default
The default is to load the image from the GRP card (system).
Command Modes
Global configuration
Command History
Release
Modification
11.2 GS
This command was introduced for Cisco 12000 series GSRs.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
In addition to the Cisco IOS image that resides on the GRP card, each line card on a Cisco 12000 series has a Cisco IOS image. When the router is reloaded, the specified image is loaded onto the GRP card and then automatically downloaded to all the line cards.
Normally, you want the same Cisco IOS image on the GRP card and all line cards. However, if you want to upgrade a line card with a new version of microcode for testing or to fix a defect, you might need to load a Cisco IOS image that is different from the one on the line card. Additionally, you might need to load a new image on the line card to work around a problem that is affecting only one of the line cards.
To load a Cisco IOS image on a line card, first use the
copytftp command to download the Cisco IOS image to a slot on one of the PCMCIA Flash memory cards. Then use the
microcode command to download the image to the line card, followed by the
microcodereload command to start the image. Immediately after you enter the
microcodereload command and press Return, the system reloads all microcode. Global configuration mode remains enabled. After the reloading is complete, enter the
exit command to return to the EXEC system prompt.
To verify that the correct image is running on the line card, use the
execute-onslotslotshowversion command.
For additional information on GSR configuration, refer to the documentation specific to your Cisco IOS software release.
Examples
In the following example, the Cisco IOS software image in slot 0 is downloaded to the line card in slot 10. This software image is used when the system is booted, a line card is inserted or removed, or the
microcodereloadglobal configuration command is issued.
In this example, the user would issue the
execute-onslot10showversioncommand to verify that the correct version is loaded.
Related Commands
Command
Description
microcodereload(12000)
Reloads microcode on Cisco 12000 series GSRs.
microcode (7000/7500)
To specify the location of the microcode that you want to download from Flash memory into the writable control store (WCS) on Cisco 7000 series (including RSP based routers) or Cisco 7500 series routers, use the
microcode command in global configuration mode. To load the microcode bundled with the system image, use the
no form of this command.
microcodeinterface-type
{ flash-filesystem:filename [slot] | rom | system [slot] }
nomicrocodeinterface-type
{ flash-filesystem:filename [slot] | rom | system [slot] }
Syntax Description
interface-type
One of the following interface processor names:
aip,cip,
eip,
feip,
fip,
fsip,
hip,mip,
sip,
sp,
ssp,
trip,
vip, or
vip2
flash-filesystem:
Flash file system, followed by a colon . Valid file systems are
bootflash,
slot0, and
slot1
Slave devices such as slaveslot0 are invalid. The slave’s file system is not available during microcode reloads.
filename
Name of the microcode file.
slot
(Optional) Number of the slot. Range is from 0 to 15.
rom
If ROM is specified, the router loads from the onboard ROM microcode.
system
If the
system keyword is specified, the router loads the microcode from the microcode bundled into the system image you are running for that interface type.
Command Default
The default is to load from the microcode bundled in the system image.
Command Modes
Global configuration
Command History
Release
Modification
10.3
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
If you do not use the
microcodereload command after using the
microcode command, the
microcodereload command will be written to the configuration file automatically.
When using Dual RSPs for simple hardware backup, ensure that the master and slave RSP card contain the same microcode image in the same location when the router is to load the interface processor microcode from a Flash file system. Thus, if the slave RSP becomes the master, it will be able to find the microcode image and download it to the interface processor.
Examples
In the following example, all FIP cards will be loaded with the microcode found in Flash memoryfile fip.v141-7 when the system is booted, when a card is inserted or removed, or when the
microcodereloadglobal configuration command is issued. The configuration is then written to the startup configuration file.
Router(config)#
microcode fip slot0:fip.v141-7
Router(config)# end
Router# copy system:running-config nvram:startup-config
Related Commands
Command
Description
moreflh:logfile
Displays the system console output generated during the Flash load helper operation.
microcode (7200)
To configure a default override for the microcode that is downloaded to the hardware on a Cisco 7200 series router, use the
microcode command in global configuration mode. To revert to the default microcode for the current running version of the Cisco IOS software, use the
no form of this command.
microcode
{ ecpa | pcpa }
location
nomicrocode
{ ecpa | pcpa }
Syntax Description
ecpa
ESCON Channel Port Adapter (CPA) interface.
pcpa
Parallel CPA interface.
location
Location of microcode, including the device and filename.
Command Default
If the default or
noform of the command is specified, the driver uses the default microcode for the current running version of the Cisco IOS software.
Command Modes
Global configuration
Command History
Release
Modification
11.3(3)T
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
If there are any default overrides when the configuration is written, then the
microcodereload command will be written to the configuration automatically. This action enables the configured microcode to be downloaded at system startup.
The CPA microcode image is preloaded on Flash memory cards for Cisco 7200-series routers for Cisco IOS Release 11.3(3)T and later releases. You may be required to copy a new image to Flash memory when a new microcode image becomes available.
For more information on the CPA configuration and maintenance, refer to the “Configuring Cisco Mainframe Channel Connection Adapters” chapter in the
Release 12.2 Cisco IOS Bridging and IBM Networking Configuration Guide.
Examples
The following example instructs the Cisco IOS software to load the microcode from an individual microcode image that is stored as a file on the Flash card inserted in Flash card slot 0:
microcode ecpa slot0:xcpa26-1
Related Commands
Command
Description
microcodereload(7200)
Resets and reloads the specified hardware in a Cisco 7200 series router.
showmicrocode
Displays microcode information.
microcode reload (12000)
To reload the Cisco IOS image from a line card on Cisco 12000 series routers, use the
microcodereloadcommand in global configuration mode.
microcodereload [slot-number]
Syntax Description
slot-number
(Optional) Slot number of the line card that you want to reload the Cisco IOS software image on. Slot numbers range from 0 to 11 for the Cisco 12012 and from 0 to 7 for the Cisco 12008 router. If you do not specify a slot number, the Cisco IOS software image is reloaded on all line cards.
Command Modes
Global configuration
Command History
Release
Modification
11.2 GS
This command was introduced for Cisco 12000 series GSRs.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
In addition to the Cisco IOS image that resides on the GRP card, each line card on Cisco 12000 series routers has a Cisco IOS image. When the router is reloaded, the specified Cisco IOS image is loaded onto the GRP card and automatically downloaded to all the line cards.
Normally, you want the same Cisco IOS image on the GRP card and all line cards. However, if you want to upgrade a line card with a new version of microcode for testing or to fix a defect, you might need to load a different Cisco IOS image. Additionally, you might need to load a new image on the line card to work around a problem affecting only one of the line cards.
To load a Cisco IOS image on a line card, first use the
copytftp command to download the Cisco IOS image to a slot on one of the PCMCIA Flash memory cards. Then use the
microcode command to download the image to the line card, followed by the
microcodereload command to start the image. To verify that the correct image is running on the line card, use the
execute-onslotslotshowversion command.
For additional information on GSR configuration, refer to the “Observing System Startup and Performing a Basic Configuration” chapter in the Cisco 12000 series installation and configuration guides.
The
microcodereload (12000) command allows you to issue another command immediately.
Note
Issuing a
microcodereload command on any of the line cards in a Cisco 12000 GSR immediately returns the console command prompt. This allows you to issue a subsequent command immediately to the reloading line card. However, any commands entered at this time will not execute, and often no indication will be given that such a command failed to run. Verify that the microcode has reloaded before issuing new commands.
Examples
In the following example, the mirocode firmware is reloaded on the line card in slot 10:
Router(config)# microcode reload 10
Related Commands
Command
Description
microcode(12000)
Loads a Cisco IOS software image on a line card from Flash memory or the GRP card on a Cisco 12000 series GSR.
microcode reload (7000 7500)
To reload the processor card on the Cisco 7000 series with RSP7000 or Cisco 7500 series routers, use the microcodereloadcommand in global configuration mode.
microcodereload [slot-number]
Syntax Description
slot-number
(Optional) Reloads the specified processor card slot on a Cisco 7500 series router.
Command Default
No default behaviors or values.
Command Modes
Global configuration
Command History
Release
Modification
10.3
This command was introduced for Cisco 7500 series routers.
12.3(8)T
The slot-number argument was added for Cisco 7500 series routers.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command reloads the microcode without rebooting the router. Immediately after you enter the microcodereload command, the system reloads all microcode. Global configuration mode remains enabled.
Note
If you modify the system configuration to load a microcode image, the microcodereload command will be written to the configuration file automatically following the use of a microcode command. This action enables the configured microcode to be downloaded at system startup.
Examples
In the following example, all controllers are reset, and the microcode specified in the current configuration is loaded:
Router(config)# microcode reload
Related Commands
Command
Description
microcode(7000/7500)
Specifies the location from where microcode should be loaded when the microcodereload command is processed on RSP-based routers.
microcode reload (7200)
To
reload the Cisco IOS microcode image on an ESCON CPA card in the Cisco 7200 series router, use the microcodereloadcommand in privileged EXEC mode.
Resets and reloads all hardware types that support downloadable microcode.
ecpa
Resets and reloads only those slots that contain hardware type ecpa.
pcpa
Resets and reloads only those slots that contain hardware type pcpa.
slotslot-number
(Optional) Resets and reloads only the slot specified, and only if it contains the hardware specified.
Command Modes
Privileged EXEC
Command History
Release
Modification
11.3(3)T
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Hardware types that do not support downloadable microcode are unaffected by the microcodereloadall command.
You will be prompted for confirmation before the microcodereloadcommand is executed.
Examples
The following example reloads the ESCON CPA microcode in slot 5 with the currently configured microcode:
Router# microcode reload ecpa slot 5
Related Commands
Command
Description
microcode(7200)
Configures a default override for the microcode that is downloaded to the hardware on a Cisco 7200 series router.
showmicrocode
Displays the microcode bundled into a Cisco 7000 series with RSP7000, Cisco 7200 series, or Cisco 7500 series router.
mkdir
To create a new directory in a Class C flash file system, use the
mkdir command in user EXEC, privileged EXEC, or diagnostic mode.
mkdirdirectory
Syntax Description
directory
The name of the directory to create.
Command Modes
User EXEC (>) Privileged EXEC (#) Diagnostic (diag)
Command History
Release
Modification
11.3AA
This command was introduced.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS XE Release 2.1
This command was modified and implemented on the Cisco ASR 1000 Aggregation Services Routers. The following enhancements were made:
This command was introduced in diagnostic mode. The command can be entered in both privileged EXEC and diagnostic mode on the Cisco ASR 1000 Series Routers.
The
harddisk:,
obfl:,
stby-harddisk:,
stby-nvram:,
stby-obfl:,
stby-usb[0-1]:,and
usb[0-1]:directory options were added.
Usage Guidelines
This command is valid only on Class C flash file systems.
When executing the
mkdirdirectory command on a USB token device, you can create only two levels of subdirectories under a directory. A new directory (third level directory) cannot be created on the USB token, but you can copy files to the existing subdirectories.
Examples
The following example creates a directory named newdir:
Router# mkdir newdir
Mkdir file name [newdir]?
Created dir flash:newdir
Router# dir
Directory of flash:
2 drwx 0 Mar 13 1993 13:16:21 newdir
8128000 bytes total (8126976 bytes free)
Related Commands
Command
Description
dir
Displays a list of files on a file system.
rmdir
Removes an existing directory in a Class C flash file system.
mkdir disk0:
To create a new directory in a Flash file system, use the
mkdirdisk0:command.
mkdirdisk0:
Syntax Description
This command has no arguments or keywords.
Command Default
This command has no default settings.
Command Modes
EXEC
Command History
Release
Modification
12.2(14)SX
Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB
Support for this command on the Supervisor Engine 2 was extended to the 12.2 SX release.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is valid only on Flash file systems.
After you enter the
mkdirdisk0: command, you are prompted to enter the new directory filename.
To check your entry, enter the
dir command.
To remove a directory, enter the
rmdir command.
Examples
This example shows how to create a directory named newdir:
Router# mkdir disk0:
Create directory filename [ ]? newdir
Created dir disk0: newdir
Router#
Related Commands
Command
Description
cd
Changes the default directory or file system.
dir
Displays a list of files on a file system.
rmdir
Removes an existing directory in a Class C Flash file system.
mode
To set the redundancy mode, use the
modecommand in redundancy configuration mode.
Syntax
for
12.2S
Release
mode
{ rpr | rpr-plus | sso }
Syntax
for
Cisco
IOS
XE
Release
2.5
and
Later
Releases
mode
{ rpr | sso }
Syntax
for
12.2XNE
Release
modesso
Syntax Description
rpr
Specifies Route Processor Redundancy (RPR) mode.
rpr-plus
Specifies Route Processor Redundancy Plus (RPR+) mode.
sso
Specifies stateful switchover (SSO) mode.
Cisco 7600 Series Routers That Are Configured with a Supervisor Engine 720
The default is SSO mode if the system is not configured for redundancy and the active and standby supervisor engines have the same image.
The default is RPR mode if different versions are installed.
If redundancy is enabled, the default is the mode that you have configured.
The default is RPR+ mode if the system is not configured for redundancy and the active and standby supervisor engines have the same image.
The default is RPR mode if different versions are installed.
If redundancy is enabled, the default is the mode that you have configured.
The default is SSO mode if the system is not configured for redundancy and the active and standby supervisor engines have the same image.
The default is RPR mode if different versions are installed.
The default is SSO mode if the system is not configured for redundancy and the active and standby supervisor engines have the same image.
The default is RPR mode if different versions are installed.
Command Modes
Redundancy configuration (config-red)
Command History
Release
Modification
12.2(14)SX
This command was introduced on the Supervisor Engine 720.
12.2(17b)SXA
This command was modified. Support was added for SSO mode and the default mode change.
12.2(17d)SXB
This command was modified. Support was added for multicast and unicast traffic.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)XNE
This command was modified. This command was implemented on the Cisco 10000 router.
Cisco IOS XE Release 2.5
This command was modified. This command was implemented on the Cisco ASR 1000 Series Routers.
Usage Guidelines
Cisco IOS Release 12.2S and 7600 Series Routers
SSO is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
On releases prior to Release 12.2(17d)SXB, single router mode (SRM) with SSO redundancy does not support stateful switchover for multicast traffic. When a switchover occurs, all multicast hardware switching entries are removed and are then re-created and reinstalled in the hardware by the newly active multilayer switch feature card (MSFC).
SRM/SSO is supported in the following releases only:
Release 12.2(17b)SXA and subsequent rebuilds.
Release 12.2(17d)SXB and subsequent rebuilds.
Nonstop forwarding (NSF) with SSO redundancy mode supports IPv4. NSF with SSO redundancy mode does not support IPv6, Internetwork Packet Exchange (IPX), and Multiprotocol Label Switching (MPLS).
If you have configured MPLS on the Cisco 7600 series routers with redundant supervisor engines, you must configure the Cisco 7600 series router in RPR mode. The switch should not be running in the default mode of SSO.
Enter the
redundancy command in global configuration mode to enter redundancy configuration mode. You can enter the
modecommand within redundancy configuration mode.
Follow these guidelines when configuring your system for RPR+ mode:
You must install compatible images on the active and standby supervisor engines to support RPR+ mode and SSO mode.
Both supervisor engines must run the same Cisco IOS software version.
Any modules that are not online at the time of a switchover are reset and reloaded on a switchover.
The Forwarding Information Base (FIB) tables are cleared on a switchover. As a result, routed traffic is interrupted until route tables reconverge.
The standby supervisor engine reloads on any change of mode and begins to work in the current mode. When you use this command to force the standby supervisor engine to run as a Distributed Forwarding Card (DFC) card, the uplink ports in the standby engine continue to be in use and are not disabled.
Cisco IOS Release XE Release 2.5 and ASR 1000 Series Routers
For Cisco ASR 1002 and 1004 routers, RRP and stateful switchover can be used to switch between Cisco IOS processes. RPR and SSO need to be configured by the user, however, because a second Cisco IOS process is not available by default on Cisco ASR 1002 and 1004 routers. Enter the
redundancy command in global configuration mode to enter redundancy configuration mode. You can enter the
modecommand within redundancy configuration mode.
The Cisco ASR 1006 Router supports a second Route Processor. The second Cisco IOS process can run only on the standby Route Processor. This means that hardware redundancy is available and RPR and SSO do not need to be configured by the user because a second Cisco IOS process is available by default on the Cisco ASR 1006 router.
RPR+ mode is not supported on the Cisco ASR 1000 Series Routers.
Cisco IOS Release 12.2XNE and 1000 Series Routers
Enter the
redundancy command in global configuration mode to enter redundancy configuration mode. You can enter the
modecommand within redundancy configuration mode.
RPR mode is not supported on the Cisco 10000 router.
Examples
This example shows how to set the redundancy mode to RPR+: