The user-queue command sets scheduling parameters for user queues in a QoS profile.
The undo user-queue command cancels the scheduling parameters that are configured for user queues in a QoS profile.
By default, no user-queue configuration exists in a QoS profile.
undo user-queue [ inbound | outbound ]
user-queue { { cir cir-value [ cbs cbs-value ] [ [ pir pir-value [ pbs pbs-value ] [ pir-priority high ] ] | [ flow-queue flow-queue-name ] | [ user-group-queue group-name ] ] * [ inbound | outbound ] [ service-template template-name [ adjust-on-card ] ] } | { cir-percentage cir-percentage-value [ cbs cbs-value ] [ [ pir-percentage pir-percentage-value [ pbs pbs-value ] [ pir-priority high ] ] | [ flow-queue flow-queue-name ] | [ user-group-queue group-name ] ] * [ inbound | outbound ] [ service-template template-name [ adjust-on-card ] ] } }
| Parameter | Description | Value |
|---|---|---|
| cbs cbs-value |
Specifies the value of CBS. |
The value is an integer in the range of 1 to 4194304. The unit is byte. By default, cbs-value(byte) = cir-value(kbit/s)*10(ms)/8. |
| pir pir-value |
Specifies the value of PIR. The value of PIR should be more than or equal to the value of CIR. |
The value is 0 or an integer ranging from 16 to 4294967294. pir-value should be no less than the configured cir-value. If pir pir-value is not configured, pir-value = cir-value by default. |
| pbs pbs-value |
Specifies the value of PBS. |
The value is an integer in the range of 1 to 4194304. The unit is byte. By default, pbs-value(byte) = pir-value(kbit/s) x 10(ms)/8. |
| flow-queue flow-queue-name |
Specifies the name of the flow queue profile. The device supports the 8-CoS (BE/AF1/AF2/AF3/AF4/EF/CS6/CS7) flow queue mode, 4-CoS (cos0/cos1/cos2/cos3) flow queue mode and priority mode. |
The name is a string of 1 to 31 characters. |
| service-template template-name |
Specifies the service profile that is applied. |
The value is a string of 1 to 31 case-sensitive characters, spaces not supported. |
| cir cir-value |
Specifies the CIR value for the user queue. The value must be smaller than the bandwidth of the interface. |
The value is 0 or an integer ranging from 16 to 4294967294.The unit is Kbit/s. |
| inbound |
Indicates that scheduling parameters are configured for incoming packets. |
- |
| outbound |
Indicates that scheduling parameters are configured for outgoing packets. |
- |
| pir-priority high |
Indicates that the PIR priority of user queues is high. |
- |
| user-group-queue group-name |
Specifies the name of a user group queue. |
The value is a string of 1 to 31 case-sensitive characters, spaces not supported. |
| adjust-on-card |
Enables the network header length function. |
This parameter is applicable only to the eTM-installed subcard. |
| cir-percentage cir-percentage-value |
Specifies the percentage value of CIR. |
The value is an integer ranging from 1 to 100. |
| pir-percentage pir-percentage-value |
Specifies the percentage value of PIR. |
The value is an integer ranging from 1 to 100. |
Usage Scenario
You can configure user-queue parameters on an interface or in a domain. If the same user-queue configuration is required on multiple interfaces or domains, to reduce configuration workload, you can configure user-queue parameters in a QoS profile and apply the QoS profile to the interfaces or domains.
To allow the CIR/PIR of an Eth-Trunk interface or sub-interface to automatically change with the Eth-Trunk interface bandwidth, specify cir-percentage or pir-percentage in the command.Prerequisites
The flow queue mapping object, flow queue profile, and GQ used in the command must have been created before application and properly configured.
Follow-up Procedure
The HQoS configuration takes effect on an interface only after a QoS profile that defines the HQoS configuration is applied to the interface.
Precautions
The service profile specified in this command can only be user-defined.
This command and the car command for the same direction in the interface view are mutually exclusive. That is, the two commands for the same direction cannot be both configured.
If the member interfaces of a trunk interface reside on TM subcards of different types on the same board and a QoS profile is applied to the trunk interface, outbound user-queue cannot be configured in the QoS profile.
If uni-directional user queue scheduling (on either incoming traffic or outgoing traffic) is already configured, you cannot configure user queue scheduling without specifying the traffic direction. Conversely, if directionless user queue scheduling is already configured, you cannot configure uni-directional user queue scheduling.
On the rear-end ETM subcards , if the network header length function is configured on the Qos profile which is applied on an outbound physical interface, the parameter adjust-on-card should be specified to ensure the network header length function validating.
On the rear-end ETM subcards ,
If cir-percentage has been configured in a QoS profile, a shared group cannot be configured in the profile using the qos-profile inbound group command.
<HUAWEI> system-view [~HUAWEI] qos-profile new [*HUAWEI-qos-profile-new] commit [~HUAWEI-qos-profile-new] user-queue cir-percentage 80 pir-percentage 90 [*HUAWEI-qos-profile-new] commit [~HUAWEI-qos-profile-new] quit [~HUAWEI] interface Eth-Trunk 5 [*HUAWEI-Eth-Trunk5] commit [~HUAWEI-Eth-Trunk5] qos-profile new inbound
<HUAWEI> system-view [~HUAWEI] flow-queue test [*HUAWEI-flow-queue-template-test] quit [*HUAWEI] qos-profile p1 [*HUAWEI-qos-profile-p1] user-queue cir 200 pir 600 flow-queue test