16.2. Queue Management Policy Command Reference

16.2.1. Command Hierarchies

16.2.1.1. Configuration Commands for 7210 SAS-Mxp

config
— qos
[no] queue-mgmt name
description description-string
— no description
[no] cbs size-in-kbytes
[no] mbs size-in-kbytes
[no] high-slope
[no] max-avg percent
[no] max-prob percent
[no] shutdown
[no] start-avg percent
[no] low-slope
[no] max-avg percent
[no] max-prob percent
[no] shutdown
[no] start-avg percent
[no] time-average-factor value
scope {exclusive |template}

16.2.1.2. Operational Commands

config
— qos
copy queue-mgmt src-name dst-name [overwrite]

16.2.1.3. Show Commands

show
— qos
queue-mgmt [name] [detail]

16.2.2. Command Descriptions

16.2.2.1. Configuration Commands

16.2.2.1.1. Generic Commands

description

Syntax 
description description-string
no description
Context 
config>qos>queue-mgmt
Supported Platforms 

7210 SAS-Mxp

Description 

This command creates a text description stored in the configuration file for a configuration context.

The description command associates a text string with a configuration context to help identify the context in the configuration file.

The no form of this command removes any description string from the context.

Parameters 
description-string—
Specifies a text string describing the entity. Allowed values are any string up to 80 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

16.2.2.1.2. Queue Management Policy QoS Commands

cbs

Syntax 
[no] cbs size-in-kbytes
Context 
config>qos>queue-mgmt
Supported Platforms 

7210 SAS-Mxp

Description 

This command specifies the CBS value (Minimum depth of the queue in kilo bytes).

Parameters 
size-in-kbytes —
Specifies the minimum depth of the queue, in kilo bytes.
Values—
0 to 145000, default

 

high-slope

Syntax 
[no] high-slope
Context 
config>qos>queue-mgmt
Supported Platforms 

7210 SAS-Mxp

Description 

This command configures the in-profile WRED slope parameters.

low-slope

Syntax 
[no] low-slope
Context 
config>qos>queue-mgmt
Supported Platforms 

7210 SAS-Mxp

Description 

This command configures the out-of-profile WRED slope parameters.

mbs

Syntax 
[no] mbs size-in-kbytes
Context 
config>qos>queue-mgmt
Supported Platforms 

7210 SAS-Mxp

Description 

This command specifies the MBS value (maximum depth of the queue in kilo bytes).

Parameters 
size-in-kbytes —
Specifies the maximum depth of the queue, in kilobytes.
Values—
0 to 145000, default

 

queue-mgmt

Syntax 
[no] queue-mgmt name
Context 
config>qos
Supported Platforms 

7210 SAS-Mxp

Description 

This command enables the context to configure a QoS queue management policy. A set of profiles and templates are available in hardware for configuring the queue parameters such as CBS, MBS, and WRED slopes parameters per queue. These profiles are available for use with multiple queues of the system. Queue management policy allows the user to define the queue parameters and allow for sharing among the queues.

Parameters 
name —
Specifies the name of the queue management policy. Valid names consist of any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

time-average-factor

Syntax 
time-average-factor value
no time-average-factor
Context 
config>qos>queue-mgmt
Supported Platforms 

7210 SAS-Mxp

Description 

This command configures the Time Average Factor (TAF).

Default 

7

Parameters 
value —
Specifies the TAF, expressed as a decimal integer. The value specified for TAF affects the speed at which the shared buffer average utilization tracks the instantaneous shared buffer utilization. A low value weights the new shared buffer average utilization calculation more to the shared buffer instantaneous utilization, zero using it exclusively. A high value weights the new shared buffer average utilization calculation more to the previous shared buffer average utilization value.
Values—
0 to 15

 

scope

Syntax 
scope {exclusive | template}
no scope
Context 
config>qos>queue-mgmt
Supported Platforms 

7210 SAS-Mxp

Description 

This command configures the scope as exclusive or template. The policy’s scope cannot be changed if the policy is applied to an interface multiple ports.

The no form of this command reverts the scope of the policy to the default.

Default 

template

Parameters 
exclusive—
Specifies that the policy can only be applied to one interface. If a policy with an exclusive scope is assigned to a second interface an error message is generated. If the policy is removed from the exclusive interface, it will become available for assignment to another exclusive interface.
template—
Specifies that the policy can be applied to multiple interface ports on the router. Default QoS policies are configured with template scope. An error is generated if you try to modify the scope parameter from template to exclusive scope on default policies.

