QoS Queue Group Template Command Reference
462 Quality of Service Guide
rate
Syntax rate pir-rate [cir cir-rate]
rate pir-rate police
no rate
Context config>qos>qgrpid>ing>qgrp>queue
Description 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 switch fabric (for SAP ingress queues). 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 oversubscription 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. For SAP ingress, the CIR also defines the rate that packets are considered in-profile 
by the system. In-profile then out-of-profile packets are preferentially queued by the system at egress 
and at subsequent next hop nodes where the packet can traverse. To be properly handled throughout 
the network, the packets must be marked accordingly for profiling at each hop.
The CIR can be used by the queue’s parent commands cir-level and cir-weight parameters to define 
the amount of bandwidth considered to be committed for the child queue during bandwidth allocation 
by the parent scheduler.
The rate command can be executed at anytime, altering the PIR and CIR rates for all queues created 
through the association of the SAP ingress or SAP egress QoS policy with the queue-id.
The no form of the command returns all queues created with the queue-id by association with the QoS 
policy to the default PIR and CIR parameters (max, 0).
Default none
Parameters pir-rate — Defines the administrative PIR rate, in kilobits, for the queue. When the rate command 
is executed, a valid PIR setting must be explicitly defined. 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’s adaptation-rule parameters and the actual 
hardware where the queue is provisioned. 
Values [1 to 2000000000 | max] Kbps
Default max
cir-rate — The cir parameter overrides the default administrative CIR used by the queue. When 
the rate command is executed, a CIR setting is optional. 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.
Values [0 to 2000000000 | max] Kbps
Default 0