Alcatel-Lucent 7950 Quality Of Service Manual page 384

Queue Group Commands
rate
Syntax rate pir-rate [cir cir-rate]
no rate
Context config>qos>qgrps>egr>qgrp>queue
config>qos>qgrps>ing>qgrp>policer
config>qos>qgrps>egr>qgrp>policer
Description
This command defines the administrative Peak Information Rate (PIR) and the administrative Committed
Information Rate (CIR) parameters for the queue or policer. The PIR defines the maximum rate that the
queue or policer can transmit packets out an egress interface (for SAP egress queues or policer). Defining a
PIR does not necessarily guarantee that the queue can transmit at the intended rate. The actual rate sustained
by the queue or policer can be limited by oversubscription factors or available egress bandwidth.
The CIR defines the rate at which the system prioritizes the queue or policer over other queues or policer
competing for the same bandwidth. In-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 as in- or out-of-profile
throughout the network, the packets must be marked accordingly for profiling at each hop.
The CIR can be used by the queue or policer'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 egress QoS policy with the queue-id or policer-id.
The no form of the command returns all queues or policer created with the queue-id or policer-id by associ-
ation with the QoS policy to the default PIR and CIR parameters (max, 0).
Default rate max cir 0 — 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.
Parameters
pir-rate — Defines the administrative PIR rate, in kilobits, for the queue or policer. 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. When max is specified, the maximum policer rate used
will be equal to the maximum capacity of the card on which the policer is configured. If the policer rate
is set to a value larger than the maximum rate possible for the card, then the PIR used is equivalent to
max. 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 or policer is provisioned.
Values
Values
Default
cir-rate — The cir parameter overrides the default administrative CIR used by the queue or policer. 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. When max is specified, the
maximum policer rate used will be equal to the maximum capacity of the card on which the policer is
Page 384
Queue: 1— 100000000, max
Policer:1— 2000000000, max
max
7950 XRS Quality of Service Guide