16.2.2.1.3. WRED Slope Commands

max-avg

Syntax 
max-avg percent
no max-avg
Context 
config>qos>queue-mgmt>high-slope
config>qos>queue-mgmt>low-slope
Supported Platforms 

7210 SAS-Mxp

Description 

This command configures the maximum average value.

Default 

max-avg 90 — High slope default is 90% buffer utilization max-avg 75 — Low slope default is 75% buffer utilization

Parameters 
percent—
Specifies the maximum average for the high or low slopes.
Values—
0 to 100

 

max-prob

Syntax 
max-prob percent
no max-prob
Context 
config>qos>queue-mgmt>high-slope
config>qos>queue-mgmt>low-slope
Supported Platforms 

7210 SAS-Mxp

Description 

This command configures the maximum probability value.

Default 

max-avg 75 — High slope default is 75% maximum drop probability corresponding to max-avg max-avg 75 — Low slope default is 75% maximum drop probability corresponding to max-avg

Parameters 
percent—
Specifies the maximum probability for the high or low slopes.
Values—
1 to 99

 

shutdown

Syntax 
[no] shutdown
Context 
config>qos>queue-mgmt>high-slope
config>qos>queue-mgmt>low-slope
Supported Platforms 

7210 SAS-Mxp

Description 

This command enables or disables the administrative status of the WRED slope.

By default, all slopes are shutdown and have to be explicitly enabled (no shutdown).

The no form of this command administratively enables the WRED slope.

Default 

shutdown

start-avg

Syntax 
start-avg percent
no start-avg
Context 
config>qos>queue-mgmt>high-slope
config>qos>queue-mgmt>low-slope
Supported Platforms 

7210 SAS-Mxp

Description 

This command is used to configure the starting average value.

Default 

max-avg 70 — High slope default is 70% buffer utilization max-avg 50 — Low slope default is 50% buffer utilization

Parameters 
percent—
Specifies the starting average for the high or low slopes.
Values—
0 to 100

 

16.2.2.2. Operational Commands

copy

Syntax 
copy queue-mgmt src-name dst-name [overwrite]
Context 
config>qos
Supported Platforms 

7210 SAS-Mxp

Description 

This command copies the existing Queue management policy entries to another Queue management policy.

The copy command is a configuration level maintenance tool used to create new policies using existing policies. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.

Parameters 
src-name—
Specifies the name of the source policy, up to 32 characters.
dst-name—
Specifies the name of the destination policy, up to 32 characters.
overwrite—
Keyword to overwrite the information in the destination policy by the information in the source policy.

16.2.2.3. Show Commands

queue-mgmt

Syntax 
queue-mgmt [name] [detail]
Context 
show>qos
Supported Platforms 

7210 SAS-Mxp

Description 

This command displays queue management policy information.

Parameters 
name—
Specifies the name of the queue management policy.
detail—
Displays detailed information about the queue management policy.
Output 

The following output is an example of queue management policy information, and Table 68 describes the output fields.

Sample Output
*A:SASX>config>qos>queue-mgmt# show qos queue-mgmt 20 detail 
 
===============================================================================
QoS Queue Management Policy
===============================================================================
Policy         : 20                           
Description    : (Not Specified)
CBS            : 1                            MBS          : 10
Time Avg       : 7                            
 
-------------------------------------------------------------------------------
High Slope Parameters
-------------------------------------------------------------------------------
Start Avg      : 70                           Admin State  : Disabled
Max Avg        : 90                           Max Prob.    : 75
 
-------------------------------------------------------------------------------
Low Slope Parameters
-------------------------------------------------------------------------------
Start Avg      : 50                           Admin State  : Disabled
Max Avg        : 75                           Max Prob.    : 75
 
-------------------------------------------------------------------------------
Associations                          
-------------------------------------------------------------------------------
SAP Egress
-------------------------------------------------------------------------------
SAP Egress Policy Id          : 200
Queue Ids                     : 1, 2, 3, 4, 5, 6, 7, 8
-------------------------------------------------------------------------------
 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
No Associations Found.
 
-------------------------------------------------------------------------------
 
-------------------------------------------------------------------------------
Network Queues
-------------------------------------------------------------------------------
No Network Queue Policy Associations found.
-------------------------------------------------------------------------------
 
 
 
