adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
no adaptation-rule
config>qos>access-egress>queue
7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
This command defines the method used by the system to derive the operational CIR and PIR rates when the queue is provisioned in hardware. For the cir and pir parameters, 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 cir and pir apply.
adaptation-rule pir closest cir closest
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. See Table: Supported hardware rates and burst step sizes for CIR and PIR values on the 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-T for information about supported hardware step-size rates.
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. See Table: Supported hardware rates and burst step sizes for CIR and PIR values on the 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-T for information about supported hardware step-size rates.
percent-rate [cir cir-percent] [pir pir-percent]
no percent-rate
config>qos>access-egress>queue
7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
This command enables support for a queue’s PIR and CIR to be configured as a percentage of the egress port’s line rate (that is, the port limit). When the rates are expressed as a port limit, the actual rates used per instance of the queue will vary based on the port speed or the configured port egress rate. For example, when the same QoS policy is used on a 1-Gigabit and a 10-Gigabit Ethernet port, the queue’s rates will be 10 times greater on the 10 Gigabit port because of the difference in port speeds. This enables the same QoS policy to be used on SAPs on different ports instead of using different policies to modify a queue’s rate to get the same relative performance from the queue.
If the port’s speed changes after the queue is created, the queue’s PIR and CIR are recalculated based on the defined percentage value.
The rate and percent-rate commands override one another. If the current rate for a queue is defined using the percent-rate command and the rate command is executed, the percent-rate values are deleted. Similarly, the percent-rate command causes any rate command values to be deleted. A queue’s rate may dynamically be changed back and forth from a percentage to an explicit rate at anytime.
The no form of this command reverts the queue to its default shaping rate and CIR values. When no percent-rate is defined within an egress queue-override, the queue reverts to the PIR and CIR defined within the access egress QoS policy associated with the queue.
Specifies the queue’s CIR as a percentage dependent on the use of the port-limit.
Specifies the queue’s PIR as a percentage dependent on the use of the port-limit.
queue-mgmt name
no queue-mgmt
config>qos>access-egress>queue
7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
This command associates the specified queue management policy with this queue.
The queue management policy is used to specify the queue buffer parameters and queue slope policy parameters.
The no form of this command associates the default SAP egress queue management policy with this queue.
Specifies the name of the queue management policy, up to 32 characters.
queue-mode queue-mode
no queue-mode
config>qos>access-egress>queue
7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
This command determines whether the queue operates in strict or weighted mode.
The no form of this command reverts the queue mode to the default.
weighted
Specifies the mode of operation for the queue.
rate cir cir-rate [pir pir-rate]
no rate
config>qos>access-egress>queue
7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
This command defines the administrative Peak Information Rate (PIR) and the administrative Committed Information Rate (CIR) parameters for the queue. The PIR defines the maximum rate that 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 anytime, altering the PIR and CIR rates for all queues created on the access ports.
The max default specifies the amount of bandwidth in kilobits per second (thousand bits per second). The max value is mutually exclusive to the pir-rate value.
Queues with a cir-level cir-level parameter value of 8 are treated differently by the software than queues configured with different cir-level values. The PIR rate values configured for the cir-level 8 queues are ignored. Only the CIR rate value is used and PIR is set to the CIR value. In addition, when executing the no form of the rate command for a queue configured at cir-level 8, the default CIR (and PIR) value is set to 1. See the cir-level parameter description under the port-parent command for more information about the scheduler behavior for queues configured with a cir-level value of 8.
The no form of this command reverts all queues created with the queue ID by association with the QoS policy to the default PIR (max) and CIR (0) parameters.
Specifies the administrative CIR rate, in kilobits, for the queue. The cir parameter overrides the default administrative CIR used by the queue. When the rate command is executed, a valid CIR setting must be explicitly defined. When the rate command has not been executed or the cir parameter is not explicitly specified, the default CIR (0) is assumed. Fractional values are not allowed and must be given as a positive integer.
Specifies the administrative PIR rate, in kilobits, for the queue. When the rate command is executed, a PIR setting is optional. When the rate command has not been executed, the default PIR of max is assumed.
Fractional values are not allowed and must be given as a positive integer.
The actual PIR rate is dependent on the queue adaptation-rule parameters and the actual hardware where the queue is provisioned.
[no] weight weight
config>qos>access-egress
7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
This command specifies the weight of the queue when the queue mode is set to weighted.
For queues configured in weighted mode, the CIR of the queues are met if bandwidth is available and the configured weights are considered in the PIR loop. The configured weight determines the proportion of available bandwidth that is given to this queue in comparison to other queues configured in weighted mode.
The no form of this command reverts the weight to the default.
1
Specifies the proportion of available bandwidth to be allocated to this queue relative to other queues.
scope {exclusive | template}
no scope
config>qos>access-egress
7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
This command configures the scope as exclusive or template. The policy’s scope cannot be changed if the policy is applied to multiple ports.
The no form of this command reverts the scope of the policy to the default.
template
Specifies that the policy can only be applied to one interface port. 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. The system default policies cannot be put into the exclusive scope. An error will be generated if scope exclusive is executed in any policies with a policy ID equal to 1.
Specifies that the policy can be applied to multiple ports on the router.