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 existing 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:

Item	Description
-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:

Item	Description
-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

Item	Description
0	Successful completion
Positive Integer	An error occurred.

Security

Attention RBAC users and Trusted AIX® users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

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