Commands Reference, Volume 4

qosmod Command

Purpose

Modifies an existing QoS (Quality of Service) Service Category or Policy Rule.

Syntax

To modify an existing Service Category:

qosmod [ -s ServiceCategory] [ -t OutgoingTOS] [ -b MaxTokenBucket] [ -f FlowServiceType] [ -m MaxRate] service

To modify an exisiting Policy Rule:

qosmod [ -s ServiceCategory] [ -r ServicePolicyRules] [ -l PolicyRulePriority] [ -n ProtocolNumber] [ -A SrcAddrRange] [ -a DestAddrRange] [ -P SrcPortRange] [ -p DestPortRange] policy

Description

The qosmod command modifies the specified Service Category or Policy Rule entry in the policyd.conf file and installs the changes in the QoS Manager.

The qosmod command clears out all the statistics of the old policy. When a qosstat command is executed immediately after qosmod, the user may not see all the data connections that were using the older rule shifted to the modified rule. This is because the reclassification of the data connection is delayed until a data packet arrives on that connection.

Note

Modifying the priority or filter spec of the rule only results in reclassification of the data connections which use that particular rule. Connections using other rules maintain their existing classification.

Flags

Flags with service modify:

-s	The name of the ServiceCategory attribute, which is mandatory.
-t	The OutgoingTOS attribute, specified as an 8-bit binary number.
-b	The MaxTokenBucket attribute, specified in Kb (Kilobits).
-f	The FlowServiceType attribute, which is ControlledLoad or Guaranteed.
-m	The MaxRate attribute, which is specified in Kbps (Kilobits per second).

Flags with policy modify:

-s	The name of the ServiceCategory attribute, which is mandatory.
-r	The name of the ServicePolicyRules attribute, which is mandatory.
-l	The PolicyRulePriority attribute, which is a positive integer.
-n	The ProtocolNumber attribute, which is defined in the /etc/protocols file.
-A	The SrcAddrRange attribute, which is the Source IP address range from a1 to a2, where a2 >= a1.
-a	The DestAddrRange attribute, which is the Destination IP address range from i1 to i2, where i2 >= i1.
-P	The SrcPortRange attribute, which is the Source Port range from a1 to a2, where a2 >= a1.
-p	The DestPortRange attribute, which is the Destination Port range from i1 to i2, where i2 >= i1.

Exit Status

0	Successful completion
Positive Integer	An error occurred.

Examples

To modify the sc01 service, type:

qosmod -s sc01 -t 10001100 -b 84 -f Guaranteed  service

To modify the pr01 policy, type:

qos -s sc01 -r pr01 -l 10 -n 6 -A 9.3.25.15-9.3.25.20 -a 9.3.25.39-9.3.25.39 -p 9015-9020 policy

To modify the sc02 service, type:
```
qosmod -s sc02 -t 10001111 service
```

To modify the pr02 policy, type:

qosmod -s sc02 -r pr02 -l 13 -n 6 policy

Related Information

The qosstat command, qoslist command, qosremove command, qosadd command.