7.6. Command Descriptions

7.6.1. Configuration Commands

7.6.1.1. Generic Commands

description

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

Supported on all 7210 SAS platforms as described in this document

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, etc.), the entire string must be enclosed within double quotes.

7.6.1.2. Operational Commands

copy

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

Supported on all 7210 SAS platforms as described in this document

Description 

This command copies or overwrites existing network queue QoS policies to another network queue policy ID. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.

Parameters 
network-queue src-name dst-name
Specifies that the source policy ID and the destination policy ID are network-queue policy IDs. Specifies the source policy ID that the copy command attempts to copy from, and the destination policy ID to which the command copies a duplicate of the policy.
overwrite—
Specifies that everything in the existing destination policy is overwritten with the contents of the source policy. If overwrite is not specified, a message is generated saying that the destination policy ID exists.

7.6.1.3. Network Queue QoS Policy Commands

network-queue

Syntax 
[no] network-queue policy-name [create]
Context 
config>qos
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command creates a context to configure a network queue policy. Network queue policies on the Ethernet port define network egress queuing.

Network queue policies define the egress queuing for access-uplink ports.

The no form of this command removes the network-queue policy from use. However, the network queue with policy-name default cannot be modified or deleted.

Default 

default

Parameters 
policy-name—
Specifies the name of the network queue policy. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.
create—
Specifies that a network queue policy is created.

7.6.1.4. Network Queue QoS Policy Queue Commands

queue

Syntax 
queue queue-id
Context 
config>qos>network-queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures a QoS network-queue policy queue.

The FCs are mapped to queues, as listed in Table 15. Only one FC can be mapped to one queue. A queue-id value of 8 is the highest priority and a queue-id value of 1 is the lowest priority. Network queues carry both the unicast and multicast traffic and no segregation is performed. The hardware port scheduler prioritizes the queue according to the priority for each queue. High priority traffic should be mapped to high-priority FCs. Mapping traffic to high-priority FCs does not guarantee high priority treatment, because the scheduler policy can influence the relative priority among the queues.

Parameters 
queue-id—
Specifies the queue within the policy. This is a required parameter each time the queue command is executed.
Values—
1 to 8

 

adaptation-rule

Syntax 
adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
no adaptation-rule
Context 
config>qos>network-queue>queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command defines the method used by the system to derive the operational CIR and PIR settings when the queue is provisioned in hardware. For the CIR and PIR parameters individually, the system attempts to find the best operational rate depending on the defined constraint.

The no form of this command removes any explicitly defined constraints used to derive the operational CIR and PIR created by the application of the policy. When a specific adaptation-rule is removed, the default constraints for pir and cir apply.

Default 

adaptation-rule cir closest pir closest

Parameters 
cir adaptation-rule—
Specifies the adaptation rule and defines the constraints enforced when adapting the CIR rate defined using the queue queue-id rate command. The cir parameter requires a qualifier that defines the constraint used to derive the operational CIR rate for the queue. When the cir parameter is not specified, the default constraint applies. The max (maximum), min (minimum), and closest qualifiers are mutually exclusive.
Default—
closest
Values—
max — Specifies that the operational CIR value is less than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.
min — Specifies that the operational CIR value is greater than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.
closest — Specifies that the operational CIR value is equal to the closest specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

 

pir adaptation-rule—
Specifies the adaptation rule and defines the constraints enforced when adapting the PIR rate defined using the queue queue-id rate command. The pir parameter requires a qualifier that defines the constraint used when deriving the operational PIR rate for the queue. When the pir command is not specified, the default constraint applies. The max (maximum), min (minimum), and closest qualifiers are mutually exclusive.
Default—
closest
Values—
max — Specifies that the operational PIR value is less than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.
min — Specifies that the operational PIR value is greater than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.
closest — Specifies that the operational PIR value is equal to the closest specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

 

slope-policy

Syntax 
[no] slope-policy name
Context 
config>qos>network-queue>queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command is used to override the default slope-policy configuration for the queue. The specified slope-policy-name must exist as a current slope policy name. If the slope policy does not exist, the slope-policy command will fail. If a slope policy is currently associated with a queue, the slope policy cannot be removed from the system.

