Cisco Nexus 7000 Series NX-OS Quality of Service Command Reference, Release 4.0
Cisco NX-OS Quality of Service Commands

Table Of Contents

Cisco NX-OS Quality of Service Commands

bandwidth (QoS)

bandwidth remaining

class (policy map type qos)

class type queuing (policy map type queuing)

class-map type qos

class-map type queuing match-any

clear qos statistics

default (table map)

description

from (table map)

match access-group

match class-map

match cos (class map type qos)

match cos (class map type queuing)

match discard-class

match dscp

match ip rtp

match packet length

match precedence

match protocol

match qos-group

police (QoS)

police aggregate

policy-map type qos

policy-map type queuing

priority (queuing)

qos shared-policer

qos statistics

queue-limit

random-detect

random-detect cos-based

service-policy

set cos (policy map type qos)

set cos (policy map type queuing)

set discard-class

set dscp (QoS)

set precedence (QoS)

set qos-group

set table

shape

show class-map type qos

show class-map type queuing

show policy-map

show policy-map interface

show policy-map interface brief

show policy-map vlan

show qos shared-policer

show queuing interface

show running-config ipqos

show table-map

table-map


Cisco NX-OS Quality of Service Commands


This chapter describes the Cisco NX-OS quality of service (QoS) commands.Cisco Nexus 7000 Series NX-OS Quality of Service Command Reference, Release 4.1

bandwidth (QoS)

To allocate a minimum percentage of the interface bandwidth to a queue and configure the bandwidth on both ingress and egress queues, use the bandwidth command. To remove a bandwidth configuration, use the no form of this command.

bandwidth {rate [bps | kbps | mbps | gbps] | percent percent}

no bandwidth {rate [bps | kbps | mbps | gbps] | percent percent}

Syntax Description

rate

Bandwidth rate. The range is from 1 to 10000000000.

bps

(Optional) Specifies the units of bits per second.

kbps

(Optional) Specifies the units of 1000 bits per second.

mbps

(Optional) Specifies the units of megabits per second.

gbps

(Optional) Specifies the units of gigabits per second.

percent

Specifies the percentage of bandwidth of the underlying link rate.

percent

Percent value in the range from 1 to 100.


Defaults

None

Command Modes

Policy map type queuing class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

You use the system-defined ingress or egress queue class for the type of module to which you want to apply the policy map (see Table 1).

Table 1 System-Defined Type queuing Class Maps 

Class Map Queue Name
Description
Default CoS Values

1 Gigabit Module Ingress: 2 queues with 4 thresholds per queue

2q4t-in-q1

Ingress queue 1 of 2q4t type

5-7

2q4t-in-q-default

Ingress default queue of 2q4t type

0-4

1 Gigabit Module Egress: 1 strict priority queue and 3 normal queues with 4 thresholds per queue

1p3q4t-out-pq1 1

Egress priority queue of 1p3q4t type

5-7

1p3q4t-out-q2

Egress queue 2 of 1p3q4t type

-

1p3q4t-out-q3

Egress queue 3 of 1p3q4t type

-

1p3q4t-out-q-default

Egress default queue of 1p3q4t type

0-4

10 Gigabit Module Ingress: 8 queues with 2 thresholds per queue

8q2t-in-q1

Ingress queue 1 of 8q2t type

5-7

8q2t-in-q2

Ingress queue 2 of 8q2t type

-

8q2t-in-q3

Ingress queue 3 of 8q2t type

-

8q2t-in-q4

Ingress queue 4 of 8q2t type

-

8q2t-in-q5

Ingress queue 5 of 8q2t type

-

8q2t-in-q6

Ingress queue 6 of 8q2t type

-

8q2t-in-q7

Ingress queue 7 of 8q2t type

-

8q2t-in-q-default

Ingress default queue of 8q2t type

0-4

10 Gigabit Module Egress: 1 strict priority queue and 7 normal queues with 4 thresholds per queue

1p7q4t-out-pq1 1

Egress priority queue of 1p7q4t type

5-7

1p7q4t-out-q2

Egress queue 2 of 1p7q4t type

-

1p7q4t-out-q3

Egress queue 3 of 1p7q4t type

-

1p7q4t-out-q4

Egress queue 4 of 1p7q4t type

-

1p7q4t-out-q5

Egress queue 5 of 1p7q4t type

-

1p7q4t-out-q6

Egress queue 6 of 1p7q4t type

-

1p7q4t-out-q7

Egress queue 7 of 1p7q4t type

-

1p7q4t-out-q-default

Egress default queue of 1p7q4t type

0-4

1 These are either priority or normal queues. If you use the priority keyword in your configuration, these are used as priority queues. Otherwise, they are used as normal queues.



Note After you use this command in a specified policy map, you cannot use the priority or shape command in the same policy map.


This command does not require a license.

Examples

This example shows how to specify a bandwidth rate for a queue:

switch(config)# policy-map type queuing my_policy1
switch(config-pmap-que)# class type queuing 1p7q4t-out-pq1
switch(config-pmap-c-que)# bandwidth 10 mbps

This example shows how to remove a bandwidth rate for a queue:

switch(config)# policy-map type queuing my_policy1
switch(config-pmap-que)# class type queuing 1p7q4t-out-pq1
switch(config-pmap-c-que)# no bandwidth 10 mbps

Related Commands

Command
Description

bandwidth remaining

Configures the bandwidth remaining on the interface in a queue.

show class-map

Displays class maps.

show policy-map

Displays policy maps and statistics.



bandwidth remaining

To configure the percentage of the bandwidth remaining on the interface after other allocations are configured on both ingress and egress queues, use the bandwidth remaining command. To remove the remaining bandwidth allocation, use the no form of this command.

bandwidth remaining percent {percent}

no bandwidth remaining percent {percent}

Syntax Description

percent

Specifies use of percentage of remaining bandwidth on the underlying link. Valid values are from 0 to 100.


Defaults

None

Command Modes

Policy map type queuing class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

You use the system-defined ingress or egress queue class for the type of module to which you want to apply the policy map (see Table 1). You can use this command in conjunction with the priority command.

See the Cisco Nexus 7000 Series NX-OS Quality of Service Configuration Guide, Release 4.1 for more information on using this command.

This command does not require a license.

Examples

This example shows how to set the bandwidth remaining for the specified queue:

switch(config)# policy-map type queuing my_policy1
switch(config-pmap-que)# class type queuing 1p7q4t-out-pq1
switch(config-pmap-c-que)# bandwidth remaining percent 25

This example shows how to remove the bandwidth remaining for the specified queue:

switch(config)# policy-map type queuing my_policy1
switch(config-pmap-que)# class type queuing 1p7q4t-out-pq1
switch(config-pmap-c-que)# no bandwidth remaining percent 25

Related Commands

Command
Description

bandwidth

Allocates a minimum percentage of the interface bandwidth to a queue.

show class-map

Displays class maps.

show policy-map

Displays policy maps and statistics.



class (policy map type qos)

To add a reference to an existing qos class map in a policy map and enter the class mode, use the class command. To remove a class from the policy map, use the no form of this command.

class [type qos] {class-map-name | class-default} [insert-before [type qos] before-class-map-name]

no class {class-map-name | class-default}

Syntax Description

type qos

(Optional) Specifies the component type, which is qos for this class. By default, the type is qos.

class-map-name

Reference to a class map.

class-default

Specifies the reserved class name that matches all traffic not classified in other classes in a policy map.

insert-before before-class-map-name

(Optional) Specifies the position of this class in the policy. If not specified, the class is placed at the end of the classes in the policy. Policy actions in the first class that matches the traffic type are performed.


Defaults

None

Command Modes

Policy map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

Policy actions in the first class that matches the traffic type are performed.

This command does not require a license.

Examples

This example shows how to add a reference to a class map at the end of a policy map:

switch(config)# policy-map my_policy1
switch(config-pmap)# class traffic_class2
switch(config-pmap-c-qos)# 

This example shows how to add a reference to a class map before an existing class map reference in a policy map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class insert-before traffic_class2 traffic_class1
switch(config-pmap-c-qos)# 

This example shows how to add a reference to the class-default class map in a policy map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class class-default
switch(config-pmap-c-qos)# 

This example shows how to remove a class map reference in a policy map:

switch(config)# policy-map my_policy1
switch(config-pmap)# no class traffic_class1
switch(config-pmap)# 

Related Commands

Command
Description

show class-map qos

Displays class maps.

show policy-map

Displays policy maps and statistics.



class type queuing (policy map type queuing)

To add a reference to an existing queuing class map in a policy map and enter the class mode, use the class type queuing command. To remove a class from the policy map, use the no form of this command.

class type queuing class-map-name

no class type queuing class-map-name

Syntax Descriptionno

class-map-name

Reference to a system-defined class map. For a list of the system-defined type queuing class maps, see Table 1.


Defaults

None

Command Modes

policy map type queuing configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

Policy actions in the first class that matches the traffic type are performed.

This command does not require a license.

Examples

This example shows how to add a reference to a class map at the end of a type queuing policy map:

switch(config)# policy-map type queuing my_policy1
switch(config-pmap-que)# class type queuing 8q2t-in-q4
switch(config-pmap-c-que)# 

This example shows how to add a reference to a class map before an existing class map reference in a type queuing policy map:

switch(config)# policy-map type queuing my_policy1
switch(config-pmap-que)# class type queuing 8q2t-in-q4 insert-before type queuing 
8q2t-in-q2
switch(config-pmap-c-que)# 

This example shows how to remove a class map reference in a type queuing policy map:

switch(config)# policy-map type queuing my_policy1
switch(config-pmap-que)# no class type queuing 8q2t-in-q4
switch(config-pmap-que)# 

Related Commands

Command
Description

show class-map queuing

Displays class maps.

show policy-map

Displays policy maps and statistics.



class-map type qos

To create or modify a class map that defines a class of traffic and enter the class-map configuration mode, use the class-map command. To remove a class map, use the no form of this command.

class-map [type qos] {[match-any | match-all] class-map-name | conform-color-in | conform-color-out | exceed-color-in | exceed-color-out}

no class-map [type qos] {class-map-name | [match-any | match-all]}

Syntax Description

type qos

(Optional) Specifies the component type qos for the class map. By default, the class map type is qos.

match-any

Specifies that if the packet matches any of the criteria configured for this class map with the match command, then this class map is applied to the packet.

match-all

Specifies that if the packet matches all the criteria configured for this class map with the match command, then this class map is applied to the packet. This is the default action if match-any is not specified.

Note This option does not work. The match criteria is always treated as match-any.

class-map-name

Name assigned to the class map. The name class-default is reserved.

conform-color-in

Type qos conform color class map in the input direction. This color-aware class map makes a policer color-aware for conform action.

conform-color-out

Type qos conform color class map in the output direction. This color-aware class map makes a policer color-aware for conform action.

exceed-color-in

Type qos exceed color class map in the input direction. This color-aware class map makes a policer color-aware for exceed action.

exceed-color-out

Type qos exceed color class map in the output direction. This color-aware class map makes a policer color-aware for exceed action.


