13.2. QoS Port Scheduler Policy Command Reference

13.2.1. Command Hierarchies

13.2.1.1. Port Scheduler Policy Configuration Commands

config
— qos
[no] port-scheduler-policy port-scheduler-name [create]
description description-string
mode {strict | rr | wrr | wdrr}
— no mode
queue queue-id [strict | weight weight]
— no queue queue-id

13.2.1.2. Operational Commands

config
— qos
copy port-scheduler-policy src-name dst-name [overwrite]

13.2.1.3. Show Commands

show
— qos
port-scheduler-policy [port-scheduler-policy-name] [association]

13.2.2. Command Descriptions

13.2.2.1. Configuration Commands

13.2.2.1.1. Generic Commands

description

Syntax 
description description-string
no description
Context 
config>qos>port-scheduler-policy
Supported Platforms 

7210 SAS-M (in access-uplink mode and network mode), 7210 SAS-T (in access-uplink mode and network mode), 7210 SAS-Sx/S 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

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.

13.2.2.2. Port Scheduler Policy Commands

port-scheduler-policy

Syntax 
[no] port-scheduler-policy port-scheduler-name [create]
Context 
config>qos
Supported Platforms 

7210 SAS-M (in access-uplink mode and network mode), 7210 SAS-T (in access-uplink mode and Network), 7210 SAS-Sx/S 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description 

The default scheduling done for a port is strict scheduling. When a port-scheduler policy is applied to a port, it overrides the default scheduling and determines the type of scheduling (Strict, RR, WRR, WDRR, WRR/WDRR + Strict) to be done between the 8 CoS queues of that particular port. When a port scheduler policy is detached from a port, the port reverts back to the default scheduling (strict).

The no form of this command removes the policy from the system.

Parameters 
port-scheduler-name—
Specifies an existing policy name. Each port-scheduler policy name should be unique and can go up to 32 ASCII characters in length.
create—
Keyword to create a port scheduler policy.

mode

Syntax 
mode {strict | rr | wrr | wdrr}
no mode
Context 
config>qos>port-sched-plcy
Supported Platforms 

7210 SAS-M (in access-uplink mode and network mode), 7210 SAS-T (in access-uplink mode and Network), 7210 SAS-Sx/S 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description 

This command configures a particular mode of scheduling for the policy. For example, this implies that when a policy with a mode RR is applied to a port then that port will follow the round robin type of scheduling between its queues.

Parameters 
mode—
Specifies the port scheduler policy mode.

strict — Strict scheduler mode

rr — Round Robin

wrr — Weighted Round Robin

wdrr — Weighted Deficit Round Robin

queue

Syntax 
queue queue-id [strict | weight weight]
no queue queue-id
Context 
config>qos>port-sched-plcy
Supported Platforms 

7210 SAS-M (in access-uplink mode and network mode), 7210 SAS-T (in access-uplink mode and Network), 7210 SAS-Sx/S 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description 

This command configures a port scheduler queue. The queue and its weights can be configured only for WRR/WDRR modes. The weight specified in case of WRR corresponds to the number of packets that needs to be sent out in a cycle for that particular queue.

For WDRR, the weight specified is the ratio of traffic that will be sent out for that particular queue. For example, in WDRR, if a weight value for queue 1 is 1 and a weight value for queue 2 is 5, then traffic out of the port is in the ratio of 1:5 between the queues (1 and 2) provided no traffic is flowing in the other queues. If the keyword strict is specified in any of the queues, then that particular queue will be treated as strict. This set of strict priority queues is serviced first in the order of their CoS numbering (the higher numbered CoS queue receives service before smaller numbered queues).

Note:

On the 7210 SAS-Sx/S 1/10GE: standalone and standalone-VC, the queue ID represents the FC. The FC is determined by the FC-to-queue ID map. For more information, see Schedulers on 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE.

The no form of this command under a WRR/WDRR mode will set the queue weights to default; for example, 1.

Parameters 
queue-id—
Specifies the queue ID.
Values—
1 to 8

 

strict—
Specifies strict access.
weight weight
Specifies the number of packets in case of WRR and ratio of traffic out in WDRR.
Values—
1 to 15

 

13.2.2.3. Operational Commands

copy

Syntax 
copy port-scheduler-policy src-name dst-name [overwrite]
Context 
config>qos
Supported Platforms 

7210 SAS-M (in access-uplink mode and network mode), 7210 SAS-T (in access-uplink mode and Network), 7210 SAS-Sx/S 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description 

This command copies existing port scheduler QoS policy entries for a port scheduler QoS policy to another port scheduler QoS 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.

If overwrite is not specified, an error will occur if the destination policy exists.

Parameters 
port-scheduler-policy src-name dst-name—
Specifies the source policy that the copy command will attempt to copy from and specifies the destination policy name to which the command will copy a duplicate of the policy. This parameter indicates that the source policy and the destination policy are port scheduler policy IDs.
overwrite—
Keyword to replace the destination policy name. When the overwrite keyword is specifies, everything in the existing destination policy will be completely overwritten with the contents of the source policy.

13.2.2.4. Show Commands

port-scheduler-policy

Syntax 
port-scheduler-policy [port-scheduler-policy-name] [association]
Context 
show>qos
Supported Platforms 

7210 SAS-M (in access-uplink mode and network mode), 7210 SAS-T (in access-uplink mode and Network), 7210 SAS-Sx/S 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description 

