Table Of Contents
ping
ping ip
ping vrf
policy (ERM)
policy (resource group)
policy-list
poll-interval
printer
private
process cpu statistics limit entry-percentage
process cpu threshold type
process-max-time
processes cpu autoprofile hog
processes cpu extended
prompt
pwd
redistribute (IP)
refuse-message
reload
rename
request-data-size
resource policy
response-data-size
retain
retry (bulkstat)
rmdir
rmon
rmon alarm
rmon capture-userdata
rmon collection history
rmon collection host
rmon collection matrix
rmon collection rmon1
rmon event
rmon queuesize
rommon-pref
rsh
rtr
rtr group schedule
rtr key-chain
rtr logging traps
rtr low-memory
rtr reaction-configuration
rtr reaction-trigger
rtr reset
rtr responder
rtr responder type frame-relay
rtr responder type tcpConnect
rtr responder type udpEcho
rtr restart
rtr schedule
rtr slm frame-relay statistics
saa apm cache-size
saa apm copy
saa apm lowWaterMark
saa apm operation
samples-of-history-kept
scheduler allocate
scheduler heapcheck process
scheduler interval
schema
scripting tcl encdir
scripting tcl init
send
server (boomerang)
service compress-config
service config
service decimal-tty
service exec-wait
service finger
service hide-telnet-address
service linenumber
service nagle
service prompt config
service sequence-numbers
ping
To diagnose basic network connectivity on AppleTalk, ATM, Connectionless Network Service (CLNS), DECnet, IP, Novell IPX, or source-route bridging (SRB) networks, use the ping command in user EXEC or privileged EXEC mode.
ping [[protocol [tag] {host-name | system-address}]
Syntax Description
protocol
|
(Optional) Protocol keyword, one of appletalk, atm, clns, decnet, ipx, or srb. If a specific protocol is not specified, a basic ping will be sent using IP (IPv4). For extended options for ping over IP, see the documentation for the ping ip command.
Note The ping atm interface atm, ping ip, ping ipv6, ping sna, and ping vrf commands are documented separately.
|
tag
|
(Optional) Specifies a tag encapsulated IP (tagIP) ping.
|
host-name
|
Host name of the system to ping. If a host-name or system-address is not specified at the command line, it will be required in the ping system dialog.
|
system-address
|
Address of the system to ping. If a host-name or system-address is not specified at the command line, it will be required in the ping system dialog.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0(7)T
|
The ping sna command was introduced.
|
12.1(12c)E
|
The ping vrf command was introduced.
|
12.2(2)T
|
Support for the IPv6 protocol was added.
|
12.2(13)T
|
The atm protocol keyword was added.
The following keywords were removed because the Apollo Domain, Banyan VINES, and XNS protocols are no longer supported in Cisco IOS software:
• apollo
• vines
• xns
|
Usage Guidelines
The ping command sends an echo request packet to an address, and then awaits a reply. Ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning. For example, the ping clns command sends International Organization for Standardization (ISO) CLNS echo packets to test the reachability of a remote router over a connectionless Open System Interconnection (OSI) network.
If you enter the ping command without any other syntax (ping<cr>), the CLI will display an interactive system dialog that prompts you for the additional syntax appropriate to the protocol you specify (See the "Examples" section).
To exit the interactive ping dialog before responding to all the prompts, type the escape sequence. The default escape sequence is Ctrl-^,X (Simultaneously press and release the Ctrl, Shift, and 6 keys and then press the X key). The escape sequence will vary depending on your line configuration. For example, another commonly used escape sequence is Ctrl-c.
Table 53 describes the test characters sent by the ping facility.
Table 53 ping Test Characters
Character
|
Description
|
!
|
Each exclamation point indicates receipt of a reply.
|
.
|
Each period indicates that the network server timed out while waiting for a reply.
|
U
|
A destination unreachable error protocol data unit (PDU) was received.
|
C
|
A congestion experienced packet was received.
|
I
|
User interrupted test.
|
?
|
Unknown packet type.
|
&
|
Packet lifetime exceeded.
|
Note
Not all protocols require hosts to support pings. For some protocols, the pings are Cisco-defined and can be answered only by another Cisco router.
The availability of protocol keywords depends on what protocols are enabled on your system.
Issuing the ping command in User EXEC mode will generally offer fewer syntax options than issuing the ping command in Privileged EXEC mode.
Examples
After you enter the ping command in privileged EXEC mode, the system prompts you for a protocol keyword. The default protocol is IP.
If you enter a host name or address on the same line as the ping command, the default action is taken as appropriate for the protocol type of that name or address.
The following example is sample dialog from the ping command using default values. The specific dialog varies somewhat from protocol to protocol.
Target IP address: 192.168.7.27
Sweep range of sizes [n]:
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 192.168.7.27, timeout is 2 seconds:
Success rate is 100 percent, round-trip min/avg/max = 1/2/4 ms
Table 54 describes the significant fields shown in the display.
Table 54 ping Field Descriptions for IP
Field
|
Description
|
Protocol [ip]:
|
Prompts for a supported protocol. Default: ip.
|
Target IP address:
|
Prompts for the IP address or host name of the destination node you plan to ping. If you have specified a supported protocol other than IP, enter an appropriate address for that protocol here. Default: none.
|
Repeat count [5]:
|
Number of ping packets that will be sent to the destination address. Default: 5.
|
Datagram size [100]:
|
Size of the ping packet (in bytes). Default: 100 bytes.
|
Timeout in seconds [2]:
|
Timeout interval. Default: 2 (seconds).
|
Extended commands [n]:
|
Specifies whether a series of additional commands appears.
|
Sweep range of sizes [n]:
|
Allows you to vary the sizes of the echo packets being sent. This capability is useful for determining the minimum sizes of the MTUs1 configured on the nodes along the path to the destination address. Packet fragmentation contributing to performance problems can then be reduced.
|
!!!!!
|
Each exclamation point (!) indicates receipt of a reply. A period (.) indicates that the network server timed out while waiting for a reply. Other characters may appear in the ping output display, depending on the protocol type.
|
Success rate is 100 percent
|
Percentage of packets successfully echoed back to the router. Anything less than 80 percent is usually considered problematic.
|
round-trip min/avg/max = 1/2/4 ms
|
Round-trip travel time intervals for the protocol echo packets, including minimum/average/maximum (in milliseconds).
|
The following example verifies connectivity to the neighboring ATM device for the ATM PVC with the virtual path identifier (VPI)/virtual channel identifier (VCI) value 0/16:
Loopback - End(0), Segment(1) [0]:1
Type escape sequence to abort.
Sending 5, 53-byte segment OAM echoes, timeout is 2 seconds:
Success rate is 100 percent (5/5), round-trip min/avg/max = 1/1/1 ms
Table 55 describes the default ping fields shown in the display.
Table 55 ping Field Descriptions for ATM
Field
|
Description
|
Protocol [ip]:
|
Prompt for a supported protocol. Enter appletalk, atm, clns, ip, novell, apollo, vines, decnet, or xns. Default: ip.
|
ATM Interface:
|
Prompt for the ATM interface.
|
VPI value [0]:
|
Prompt for the virtual path identifier. Default: 0.
|
VCI value [1]:
|
Prompt for the virtual channel identifier. Default:1.
|
Loopback - End(0), Segment(1) [0]:
|
Prompt to specify end loopback, which verifies end-to-end PVC integrity, or segment loopback, which verifies PVC integrity to the neighboring ATM device. Default: segment loopback.
|
Repeat Count [5]:
|
Number of ping packets that will be sent to the destination address. Default: 5.
|
Timeout [2]:
|
Timeout interval. Default: 2 (seconds).
|
!!!!!
|
Each exclamation point (!) indicates receipt of a reply. A period (.) indicates that the network server timed out while waiting for a reply. Other characters may appear in the ping output display, depending on the protocol type.
|
Success rate is 100 percent
|
Percentage of packets successfully echoed back to the router. Anything less than 80 percent is usually considered problematic.
|
round-trip min/avg/max = 1/1/1 ms
|
Round-trip travel time intervals for the protocol echo packets, including minimum/average/maximum (in milliseconds).
|
Related Commands
Command
|
Description
|
ping atm interface atm
|
Tests the connectivity of a specific PVC.
|
ping ip
|
Tests network connectivity on IP networks.
|
ping ipv6
|
Tests the connection to a remote host on the network using IPv6.
|
ping sna
|
Tests network integrity and timing characteristics over an SNA Switching network.
|
ping vrf
|
Tests the connection in the context of a specific VPN (VRF).
|
ping ip
To test network connectivity on IP networks, use the ping ip command in privileged EXEC mode.
ping ip {host-name | ip-address} [data [hex-data-pattern] | df-bit | repeat [repeat-count] | size
[datagram-size] [source {source-address | source-interface} ] [timeout seconds] [validate]
[verbose]
Syntax Description
host-name
|
Host name of the system to ping.
|
system-address
|
Address of the system to ping.
|
data hex-data-pattern
|
(Optional) Specifies the data pattern. Range is from 0 to FFFF.
|
df-bit
|
(Optional) Enables the "do-not-fragment" bit in the IP header.
|
repeat repeat-count
|
(Optional) Specifies the number of pings sent. The range is from 1 to 2147483647. The default is 5.
|
size
|
(Optional) Specifies the datagram size. Datagram size is the number of bytes in each ping.
|
datagram-size
|
(Optional) Range is from 40 to 18024.
|
source
|
(Optional) Specifies the source address or source interface.
|
source-address
|
(Optional) IP address to use as the source in the ping packets.
|
source-interface
|
(Optional) Name of the interface from which the ping should be sent, and the Interface ID (slot/port/number). Interface name keywords include the following:
• async (Asynchronous Interface)
• bvi (Bridge-Group Virtual Interface)
• ctunnel
• dialer
• ethernet
• fastEthernet
• lex
• loopback
• multilink (Multilink-group interface)
• null
• port-channel (Ethernet channel of interfaces)
• tunnel
• vif (PGM Multicast Host interface)
• virtual-template
• virtual-tokenring
• xtagatm (Extended Tag ATM interface)
The availability of these keywords depends on your system hardware.
|
timeout seconds
|
(Optional) Specifies the timeout interval in seconds. The default is 2 seconds. Range is from 0 to 3600.
|
validate
|
(Optional) Validates the reply data.
|
verbose
|
(Optional) Enables verbose output, which lists individual ICMP packets, as well as Echo Responses.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0
|
The data, df-bit, repeat, size, source, timeout, and validate keywords were added.
|
Usage Guidelines
The ping command sends an echo request packet to an address, then awaits a reply. Ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.
To abnormally terminate a ping session, type the escape sequence—by default, Ctrl-^ X. You type the default by simultaneously pressing and releasing the Ctrl, Shift, and 6 keys, and then pressing the X key.
Table 56 describes the test characters that the ping facility sends.
Table 56 ping Test Characters
Character
|
Description
|
!
|
Each exclamation point indicates receipt of a reply.
|
.
|
Each period indicates that the network server timed out while waiting for a reply.
|
U
|
A destination unreachable error protocol data unit (PDU) was received.
|
C
|
A congestion experienced packet was received.
|
I
|
User interrupted test.
|
?
|
Unknown packet type.
|
&
|
Packet lifetime exceeded.
|
Note
Not all protocols require hosts to support pings. For some protocols, the pings are Cisco-defined and are only answered by another Cisco router.
Examples
After you enter the ping command in privileged mode, the system prompts you for a protocol keyword. The default protocol is IP.
If you enter a host name or address on the same line as the ping command, the default action is taken as appropriate for the protocol type of that name or address.
The optional data, df-bit, repeat, size, source, timeout, and validate keywords can be used to avoid extended ping command output. You can use as many of these keywords as you need, and you can use them in any order after the host-name or system-address arguments.
Although the precise dialog varies somewhat from protocol to protocol, all are similar to the ping session using default values shown in the following output:
Target IP address: 192.168.7.27
Sweep range of sizes [n]:
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 192.168.7.27, timeout is 2 seconds:
Success rate is 100 percent, round-trip min/avg/max = 1/2/4 ms
Table 57 describes the default ping fields shown in the display.
Table 57 ping Field Descriptions
Field
|
Description
|
Protocol [ip]:
|
Prompts for a supported protocol. The default is IP.
|
Target IP address:
|
Prompts for the IP address or host name of the destination node you plan to ping. If you have specified a supported protocol other than IP, enter an appropriate address for that protocol here. The default is none.
|
Repeat count [5]:
|
Prompts for the number of ping packets that will be sent to the destination address. The default is 5 packets.
|
Datagram size [100]:
|
Prompts for the size of the ping packet (in bytes). The default is 100 bytes.
|
Timeout in seconds [2]:
|
Prompts for the timeout interval. The default is 2 seconds.
|
Extended commands [n]:
|
Specifies whether a series of additional commands appears.
|
Sweep range of sizes [n]:
|
Allows you to vary the sizes of the echo packets being sent. This capability is useful for determining the minimum sizes of the MTUs configured on the nodes along the path to the destination address. Packet fragmentation contributing to performance problems can then be reduced.
|
!!!!!
|
Each exclamation point (!) indicates receipt of a reply. A period (.) indicates that the network server timed out while waiting for a reply. Other characters may appear in the ping output display, depending on the protocol type.
|
Success rate is 100 percent
|
Indicates the percentage of packets successfully echoed back to the router. Anything less than 80 percent is usually considered problematic.
|
round-trip min/avg/max = 1/2/4 ms
|
Indicates the round-trip travel time intervals for the protocol echo packets, including minimum/average/maximum (in milliseconds).
|
Related Commands
Command
|
Description
|
ping ipv6
|
Tests the connection to a remote host on the network using IPv6.
|
ping vrf
|
Tests the connection in the context of a specific VPN (VRF).
|
ping vrf
To test a connection in the context of a specific VPN connection, use the ping vrf command in Exec mode.
ping vrf vrf-name [tag] [connection] target-address [connection-options]
Syntax Description
vrf-name
|
The name of the VPN (VRF context).
|
tag
|
(Optional) Specifies a tag encapsulated IP (tagIP) ping.
|
connection
|
(Optional) Connection options include atm, clns, decnet, ip, ipv6, ipx, sna, or srb. The default is ip.
|
target-address
|
The destination ID for the ping operation. Usually, this is the IP-address of the host. For example, the target for an IP ping in a VRF context would be the IP address or domain name of the target host.
• If the target address is not specified, the CLI will enter the interactive dialog for ping.
|
connection-options
|
Each connection type may have its own set of connection options. For example, connection options for IP include source, df-bit, and timeout. See the appropriate ping command documentation for details.
|
Defaults
The default connection type for ping is IP (specifically, IPv4).
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.1(12c)E, 12.2
|
This command was introduced.
|
Usage Guidelines
A VPN routing/forwarding (VRF) instance is used to identify a VPN. To check if a configured VRF is working, you can use the ping vrf command.
When attempting to ping from a provider edge (PE) router to a customer edge (CE) router, or from a PE router to PE router, the standard ping command will not usually work. The ping vrf command allows you to ping the IP addresses of LAN interfaces on CE routers.
If you are on a PE router, be sure to indicate the specific VRF (VPN) name, as shown in the "Examples" section.
If all required information is not provided at the command line, the system will enter the interactive dialog (extended mode) for ping.
Examples
In the following example, the target host in the domain 209.165.201.1 is pinged (using IP/ICMP) in the context of the "Customer_A" VPN connection.
Router# ping vrf Customer_A 209.165.201.1
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 209.165.201.1, timeout is 2 seconds:
Success rate is 100 percent (5/5), round-trip min/avg/max = 176/264/576 ms
Pressing the Enter key before providing all of the required options will begin the interactive dialog for ping. In the following example, the interactive dialog is started after the "ip" protocol is specified, but no address is given:
Router# ping vrf Customer_B ip
Target IP address: 209.165.200.225
Source address or interface:
Set DF bit in IP header? [no]:
Validate reply data? [no]:
Loose, Strict, Record, Timestamp, Verbose[none]: Record
Loose, Strict, Record, Timestamp, Verbose[RV]:
Sweep range of sizes [n]:
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 209.165.200.225, timeout is 2 seconds:
Packet has IP options: Total option bytes= 39, padded length=40
Success rate is 100 percent (5/5), round-trip min/avg/max = 4/4/4 ms
The following example shows the various options for IP in the ping vrf command:
Router# show parser dump exec | include ping vrf
1 ping vrf <string> ip <string>
1 ping vrf <string> ip (interactive)
1 ping vrf <string> ip <string>
1 ping vrf <string> ip <string> source <address>
1 ping vrf <string> ip <string> source <interface>
1 ping vrf <string> ip <string> repeat <1-2147483647>
1 ping vrf <string> ip <string> size Number
1 ping vrf <string> ip <string> df-bit
1 ping vrf <string> ip <string> validate
1 ping vrf <string> ip <string> data <0-65535>
1 ping vrf <string> ip <string> timeout <0-3600>
1 ping vrf <string> ip <string> verbose
1 ping vrf <string> ip <string> data <0-65535>
1 ping vrf <string> ip <string> timeout <0-3600>
1 ping vrf <string> appletalk
1 ping vrf <string> decnet
Related Commands
Command
|
Description
|
ping
|
Diagnoses basic network connectivity to a specific host.
|
ping atm interface atm
|
Tests the connectivity of a specific PVC.
|
ping ip
|
Tests the connection to a remote host on the network using IPv4.
|
ping ipv6
|
Tests the connection to a remote host on the network using IPv6.
|
ping sna
|
Tests network integrity and timing characteristics over an SNA Switching network.
|
protocol
|
(Optional) Protocol keyword, one of atm, clns, decnet, ipx, or srb.
Note The ping atm interface atm, ping ip, ping ipv6, ping sna, and ping vrf commands are documented separately.
|
tag
|
(Optional) Specifies a tag encapsulated IP (tagIP) ping.
|
host-name
|
Host name of the system to ping. If a host-name or system-address is not specified at the command line, it will be required in the ping system dialog.
|
system-address
|
Address of the system to ping. If a host-name or system-address is not specified at the command line, it will be required in the ping system dialog.
|
policy (ERM)
To configure an ERM resource policy, use the policy command in ERM configuration mode. To disable this function, use the no form of this command.
policy policy-name [global | type resource-user-type]
no policy policy-name
Syntax Description
policy-name
|
Name of the policy you want to configure.
|
global
|
(Optional) Configures a global policy.
|
type resource-user-type
|
(Optional) Specifies a type for the policy you are configuring. The resource-user-type argument specifies the name of the resource user type.
|
Command Default
Disabled
Command Modes
ERM configuration
Command History
Release
|
Modification
|
12.3(14)T
|
This command was introduced.
|
Usage Guidelines
You can configure a resource policy only in ERM configuration mode.
Examples
The following example shows how to configure a resource policy with the policy name cpu_mem_policy and the resource type iosprocess:
Router(config-erm)# policy cpu_mem_policy type iosprocess
Related Commands
Command
|
Description
|
resource policy
|
Enters ERM configuration mode.
|
show resource all
|
Displays all the resource details.
|
show resource database
|
Displays the resource database details.
|
show resource owner
|
Displays the resource owner details.
|
show resource relationship
|
Displays the resource relationship details.
|
slot (ERM policy)
|
Configures line cards.
|
system (ERM policy)
|
Configures system level resource owners.
|
policy (resource group)
To apply an already configured policy to a specified resource group, use the policy command in resource group configuration mode. To disable this function, use the no form of this command.
policy policy-name
no policy policy-name
Syntax Description
policy-name
|
Applies the specified policy to a resource group. The policy-name argument specifies the name of the policy you want to apply to the resource group.
|
Command Default
Disabled
Command Modes
Resource group configuration
Command History
Release
|
Modification
|
12.3(14)T
|
This command was introduced.
|
Usage Guidelines
Before applying a policy to a resource group, you must configure a resource policy using the policy policy-name command in ERM configuration mode and create a resource group using the user group resource-group-name type resource-user-type command in ERM configuration mode.
When you apply a policy using the policy policy-name command in resource group configuration mode, you are applying a policy (which contains the thresholds) to the resource group you created using the user group resource-group-name type resource-user-type command in ERM configuration mode.
For example, say you have created a resource group with the name lowPrioUsers and iosprocess as the type. You have some low-priority RUs or tasks like HTTP and SNMP, and you want to set a threshold for all the low-priority RUs together, not separately. You must add the RUs to the resource group using the instance instance-name command and then apply a resource policy. If the resource policy you applied sets a minor rising threshold value of 10% for the resource group, then when the accumulated usage of both HTTP and SNMP RUs crosses the 10% mark, a notification is sent to the RUs in the resource group lowPrioUsers. That is, if HTTP usage is 4% and SNMP usage is 7%, then a notification is sent to the resource group. This facility helps to set thresholds for a group of RUs, as it is difficult to set a threshold for every single RU.
Examples
The following example shows how to apply a resource policy named cpu_mem_policy to a resource group named lowPrioUsers:
Router(config-erm)# user group lowPrioUsers type iosprocess
Router(config-res-group)# policy group-policy1
Related Commands
Command
|
Description
|
instance (resource group)
|
Adds the RUs to the resource group.
|
policy (ERM)
|
Configures an ERM resource policy.
|
resource policy
|
Enters ERM configuration mode.
|
user (ERM)
|
Creates a resource group.
|
policy-list
To associate a policy list with a Command Scheduler occurrence, use the policy-list command in kron-occurrence configuration mode. To delete a policy list from the Command Scheduler occurrence, use the no form of this command.
policy-list list-name
no policy-list list-name
Syntax Description
list-name
|
Name of policy list. If the list-name is new, a policy list structure will be created. If the list-name is not new, the existing policy list will be edited.
|
Defaults
No policy list is associated.
Command Modes
Kron-occurrence configuration (config-kron-occurrence)
Command History
Release
|
Modification
|
12.3(1)
|
This command was introduced.
|
Usage Guidelines
Use the policy-list command with the kron occurrence command to schedule one or more policy lists to run at the same time or interval. Use the kron policy-list command in conjunction with the cli command to create a Command Scheduler policy list containing EXEC command line interface (CLI) commands to be scheduled to run on the router at a specified time.
The Command Scheduler process is useful to automate the running of EXEC commands at recurring intervals, and can it be used in remote routers to minimize manual intervention.
Examples
The following example shows how to create a Command Scheduler occurrence named may and associate a policy list named sales-may with the occurrence:
Router(config)# kron occurrence may at 6:30 may 20 oneshot
Router(config-kron-occurrence)# policy-list sales-may
Related Commands
Command
|
Description
|
cli
|
Specifies EXEC CLI commands within a Command Scheduler policy list.
|
kron occurrence
|
Specifies schedule parameters for a Command Scheduler occurrence and enters kron-occurrence configuration mode.
|
kron policy-list
|
Specifies a name for a Command Scheduler policy and enters kron-policy configuration mode.
|
poll-interval
To configure the polling interval for a bulk statistics schema, use the poll-interval command in Bulk Statistics Schema configuration mode. To remove a previously configured polling interval, use the no form of this command.
poll-interval minutes
no poll-interval minutes
Syntax Description
minutes
|
Polling interval of data for this schema in minutes. The valid range is from 1 minute to 20000 minutes. The default is 5 minutes.
|
Defaults
Object instances are polled once every five minutes.
Command Modes
Bulk Statistics Schema configuration (config-bulk-sc)
Command History
Release
|
Modification
|
12.0(24)S
|
This command was introduced.
|
12.3(2)T
|
This command was integrated into Cisco IOS Release 12.3(2)T.
|
12.2(25)S
|
This command was integrated into Cisco IOS Release 12.2(25)S.
|
Usage Guidelines
The poll-interval command sets how often the MIB instances specified by the schema and associated object list are to be polled. Collected data is stored in the local bulk statistics file for later transfer.
Examples
In the following example the polling interval for bulk statistics collection is set to once every 3 minutes in the schema called Ethernet2/1-CAR:
Router(config)# snmp mib bulkstat schema Ethernet2/1-CAR
Router(config-bulk-sc)# object-list CAR-mib
Router(config-bulk-sc)# poll-interval 3
Router(config-bulk-sc)# instance wildcard oid 3.1
Router(config-bulk-sc)# exit
Related Commands
Command
|
Description
|
snmp mib bulkstat schema
|
Names a bulk statistics schema and enters Bulk Statistics Schema configuration mode.
|
printer
To configure a printer and assign a server tty line (or lines) to it, use the printer command in global configuration mode. To disable printing on a tty line, use the no form of this command.
printer printer-name {line number | rotary number} [newline-convert | formfeed]
no printer
Syntax Description
printer-name
|
Printer name.
|
line number
|
Assigns a tty line to the printer.
|
rotary number
|
Assigns a rotary group of tty lines to the printer.
|
newline-convert
|
(Optional) Converts newline (linefeed) characters to a two-character sequence "carriage-return, linefeed" (CR+LF).
|
formfeed
|
(Optional) Causes the Cisco IOS software to send a form-feed character (ASCII 0x0C) to the printer tty line immediately following each print job received from the network.
|
Defaults
No printers are defined by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
This command enables you to configure a printer for operations and assign either a single tty line or a group of tty lines to it. To make multiple printers available through the same printer name, specify the number of a rotary group.
In addition to configuring the printer with the printer command, you must modify the file /etc/printcap on your UNIX system to include the definition of the remote printer in the Cisco IOS software. Refer to the Cisco IOS Configuration Fundamentals Configuration Guide for additional information.
Use the optional newline-convert keyword in UNIX environments that cannot handle single-character line terminators. This converts newline characters to a carriage-return, linefeed sequence. Use the formfeed keyword when using the line printer daemon (lpd) protocol to print and your system is unable to separate individual output jobs with a form feed (page eject). You can enter the newline-convert and formfeed keywords together and in any order.
Examples
In the following example a printer named printer1 is configured and output is assigned to tty line 4:
Router(config)# printer printer1 line 4
Related Commands
Command
|
Description
|
clear line
|
Returns a terminal line to idle state.
|
private
To save user EXEC command changes between terminal sessions, use the private command in line configuration mode. To restore the default condition, use the no form of this command.
private
no private
Syntax Description
This command has no arguments or keywords.
Defaults
User-set configuration options are cleared with the exit EXEC command or when the interval set with the exec-timeout line configuration command has passed.
Command Modes
Line configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
This command ensures that the terminal parameters set by the user remain in effect between terminal sessions. This behavior is desirable for terminals in private offices.
Examples
In the following example, line 15 (in this example, vty 1) is configured to keep all user-supplied settings at system restarts:
Router(config-line)# private
Related Commands
Command
|
Description
|
exec-timeout
|
Sets the interval that the EXEC command interpreter waits until user input is detected.
|
exit
|
Exits any configuration mode, or closes an active terminal session and terminates the EXEC.
|
process cpu statistics limit entry-percentage
To set the process entry limit and the size of the history table for CPU utilization statistics, use the process cpu statistics limit entry-percentage command in global configuration mode. To disable CPU utilization statistics, use the no form of this command.
process cpu statistics limit entry-percentage number [size seconds]
no process cpu statistics limit entry-percentage
Syntax Description
number
|
Sets the percentage (1 to 100) of CPU utilization that a process must use to become part of the history table.
|
size seconds
|
(Optional) Changes the duration of time in seconds for which CPU statistics are stored in the history table. Valid values are 5 to 86400. The default is 600.
|
Defaults
size seconds: 600 seconds
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(26)S
|
This command was introduced.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.2(25)S
|
This command was integrated into Cisco IOS Release 12.2(25)S.
|
Usage Guidelines
Use the process cpu statistics limit entry-percentage command to set the entry limit and size of CPU utilization statistics.
Examples
The following example shows how to set an entry limit at 40 percent and a size of 300 seconds:
Router(config)# process cpu statistics limit entry-percentage 40 size 300
Related Commands
Command
|
Description
|
process cpu threshold type
|
Defines CPU usage thresholds that, when crossed, cause a CPU threshold notification.
|
snmp-server enable traps cpu
|
Enables CPU threshold violations traps.
|
snmp-server host
|
Specifies the recipient of SNMP notifications.
|
process cpu threshold type
To set CPU thresholding notification types and values, use the process cpu threshold type command in global configuration mode. To disable CPU thresholding notifications, use the no form of this command.
process cpu threshold type {total | process | interrupt} rising percentage interval seconds
[falling percentage interval seconds]
no process cpu threshold type {total | process | interrupt}
Syntax Description
total
|
Sets the CPU threshold type to total CPU utilization.
|
process
|
Sets the CPU threshold type to CPU process utilization.
|
interrupt
|
Sets the CPU threshold type to CPU interrupt utilization.
|
rising percentage
|
The percentage (1 to 100) of CPU resources that, when exceeded for the configured interval, triggers a CPU thresholding notification.
|
interval seconds
|
The duration of the CPU threshold violation, in seconds (5 to 86400), that must be met to trigger a CPU thresholding notification.
|
falling percentage
|
(Optional) The percentage (1 to 100) of CPU resources that, when usage falls below this level for the configured interval, triggers a CPU thresholding notification.
• This value must be equal to or less than that of the rising percentage argument.
• If not specified, the falling percentage argument is set to the same value as the rising percentage argument.
|
Defaults
CPU thresholding notifications are disabled.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(26)S
|
This command was introduced.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T.
|
12.2(25)S
|
This command was integrated into Cisco IOS Release 12.2(25)S.
|
Usage Guidelines
This command defines CPU usage thresholds that, when crossed, cause a CPU thresholding notification. When this command is enabled, Cisco IOS software polls the system at the configured interval. Notification occurs in two situations:
•
When a configured CPU usage threshold is exceeded (rising percentage)
•
When CPU usage falls below the configured threshold (falling percentage)
Examples
The following example shows how to set the total CPU utilization notification threshold at 80 percent for a rising threshold notification and 20 percent for a falling threshold notification, with a 5-second polling interval.
Router(config)# process cpu threshold type total rising 80 interval 5 falling 20
interval 5
Related Commands
Command
|
Description
|
process cpu statistics limit entry
|
Sets the entry limit and size of CPU utilization statistics.
|
snmp-server enable traps cpu
|
Enables CPU threshold violations traps.
|
snmp-server host
|
Specifies the recipient of SNMP notifications.
|
process-max-time
To configure the amount of time after which a process should voluntarily yield to another process, use the process-max-time command in global configuration mode. To reset this value to the system default, use the no form of this command.
process-max-time milliseconds
no process-max-time milliseconds
Syntax Description
milliseconds
|
Maximum duration (in milliseconds) that a process can run before suspension. The range is from 20to 200 milliseconds.
|
Defaults
The default maximum process time is 200 milliseconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1
|
This command was introduced.
|