Defaults

type—qos

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

System-defined queuing class map names cannot be deleted. See the Cisco Nexus 7000 Series NX-OS Quality of Service Configuration Guide, Release 4.1 for more information on this command.


Note When you cnfigure match all for a QoS class map by entering the class-map type qos match-all command, the match-all option does not work. Instead, the match criteria is always treated as match any.


This command does not require a license.

Examples

This example shows how to create or modify a qos class map:

switch(config)# class-map my_class1
switch(config-cmap-qos)#

This example shows how to remove a qos class map:

switch(config)# no class-map my_class1
switch(config)#

This example shows how to modify a qos color class map:

switch(config)# class-map conform-color-in
switch(config-color-map)#

Related Commands

Command
Description

show class-map qos

Displays class maps.



class-map type queuing match-any

To modify a type queuing class map and enter the class-map configuration mode, use the class-map type queuing match-any command.

class-map type queuing match-any queuing-class-map-name

Syntax Description

queuing-class-map-name

Specifies a system-defined queuing class map name. See Table 1 for the list of system-define queuing class maps.


Defaults

None

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

If the packet matches any of the criteria configured for this class map with the match command, then this class map is applied to the packet. Class maps of type queuing support only this option.

Any modification make to the class maps type queuing changes the configuration for all ports of the specified port type on all VDCs.

System-defined queuing class map names cannot be deleted. See the Cisco Nexus 7000 Series NX-OS Quality of Service Configuration Guide, Release 4.1 for more information on using this command.

This command does not require a license.

Examples

This example shows how to modify a queuing class map:

switch(config)# class-map type queuing match-any 2q4t-in-q1
switch(config-cmap-que)#

Related Commands

Command
Description

show class-map queuing

Displays class maps.

match cos

Defines the class of traffic in type queuing class maps.



clear qos statistics

To clear QoS statistics, use the clear qos statistics command.

