map queue

Syntax

map queue <QUEUE-NUMBER> local-priority <PRIORITY-NUMBER>

no map queue <QUEUE-NUMBER> [local-priority <PRIORITY-NUMBER>]

Description

Assigns a local priority to a queue in a queue profile. By default, the larger the queue number the higher its priority. A queue without a local priority value assigned to it is not used to store packets. The same queue can be assigned multiple local priorities.

The no form of this command removes the specified local priority from a specific queue. If no local priority number is specified, then all local priorities are removed from the queue.

Command context

config-queue

Parameters

<QUEUE-NUMBER>

Specifies the queue number. Range: 0 to 7.

<PRIORITY-NUMBER>

Specifies the queue priority. Range: 0 to 7, where 0 is the lowest priority and 7 is the highest.

Authority

Administrators or local user group members with execution rights for this command.

Usage

  • For a queue profile to be complete and ready to be applied, all eight local priorities must be mapped to a queue.
The following commands illustrate an invalid configuration, where every local priority value is assigned to a queue.
map queue 0 local-priority 0
map queue 1 local-priority 1
map queue 1 local-priority 2
map queue 3 local-priority 3
map queue 4 local-priority 4
map queue 5 local-priority 5
map queue 5 local-priority 6
map queue 5 local-priority 7
The following commands illustrate an invalid configuration, because local priority 2 is not assigned to a queue.
map queue 0 local-priority 0
map queue 1 local-priority 1
map queue 2 local-priority 3
map queue 3 local-priority 4
map queue 4 local-priority 5
map queue 5 local-priority 6
map queue 5 local-priority 7

Examples

Assigning priority 7 to queue 7 in profile myprofile:

switch(config)# qos queue-profile myprofile
switch(config-queue)# map queue 7 local-priority 7

Removing priority 7 from queue 7 in profile myprofile:

switch(config)# qos queue-profile myprofile
switch(config-queue)# no map queue 7 local-priority 7