*A:SN12345678# show qos slope-policy 100  
===============================================================================
QoS Slope Policy
===============================================================================
Policy         : 100                                                           
Description    : Slope policy 100
-------------------------------------------------------------------------------
Utilization                   State       Start-Threshold
-------------------------------------------------------------------------------
High Slope
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%) 
-------------------------------------------------------------------------------
Queue1          Down            70           90            75 
Queue2          Down            70           90            75 
Queue3          Down            70           90            75 
Queue4          Down            70           90            75 
Queue5          Down            70           90            75 
Queue6          Down            70           90            75 
Queue7          Down            70           90            75 
Queue8          Down            70           90            75 
-------------------------------------------------------------------------------
Low Slope
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%) 
-------------------------------------------------------------------------------
Queue1          Down            50           75            75 
Queue2          Down            50           75            75 
Queue3          Down            50           75            75 
Queue4          Down            50           75            75 
Queue5          Down            50           75            75 
Queue6          Down            50           75            75 
Queue7          Down            50           75            75 
Queue8          Down            50           75            75 
-------------------------------------------------------------------------------
Non Tcp Slope
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%) 
-------------------------------------------------------------------------------
Queue1          Down            50           75            75 
Queue2          Down            50           75            75 
Queue3          Down            50           75            75 
Queue4          Down            50           75            75 
Queue5          Down            50           75            75 
Queue6          Down            50           75            75 
Queue7          Down            50           75            75 
Queue8          Down            50           75            75 
-------------------------------------------------------------------------------
Time Avg Factor
-------------------------------------------------------------------------------
Queue Id   Time Avg Factor
-------------------------------------------------------------------------------
Queue1            7 
Queue2            7 
Queue3            7 
Queue4            7 
Queue5            7 
Queue6            7 
Queue7            7 
Queue8            7 
===============================================================================
*A:SN12345678# show qos slope-policy 100 detail 
 
 
*A:SN12345678#
===============================================================================
QoS Slope Policy
===============================================================================
Policy         : 100                                                           
Description    : Slope policy 100
-------------------------------------------------------------------------------
High Slope
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%) 
-------------------------------------------------------------------------------
Queue1          Down            70           90            75 
Queue2          Down            70           90            75 
Queue3          Down            70           90            75 
Queue4          Down            70           90            75 
Queue5          Down            70           90            75 
Queue6          Down            70           90            75 
Queue7          Down            70           90            75 
Queue8          Down            70           90            75 
-------------------------------------------------------------------------------
Low Slope
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%) 
-------------------------------------------------------------------------------
Queue1          Down            50           75            75 
Queue2          Down            50           75            75 
Queue3          Down            50           75            75 
Queue4          Down            50           75            75 
Queue5          Down            50           75            75 
Queue6          Down            50           75            75 
Queue7          Down            50           75            75 
Queue8          Down            50           75            75 
-------------------------------------------------------------------------------
Non Tcp Slope
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%) 
-------------------------------------------------------------------------------
Queue1          Down            50           75            75 
Queue2          Down            50           75            75 
Queue3          Down            50           75            75 
Queue4          Down            50           75            75 
Queue5          Down            50           75            75 
Queue6          Down            50           75            75 
Queue7          Down            50           75            75 
Queue8          Down            50           75            75 
-------------------------------------------------------------------------------
Time Avg Factor
-------------------------------------------------------------------------------
Queue Id   Time Avg Factor
-------------------------------------------------------------------------------
Queue1            7 
Queue2            7 
Queue3            7 
Queue4            7 
Queue5            7 
Queue6            7 
Queue7            7 
Queue8            7 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Object Type Object Id     Application          Pool
-------------------------------------------------------------------------------
Port        1/1/13        Acc-Egr              default 
===============================================================================
*A:SN12345678# 
Table 68:  Output Fields: Queue Management Policy  

Label

Description

Policy

The ID that uniquely identifies the policy

Description

A string that identifies the policy’s context in the configuration file

Time Avg

The weighting between the previous shared buffer average utilization result and the new shared buffer utilization

CBS

Displays the committed burst size

MBS

Displays the maximum burst size

Slope Parameters

Start Avg

Specifies the low priority or high priority RED slope position for the shared buffer average utilization value where the packet discard probability starts to increase above zero

Max Avg

Specifies the percentage of the shared buffer space for the buffer pool at which point the drop probability becomes 1, expressed as a decimal integer

Admin State

Up — The administrative status of the RED slope is enabled

Down — The administrative status of the RED slope is disabled

Max Prob.

Specifies the high priority RED slope position for the maximum non-one packet discard probability value before the packet discard probability rises directly to one

Service Associations

SAP Egress Policy Id

Displays the SAP Egress policy ID

Queue Ids

Displays the Queue IDs