clear qos statistics [{interface [ethernet type/slot | port-channel number] | [vlan [vlan-id]} [input | output] [type {qos | queuing}]]

Syntax Description

interface

(Optional) Specifies which interface to clear.

vlan [vlan-id]

(Optional) Specifies a VLAN to clear. Valid values are from 1 to 4094.

input

(Optional) Clears only input statistics.

output

(Optional) Clears only output statistics.

type

(Optional) Specifies the type of statistics to clear.

qos

Specifies clearing qos statistics.

queuing

Specifies clearing queuing statistics.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

If you do not specify the interface or VLAN, the device clears the counters for all VLANs and interfaces.

This command does not require a license.

Examples

This example shows how to clear all QoS statistics:

switch# clear qos statistics
switch# 

This example shows how to clear all input QoS statistics for VLAN1:

switch# clear qos statistics vlan 1 input
switch# 

Related Commands

Command
Description

qos statistics

Enables or disables QoS statistics.

show qos statistics

Displays QoS statistics.



default (table map)

To specify the default action for mapping input field values to output field values in a table map, use the default command.

default {value | copy}

no default {value | copy}

Syntax Description

value

Default value to use for the output value in the range from 0 to 63.

copy

Specifies that the default action is to copy all equal values to an equal output value.


Defaults

Copies the input value to the output value.

Command Modes

Table map configuration
Default table map configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


4.0(2)

The ignore variable for this command is no longer supported.


Usage Guidelines

The copy keyword is available only in the table map configuration mode. In the default table map configuration mode, the copy keyword is not available because all values must be assigned a mapping.

This command does not require a license.

Examples

This example shows how to remove the default mapping action copy. The resulting default action is ignore:

switch(config)# table-map my_table1
switch(config-tmap)# no default copy
switch(config-tmap)# 

Related Commands

Command
Description

from

Specifies input field to output field mappings in table maps.

show table-map

Displays table maps.



description

To add a description to a class map, policy map, or table map, use the description command. To remove the description, use the no form of this command.

description text

no description text

Syntax Description

text

Description for the class map, policy map, or table map. The description has a maximum of 200 characters.


Defaults

None

Command Modes

Class map type qos configuration
Policy map type qos configuration
Policy map type queuing configuration
Table map configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to add a description to a policy map:

switch(config)# policy-map my_policy1
switch(config-pmap)# description this policy applies to input packets
switch(config-pmap)# 

Related Commands

Command
Description

class-map

Creates or modifies a class map.

policy-map

Creates or modifies a policy map.

table-map

Creates or modifies a table map.



from (table map)

To specify a set of mappings of input field values to output field values in a table map, use the from command.

from source-value to dest-value

Syntax Description

source-value

Specifies the source value in the range from 0 to 63.

dest-value

Specifies the destination value in the range from 0 to 63.


Defaults

To configure the default mapping action for table maps, see the default (table map) command.

Command Modes

Table map configuration
Default table map configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to create a mapping from three source values to the corresponding destination values:

switch(config)# table-map my_table1
switch(config-tmap)# from 0 to 7
switch(config-tmap)# from 1 to 6
switch(config-tmap)# from 2 to 5

Related Commands

Command
Description

default (table map)

Specifies the default action for mapping of input field value to output field value in a table map.

show table-map

Displays table maps.



match access-group

To identify a specified access control list (ACL) group as a match criteria for a class map, use the match access-group command in the class map configuration mode. To remove ACL match criteria from a class map, use the no form of this command.

match access-group name acl-name

no match access-group name acl-name

Syntax Description

access-group name acl-name

Matches on the characteristics in the ACL name specified.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.

4.1(2)

This command was updated to allow matching on IPv6 ACLs and IPv4 ACLs.


Usage Guidelines


Note The permit and deny ACL keywords do not affect the matching of packets.


This command does not require a license.

Examples

This example shows how to create a qos class map that matches characteristics of the ACL my_acl:

switch(config)# class-map class_acl
switch(config-cmap-qos)# match access-group name my_acl

Related Commands

Command
Description

show class-map

Displays class maps.


match class-map

To match on the match commands in a specified class map, use the match class-map command in the class map configuration mode. To remove the match on the specified class map, use the no form of this command.

match [not] class-map class-map-name

no match [not] class-map class-map-name

Syntax Description

not

(Optional) Negates the specified match result.

class-map-name

Matches on the match commands in the specified class-map name.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to match on the matches specified in class map named my_test:

switch(config)# class-map my_test
switch(config-cmap-qos)# match class-name my_test

Related Commands

Command
Description

show class-map

Displays class maps.


match cos (class map type qos)

To define the class of traffic using the Class of Service (CoS) value in a type qos class map, use the match cos command. To remove the match on the CoS value, use the no form of this command.

match [not] cos cos-list

no match [not] cos cos-list

Syntax Description

not

(Optional) Negates the specified match result.

cos-list

Matches on the specified COS value or list of specified CoS values. Valid values are from 0 to 7.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

To specify a list of values, use one of the following options:

Specify a range of values separated by a dash

Specify a noncontiguous list of values separated by commas


Note Only class maps of type qos support the optional not keyword form of this command. Class maps of type queuing do not support the not keyword.


This command does not require a license.

Examples

This example shows how to match on the CoS value for a type qos class map:

switch(config)# class-map class_acl
switch(config-cmap-qos)# match cos 5-7

Related Commands

Command
Description

show class-map

Displays class maps.


match cos (class map type queuing)

To define the class of traffic in a type queuing class map, use the match cos command. To remove the match configuration, use the no form of these commands.

match cos cos-list

no match cos cos-list

Syntax Description

cos-list

Matches on the specified COS value or list of specified CoS values. Valid values are from 0 to 7.


Defaults

None

Command Modes

Class-map type queuing configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

To specify a list of values, use one of the following options:

Specify a range of values separated by a dash

Specify a noncontiguous list of values separated by commas

Any modifications you make to the class map type queuing changes the configuration for all ports of the specified port type on all VDCs.


Note Only class maps of type qos support the optional not keyword form of this command.


This command does not require a license.

Examples

This example shows how to modify a type queuing class map to match on CoS:

switch(config)# class-map type queuing match-any 8q2t-in-q4
switch(config-cmap-que)# match cos 3
switch(config-cmap-que)# 

Related Commands

Command
Description

show class-map

Displays class maps.


match discard-class

To identify specific discard class values as a match criteria, use the match discard-class command. To remove specified discard class values as a match criteria, use the no form of this command.

match [not] discard-class discard-class-list

no match [not] discard-class discard-class-list

Syntax Description

not

(Optional) Negates the specified match result.

discard-class-list

Matches on the specified discard class value or list of discard class values. Valid values are from 0 to 63.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

The discard-class value is an internal label and is not part of the packet payload or any packet header. The discard-class values have no mathematical significance.

To specify a list of values, use one of the following options:

Specify a range of values separated by a dash

Specify a noncontiguous list of values separated by commas

This command does not require a license.

Examples

This example shows how to match on discard class value 5:

switch(config)# class-map my_test
switch(config-cmap-qos)# match discard-class 5

Related Commands

Command
Description

show class-map

Displays class maps.


match dscp

To identify specific Differentiated Services code point (DSCP) values as a match criteria, use the match dscp command. To remove specified DSCP values as a match criteria, use the no form of this command.

match [not] dscp dscp-list

no match [not] dscp dscp-list

Syntax Description

not

(Optional) Negates the specified match result.

dscp-list

Matches on the specified DSCP value or list of DSCP values. See Table 2 for a list of valid DSCP values.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

The standard DSCP values are shown in Table 2.

Table 2 Standard DSCP Values 

 
List of DSCP Values

af11

AF11 dscp (001010)—decimal value 10

af12

AF12 dscp (001100)—decimal value 12

af13

AF13 dscp (001110)—decimal value 14

af21

AF21 dscp (010010)—decimal value 18

af22

AF22 dscp (010100)—decimal value 20

af23

AF23 dscp (010110)—decimal value 22

af31

AF31 dscp (011010)—decimal value 26

af32

AF40 dscp (011100)—decimal value 28

af33

AF33 dscp (011110)—decimal value 30

af41

AF41 dscp (100010)—decimal value 34

af42

AF42 dscp (100100)—decimal value 36

af43

AF43 dscp (100110)—decimal value 38

cs1

CS1 (precedence 1) dscp (001000)—decimal value 8

cs2

CS2 (precedence 2) dscp (010000)—decimal value 16

cs3

CS3 (precedence 3) dscp (011000)—decimal value 24

cs4

CS4 (precedence 4) dscp (100000)—decimal value 32

cs5

CS5 (precedence 5) dscp (101000)—decimal value 40

cs6

CS6 (precedence 6) dscp (110000)—decimal value 48

cs7

CS7 (precedence 7) dscp (111000)—decimal value 56

default

Default dscp (000000)—decimal value 0

ef

EF dscp (101110)—decimal value 46


To specify a list of values, use one of the following options:

Specify a range of values separated by a dash

Specify a noncontiguous list of values separated by commas

This command does not require a license.

Examples

This example shows how to match on DSCP value af21:

switch(config)# class-map my_test
switch(config-cmap-qos)# match dscp af21

Related Commands

Command
Description

show class-map

Displays class maps.


match ip rtp

To configure a class map to use the Real-Time Protocol (RTP) port as a match criteria, use the match ip rtp command. To remove the RTP port as a match criteria, use the no form of this command.

match [not] ip rtp port-list

no match [not] ip rtp port-list

Syntax Description

not

(Optional) Negates the specified match result.

port-list

Matches on the specified UDP or list of UDP ports that are using RTP. Valid values range from 2000 to 65535.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

To specify a list of values, use one of the following options:

Specify a range of values separated by a dash

Specify a noncontiguous list of values separated by commas

This command does not require a license.

Examples

This example shows how to match on a port using RTP:

switch(config)# class-map my_test
switch(config-cmap-qos)# match ip rtp 2300

Related Commands

Command
Description

show class-map

Displays class maps.


match packet length

To configure a class map to use Layer 3 packet length in the IP header as a match criteria, use the match packet length command. To remove a previously specified Layer 3 packet length as a match criteria, use the no form of this command.

match [not] packet length packet-length-list

no match [not] packet length packet-length-list

Syntax Description

not

(Optional) Negates the specified match result.

packet-length-list

Matches on the specified Layer 3 packet length or list of packets lengths specified in bytes. Valid values range from 1 to 9198.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

To specify a list of values, use one of the following options:

Specify a range of values separated by a dash

Specify a noncontiguous list of values separated by commas

This command does not require a license.

Examples

This example shows how to match on a Layer 3 packet length of 600 to 660:

switch(config)# class-map my_test
switch(config-cmap-qos)# match packet length 600-660

Related Commands

Command
Description

show class-map

Displays class maps.


match precedence

To configure a class map to use the precedence value in the Type of Service (TOS) byte field of the IP header as a match criteria, use the match precedence command. To remove the precedence values as a match criteria, use the no form of this command.

match [not] precedence precedence-list

no match [not] precedence precedence-list

Syntax Description

not

(Optional) Negates the specified match result.

precedence-list

Matches on the specified IP precedence value or list of IP precedence values specified in bytes. Valid values are shown in Table 3.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

See Table 3 for a list of precedence values.

Table 3 Precedence Values 

 
List of Precedence Values

<0-7>

IP precedence value

critical

Critical precedence (5)

flash

Flash precedence (3)

flash-override

Flash override precedence (4)

immediate

Immediate precedence (2)

internet

Internetwork control precedence (6)

network

Network control precedence (7)

priority

Priority precedence (1)

routine

Routine precedence (0)


To specify a list of values, use one of the following options:

Specify a range of values separated by a dash

Specify a noncontiguous list of values separated by commas

This command does not require a license.

Examples

This example shows how to match on an IP precedence value:

switch(config)# class-map my_test
switch(config-cmap-qos)# match precedence 7

Related Commands

Command
Description

show class-map

Displays class maps.


match protocol

To configure a class map to use a specific protocol as a match criterion, use the match protocol command. To remove the specified protocol as a match criteria, use the no form of this command.

match [not] protocol protocol-name

no match [not] protocol protocol-name

Syntax Description

not

(Optional) Negates the specified match result.

protocol-name

Matches on the specified protocol name. Valid values are shown in Table 4.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

The list of valid protocol names is shown in Table 4.

Table 4 Protocol Names

Argument
Description

arp

Address Resolution Protocol (ARP)

bridging

Bridging

cdp

Cisco Discovery Protocol (CDP)

clns

Connectionless Network Service (CLNS)

clns_es

CLNS End Systems

clns_is

CLNS Intermediate System

dhcp

Dynamic Host Configuration (DHCP)

isis

Intermediate system to intermediate system (IS-IS)

ldp

Label Distribution Protocol (LDP)

netbios

NetBIOS Extended User Interface (NetBEUI)



Note A maximum of eight different of the above protocols can be matched at one time.


To specify more than one protocol, enter the command more than once with the desired protocol value each time.

This command does not require a license.

Examples

This example shows how to match on a specified protocol:

switch(config)# class-map my_test
switch(config-cmap-qos)# match protocol ldp

Related Commands

Command
Description

show class-map

Displays class maps.


match qos-group

To configure a class map to use a specific QoS group value as a match criterion, use the match qos-group command. To remove the specified protocol as a match criteria, use the no form of this command.

match [not] qos-group qos-group-list

no match [not] qos-group qos-group-list

Syntax Description

not

(Optional) Negates the specified match result.

qos-group-list

Matches on the specified Qos group value or list of QoS group values specified in bytes. Valid values are from 0 to 126.


Defaults

None

Command Modes

Class-map type qos configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

The QoS group is an internal label and is not part of the packet payload or any packet header. The QoS group values have no mathematical significance. For example, a QoS group value of 2 is not greater than 1; the values are used only to internally differentiate QoS groups. As such, this value has local significance only.

You match on the QoS group only in egress policies because its value is undefined until you set it in an ingress policy.

To specify a list of values, use one of the following options:

Specify a range of values separated by a dash

Specify a noncontiguous list of values separated by commas

This command does not require a license.

Examples

This example shows how to match on a specified QoS group value:

switch(config)# class-map my_test
switch(config-cmap-qos)# match qos-group 6

Related Commands

Command
Description

show class-map

Displays class maps.


police (QoS)

To configure policing of the data rates for a particular class of traffic, use the police command. To remove a policing configuration, use the no form of this command.

police [cir] {cir-value [bps | kbps | mbps | gbps] | percent percent} | [[bc] bc-value [bytes | kbytes | mbytes | ms | us]] | | [pir {pir-value [bps | kbps | mbps | gbps] | percent percent} [[be] be-value [bytes | kbytes | mbytes | ms | us]] | [conform {transmit | set-prec-transmit precedence-value | set-dscp-transmit dscp-value | set-cos-transmit cos-val | set-discard-class-transmit discard-class-value | set-qos-transmit qos-group-value} [exceed {drop | set dscp dscp table cir-markdown-map}] [violate {drop | set dscp dscp table pir-markdown-map}]]}

no police [cir] {cir-value [bps | kbps | mbps | gbps] | percent percent} | [[bc] bc-value [bytes | kbytes | mbytes | ms | us]] | | [pir {pir-value [bps | kbps | mbps | gbps] | percent percent} [[be] be-value [bytes | kbytes | mbytes | ms | us]] | [conform {transmit | set-prec-transmit precedence-value | set-dscp-transmit dscp-value | set-cos-transmit cos-val | set-discard-class-transmit discard-class-value | set-qos-transmit qos-group-value} [exceed {drop | set dscp dscp table cir-markdown-map}] [violate {drop | set dscp dscp table pir-markdown-map}]]}

Syntax Description

cir

(Optional) Sets the committed information rate as a bit rate or a percentage of the link rate.

cir-value

Committed information rate. The range of values is 1 to 80000000000; the range of policing values that are mathematically significant is 8000 to 80 Gbps.

bps

(Optional) Specifies the units of bits per second.

kbps

(Optional) Specifies the units of kilobits per second.

mbps

(Optional) Specifies the units of megabits per second.

gbps

(Optional) Specifies the units of gigabits per second.

percent

Specifies the percentage of the related parameter.

percent

Specifies percent. Valid values are from 1 to 100.

bc

Sets the committed burst rate, which is how much the cir can be exceeded, either as a bit rate or an amount of time at cir.

bc-value

Committed burst rate. The range of values is 1 to 536870912. The default value is 200.

bytes

(Optional) Specifies the units of bytes per second.

kbytes

(Optional) Specifies the units of kilobytes per second.

mbytes

(Optional) Specifies the units of megabytes per second.

ms

(Optional) Specifies the units of milliseconds.

us

(Optional) Specifies the units of microseconds.

pir

Sets the peak information rate.

pir-value

Specifies the peak information rate. The range of values is 1 to 80000000000; the range of policing values that are mathematically significant is 8000 to 80 Gbps.

be

Extended burst rate.The range of values is 1 to 536870912.

be-value

Specifies the extended burst rate. If the bc value is not specified, the default is 200 milliseconds of traffic at the configured rate. The default data rate units are bytes.

conform

Sets the action to take when the data rate is within bounds.

transmit

Specifies the action of transmitting packets.

set-prec-transmit precedence-value

Sets the IP precedence field to the specified value and transmits the packet. Valid values are from 0 to 7.

set-dscp-transmit dscp-value

Sets the DSCP field to the specified value and transmits the packet. See Table 2 for a list of valid values for this field.

set-cos-transmit cos-val

Sets the CoS field to the specified value and transmits the packet. Valid values are from 0 to 7.

set-discard-class-transmit discard-class-value

Sets the discard class field to the specified value and transmits the packet. Valid values are from 0 to 63.

set-qos-transmit qos-group-value

Sets the QoS group field to the specified value and transmits the packet. Valid values are from 0 to 126.

exceed

Sets the action to take when the data rate is exceeded. The default is drop.

drop

Specifies the action of dropping packets.

set dscp dscp table cir-markdown-map

Sets the DSCP field to the corresponding value in the system-defined table map and transmits the packet.

violate

Sets the action to take when the data rate violates the configured rate values. The default is drop.

set dscp dscp table pir-markdown-map

Sets the DSCP field to the corresponding value in the system-defined table map and transmits the packet.


Defaults

bc default value is 200 milliseconds of traffic at the configured rate. The default data rate units are bytes.

be default value is 200 milliseconds of traffic at the configured rate. The default data rate units are bytes.

exceed default action is drop.

violate default action is drop.

Command Modes

Policy map type qos class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows a 1-rate, 2-color policer that transmits if the data rate is within 200 milliseconds of traffic at 256000 bps and marks the Differentiated Service Code Point (DSCP) value based on the system-defined table map pir-markdown-map if the data rate is violated:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class default-class
switch(config-pmap-c-qos)# police cir 256000 conform transmit violate drop
switch(config-pmap-c-qos)#

This example shows a 1-rate, 3-color policer that transmits if the data rate is within 200 milliseconds of traffic at 256000 bps, marks DSCP based on the system-defined table map cir-markdown-map if the data rate is within 300 milliseconds of traffic at 256000 bps, and drops packets otherwise (pir must equal cir):

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class default-class
switch(config-pmap-c-qos)# police cir 256000 pir 256000 conform transmit exceed set dscp 
dscp table cir-markdown-map violate drop
switch(config-pmap-c-qos)#

This example shows a 2-rate, 3-color policer that transmits and sets CoS to 5 if the data rate is within 200 milliseconds of traffic at 256000 bps, marks DSCP based on the system-defined table map cir-markdown-map if the data rate exceeds 200 milliseconds of traffic at 512 bps, and drops packets otherwise:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class default-class
switch(config-pmap-c-qos)# police cir 256000 pir 512000 conform set-cos-transmit 5 exceed 
set dscp dscp table cir-markdown-map violate drop
switch(config-pmap-c-qos)#

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



police aggregate

To apply an aggregate policer to a particular class of traffic across multiple interfaces, use the police aggregate command. To remove an aggregate policer configuration, use the no form of this command.

police aggregate policer-name

no police aggregate policer-name

Syntax Description

policer-name

Name of a shared aggregate policer to use.


Defaults

None

Command Modes

Policy map type qos class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

Shared policers can only be applied to interfaces on the same module.


Note For information about configuring a shared policer, see the qos shared-policer command.


This command does not require a license.

Examples

This example shows how to configure a shared policer for the class-default class of traffic:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class default-class
switch(config-pmap-c-qos)# police aggregate my_aggregate_policer
switch(config-pmap-c-qos)#

This example shows how to remove the configuration of a shared policer from the class-default class of traffic:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class default-class
switch(config-pmap-c-qos)# no police aggregate my_aggregate_policer
switch(config-pmap-c-qos)#

Related Commands

Command
Description

qos shared-policer

Configures simultaneous policing across multiple interfaces for a specified class of traffic.

show policy-map

Displays policy maps and statistics.



policy-map type qos

To create or modify a policy map and enter the policy map type qos configuration mode, use the policy-map type qos command. To remove a policy map, use the no form of this command.

policy-map [type qos] [match-first] qos-policy-map-name

no policy-map [type qos] [match-first] qos-policy-map-name

Syntax Description

match-first

(Optional) Specifies that policies associated with the first class that matches the packet characteristics are executed. This is the default action if this option is not specified.

Note Because this is the default action, you do not need to enter this variable; it is here to ensure compatibility with other systems.

qos-policy-map-name

Name assigned to a type qos policy map.


Defaults

The software enters the policy map type qos configuration mode if you enter the policy-map command without specifying a type.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

Use the service-policy command to assign policy maps to interfaces.

This command does not require a license.

Examples

This example shows how to create or modify a type qos policy map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)#

