Legacy QoS Command Deprecation
In Cisco IOS XE Release 2.6, to streamline Cisco IOS XE quality of service (QoS), certain commands have been hidden. Although these commands are available, the command-line interface (CLI) interactive help does not display them. This means that if you attempt to view a hidden command by entering a question mark (?) at the command line, the command does not appear. However, if you know the command syntax, you can enter it (the system accepts the command and returns a message stating that it is deprecated).
The functionality provided by these hidden commands has been replaced by similar functionality provided via the modular QoS CLI (MQC). The MQC is a set of a platform-independent commands for configuring QoS on Cisco platforms. This means that you should now provision QoS by defining traffic classes, creating traffic policies containing those classes, and attaching those policies to the desired interfaces.
In Cisco IOS XE Release 3.2S, these commands have been removed. This means that you must use the appropriate replacement MQC commands.
This document lists the hidden or removed commands and their replacement commands.
Finding Feature Information
Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the "Feature Information for Legacy QoS Command Deprecation" section.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•
Information About Legacy QoS Command Deprecation
•Feature Information for Legacy QoS Command Deprecation
Information About Legacy QoS Command Deprecation
•QoS Features Applied Using the MQC
•Legacy Commands Being Hidden or Removed
QoS Features Applied Using the MQC
The MQC structure lets you define a traffic class (also called a class map), create a traffic policy (also called a policy map), and attach the traffic policy to an interface. This comprises the following three high-level steps.
1. Define a traffic class by using the class-map command. A traffic class is used to classify traffic.
2. Create a traffic policy by using the policy-map command. A traffic policy contains a traffic class and one or more QoS features that will be applied to the traffic class. The QoS features in the traffic policy determine how to treat the classified traffic.
3. Attach the traffic policy to the interface by using the service-policy command.
Steps 1 and 3 do not involve legacy QoS hidden or removed commands, which means that they are not within the scope of this document. For more information about these two steps, see the "Applying QoS Features Using the MQC" module in the Quality of Service Solutions Configuration Guide.
Legacy Commands Being Hidden or Removed
Table 1 lists the commands that have been hidden or removed. The table also lists their replacement commands (or sequence of commands).
|
|
|
|---|---|
Configuring Bandwidth Allocation |
|
Commands Command Usage Router(config)# interface type number Router(config-if)# max-reserved-bandwidth percentage
|
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# bandwidth {bandwidth-in-kbps | remaining percent percentage | percent percentage} |
Configuring Custom Queueing |
|
Commands Command Usage Router(config)# interface type number Router(config-if)# custom-queue-list [list-number] |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# bandwidth {bandwidth-in-kbps | remaining percent percentage | percent percentage} |
Configuring Priority Queueing |
|
Commands Command Usage Router(config)# interface type number Router(config-if)# ip rtp priority starting-port-number port-range bandwidth |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-name Router(config-pmap-c)# priority |
Configuring Weighted Fair Queueing |
|
Commands Command Usage Router(config)# interface type number Router(config-if)# fair-queue
[congestive-discard-threshold [dynamic-queue-count
[reserved-queue-count]]]
|
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# fair-queue
Router(config-pmap-c)# fair-queue dynamic-queues Router(config-pmap-c)# fair-queue queue-limit packets |
Configuring the Threshold for Discarding DE Packets from a Switched PVC Traffic Shaping Queue |
|
Commands • Command Usage Router(config)# map-class frame-relay map-class-name Router(config-map-class)# frame-relay congestion threshold de percentage |
Command Usage Router(config)# policy-map policy-map-name1 Router(config-pmap)# class class-default
Router(config-pmap-c)# random-detect
discard-class-based
Router(config-pmap-c)# random-detect discard-class
discard-class min-threshold max-threshold
Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# policy-map shape
Router(config-pmap)# class class-default
Router(config-pmap-c)# shape average rate Router(config-pmap-c)# service-policy policy-map-name1 Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# policy-map policy-map-name2 Router(config-pmap)# class class-name
Router(config-pmap-c)# set discard-class
discard-class
|
Configuring Frame Relay Custom Queueing for Virtual Circuits |
|
Commands • Command Usage Router(config)# map-class frame-relay map-class-name
Router(config-map-class)# frame-relay custom-queue-list list-number |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# bandwidth {bandwidth-in-kbps | remaining percent percentage | percent percentage} |
Configuring Frame Relay ECN Bits Threshold |
|
Commands • Command Usage Router(config)# map-class frame-relay map-class-name Router(config-map-class)# frame-relay congestion threshold ecn percentage |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# shape average rate Router(config-pmap-c)# set fr-fecn-becn percent |
Configuring Frame Relay Weighted Fair Queueing |
|
Commands Command Usage Router(config)# map-class frame-relay map-class-name
Router(config-map-class)# frame-relay fair-queue [discard-threshold [dynamic-queue-count [reserved-queue-count [buffer-limit]]]] |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# fair-queue Router(config-pmap-c)# fair-queue dynamic-queues Router(config-pmap-c)# fair-queue queue-limit packets |
Configuring Frame Relay Priority Queueing on a PVC |
|
Commands Command Usage Router(config)# map-class frame-relay map-class-name
Router(config-map-class)# frame-relay ip rtp priority starting-port-number port-range bandwidth |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-name Router(config-pmap-c)# priority bandwidth-in-kbps [burst-in-bytes] |
Assigning a Priority Queue to Virtual Circuits Associated with a Map Class |
|
Commands Command Usage Router(config)# map-class frame-relay map-class-name Router(config-map-class)# frame-relay priority-group group-number |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# priority Router(config-pmap-c)# priority bandwidth-in-kbps [burst-in-bytes] Router(config-pmap-c)# priority percent percentage [burst-in-bytes] Router(config-pmap-c)# priority level level [percent percentage [burst-in-bytes]] |
Configuring the Frame Relay Rate Adjustment to BECN |
|
Commands • Command Usage Router(config)# map-class frame-relay map-class-name Router(config-map-class)# frame-relay adaptive-shaping becn |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# shape average rate Router(config-pmap-c)# shape adaptive rate |
Configuring the Frame Relay Rate Adjustment to ForeSight Messages |
|
Commands • Command Usage Router(config)# map-class frame-relay map-class-name Router(config)# frame-relay adaptive-shaping foresight |
Command Usage None (this functionality no longer exists). |
Enabling Frame Relay Traffic-Shaping FECNs as BECNs |
|
Commands Command Usage Router(config)# map-class frame-relay map-class-name Router(config-map-class)# frame-relay fecn-adapt |
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# shape average rate
Router(config-pmap-c)# shape fecn-adapt
|
Configuring Frame Relay Traffic Shaping |
|
Commands Command Usage Router(config)# map-class frame-relay map-class-name Router(config-map-class)# frame-relay bc {in | out}
committed-burst-size-in-bits
Router(config-map-class)# frame-relay be {in | out}
excess-burst-size-in-bits
Router(config-map-class)# frame-relay cir {in | out}
bits-per-second
|
Command Usage Router(config)# policy-map policy-map-name Router(config-pmap)# class class-default
Router(config-pmap-c)# shape average rate
|
Configuring the Frame Relay Enhanced Local Management Interface |
|
Commands Command Usage Router(config)# interface type number
Router(config-if)# no ip address Router(config-if)# encapsulation frame-relay Router(config-if)# frame-relay lmi-type ansi Router(config-if)# frame-relay traffic-shaping Router(config-if)# frame-relay qos-autosense |
Command Usage None (this functionality no longer exists). |
Displaying the Contents of Packets Inside a Queue for an Interface or VC |
|
Commands Command Usage Router# show queue interface |
Command Usage Router# show policy-map interface |
Displaying Queueing Strategies |
|
Commands Command Usage Router# show queueing |
Command Usage Router# show policy-map interface |
Displaying Weighted Random Early Detection (WRED) Information |
|
Commands • Command Usage Router# show interfaces [type number] random-detect |
Command Usage Router# show policy-map interface |
Displaying the Traffic-Shaping Configuration, Queueing, and Statistics |
|
Commands • Command Usage Router# show traffic-shape [interface-type
interface-number]
Router# show traffic-shape queue [interface-number [dlci dlci-number]] Router# show traffic-shape statistics [interface-type interface-number] |
Command Usage Router# show policy-map interface |
Displaying Weighted Fair Queueing Information |
|
Commands Command Usage Router# show interfaces [interface-type interface-number] fair-queue |
Command Usage Router# show policy-map interface |
Additional References
Related Documents
|
|
|
|---|---|
Cisco IOS commands |
|
Defining traffic classes; attaching traffic policies to interfaces |
"Applying QoS Features Using the MQC" module in the Quality of Service Solutions Configuration Guide |
Reference pages for QoS commands |
|
Reference pages for wide-area networking commands |
Technical Assistance
Feature Information for Legacy QoS Command Deprecation
Table 2 lists the release history for legacy QoS commands that have been deprecated.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS XE software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note Table 2 lists only the Cisco IOS XE Software release that introduced support for a given feature in a given Cisco IOS XE Software release train. Unless noted otherwise, subsequent releases of that Cisco IOS XE Software release train also support that feature.
|
|
|
|
|---|---|---|
Legacy QoS Command Deprecation: Hidden Commands |
Cisco IOS XE |
To streamline Cisco IOS XE QoS, certain commands have been hidden, which means that if you try to view a hidden command by entering a question mark (?) at the command line, the command does not appear. However, if you know the command syntax, you can enter it. These commands will be removed in a future release. The functionality provided by these hidden commands is replaced by similar functionality from the modular QoS CLI (MQC), which is a set of a platform-independent commands for configuring QoS. The following sections provide information about this feature: • • The following commands were modified: custom-queue-list, fair-queue (WFQ), frame-relay adaptive-shaping (becn keyword), frame-relay adaptive-shaping (foresight keyword), frame-relay bc, frame-relay be, frame-relay cir, frame-relay congestion threshold de, frame-relay congestion threshold ecn, frame-relay custom-queue-list, frame-relay fair-queue, frame-relay fecn-adapt, frame-relay ip rtp priority, frame-relay priority-group, frame-relay qos-autosense, ip rtp priority, max-reserved-bandwidth, show interfaces fair-queue, show interfaces random-detect, show queue, show queueing, show traffic-shape, show traffic-shape queue, show traffic-shape statistics. |
Legacy QoS Command Deprecation: Removed Commands |
Cisco IOS XE |
The legacy QoS commands were removed. This means that you must use the appropriate replacement MQC commands. The following sections provide information about this feature: • • The following commands were removed: custom-queue-list, fair-queue (WFQ), frame-relay adaptive-shaping (becn keyword), frame-relay adaptive-shaping (foresight keyword), frame-relay bc, frame-relay be, frame-relay cir, frame-relay congestion threshold de, frame-relay congestion threshold ecn, frame-relay custom-queue-list, frame-relay fair-queue, frame-relay fecn-adapt, frame-relay ip rtp priority, frame-relay priority-group, frame-relay qos-autosense, ip rtp priority, max-reserved-bandwidth, show interfaces fair-queue, show interfaces random-detect, show queue, show queueing, show traffic-shape, show traffic-shape queue, show traffic-shape statistics. |
Feedback