This command displays port-scheduler policy information

Parameters 
port-scheduler-policy-name—
Displays information for the specified existing port scheduler policy.
association—
Displays associations related to the specified port scheduler policy.
Output 

The following outputs are examples of QoS port scheduler policy information, and the associated tables describe the output fields:

Sample Output (7210 SAS-M and 7210 SAS-T)
*A:Dut-1>config# show qos port-scheduler-policy          
===============================================================================
Port Scheduler Policies
===============================================================================
Policy-Id                     Description                             Mode     
-------------------------------------------------------------------------------
default                       Default Port Scheduler policy.          STRICT   
psp                                                                   WDRR     
psp1                                                                  WDRR     
===============================================================================
*A:Dut-1>config#
 
 
*A:Dut-1>config# show qos port-scheduler-policy psp association 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : psp
Accounting        : packet-based                                               
Mode              : WDRR                                                       
 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
 - Port : 1/1/1
 
===============================================================================
*A:Dut-1>config# 
 
 
*A:Dut-1>config# show qos port-scheduler-policy psp 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : psp
Accounting        : packet-based                                               
Mode              : WDRR                                                       
Last changed      : 04/12/2001 02:04:16                                        
Queue 1 Weight:   : 1                                                          
Queue 2 Weight:   : 2                                                          
Queue 3 Weight:   : 5                                                          
Queue 4 Weight:   : 1                                                          
Queue 5 Weight:   : 1                                                          
Queue 6 Weight:   : 1                                                          
Queue 7 Weight:   : 1                                                          
Queue 8 Weight:   : 1                                                          
===============================================================================
*A:Dut-1>config# 
Table 63:  Output Fields: Port Scheduler Policy for 7210 SAS-M and 7210 SAS-T 

Label

Description

Policy-Id

The ID of the policy

Description

Description of the policy

Mode

Displays the port scheduler policy mode (STRICT, RR, WRR, WDRR)

Associations

Displays associations related to the specified port scheduler policy

Policy-Name

Displays the port scheduler policy name

Accounting

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

Last Changed

Displays the last time the configuration changed

Queue #

Displays the weight of the queue, if configured

Sample Output (7210 SAS-Sx 1/10GE)
*A:K-SAS-Sx>config>qos# show qos port-scheduler-policy 
===============================================================================
Port Scheduler Policies
===============================================================================
Policy-Id                     Description                             Mode
-------------------------------------------------------------------------------
1                                                                     STRICT
default                       Default Port Scheduler policy.          STRICT
===============================================================================
*A:K-SAS-Sx>config>qos# show qos port-scheduler-policy "default" association 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : default
Description       : Default Port Scheduler policy.
Accounting        : packet-based        
Mode              : STRICT              
 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
- Port : 1/1/1
- Port : 1/1/2
- Port : 1/1/3
- Port : 1/1/4
- Port : 1/1/5
- Port : 1/1/6
- Port : 1/1/7
........
===============================================================================
*A:K-SAS-Sx>config>qos# show qos port-scheduler-policy "default" 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : default
Description       : Default Port Scheduler policy.
Accounting        : packet-based        
Mode              : STRICT              
Last changed      : 01/03/2000 07:34:35 
Number Of Queues  : 8                   
===============================================================================
Table 64:  Output Fields: Port Scheduler Policy for 7210 SAS-Sx 1/10GE 

Label

Description

Policy-Id

The ID of the policy

Description

Description of the policy

Mode

Displays the port scheduler policy mode (STRICT, RR, WRR, WDRR)

Associations

Displays associations related to the specified port scheduler policy

Policy-Name

Displays the port scheduler policy name

Accounting

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

Last Changed

Displays the last time the configuration changed

Number of Queues

Displays the number of queues, if configured

Sample Output (Association)
*A:card-1# show qos port-scheduler-policy default association 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : default
Description       : Default Port Scheduler policy.
Accounting        : packet-based                                               
Mode              : STRICT                                                     
 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
 - Port : 1/1/3
 - Port : 1/1/6
 - Port : 1/1/7
 - Port : 1/1/8
 - Port : 1/1/9
 - Port : 1/1/10
 - Port : 1/1/11
 - Port : 1/1/12
 - Port : 1/1/13
 - Port : 1/1/14
 - Port : 1/1/16                      
 - Port : 1/1/17
 - Port : 1/1/18
 - Port : 1/1/19
 - Port : 1/1/21
 - Port : 1/1/22
 - Port : 1/1/23
 - Port : 1/1/24
...
===============================================================================
*A:card-1#
 
*A:Dut-1>config# show qos port-scheduler-policy default 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : default
Description       : Default Port Scheduler policy.
Accounting        : packet-based                                               
Mode              : STRICT                                                     
Last changed      : 04/11/2001 19:59:21                                        
Number Of Queues  : 8                                                          
===============================================================================
*A:Dut-1>config# 
Table 65:  Output Fields: Association 

Label

Description

Policy-Name

Displays the port scheduler policy name

Description

Description of the policy

Accounting

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

Mode

Displays the port scheduler policy mode (STRICT, RR, WRR, WDRR)

Associations

Displays associations related to the specified port scheduler policy

Last Changed

Displays the last time the configuration changed

Number of Queues

Displays the number of queues, if configured