This example shows how to remove a type qos policy map:

switch(config)# no policy-map my_policy1

Related Commands

Command
Description

service-policy

Attaches a policy map to an interface.

show policy-map

Displays policy maps and statistics.


policy-map type queuing

To create or modify a policy map and enter the policy map type queuing configuration mode, use the policy-map type queuing command. To remove a policy map, use the no form of this command.

policy-map type queuing [match-first] queuing-policy-map-name

no policy-map type queuing [match-first] queuing-policy-map-name

Syntax Description

match-first

(Optional) Specifies that policies associated with the first class that matches the packet characteristics are executed. This is the default action if this option is not specified.

Note Because this is the default action, you do not need to enter this variable; it is here to ensure compatibility with other systems.

queuing-policy-map-name

Name assigned to a type queuing policy map.


Defaults

None

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

Use the service-policy command to assign policy maps to interfaces.

This command does not require a license.

Examples

This example shows how to create or modify a queuing policy map:

switch(config)# policy-map type queuing my_policy1
switch(config-pmap-que)#

This example shows how to remove a type queuing policy map:

switch(config)# no policy-map type queuing my_policy1
switch(config)#

Related Commands

Command
Description

service-policy

Attaches a policy map to an interface.

show policy-map

Displays policy maps and statistics.



priority (queuing)

To configure a single output queuing class as the priority queue, use the priority command. To remove the priority queue selection, use the no form of this command.

priority [level priority-value]

no priority [level priority-value]

Syntax Description

level priority-value

(Optional) Priority level for an output queuing class. Only one priority level is supported. The priority value can only be 1.


Defaults

The software distributes the bandwidth among the output queues, when you do not specify priority.

Command Modes

Policy map type queuing configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

The priority level can only be 1.

Use the bandwidth remaining command to allocate the remaining bandwidth among the nonpriority output queues. By default, the software evenly distributes the remaining bandwidth among the nonpriority output queues.

You can also use the police command to explicitly configure the priority for specified classes of traffic.


Note After you use this command in a specified policy map, you cannot use the bandwidth or shape command in the same policy map.


This command does not require a license.

Examples

This example shows how to assign a priority queue:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# priority level 1
switch(config-pmap-c-que)# 

This example shows how to remove a priority queue:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# no priority level 1
switch(config-pmap-c-que)# 

Related Commands

Command
Description

bandwidth remaining

Configures the bandwidth remaining on the interface in a queue.

police

Configures policing for specified classes of traffic.

show policy-map

Displays policy maps and statistics.



qos shared-policer

To configure simultaneous policing of the data rates for a particular class of traffic across multiple interfaces, use the qos shared-policer command. To remove a shared policer configuration, use the no form of this command.

qos shared-policer [type qos] policer-name [cir] {cir-value [bps | kbps | mbps | gbps] | percent percent} | [[bc] bc-value [bytes | kbytes | mbytes | ms | us]] | [pir {pir-value [bps | kbps | mbps | gbps] | percent -percent} [[be] be-value [bytes | kbytes | mbytes | ms | us]]] | [conform {transmit | set-prec-transmit precedence-value | set-dscp-transmit dscp-value | set-cos-transmit cos-val | set-discard-class-transmit discard-class-value | set-qos-transmit qos-group-value} [exceed {drop | set dscp dscp table cir-markdown-map}] [violate {drop | set dscp dscp table pir-markdown-map}]]

no qos shared-policer [type qos] policer-name

Syntax Description

type qos

(Optional) Component type, which is qos for this class.

policer-name

Name of a shared policer.

cir

(Optional) Sets the committed information rate as a bit rate or a percentage of the link rate.

cir-value

Committed information rate. The range of values is 1 to 80000000000; the range of policing values that are mathematically significant is 8000 to 80 Gbps.

bps

(Optional) Specifies the units of bits per second.

kbps

(Optional) Specifies the units of kilobits per second.

mbps

(Optional) Specifies the units of megabits per second.

gbps

(Optional) Specifies the units of gigabits per second.

percent

Specifies the percentage of the related parameter.

percent

Specifies percent. Valid values are from 1 to 100.

bc

Sets the committed burst rate, which is how much the cir can be exceeded, either as a bit rate or an amount of time at cir.

bc-value

Committed burst rate. The range of values is 1 to 536870912. The default value is 200.

bytes

(Optional) Specifies the units of bytes per second.

kbytes

(Optional) Specifies the units of kilobytes per second.

mbytes

(Optional) Specifies the units of megabytes per second.

ms

(Optional) Specifies the units of milliseconds.

us

(Optional) Specifies the units of microseconds.

pir

Sets the peak information rate.

pir-value

Specifies the peak information rate. The range of values is 1 to 80000000000; the range of policing values that are mathematically significant is 8000 to 80 Gbps.

be

Extended burst rate.The range of values is 1 to 536870912.

be-value

Specifies the extended burst rate. If the bc value is not specified, the default is 200 milliseconds of traffic at the configured rate. The default data rate units are bytes.

conform

Sets the action to take when the data rate is within bounds.

transmit

Specifies the action of transmitting packets.

set-prec-transmit precedence-value

Sets the IP precedence field to the specified value and transmits the packet. Valid values are from 0 to 7.

set-dscp-transmit dscp-value

Sets the DSCP field to the specified value and transmits the packet. See Table 2 for a list of valid values for this field.

set-cos-transmit cos-val

Sets the CoS field to the specified value and transmits the packet. Valid values are from 0 to 7.

set-discard-class-transmit discard-class-value

Sets the discard class field to the specified value and transmits the packet. Valid values are from 0 to 63.

set-qos-transmit qos-group-value

Sets the QoS group field to the specified value and transmits the packet. Valid values are from 0 to 126.

exceed

Sets the action to take when the data rate is exceeded. The default is drop.

drop

Specifies the action of dropping packets.

set dscp dscp table cir-markdown-map

Sets the DSCP field to the corresponding value in the system-defined table map and transmits the packet.

violate

Sets the action to take when the data rate violates the configured rate values. The default is drop.

set dscp dscp table pir-markdown-map

Sets the DSCP field to the corresponding value in the system-defined table map and transmits the packet.


Defaults

type default value is qos.

bc default value is 200 milliseconds of traffic at the configured rate. The default data rate units are bytes.

be default value is 200 milliseconds of traffic at the configured rate. The default data rate units are bytes.

exceed default action is drop.

violate default action is drop.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

The interfaces attached to the shared policer must be on the same module. See the police aggregate command for an example of using a shared policer.

This command does not require a license.

Examples

This example shows configuration of a 2-rate, 3-color shared policer that transmits and sets CoS to 5 if the data rate is within 200 milliseconds of traffic at 256000 bps, marks DSCP based on the system-defined table map cir-markdown-map if the data rate exceeds 200 milliseconds of traffic at 512 bps, and drops packets otherwise:

switch(config)# qos shared-policer my_shared_policer cir 256000 pir 512000 conform 
set-cos-transmit 5 exceed set dscp dscp table cir-markdown-map violate drop
switch(config)# 

Related Commands

Command
Description

police aggregate

Configures simultaneous policing of the data rates for a particular class of traffic across multiple interfaces.

show policy-map

Displays policy maps and statistics.


qos statistics

To enable QoS statistics, use the qos statistics command. To disable QoS statistics, use the no form of this command.

qos statistics

no qos statistics

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to enable QoS statistics:

switch(config)# qos statistics
switch(config)# 

This example shows how to disable QoS statistics:

switch(config)# no qos statistics
switch(config)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



queue-limit

To configure tail drop by setting queue limits on both ingress and egress queues, use the queue-limit command. To remove a queue limit, use the no form of this command.

queue-limit [cos cos-value] {queue-size [packets | bytes | kbytes | mbytes | ms | us] | percent percent-queue-size}

no queue-limit [cos cos-value] {queue-size [packets | bytes | kbytes | mbytes | ms | us] | percent percent-queue-size}

Syntax Description

cos cos-value

(Optional) Applies the queue limit to packets with the specified CoS value. Valid values are from 0 to 7.

queue-size

Specifies the queue size threshold. The range is from 1 to 83886080.

packets

(Optional) Specifies that queue size is in packets. If not specified, packets is the default units.

bytes

(Optional) Specifies that the queue size is in bytes.

kbytes

(Optional) Specifies that the queue size is in kilobytes.

mbytes

(Optional) Specifies that the queue size is in megabytes.

ms

(Optional) Specifies that the queue size is in milliseconds at the underlying interface minimum guaranteed link rate.

us

(Optional) Specifies that queue size is in microseconds at the underlying interface minimum guaranteed link rate.

percent-queue-size

Specifies the percentage of the buffer memory used by the queue. The range is from 1 to 100.


Defaults

queue-size is in packets by default.

Command Modes

Policy map type queuing class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

The system drops packets that exceed the configured queue-size threshold.

By default, the queue limit is applied to all packets with a CoS value not assigned a queue limit.

The queue limit is not supported on ingress policies on the 10-Gbps interfaces.

Tail drop and weighted random early detection (WRED) cannot be configured in the same class. For information about configuring WRED, see the random-detect command.

This command does not require a license.

Examples

This example shows how to assign a queue limit to a policy map queuing class that applies only to the specified CoS value:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# queue-limit cos 3 10 mbytes
switch(config-pmap-c-que)# 

This example shows how to remove a queue limit from a policy map queuing class:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# no queue-limit cos 3 10 mbytes
switch(config-pmap-c-que)# 

