cc/td/doc/product/software/ios113ed/cs/csprtf
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Performance Management Commands

Performance Management Commands

This chapter describes the function and displays the syntax for performance management commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Configuration Fundamentals Command Reference.

buffers

Use the buffers global configuration command to make adjustments to initial buffer pool settings and to the limits at which temporary buffers are created and destroyed. Use the no form of this command to return the buffers to their default size.

buffers {small | middle | big | verybig | large | huge | type number} {permanent | max-free
| min-free | initial} number
no buffers {small
| middle | big | verybig | large | huge | type number} {permanent | max-free
| min-free
| initial} number

small Buffer size of this public buffer pool is 104 bytes.
middle Buffer size of this public buffer pool is 600 bytes.
big Buffer size of this public buffer pool is 1524 bytes.
verybig Buffer size of this public buffer pool is 4520 bytes.
large Buffer size of this public buffer pool is 5024 bytes.
huge Default buffer size of this public buffer pool is 18024 bytes. This value can be configured with the buffers huge size command.
type number Interface type and interface number of the interface buffer pool. The type value cannot be fddi.
permanent Number of permanent buffers that the system tries to create and keep. Permanent buffers are normally not trimmed by the system.
max-free Maximum number of free or unallocated buffers in a buffer pool.
A maximum of 20,480 small buffers can be constructed in the pool.
min-free Minimum number of free or unallocated buffers in a buffer pool.
initial Number of additional temporary buffers that are to be allocated when the system is reloaded. This keyword can be used to ensure that the system has necessary buffers immediately after reloading in a high-traffic environment.
number Number of buffers to be allocated.

buffers huge size

Use the buffers huge size global configuration command to dynamically resize all huge buffers to the value you specify. Use the no form of this command to restore the default buffer values.

buffers huge size number
no buffers huge size number


number Huge buffer size, in bytes.

custom-queue-list

To assign a custom queue list to an interface, use the custom-queue-list interface configuration command. To remove a specific list or all list assignments, use the no form of the command.

custom-queue-list list
no custom-queue-list [
list]

list Number of the custom queue list you want to assign to the interface. An integer from 1 to 16.

fair-queue

To enable weighted fair queueing for an interface, use the fair-queue interface configuration command. To disable weighted fair queuing for an interface, use the no form of this command.

fair-queue [congestive-discard-threshold [dynamic-queues [reservable-queues]]]
no fair-queue


congestive-discard-threshold (Optional) Number of messages allowed in each queue in the range 1 to 4096. The default is 64 messages. When the number of messages in the queue for a high-bandwidth conversation reaches the specified threshold, new high-bandwidth messages are discarded.
dynamic-queues (Optional) Number of dynamic queues used for best-effort conversations (that is, a normal conversation not requiring any special network services). Values are 16, 32, 64, 128, 256, 512, 1024, 2048, and 4096. The default is 256.
reservable-queues (Optional) Number of reservable queues used for reserved conversations in the range 0 to 1000. The default is 0. Reservable queues are used for interfaces configured for the Resource Reservation Protocol (RSVP) feature.

load-interval

To change the length of time for which data is used to compute load statistics, use the load-interval interface configuration command. Use the no form of this command to revert to the default setting.

load-interval seconds
no load-interval seconds


seconds Length of time for which data is used to compute load statistics. A value that is a multiple of 30, from 30 to 600 (30, 60, 90, 120, and so forth).

priority-group

To assign the specified priority list to an interface, use the priority-group interface configuration command. Use the no form of this command to remove the specified priority group assignment.

priority-group list
no priority-group


list Priority list number assigned to the interface. An integer from 1 to 16.

priority-list default

To assign a priority queue for those packets that do not match any other rule in the priority list, use the priority-list default global configuration command. Use the no form of this command to return to the default or assign normal as the default.

priority-list list-number default {high | medium | normal | low}
no priority-list list-number default {high | medium | normal | low}


list-number Arbitrary integer between 1 and 16 that identifies the priority list selected by the user.
high | medium | normal | low Priority queue level.

priority-list interface

To establish queuing priorities on packets entering from a given interface, use the priority-list interface global configuration command. Use the no form of this command with the appropriate arguments to remove an entry from the list.

priority-list list-number interface interface-type interface-number {high | medium |
normal | low}
no priority-list list-number interface interface-type interface-number {high | medium |
normal | low}


list-number Arbitrary integer between 1 and 16 that identifies the priority list selected by the user.
interface-type Specifies the name of the interface.
interface-number Number of the specified interface.
high | medium | normal | low Priority queue level.