The slope policy contains High and Low slope definitions that will be used by the queue.

If the slope-policy command is not executed or the no slope policy command is executed, the default slope policy will be associated with the queue.

The no form of the command restores the default slope policy to the queue.

Parameters 
name—
The name parameter is required and must specify an existing slope policy name. If slope-policy-name does not exist, the slope-policy command will fail.
Values—
32 chars maximum

 

rate

Syntax 
rate [cir cir-percent] [pir pir-percent]
no rate
Context 
config>qos>network-queue>queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command defines the PIR and the CIR parameters for the queue. The PIR defines the maximum rate at which the queue can transmit packets through the port. Defining a PIR does not necessarily guarantee that the queue can transmit at the intended rate. The actual rate sustained by the queue can be limited by over subscription factors or available egress bandwidth. The CIR defines the rate at which the system prioritizes the queue over other queues competing for the same bandwidth.

The rate command can be executed at any time, changing the PIR and CIR rates for all queues created on the access ports.

The no form of this command reverts all queues created with the queue-id by association with the QoS policy to the default PIR and CIR parameters.

Parameters 
cir cir percent
Specifies the percentage of the guaranteed rate allowed for the queue. When the rate command is executed, a valid CIR setting must be explicitly defined. When the rate command has not been executed, the default CIR of 0 is assumed. Fractional values are not allowed and must be given as a positive integer.

The actual CIR rate is dependent on the queue’s adaptation-rule parameters and the actual hardware where the queue is provisioned.

Values—
0 to 100

 

Default—
0
pir percent
Specifies the percentage of the maximum rate allowed for the queue. When the rate command is executed, the PIR setting is optional. When the rate command has not been executed, or the PIR parameter is not explicitly specified, the default PIR of 100 is assumed. Fractional values are not allowed and the value must be a positive integer.
Values—
1 to 100 percent

 

Default—
100

7.6.1.5. Show Commands

network-queue

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

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays network queue policy information.

Parameters 
network-queue-policy-name—
Specifies the name of the network queue policy. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.
detail—
Specifies each queue’s rates and adaptation-rule and & cbs details. It also shows FC to queue mapping details.
Output 

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

Sample Output
*A:card-1# show qos network-queue nq1    
===============================================================================
QoS Network Queue Policy
-------------------------------------------------------------------------------
Network Queue Policy (nq1)
-------------------------------------------------------------------------------
Policy         : nq1                                                          
Accounting     : packet-based 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Port-id : 1/1/20 
===============================================================================
*A:card-1# 
 
*A:card-1>config>qos# show qos network-queue nq1-cbs detail
===============================================================================
QoS Network Queue Policy
-------------------------------------------------------------------------------
Network Queue Policy (nq1-cbs)
-------------------------------------------------------------------------------
Policy : nq1-cbs
Accounting : packet-based
-------------------------------------------------------------------------------
Queue CIR        PIR       CBS
      CIR Rule   PIR Rule
-------------------------------------------------------------------------------
1      0         32        8.29
       max       closest
2      0         100       6.00
       closest   closest
3      0         100       10.00
       closest   closest
4      0         100       6.00
       closest   closest
5      0         100       10.00
       closest   closest
6      0         4         10.00
       closest   closest
7      3         93        1.00
       closest   closest
8      0         3         7.00
       closest   closest
-------------------------------------------------------------------------------
FC    UCastQ
-------------------------------------------------------------------------------
be     1
l2     2
af     3
l1     4
h2     5
ef     6
h1     7
nc     8
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Port-id : 1/1/1
===============================================================================
*A:card-1>config>qos#
Table 35:  Output Files: Network Queue Policy 

Label

Description

Policy

The policy name that uniquely identifies the policy

Accounting

Displays whether the accounting mode is packet-based or frame-based

Description

A text string that helps identify the policy’s context in the configuration file

Port-Id

Displays the physical port identifier where the network queue policy is applied

Queue

Displays the queue ID

CIR

Displays the committed information rate

PIR

Displays the peak information rate

CBS

Displays the committed burst size

FC

Displays FC to queue mapping