10.5. Command Descriptions

10.5.1. Configuration Commands

10.5.1.1. Generic Commands

description

Syntax 
description description-string
no description
Context 
config>qos>port-scheduler-policy
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.

10.5.1.2. Operational Commands

copy

Syntax 
copy port-scheduler-policy 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 existing port scheduler QoS policy entries for a port scheduler QoS policy to another port scheduler QoS policy. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.

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

10.5.1.3. Port Scheduler Policy Commands

port-scheduler-policy

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

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures the port-scheduler policy. 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.
create —
Specifies that a port scheduler policy is created.

mode

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

Supported on all 7210 SAS platforms as described in this document

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 
strict—
Specifies that the port follows a strict scheduler mode.
rr—
Specifies that the port follows round robin scheduling.
wrr—
Specifies that the port follows weighted round robin scheduling.
wdrr—
Specifies that the port follows weighted deficit round robin scheduling.

queue

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

Supported on all 7210 SAS platforms as described in this document

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).

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 (8 is the highest)

 

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

 

10.5.1.4. Show Commands

port-scheduler-policy

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

Supported on all 7210 SAS platforms as described in this document

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 port scheduler policy information, and Table 45 describes the output fields.

Sample Output
*A:card-1>config# show qos port-scheduler-policy
===============================================================================
Port Scheduler Policies
===============================================================================
Policy-Id                 Description                              Mode
default                   Default Port Scheduler Policy.           STRICT
psp                                                                WRR
test                      psp                                      WRR
===============================================================================
*A:card-1>config#
*A:card-1>config# show qos port-scheduler-policy psp association
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name : psp
Mode : WRR
Accounting: packet-based
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
- Port : 1/1/1
===============================================================================
*A:card-1>config#
*A:card-1>config# show qos port-scheduler-policy psp
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name : psp
Mode : WRR
Accounting : packet-based
Last changed : 01/01/2000 05:14:06
Queue 1:          Weight: 1
Queue 2:          Weight: 3
Queue 3:          Weight: 5
Queue 4:          Weight: 0
Queue 5:          Weight: 5
Queue 6:          Weight: 5
Queue 7:          Weight: strict
Queue 8:          Weight: strict
===============================================================================
*A:card-1>config#
*A:SN12345678>config# show qos port-scheduler-policy default
=============================================================================
QoS Port Scheduler Policy
=============================================================================
Policy-Name       : default
Accounting        : frame-based
Description       : Default Port Scheduler policy.
Mode              : STRICT
Last changed      : 08/04/2009 20:55:46                                        
Number Of Queues  : 8                                                          
=============================================================================
*A:SN12345678>config#
Sample output for 7210 SAS-D
 
*A:SAS-D>show>qos# port-scheduler-policy abc
 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : abc
Description       : (Not Specified)
Accounting        : packet-based
Mode              : STRICT
Last changed      : 01/01/1970 04:57:48
Number Of Queues  : 8
===============================================================================
*A:SAS-D>show>qos# port-scheduler-policy abc association
 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : abc
Description       : (Not Specified)
Accounting        : packet-based
Mode              : STRICT
 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
No Association Found.
 
===============================================================================
*A:SAS-D>show>qos#
Table 45:  Output Fields: Show Port Scheduler Policy  

Label

Description

Policy Name

Displays the port scheduler policy name

Associations

Displays associations related to the specified port scheduler policy

Mode

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

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