priority-list protocol

To establish queuing priorities based upon the protocol type, use the priority-list protocol global configuration command. Use the no form of this command with the appropriate list number to remove an entry from the list.

priority-list list-number protocol protocol-name {high | medium | normal | low}
queue-keyword keyword-value
no priority-list list-number protocol [protocol-name {high | medium | normal | low}
queue-keyword keyword-value]


list-number Arbitrary integer between 1 and 16 that identifies the priority list selected by the user.
protocol-name Specifies the protocol type: aarp, arp, apollo, appletalk, bridge (transparent), clns, clns_es, clns_is, compressedtcp, cmns, decnet, decnet_node, decnet_router-l1, decnet_router-l2, ip, ipx, pad, rsrb, stun, vines, xns, and x25.
high | medium | normal | low Priority queue level.
queue-keyword keyword-value Possible keywords are fragments, gt, lt, list, tcp, and udp.

priority-list queue-limit

To specify the maximum number of packets that can be waiting in each of the priority queues, use the priority-list queue-limit global configuration command. The no form of this command selects the normal queue.

priority-list list-number queue-limit high-limit medium-limit normal-limit low-limit
no priority-list
list-number queue-limit

list-number Arbitrary integer between 1 and 16 that identifies the priority list selected by the user.
high-limit medium-limit
normal-limit low-limit
Priority queue maximum length. A value of 0 for any of the four arguments means that the queue can be of unlimited size for that particular queue.

queue-list default

To assign a priority queue for those packets that do not match any other rule in the queue list, use the queue-list default global configuration command. To restore the default value, use the no form of this command.

queue-list list-number default queue-number
no queue-list list-number default queue-number


list-number Number of the queue list. An integer from 1 to 16.
queue-number Number of the queue. An integer from 1 to 16.

queue-list interface

To establish queuing priorities on packets entering on an interface, use the queue-list interface global configuration command. To remove an entry from the list, use the no form of the command.

queue-list list-number interface type number queue-number
no queue-list list-number interface queue-number


list-number Number of the queue list. An integer from 1 to 16.
type Required argument that specifies the name of the interface.
number Number of the specified interface.
queue-number Number of the queue. An integer from 1 to 16.

queue-list protocol

To establish queuing priority based upon the protocol type, use the queue-list protocol global configuration command. Use the no form of this command with the appropriate list number to remove an entry from the list.

queue-list list-number protocol protocol-name queue-number queue-keyword keyword-value
no queue-list list-number protocol protocol-name


list-number Number of the queue list. An integer from 1 to 16.
protocol-name Required argument that specifies the protocol type: aarp, arp, apollo, appletalk, bridge (transparent), clns, clns_es, clns_is, compressedtcp, cmns, decnet, decnet_node, decnet_routerl1, decnet_routerl2, dlsw, ip, ipx, pad, rsrb, stun, vines, xns, and x25.
queue-number Number of the queue. An integer from 1 to 16.
queue-keyword keyword-value Possible keywords are gt, lt, list, tcp, and udp.

queue-list queue byte-count

To designate the byte size allowed per queue, use the queue-list queue byte-count global configuration command. To return the byte size to the default value, use the no form of the command.

queue-list list-number queue queue-number byte-count byte-count-number
no queue-list
list-number queue queue-number byte-count byte-count-number

list-number Number of the queue list. An integer from 1 to 16.
queue-number Number of the queue. An integer from 1 to 16.
byte-count-number Specifies the lower boundary on how many bytes the system allows to be delivered from a given queue during a particular cycle.

queue-list queue limit

To designate the queue length limit for a queue, use the queue-list queue limit global configuration command. To return the queue length to the default value, use the no form of the command.

queue-list list-number queue queue-number limit limit-number
no queue-list
list-number queue queue-number limit limit-number

list-number Number of the queue list. An integer from 1 to 16.
queue-number Number of the queue. An integer from 1 to 16.
limit-number Maximum number of packets which can be enqueued at any time.
Range is 0 to 32767 queue entries. A value of 0 means that the queue can be of unlimited size.

random-detect

To enable random early detection on an interface, use the random-detect interface configuration command. Use the no form of this command to disable random early detection on the interface.

random-detect [weighting]
no
random-detect

weighting (Optional) Exponential weighting constant in the range 1 to 16 used to determine the rate that packets are dropped when congestion occurs. The default is 10 (that is, drop 1 packet every 210).

scheduler allocate