Related Commands

Command
Description

random-detect

Configures weighted random early detection (WRED).

show policy-map

Displays policy maps and statistics.



random-detect

To configure weighted random early detection (WRED) on both ingress and egress queues by setting aggregate minimum and maximum packet drop threshold default values for specific CoS values, use the random-detect command. To remove a WRED configuration, use the no form of this command.

random-detect {cos cos-list [minimum-threshold] {min-threshold [packets | bytes | kbytes | mbytes | ms | us] | percent min-percent-of-qsize} [maximum-threshold] {max-threshold [packets | bytes | kbytes | mbytes | ms | us] | percent max-percent-of-qsize}

no random-detect {cos cos-list [minimum-threshold] {min-threshold [packets | bytes | kbytes | mbytes | ms | us] | percent min-percent-of-qsize} [maximum-threshold] {max-threshold [packets | bytes | kbytes | mbytes | ms | us] | percent max-percent-of-qsize}

Syntax Description

cos cos-list

Specifies the CoS values where the software applies thresholds. Valid values are from 0 to 7.

min-threshold

Specifies the minimum threshold. Valid values are from 1 to 52428800.

packets

(Optional) Specifies that thresholds are in packets.

bytes

(Optional) Specifies that thresholds are in bytes.

kbytes

(Optional) Specifies that thresholds are in kilobytes.

mbytes

(Optional) Specifies that thresholds are in megabytes.

ms

(Optional) Specifies that thresholds are in milliseconds at the underlying interface minimum guaranteed link rate

us

(Optional) Specifies that thresholds are in microseconds at the underlying interface minimum guaranteed link rate.

min-percent-of-qsize

(Optional) Specifies the minimum percentage of the buffer memory used by the queue. The range is from 1 to 100.

max-threshold

Specifies the maximum threshold. Valid values are from 1 to 52428800.

max-percent-of-qsize

(Optional) Specifies the maximum percentage of the buffer memory used by the queue. The range is from 1 to 100.


Defaults

Thresholds are in packets by default.

The random-detect cos-based command must be specified for a queue to establish default thresholds for any CoS values that are not specified in random-detect commands for the same queue.

Command Modes

Policy map type queuing class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines


Note You must enter the random-detect cos-based command before you enter the random-detect command.


The minimum and maximum threshold units must match.

The system drops packets that exceed the minimum threshold at an increasing rate as the maximum threshold is reached. By default, the units are in packets,

WRED and tail drop cannot be configured in the same class. For information about configuring tail drop, see the queue-limit command.

You cannot configure WRED on ingress 10-Gigabit Ethernet ports.

For CoS lists, you can use the following:

Specify only one value—cos 1

Specify a range of values—cos 1-3

Specify a comma-separated list of values—cos 1, 4-6

This command does not require a license.

Examples

This example shows how to configure WRED for a queue by setting the default WRED thresholds followed by thresholds that apply to CoS values 5 and 7:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# random-detect cos-based aggregate 10 mbytes 20 mbytes
switch(config-pmap-c-que)# random-detect cos 5,7 15 mbytes 20 mbytes
switch(config-pmap-c-que)# 

This example shows how to configure WRED for a queue by setting the default WRED thresholds followed by queue buffer size thresholds that apply to CoS value 5:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# random-detect cos-based aggregate 10 mbytes 20 mbytes
switch(config-pmap-c-que)# random-detect cos 5 percent 5 percent 15
switch(config-pmap-c-que)# 

This example shows how to remove a WRED configuration from a policy map queuing class:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# no random-detect cos-based aggregate 10 mbytes 20 mbytes
switch(config-pmap-c-que)# no random-detect cos 5 percent 5 percent 15
switch(config-pmap-c-que)# 

Related Commands

Command
Description

random-detect cos-based

Configures WRED.

queue limit

Configures tail drop.

show policy-map

Displays policy maps and statistics.



random-detect cos-based

To configure weighted random early detection (WRED) on both ingress and egress queues by setting minimum and maximum packet drop thresholds, use the random-detect cos-based command. To remove a WRED configuration, use the no form of this command.

random-detect cos-based [aggregate [minimum-threshold] {min-threshold [packets | bytes | kbytes | mbytes | ms | us] | percent min-percent-of-qsize} [maximum-threshold] {max-threshold [packets | bytes | kbytes | mbytes | ms | us] | percent max-percent-of-qsize}]

no random-detect cos-based [aggregate [minimum-threshold] {min-threshold [packets | bytes | kbytes | mbytes | ms | us] | percent min-percent-of-qsize} [maximum-threshold] {max-threshold [packets | bytes | kbytes | mbytes | ms | us] | percent max-percent-of-qsize}]

Syntax Description

aggregate

(Optional) Specifies where the software applies aggregate thresholds for CoS values not specified in random-detect command.

min-threshold

Specifies the minimum threshold. Valid values are from 1 to 52428800.

packets

(Optional) Specifies that thresholds are in packets.

bytes

(Optional) Specifies that thresholds are in bytes.

kbytes

(Optional) Specifies that thresholds are in kilobytes.

mbytes

(Optional) Specifies that thresholds are in megabytes.

ms

(Optional) Specifies that thresholds are in milliseconds at the underlying interface minimum guaranteed link rate

us

(Optional) Specifies that thresholds are in microseconds at the underlying interface minimum guaranteed link rate.

min-percent-of-qsize

(Optional) Specifies the minimum percentage of the buffer memory used by the queue. The range is from 1 to 100.

max-threshold

Specifies the maximum threshold. Valid values are from 1 to 52428800.

max-percent-of-qsize

(Optional) Specifies the maximum percentage of the buffer memory used by the queue. The range is from 1 to 100.


Defaults

Thresholds are in packets by default.

Command Modes

Policy map type queuing class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command is required when you configure WRED to establish default thresholds for CoS values for which you do not define specific thresholds.

The minimum and maximum threshold units must match.

The system drops packets that exceed the minimum threshold at an increasing rate as the maximum threshold is reached. By default, the units are in packets,

WRED and tail drop cannot be configured in the same class. For information about configuring tail drop, see the queue-limit command.


Note You cannot configure WRED on ingress 10-Gigabit Ethernet ports.


This command does not require a license.

Examples

This example shows how to configure WRED for a queue by setting the default WRED thresholds followed by thresholds that apply to CoS values 5 and 7:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# random-detect cos-based aggregate 10 mbytes 20 mbytes
switch(config-pmap-c-que)# random-detect cos 5,7 15 mbytes 20 mbytes
switch(config-pmap-c-que)# 

This example shows how to configure WRED for a queue by setting the default WRED thresholds followed by queue buffer size thresholds that apply to CoS value 5:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# random-detect cos-based aggregate 10 mbytes 20 mbytes
switch(config-pmap-c-que)# random-detect cos 5 percent 5 percent 15
switch(config-pmap-c-que)# 

This example shows how to remove a WRED configuration from a policy map queuing class:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# no random-detect cos-based aggregate 10 mbytes 20 mbytes
switch(config-pmap-c-que)# no random-detect cos 5 percent 5 percent 15
switch(config-pmap-c-que)# 

Related Commands

Command
Description

random-detect

Configures WRED.

queue limit

Configures tail drop.

show policy-map

Displays policy maps and statistics.



service-policy

To attach a policy map to an interface, VLAN, or tunnel, use the service-policy command. To remove a service-policy from an interface, VLAN or tunnel, use the no form of this command.

service-policy [type {qos | queuing}] {input | output} policy-map-name [no-stats]

no service-policy [type {qos | queuing}] {input | output} policy-map-name [no-stats]

Syntax Description

type

(Optional) Specifies whether the policy map is of type qos or queuing.

qos

Specifies a policy map of type qos.

queuing

Specifies a policy map of type queuing.

input

Applies this policy map to packets coming into this interface.

output

Applies this policy map to packets going out of this interface.

policy-map-name

Name of the policy map to attach to this interface. Only one policy map can be attached to the input and one to the output of a given interface for each of the policy type qos and queuing.

no-stats

(Optional) Disables generation of statistics for this policy map.


Defaults

type default is qos.

No policies of type qos are active on an interface until the service-policy command is issued. The system-defined type queuing class maps are attached to each interface unless you specifically attach a different class map. For a list of the system-defined type queuing class maps, see Table 1.

Command Modes

Interface configuration
VLAN configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.

4.0(3)

Support for tunnel interfaces is added.


Usage Guidelines

No policies of type qos are active on an interface until you enter the service-policy command. The system-defined type queuing class maps are attached to each interface unless you specifically attach a different class map.

You can attach one ingress and one egress type qos policy map to port, port channel, tunnel, and VLANs. You can attach one ingress and one egress type queuing policy map to an interface of type port, port channel, tunnel, and VLAN.

Only one policy map can be attached to the input and one to the output of a given interface for each of the policy type qos and queuing.


Note For more information on using service policies, see the Cisco Nexus 7000 Series NX-OS Quality of Service Configuration Guide, Release 4.1.


This command does not require a license.

Examples

This example shows how to attach qos type policy maps to the ingress and egress packets of a VLAN:

switch(config)# vlan 1
switch(config-vlan)# service-policy input my_input_policy
switch(config-vlan)# service-policy output my_output_policy
switch(config-vlan)# 

This example shows how to attach a queuing policy map to the ingress packets of a port interface:

switch(config)# interface ethernet 2/1
switch(config-if)# service-policy type queuing input my_input_q_policy
switch(config-if)# 

This example shows how to remove a policy map from a VLAN:

switch(config)# vlan 1
switch(config-vlan)# no service-policy input my_input_policy
switch(config-vlan)# 

Related Commands

Command
Description

show policy-map interface brief

Displays all interfaces and VLANs with attached service policies in a brief format.



set cos (policy map type qos)

To assign a CoS value for a class of traffic in a type qos policy map, use the set command. To remove the assigned value from the class, use the no form of this command.

set cos cos-value

no set cos cos-value

Syntax Description

cos-value

Specifies the CoS value to assign for this class of traffic. The range is from 0 to 7.


Defaults

None

Command Modes

Policy map type qos class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

You can use this command only on type qos policies that are attached to egress ports.

This command does not require a license.

Examples

This example shows how to remove assignment of CoS for a class of traffic in a type qos policy map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class traffic_class2
switch(config-pmap-c-qos)# no set cos 3
switch(config-pmap-c-qos)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



set cos (policy map type queuing)

To assign a CoS value for untrusted ports in a type queuing policy map, use the set cos command. To remove the assigned value from the class, use the no form of this command.

set cos cos-value-queuing

no set cos cos-value-queuing

Syntax Description

cos cos-value-queuing

Specifies the CoS value to assign for this class of traffic. The range is from 0 to 7.


Defaults

None

Command Modes

Policy map type queuing class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

You can only use this form of the set cos command for ingress default type queuing classes. For a table of system-defined queuing class maps, see Table 1.


Note The CoS values that you set using this command apply to all packets ingressing the specified interfaces, not just to the class-default packets.


If you set the CoS value, the device modifies the value before ingress queuing and scheduling so the CoS-modified packets are classified differently.

This command does not require a license.

Examples

This example shows how to assign a CoS value for a class of traffic in a queuing policy map:

switch(config)# policy-map type queuing match-first my_queuing_policy1
switch(config-pmap-que)# class type queuing 2q4t-in-q-default
switch(config-pmap-c-que)# set cos 3
switch(config-pmap-c-que)# 

This example shows how to remove a CoS assignment for a class of traffic in a queuing policy map:

switch(config)# policy-map type queuing match-first my_queuing_policy1
switch(config-pmap-que)# class type queuing 2q4t-in-q-default
switch(config-pmap-c-que)# no set cos 3
switch(config-pmap-c-que)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



set discard-class

To assign a discard-class value for a class of traffic in a type qos policy map, use the set discard-class command. To leave the discard-class values unchanged, use the no form of this command.

set discard-class discard-value

no set discard-class discard-value

Syntax Description

discard-value

Specifies the discard-class value to assign for this class of traffic. The range is from 0 to 63.


Defaults

None

Command Modes

Policy map type qos class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

You can set the discard-class value only in ingress policies.


Note If you configure this value, you cannot configure a value using the set dscp or the set precedence command.


This command does not require a license.

Examples

This example shows how to assign discard-class value for a class of traffic in a type qos policy map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class traffic_class2
switch(config-pmap-c-qos)# set discard-class 40
switch(config-pmap-c-qos)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



set dscp (QoS)

To assign a DSCP value for a class of traffic in a type qos policy map, use the set dscp command. To remove a previously set DSCP value, use the no form of this command.

set dscp [tunnel] dscp-value

no set dscp [tunnel] dscp-value

Syntax Description

tunnel

Sets the DSCP value in the tunnel encapsulation. This keyword is not supported in Release 4.0.1.

dscp-value

Specifies the DSCP value or parameter to assign for this class of traffic. The range is from 0 to 63.


Defaults

None

Command Modes

Policy map type qos class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.

4.0.3

The tunnel keyword is supported.


Usage Guidelines

See Table 2 for a list of standard DSCP values.


Note If you configure this value, you cannot configure a value using the set discard-class or set precedence command.


This command does not require a license.

Examples

This example shows how to assign DSCP for a class of traffic in a type qos policy map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class traffic_class2
switch(config-pmap-c-qos)# set cos 3
switch(config-pmap-c-qos)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



set precedence (QoS)

To set precedence value in an IP header for a class of traffic in a type qos policy map, use the set precedence command. To leave the precedence value unchanged for the class, use the no form of this command.

set precedence [tunnel] precedence-value

no set precedence [tunnel] precedence-value

Syntax Description

tunnel

Sets the IP precedence value in the tunnel encapsulation. This keyword is not supported in Release 4.0.1.

precedence-value

Specifies the IP precedence value to assign for this class of traffic. The range is from 0 to 7.


Defaults

None

Command Modes

Policy map type qos class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.

4.0.3

The tunnel keyword is supported.


Usage Guidelines

See Table 3 for a list of the IP precedence values.

The device rewrites the last 3 bits of the Type of Service (ToS) field in the IP header to 0 for packets that match this class.


Note If you configure this value, you cannot configure a value using the set discard-class or set dscp command.


This command does not require a license.

Examples

This example shows how to set the IP precedence value for a class of traffic in a type qos policy map:

switch(config)# policy-map policy1
switch(config-pmap-qos)# class class2
switch(config-pmap-c-qos)# set precedence 3
switch(config-pmap-c-qos)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



set qos-group

To assign the QoS group identifier for a class of traffic in a type qos policy map, use the set qos-group command. To remove the assigned value from the class, use the no form of this command.

set qos-group qos-group-value

no set qos-group qos-group-value

Syntax Description

qos-group-value

Specifies the QoS group value to assign for this class of traffic. The range is from 0 to 126.


Defaults

None

Command Modes

Policy map type qos class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

You can set the QoS group identifier value only in ingress policies.

This command does not require a license.

Examples

This example shows how to assign a QoS group identifier for a class of traffic in a type qos policy map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class traffic_class2
switch(config-pmap-c-qos)# set qos-group 100
switch(config-pmap-c-qos)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



set table

To define a mapping between two fields for a class of traffic in a type qos policy map, use the set table command. To remove the assigned mapping from the class, use the no form of this command.

set header-parameter {same-header-parameter | output-header-parameter} table {table-map-name | mutation-map}

no set header-parameter {same-header-parameter | output-header-parameter} table {table-map-name | mutation-map}

Syntax Description

header-parameter

Specifies one of the header parameters cos, dscp, precedence, or discard-class.

same-header-parameter

Specifies a header parameter that is the same as the first header parameter in the command line.

output-header-parameter

Specifies an output header parameter that is different from the first header parameter in the command line. This is used in mutation mapping.

table-map-name

Specifies a user-defined table map name to use for mapping the specified header parameter.

mutation-map

Specifies a system-defined table map name to use for mutation mapping of the input parameter to the output parameter.


Defaults

None

Command Modes

Policy map type qos class configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


4.1(2)

You can set only similar values when you create a mutation map. For example, you can set cos-cos or dscp-dscp; you cannot set cos-dscp or dscp-precedence.


Usage Guidelines

The system-defined table maps used in the set table command are shown in Table 5.

Table 5 System-Defined Table Maps Used in the set table Command 

Table Map Name
Description

cos-discard-class-map

Table map used to map the CoS value to the discard-class value.

cos-dscp-map

Table map used to map the CoS value to the DSCP value.

cos-precedence-map

Table map used to map the CoS value to the precedence value.

dscp-cos-map

Table map used to map the DSCP value to the CoS value.

dscp-precedence-map

Table map used to map the DSCP value to the precedence value.

dscp-discard-class-map

Table map used to map the DSCP value to the discard-class value.

precedence-dscp-map

Table map used to map the precedence value to the DSCP value.

precedence-cos-map

Table map used to map the precedence value to the CoS value.

precedence-discard-class-map

Table map used to map the precedence value to the discard-class value.

discard-class-cos-map

Table map used to map the discard-class value to the CoS value.

discard-class-prec-map

Table map used to map the discard-class value to the precedence value.

discard-class-dscp-map

Table map used to map the discard-class value to the DSCP value.



Note You can set only similar values when you create a mutation map. For example, you can set cos-cos or dscp-dscp; you cannot set cos-dscp or dscp-precedence.


This command does not require a license.

Examples

This example shows how to perform mutation mapping for a class of traffic in a type qos policy map based on input DSCP and output IP precedence using a system-defined table map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class traffic_class2
switch(config-pmap-c-qos)# set dscp precedence table dscp-precedence-map
switch(config-pmap-c-qos)# 

This example shows how to perform mutation mapping for a class of traffic in a type qos policy map based on input DSCP and output IP precedence using a user-defined table map:

switch(config)# policy-map my_policy1
switch(config-pmap-qos)# class class_default
switch(config-pmap-c-qos)# set dscp dscp table my_table
switch(config-pmap-c-qos)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



shape

To configure shaping on an egress queue to impose a maximum rate on it, use the shape command. To remove a shaping configuration, use the no form of this command.

shape [average] {average-rate [bps | kbps | mbps | gbps] | percent percent-rate}

no shape [average] {average-rate [bps | kbps | mbps | gbps] | percent percent-rate}

Syntax Description

average

(Optional) Specifies an optional keyword. Shaping is based on an average rate.

average-rate

Average rate for shaping. The range of values is 1 to 80000000000; the range of policing values that are mathematically significant is 8000 to 80 Gbps.

bps

(Optional) Specifies the units of bits per second.

kbps

(Optional) Specifies the units of 1000 bits per second.

mbps

(Optional) Specifies the units of megabits per second.

gbps

(Optional) Specifies the units of gigabits per second.

percent

Specifies the percentage of the underlying interface link rate.

Note You can use the percent keyword only for interfaces that are set to autonegotiate.

percent-rate

Percent value in the range from 1 to 100.


Defaults

bps is default data rate.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

You use the system-defined egress queue class for the type of module to which you want to apply the policy map. See Table 1 for a list of the system-defined type queuing class maps.

The device forces the shape rate to the closest value in the following percentage intervals: 100, 50, 25, 12.5, 6.25, 3.13, or 1.07.


Note If you configure shaping, you cannot configure bandwidth or priority in the same policy map.


This command does not require a license.

Examples

This example shows how to apply shaping based on a percentage rate to a policy map type queuing class:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# shape percent 25
switch(config-pmap-c-que)# 

This example shows how to apply shaping based on an average rate to a policy map type queuing class:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# shape 500 mbps
switch(config-pmap-c-que)# 

This example shows how to remove a shaping configuration from a policy map type queuing class:

switch(config)# policy-map type queuing match-first my_queue
switch(config-pmap-que)# class type queuing 1p3q4t-out-pq1
switch(config-pmap-c-que)# no shape percent 25
switch(config-pmap-c-que)# 

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



show class-map type qos

To display type qos class maps, use the show class-map type qos command.

show class-map type qos [class-map-name | color-class-map-name]

Syntax Description

class-map-name

Named class map. The name class-default is reserved.

color-class-map-name

System-defined color class map.


Defaults

Displays all type qos class maps if no class map name is specified.

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

Table 6 displays the list of system-defined class maps that display with this command.

Table 6 System-Defined Type qos Class Maps That Display with This Command 

Class Map Name
Description

conform-color-in

Type qos conform color class map in the input direction. This color-aware class map makes a policer color-aware for conform action.

conform-color-out

Type qos conform color class map in the output direction. This color-aware class map makes a policer color-aware for conform action.

exceed-color-in

Type qos exceed color class map in the input direction. This color-aware class map makes a policer color-aware for exceed action.

exceed-color-out

Type qos exceed color class map in the output direction. This color-aware class map makes a policer color-aware for exceed action.


When you enter the command show class-map with no arguments or keywords, the system also displays the Control Plane Policing (CoPP) configuration.

This command does not require a license.

Examples

This example shows how to display all type qos class maps:

switch(config)# show class-map type qos

  Type qos class-maps
  ====================

    class-map type qos match-all abc
      match dscp 0-3

    class-map type qos conform-color-in
      Description: Conform color map in input direction

    class-map type qos conform-color-out
      Description: Conform color map in output direction

    class-map type qos exceed-color-in
      Description: Exceed color map in input direction

    class-map type qos exceed-color-out
      Description: exceed color map in output direction

Related Commands

Command
Description

class-map

Creates or modifies a class map.



show class-map type queuing

To display type queuing class maps, use the show class-map type queuing command.

show class-map type queuing [class-map-name]

Syntax Description

class-map-name

Named class map.


Defaults

Displays all type queuing class maps if no class map name is specified.

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

See Table 1 for a list of the system-defined type queuing class maps.

This command does not require a license.

Examples

This example shows how to display all type queuing class maps:

switch(config)# show class-map type queuing

  Type queuing class-maps
  ========================

    class-map type queuing match-any 2q4t-in-q1
      Description: Classifier for ingress queue 1 of type 2q4t
      match cos 5-7

    class-map type queuing match-any 2q4t-in-q-default
      Description: Classifier for ingress default queue of type 2q4t
      match cos 0-4

    class-map type queuing match-any 8q2t-in-q1
      Description: Classifier for ingress queue 1 of type 8q2t
      match cos 5-7

    class-map type queuing match-any 8q2t-in-q2
      Description: Classifier for ingress queue 2 of type 8q2t

    class-map type queuing match-any 8q2t-in-q3
      Description: Classifier for ingress queue 3 of type 8q2t

    class-map type queuing match-any 8q2t-in-q4
      Description: Classifier for ingress queue 4 of type 8q2t

    class-map type queuing match-any 8q2t-in-q5
      Description: Classifier for ingress queue 5 of type 8q2t

    class-map type queuing match-any 8q2t-in-q6
      Description: Classifier for ingress queue 6 of type 8q2t

    class-map type queuing match-any 8q2t-in-q7
      Description: Classifier for ingress queue 7 of type 8q2t

    class-map type queuing match-any 8q2t-in-q-default
      Description: Classifier for ingress default queue of type 8q2t
      match cos 0-4

    class-map type queuing match-any 1p3q4t-out-pq1
      Description: Classifier for egress priority queue of type 1p3q4t
      match cos 5-7

    class-map type queuing match-any 1p3q4t-out-q2
      Description: Classifier for egress queue 2 of type 1p3q4t

    class-map type queuing match-any 1p3q4t-out-q3
      Description: Classifier for egress queue 3 of type 1p3q4t

    class-map type queuing match-any 1p3q4t-out-q-default
      Description: Classifier for egress default queue of type 1p3q4t
      match cos 0-4

    class-map type queuing match-any 1p7q4t-out-pq1
      Description: Classifier for egress priority queue of type 1p7q4t
      match cos 5-7

    class-map type queuing match-any 1p7q4t-out-q2
      Description: Classifier for egress queue 2 of type 1p7q4t

    class-map type queuing match-any 1p7q4t-out-q3
      Description: Classifier for egress queue 3 of type 1p7q4t

    class-map type queuing match-any 1p7q4t-out-q4
      Description: Classifier for egress queue 4 of type 1p7q4t

    class-map type queuing match-any 1p7q4t-out-q5
      Description: Classifier for egress queue 5 of type 1p7q4t

    class-map type queuing match-any 1p7q4t-out-q6
      Description: Classifier for egress queue 6 of type 1p7q4t

    class-map type queuing match-any 1p7q4t-out-q7
      Description: Classifier for egress queue 7 of type 1p7q4t

    class-map type queuing match-any 1p7q4t-out-q-default
      Description: Classifier for egress default queue of type 1p7q4t
      match cos 0-4

Related Commands

Command
Description

class-map

Creates or modifies a class map.



show policy-map

To display policy maps and statistics, use the show policy-map command.

show policy-map [type {qos | queuing}] [policy-map-name]

Syntax Description

type

(Optional) Specifies the component type to display.

qos

Displays policy maps of type qos only.

queuing

Displays policy maps of type queuing only.

policy-map-name

(Optional) Displays a named policy map.


Defaults

None.

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.

4.0(3)

The WRR for the type queuing default-in-policy was changed from 50/50 to 80/20.


Usage Guidelines

When you enter the command show policy-map with no arguments or keywords, the system also displays the Control Plane Policing (CoPP) information.

This command does not require a license.

Examples

This example shows how to display a named policy map:

switch(config)# show policy-map abc

Type qos policy-maps
  ====================

  policy-map type qos abc
    class  abc
      set dscp 3
      set qos-group 3
      set cos dscp table cos-dscp-map
    class  class-default

This example shows how to display all type queuing policy maps:

switch(config)# show policy-map type queuing

  Type queuing policy-maps
  ========================

  policy-map type queuing q1
    class type queuing 8q2t-in-q-default
      set cos 4
  policy-map type queuing default-in-policy
    class type queuing in-q1
      queue-limit percent 50
      bandwidth percent 80
    class type queuing in-q-default
      queue-limit percent 50
      bandwidth percent 20
  policy-map type queuing default-out-policy
    class type queuing out-pq1
      priority level 1
      queue-limit percent 16
    class type queuing out-q2
      queue-limit percent 1
    class type queuing out-q3
      queue-limit percent 1
    class type queuing out-q-default
      queue-limit percent 82
      bandwidth remaining percent 25

Related Commands

Command
Description

class-map

Creates or modifies a class map.



show policy-map interface

To display policy maps and statistics for the interfaces, use the show policy-map interface command.

show policy-map interface [ethernet {slot/port} | port-channel {channel-number}] [input | output] [type {qos | queuing}]

Syntax Description

ethernet

(Optional) Displays policy maps assigned to Ethernet interfaces.

slot/port

Displays policy maps assigned to specified interface.

port-channel

(Optional) Displays policy maps assigned to port channels.

channel-number

Displays policy maps assigned to specified port channel.

input

(Optional) Displays policy maps assigned to input traffic only.

output

(Optional) Displays policy maps assigned to output traffic only.

type

(Optional) Specifies the component type to display.

qos

Displays policy maps of type qos only.

queuing

Displays policy maps of type queuing only.


Defaults

None.

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

Statistics are on by default.

This command does not require a license.

Examples

This example shows how to display policy maps assigned to a specified interface:

switch(config)# show policy-map interface ethernet 2/10

Global statistics status :   enabled

Ethernet2/10

  Service-policy (queuing) input:   default-in-policy
    policy statistics status:   enabled

    Class-map (queuing):   in-q1 (match-any)
      queue-limit percent 50
      bandwidth percent 50
      queue dropped pkts : 0

    Class-map (queuing):   in-q-default (match-any)
      queue-limit percent 50
      bandwidth percent 80
      queue dropped pkts : 0

  Service-policy (queuing) output:   default-out-policy
    policy statistics status:   enabled

    Class-map (queuing):   out-pq1 (match-any)
      priority level 1
      queue-limit percent 16
      queue dropped pkts : 0

    Class-map (queuing):   out-q2 (match-any)
      queue-limit percent 1
      queue dropped pkts : 0

    Class-map (queuing):   out-q3 (match-any)
      queue-limit percent 1
      queue dropped pkts : 0

    Class-map (queuing):   out-q-default (match-any)
      queue-limit percent 82
      bandwidth remaining percent 25
      queue dropped pkts : 0

This example shows how to display policy maps assigned to a specified interface:

switch(config)# show policy-map interface ethernet 2/2 type qos

Global statistics status : enabled 

Ethernet2/2 

Service-policy (qos) input: pmap 
policy statistics status: enabled 

Class-map (qos): map (match-all) 
1000000 packets 
Match: dscp 46 
police cir percent 20 bc 200 ms 
conformed 78962304 bytes, 2725540 bps action: transmit 
violated 49037696 bytes, 1692633 bps action: drop 

Class-map (qos): class-default (match-any) 
1000000 packets 
police cir percent 10 bc 200 ms 
conformed 39481856 bytes, 1362794 bps action: transmit 
violated 88518144 bytes, 3055378 bps action: drop

Related Commands

Command
Description

class-map

Creates or modifies a class map.



show policy-map interface brief

To display policy maps applied to interfaces in a brief format, use the show policy-map interface brief command.

show policy-map interface brief

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to display assigned policy maps in a brief format:

switch(config)# show policy-map interface brief

 Interface/VLAN [Status]:INP QOS       OUT QOS       INP QUE       OUT QUE
================================================================================
port-channel5   [Active]:                            default-in-po default-out-p

port-channel20  [Active]:                            default-in-po default-out-p

port-channel30  [Active]:                            default-in-po default-out-p

port-channel37  [Active]:                            default-in-po default-out-p

port-channel50  [Active]:                            default-in-po default-out-p


Ethernet2/2     [Active]:                            default-in-po default-out-p

Ethernet2/3     [Active]:                            default-in-po default-out-p

==================================================================================

Related Commands

Command
Description

show policy-map

Displays policy maps and statistics.



show policy-map vlan

To display policy maps for the VLANs, use the show policy-map vlan command.

show policy-map vlan [vlan-id] [input | output] [type {qos | queuing}]

Syntax Description

vlan-id

(Optional) Displays policy maps assigned to specified VLAN.

input

(Optional) Displays policy maps assigned to input traffic only.

output

(Optional) Displays policy maps assigned to output traffic only.

type

(Optional) Specifies the component type to display.

qos

Displays policy maps of type qos only.

queuing

Displays policy maps of type queuing only. This is not supported in Release 4.0.1.


Defaults

None.

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to display policy maps assigned to all VLANs:

switch(config)# show policy-map vlan

Global statistics status :   enabled

Vlan 1

  Service-policy (qos) input:   abc
    policy statistics status:   enabled

    Class-map (qos):   abc (match-all)
      Match: dscp 0-3
      set dscp 3
      set qos-group 3
      set cos dscp table cos-dscp-map

    Class-map (qos):   class-default (match-any)

  Service-policy (qos) output:   def
    policy statistics status:   enabled

Related Commands

Command
Description

class-map

Creates or modifies a class map.



show qos shared-policer

To display qos shared policers, use the show qos shared-policer command.

show qos shared policer [type qos] [policer-name]

Syntax Description

type qos

(Optional) Displays type qos policers.

policer-name

(Optional) Displays the specified policer name.


Defaults

None.

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to display all type qos policers:

switch(config)# show qos shared-policer

switch(config)# qos shared-policer foo cir 300 mbps bc 200 ms conform transmit violate 
drop

Related Commands

Command
Description

class-map

Creates or modifies a class map.



show queuing interface

To display queuing infromation on a specified interface, use the show queuing interface command.

show queuing interface {ethernet slot/port}

Syntax Description

slot/port

Enter the module number and the port number for which you want to display the queuing information.


Defaults

None.

Command Modes

Any command mode

Supported User Roles

network-admin
network-operator
vdc-admin
vdc-operator

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to display the queuing information for a specified interface:

switch# show queuing interface ethernet 2/9

Interface Ethernet2/9 TX Queuing strategy: Weighted Round-Robin
  Port QoS is enabled
    Queuing Mode in TX direction: mode-cos
    Transmit queues [type = 1p3q4t]
    Queue Id                       Scheduling   Num of thresholds
    _____________________________________________________________
       1p3q4t-out-q-default        WRR             04
       1p3q4t-out-q2               WRR             04
       1p3q4t-out-q3               WRR             04
       1p3q4t-out-pq1              Priority        04

   Configured WRR
      WRR bandwidth ratios:   25[1p3q4t-out-q-default] 38[1p3q4t-out-q2] 37[1p3q
4t-out-q3]
   WRR configuration read from HW
      WRR bandwidth ratios:   24[1p3q4t-out-q-default] 37[1p3q4t-out-q2] 37[1p3q
4t-out-q3]

   Configured queue-limit ratios
      queue-limit ratios:     82[1p3q4t-out-q-default] 1[1p3q4t-out-q2] 1[1p3q4t
-out-q3] 16[1p3q4t-out-pq1]
   queue-limit ratios configuration read from HW
      queue-limit ratios:     82[1p3q4t-out-q-default] 1[1p3q4t-out-q2] 1[1p3q4t
-out-q3] 16[1p3q4t-out-pq1]

   Thresholds:
      COS    Queue                       Threshold Type      Min     Max
      __________________________________________________________________
       0     1p3q4t-out-q-default            DT               100     100
       1     1p3q4t-out-q-default            DT               100     100
       2     1p3q4t-out-q-default            DT               100     100
       3     1p3q4t-out-q-default            DT               100     100
       4     1p3q4t-out-q-default            DT               100     100
       5     1p3q4t-out-pq1                  DT               100     100
       6     1p3q4t-out-pq1                  DT               100     100
       7     1p3q4t-out-pq1                  DT               100     100

  Interface Ethernet2/9 RX Queuing strategy: Weighted Round-Robin
    Queuing Mode in RX direction: mode-cos
    Receive queues [type = 2q4t]
    Port Cos not configured
    Queue Id                      Scheduling   Num of thresholds
    ____________________________________________________________
       2q4t-in-q-default           WRR             04
       2q4t-in-q1                  WRR             04

   Configured WRR
      WRR bandwidth ratios:   50[2q4t-in-q-default] 50[2q4t-in-q1]
   WRR configuration read from HW
      WRR bandwidth ratios:   50[2q4t-in-q-default] 50[2q4t-in-q1]

   Configured queue-limit ratios
      queue-limit ratios:     50[2q4t-in-q-default] 50[2q4t-in-q1]
   queue-limit ratios configuration read from HW
      queue-limit ratios:     50[2q4t-in-q-default] 50[2q4t-in-q1]

   Thresholds:
      COS    Queue                       Threshold Type      Min     Max
      __________________________________________________________________
       0     2q4t-in-q-default               DT               100     100
       1     2q4t-in-q-default               DT               100     100
       2     2q4t-in-q-default               DT               100     100
       3     2q4t-in-q-default               DT               100     100
       4     2q4t-in-q-default               DT               100     100
       5     2q4t-in-q1                      DT               100     100
       6     2q4t-in-q1                      DT               100     100
       7     2q4t-in-q1                      DT               100     100


Related Commands

Command
Description

show class-map type queuing

Displays information about class maps type queuing.

show policy-map type queuing

Displays information about policy maps type queuing.



show running-config ipqos

To display information about the running-system configuration for Quality of Service (QoS), use the show running-config ipqos command.

show running-config ipqos [all]

Syntax Description

all

(Optional) Displays configured and default information.


Defaults

None

Command Modes

Any command mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

This command does not require a license.

Examples

This example shows how to display QoS information:

switch(config)# show running-config ipqos

version 4.0(3)
qos statistics
class-map type qos match-all abc
  match dscp 0-3
class-map type qos match-all qqq
class-map type qos match-all class1
class-map type qos match-all cmapdef
class-map type qos match-all my_test
  match cos 5
class-map type qos match-all my_class
  match discard-class 56
class-map type qos match-all class_acl
class-map type qos match-all class_protocol
class-map conform-color-in
class-map conform-color-out
class-map exceed-color-in
class-map exceed-color-out
class-map type queuing match-any 2q4t-in-q1
  match cos 5-7
class-map type queuing match-any 2q4t-in-q-default
  match cos 0-4
class-map type queuing match-any 8q2t-in-q1
  match cos 5-7
class-map type queuing match-any 8q2t-in-q2
class-map type queuing match-any 8q2t-in-q3
class-map type queuing match-any 8q2t-in-q4
class-map type queuing match-any 8q2t-in-q5
class-map type queuing match-any 8q2t-in-q6
class-map type queuing match-any 8q2t-in-q7
class-map type queuing match-any 8q2t-in-q-default
  match cos 0-4
class-map type queuing match-any 1p3q4t-out-pq1
  match cos 5-7
class-map type queuing match-any 1p3q4t-out-q2
class-map type queuing match-any 1p3q4t-out-q3
class-map type queuing match-any 1p3q4t-out-q-default
  match cos 0-4
class-map type queuing match-any 1p7q4t-out-pq1
  match cos 5-7
class-map type queuing match-any 1p7q4t-out-q2
class-map type queuing match-any 1p7q4t-out-q3
class-map type queuing match-any 1p7q4t-out-q4
class-map type queuing match-any 1p7q4t-out-q5
class-map type queuing match-any 1p7q4t-out-q6
class-map type queuing match-any 1p7q4t-out-q7
class-map type queuing match-any 1p7q4t-out-q-default
  match cos 0-4
table-map cir-markdown-map
  default copy
  from 10,12 to 12
  from 18,20 to 20
  from 26,28 to 28
  from 34,36 to 36
table-map pir-markdown-map
  default copy
  from 10,12 to 14
  from 18,20 to 22
  from 26,28 to 30
  from 34,36 to 38
table-map cos-dscp-map
  default copy
  from 0 to 2
table-map cos-precedence-map
  default copy
table-map cos-discard-class-map
  default copy
table-map dscp-cos-map
  default copy
table-map dscp-precedence-map
  default copy
table-map dscp-discard-class-map
  default copy
table-map precedence-cos-map
  default copy
table-map precedence-dscp-map
  default copy
table-map precedence-discard-class-map
  default copy
table-map discard-class-cos-map
  default copy
table-map discard-class-dscp-map
  default copy
table-map discard-class-precedence-map
  default copy
table-map t1
  default copy
table-map abc
  default copy
table-map my_table1
  default copy
table-map steve_tm2
  default 3
table-map steve_table_map
  default ignore
policy-map type queuing q
policy-map type queuing pq
  class type queuing 8q2t-in-q4
    queue-limit cos 3 1000 packets
    queue-limit cos 4 1000 packets
    queue-limit 10000 packets
policy-map type queuing q1
policy-map type queuing q2
  class type queuing 1p3q4t-out-pq1
policy-map type queuing p_q
  class type queuing 8q2t-in-q4
  class type queuing 8q2t-in-q-default
    set cos 4
policy-map type queuing abcq
  class type queuing 8q2t-in-q4
policy-map type queuing p_q2
  class type queuing 1p7q4t-out-q2
    shape average percent 10
policy-map type queuing steve_q
  class type queuing 1p7q4t-out-pq1
  class type queuing 1p7q4t-out-q4
  class type queuing 1p7q4t-out-q2
policy-map type queuing my_queue
  class type queuing 1p3q4t-out-pq1
policy-map type queuing steve_pq1
  class type queuing 1p3q4t-out-pq1
policy-map type qos abc
  class abc


switch# show running-config ipqos
version 4.0(3)
class-map type qos match-all abc
  match dscp 0-3
class-map type qos match-all qqq
class-map type qos match-all class1
class-map type qos match-all cmapdef
class-map type qos match-all my_test
  match cos 5
class-map type qos match-all my_class
  match discard-class 56
class-map type qos match-all class_acl
class-map type qos match-all class_protocol
table-map cos-dscp-map
  default copy
  from 0 to 2
table-map t1
  default copy
table-map abc
  default copy
table-map my_table1
  default copy
table-map steve_tm2
  default 3
table-map steve_table_map
  default ignore
policy-map type queuing q
policy-map type queuing pq
  class type queuing 8q2t-in-q4
    queue-limit cos 3 1000 packets
    queue-limit cos 4 1000 packets
    queue-limit 10000 packets
policy-map type queuing q1
policy-map type queuing q2
  class type queuing 1p3q4t-out-pq1
policy-map type queuing p_q
  class type queuing 8q2t-in-q4
  class type queuing 8q2t-in-q-default
    set cos 4
policy-map type queuing abcq
  class type queuing 8q2t-in-q4
policy-map type queuing p_q2
  class type queuing 1p7q4t-out-q2
    shape average percent 10
policy-map type queuing steve_q
  class type queuing 1p7q4t-out-pq1
  class type queuing 1p7q4t-out-q4
  class type queuing 1p7q4t-out-q2
policy-map type queuing my_queue
  class type queuing 1p3q4t-out-pq1
policy-map type queuing steve_pq1
  class type queuing 1p3q4t-out-pq1
policy-map type qos abc
  class abc
    set dscp 3
    set qos-group 3
    set cos dscp table cos-dscp-map
  class class-default
policy-map type qos def
policy-map type qos policy1
  class class-default
  class class1
policy-map type qos polilcy1
policy-map type qos my_policy
  class class-default
policy-map type qos my_policy1
policy-map type queuing my_policy1
  class type queuing 1p7q4t-out-q2
policy-map type queuing shape_queue
  class type queuing 1p3q4t-out-pq1
    queue-limit 38984 packets
    random-detect cos-based
policy-map type queuing shape_queues
  class type queuing 1p3q4t-out-pq1
policy-map type queuing 1p3q4t-out-pq1
policy-map type queuing untrusted_port_cos
  class type queuing 2q4t-in-q-default

interface Ethernet2/4
  service-policy type qos input abc
  service-policy type qos output def
  service-policy type queuing output q1

Related Commands

Command
Description

show class-map

Displays information about class maps.

show policy-map

Displays statistics and information about policy maps.



show table-map

To display table maps, use the show table-map command.

show table-map [table-map-name | default-table-map-name]

Syntax Description

table-map-name

Displays the user-defined named table map.

default-table-map-name

Displays a system-defined default table map.


Defaults

None.

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.

4.0.2

Display was changed


Usage Guidelines

See Table 5 for a list of the system-defined table maps.

In Cisco NX-OS Release 4.0.2 and later releases, the display shows only one of the folloiwng:

The default copy if you have not configured any changes to the table map.

The changes you configured to the table map.

This command does not require a license.

Examples

In Cisco NX-OS Release 4.0.2 and later releases, the following example shows how to display a system-defined table map:

switch(config-pmap-c-qos)# show table-map cos-dscp-map

  Table-map cos-dscp-map
    default copy

This example shows how to display a system-defined table map:

switch(config)# show table-map cos-dscp-map

Table-map cos-dscp-map
    from  0 to 0
    from  1 to 1
    from  2 to 2
    from  3 to 3
    from  4 to 4
    from  5 to 5
    from  6 to 6
    from  7 to 7

Related Commands

Command
Description

table-map

Creates or modifies a table map.



table-map

To create or modify a table map and enter the table map configuration mode, use the table-map command. To remove a table map, use the no form of this command.

table-map {table-map-name | default-table-map-name}

no table-map {table-map-name | default-table-map-name}

Syntax Description

table-map-name

Name of an existing or new user-defined table map.

default-table-map-name

Name of a system-defined table map.


Defaults

None

Command Modes

Global configuration

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

4.0

This command was introduced.


Usage Guidelines

See Table 5 for a list of the system-defined table maps.

This command does not require a license.

Examples

This example shows how to create or modify a table map:

switch(config)# table-map my_table1
switch(config-tmap)#

This example shows how to remove a table map:

switch(config)# no table-map my_table1
switch(config)#

Related Commands

Command
Description

show table-map

Displays table maps.