To guarantee CPU time for processes, use the scheduler allocate global configuration command on the Cisco 7200 series and Cisco 7500 series. The no form of this command restores the default.

scheduler allocate interrupt-time process-time
no scheduler allocate


interrupt-time Integer (in microseconds) that limits the maximum number of microseconds to spend on fast switching within any one network interrupt context. The range is 400 to 60000 microseconds. The default is 4000 microseconds.
process-time Integer (in microseconds) that guarantees the minimum number of microseconds to spend at the process level when network interrupts are disabled. The range is 100 to 4000. The default is 200 microseconds.

scheduler interval

To control the maximum amount of time that can elapse without running system processes, use the scheduler interval global configuration command. The no form of this command restores the default.

scheduler interval milliseconds
no scheduler interval


milliseconds Integer that specifies the interval, in milliseconds. The minimum interval that you can specify is 500 milliseconds; there is no maximum value.

service nagle

To enable the Nagle congestion control algorithm, use the service nagle global configuration command. Use the no form of this command to disable this feature.

service nagle
no service nagle

show buffers

Use the show buffers EXEC command to display statistics for the buffer pools on the network server.

show buffers [type number | alloc [dump]]

type number (Optional) Displays interface pool information. If the specified interface type and number has its own buffer pool, displays information for that pool. Value of type can be ethernet, serial, tokenring, fddi, bri, atm, e1, t1.
alloc (Optional) Displays a brief listing of all allocated buffers.
dump (Optional) Dumps all allocated buffers. This keyword must be used with the alloc keyword, not by itself.

show queueing

To list the current state of the queue lists, use the show queueing privileged EXEC command.

show queueing [custom | fair | priority | virtual-access interface-number]

custom (Optional) Shows status of custom queueing list configuration.
fair (Optional) Shows status of the fair queueing configuration. This is the default.
priority (Optional) Shows status of priority queueing list configuration.
virtual-access interface- number (Optional) Shows information about interleaving on a virtual access interface.

show traffic-shape

Use the show traffic-shape EXEC command to display the current traffic-shaping configuration.

show traffic-shape [interface]

interface (Optional) Name of the interface.

show traffic-shape statistics

Use the show traffic-shape statistics EXEC command to display the current traffic-shaping statistics.

show traffic-shape statistics [interface]

interface (Optional) Name of the interface.

traffic-shape adaptive

To configure a Frame Relay subinterface to estimate the available bandwidth when backward explicit congestion notifications (BECNs) are received, use the traffic-shape adaptive interface configuration command. Use the no form of this command to stop adapting to congestion signals.

traffic-shape adaptive [bit-rate]
no
traffic-shape adaptive

bit-rate (Optional) Lowest bit rate that traffic is shaped to in bits per second. The default is half the value specified for the traffic-shape rate or traffic-shape group bit-rate option.

traffic-shape group

To enable traffic shaping based on a specific access list for outbound traffic on an interface, use the traffic-shape group interface configuration command. Use the no form of this command to disable traffic shaping on the interface for the access list.

traffic-shape group access-list bit-rate [burst-size [excess-burst-size]]
no
traffic-shape group access-list

access-list Number of the access list that controls the packets that traffic shaping is applied to on the interface.
bit-rate Bit rate that traffic is shaped to in bits per second. This is the access bit rate that you contract with your service provider or the service level you intend to maintain.
burst-size (Optional) Sustained number of bits that can be transmitted per interval. On Frame Relay interfaces, this is the committed burst size contracted with your service provider. The default is the bit-rate divided by 8.
excess-burst-size (Optional) Maximum number of bits that can exceed the burst size in the first interval in a congestion event. On Frame Relay interfaces, this is the excess burst size contracted with your service provider. The default is equal to the burst-size.

traffic-shape rate

To enable traffic shaping for outbound traffic on an interface, use the traffic-shape rate interface configuration command. Use the no form of this command to disable traffic shaping on the interface.

traffic-shape rate bit-rate [burst-size [excess-burst-size]]
no
traffic-shape rate

bit-rate Bit rate that traffic is shaped to in bits per second. This is the access bit rate that you contract with your service provider or the service level you intend to maintain.
burst-size (Optional) Sustained number of bits that can be transmitted per interval. On Frame Relay interfaces, this is the committed burst size contracted with your service provider. The default is the bit-rate divided by 8.
excess-burst-size (Optional) Maximum number of bits that can exceed the burst size in the first interval in a congestion event. On Frame Relay interfaces, this is the excess burst size contracted with your service provider. The default is equal to the burst-size.

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1998 © Cisco Systems Inc.