3Com Router 3012 Operating manual

3Com Router
Command Reference Guide Addendum for V1.20
http://www.3com.com/
Part No. 10014302
Published January 2004

1.1. Introduction
1.1.1. Scope
This manual provides command reference information for new software features found in V1.20 of
the 3Com Router operating system. Use this addendum to supplement command reference
information found in the 3Com Router Command Reference Guide.
1.1.2. Online Resources
Download the Router 3000 Installation Guide from:
http://support.3com.com/infodeli/tools/routers/R3000Install.pdf
Download the Router 5000 Installation Guide from:
http://support.3com.com/infodeli/tools/routers/5000Install.pdf
Download the 3Com Router Command Reference Guide from:
http://support.3com.com/infodeli/tools/routers/3ComRouterComRef.pdf
Download the 3Com Router Configuration Guide from:
http://support.3com.com/infodeli/tools/routers/3com_configuration_guide.pdf
Download other current software updates and release notes from:
http://www.3com.com/
3Com Router Command Reference Guide Addendum for V1.2
2

Chapter 1 CBQ Configuration Commands
1.1 af
Syntax
af bandwidth { bandwidth | pct percentage }
undo af
View
Policy-class view
Parameter
bandwidth: Bandwidth in kbit/s in the range of 8 to 1000000.
percentage: Percentage of available bandwidth in the range of 1 to 100.
Description
Using the af command, you can configure the class to perform the
assured-forwarding and the minimum bandwidth used. Using the undo af command,
you can cancel the configuration.
Both user-defined class and default-class are configurable.
The sum of the bandwidths assigned to the assured-forwarding and
expedited-forwarding classes of the same policy must be smaller than the available
bandwidth of the interface applied by the policy.
All bandwidth values involved in a policy must be configured as the same type, for
example, all in absolute value or percentage form.
For the related command, see qos policy, qos-class.
Example
Configure the "database" class of the "3Com" policy to perform assured-forwarding
with the minimum bandwidth as 200kbit/s.
[3Com] qos policy 3Com
[3Com-qospolicy-3Com] qos-class database
[3Com-qospolicy-c-3Com database] af bandwidth 200
3Com Router Command Reference Guide Addendum for V1.2
3

1.2 car
Syntax
car cir rate [ cbs size ebs size ] [ conform action [ exceed action] ]
undo car
View
Policy-class view
Parameter
cir rate: Committed information rate in the range of 8000 to 155000000 bit/s.
cbs size: Committed burst size, that is, the number of bits that can be sent in each
interval in the range of 15000 to 155000000 bits. By default, it is 15000.
ebs size: Excessive burst size in the range of 0 to 155000000 bits. By default, it is 0.
Conform: Action (defaulted to pass) conducted to the packets when the traffic of the
packets conforms to the CIR.
exceed: Action (defaulted to discard) conducted to the packets when the traffic of the
packets does not conform to the CIR.
action: Action conducted to a packet, including:
 discard: Drop the packet
 remark-dscp-pass new-dscp: Set new-dscp and transmit the packet. It ranges
from 0 to 63.
 remark-prec-pass new-precedence: Set new-precedence of IP and transmit the
packet. It ranges from 0 to 7.
 pass: Transmit the packet.
Description
Using the car command, you can configure traffic monitoring for a class. Using the
undo car command, you can delete the configuration of traffic monitoring.
When being used in interface policy, car can be used in the input or output direction
of the interface.
Applying a policy configured with car on an interface will cause the previous qos car
command ineffective.
If this command is frequently configured on the classes of the same policy, the last
configuration will overwrite the previous ones.
3Com Router Command Reference Guide Addendum for V1.2
4

For the related command, see qos policy, qos-class.
Example
Configure traffic monitoring for a class. The normal traffic of packets is 38400bit/s.
Burst traffic twice of the normal traffic can pass initially and later the traffic is
transmitted normally when the rate does not exceed 38400bit/s. When the rate
exceeds 38400bit/s, the precedence of the packet turns to 0 and the packet is
transmitted.
[3Com] qos policy 3Com
[3Com-qospolicy-3Com] qos-class database
[3Com-qospolicy-c-3Com database] car cir 38400 cbs 76800 ebs 0 conform pass
exceed remark-prec-pass 0
1.3 debugging qos
Syntax
debugging qos { { cbq { af | be | ef | class } } | cq | pq | wfq } [ interface type
number ]
undo debugging qos { { cbq { af | be | ef | class } } | cq | pq | wfq } [ interface type
number ]
View
All views
Parameter
cbq af: Enable the debugging of confirming forwarding information in CBQ.
cbq be: Enable the debugging of best-effort forwarding information in CBQ.
cbq ef: Enable the debugging expedited-forwarding information in CBQ.
cbq class: Enable the debugging of the class information of CBQ.
cq: Enable the debugging of the CQ.
pq: Enable the debugging of the PQ.
wfq: Enable the debugging of the WFQ.
interface type number: Enable the debugging of the interface QoS. If this parameter
is not used, the QoS debugging of all interfaces will be enabled.
3Com Router Command Reference Guide Addendum for V1.2
5

Description
Using the debugging qos command, you can enable the debugging of QoS. Using
the undo debugging qos command, you can disable the debugging of Qos.
By default, the debugging of QoS is disabled.
Example
Enable the debugging of the CBQ class information on the interface Serial0.
[Router] debugging qos cbq class interface serial 0
1.4 display qos cbq interface
Syntax
display qos cbq interface [ type number ]
View
All views
Parameter
interface - type : Interface type.
number: Interface number.
Description
Using the display qos cbq interface command, you can browse the class-based
queue configuration information and running status of the specified interface or all
interfaces.
Example
[3Com] display qos cbq interface
Interface: Ethernet0
Class Based Queueinging: (Output queue: Total Size/Discards)
CBQ: 0/0
Queue Size: 0/0/0 (EF/AF/BE)
BE Queues: 0/0/256 (Active/Max active/Total)
AF Queues: 1 (Allocated)
Bandwidth(Kbps): 74992/75000 (Available/Max reserve)
3Com Router Command Reference Guide Addendum for V1.2
6

1.5 display qos class
Syntax
display qos class [ class-name ]
View
All views
Parameter
class-name: Name of the class. By default, the information of all classes are
displayed.
Description
Using the display qos class command, you can browse the class information
concerning router configuration.
Example
[3Com] display qos class
QoS Class Configuration Information:
Class: 3COM
Operator: Logical AND
Rules: If-match ip-precedence 5
Class: database
Operator: Logical AND
Rules: If-match ACL 131
If-match inbound-interface Ethernet0
1.6 display qos policy
Syntax
display qos policy [policy-name [ class class-name ] ]
View
All views
3Com Router Command Reference Guide Addendum for V1.2
7

Parameter
policy-name: Name of policy. By default, the configuration information of all policies
are displayed.
class-name: Class name in the policy.
Description
Using the display qos policy command, you can browse the configuration
information of the specified or all classes of the specified or all policies.
Example
[3Com] display qos policy
QoS Policy Configuration Information:
Policy: test
Class: default-class
Behavior(s):
-none-
Class: AF
Behavior(s):
Committed Access Rate:
CIR 8000 (Bps), CBS 15000 (Bit), EBS 0 (Bit)
Conform Action: pass
Exceed Action: discard
Policy: 3Com
Class: default-class
Behavior(s):
-none-
Class: 3COM
Behavior(s):
Expedited Forwarding
Bandwidth 8 (Kbps) Burst 1500 (Byte)
Class: AF
Behavior(s):
Assured Forwarding
Bandwidth 20 (%)
Discard Method: Tail (Max Threshold 64 packets)
3Com Router Command Reference Guide Addendum for V1.2
8

Committed Access Rate:
CIR 8000 (Bps), CBS15000 (Bit), EBS 0 (Bit)
Conform Action: remark mpls exp 3 and pass
Exceed Action: discard
Class: SHAPE
Behavior(s):
Traffic Shape:
CIR 8000 (Bps), CBS 15000 (Bit), EBS 0 (Bit)
Queue Length 1024 (Packet)
1.7 display qos policy interface
Syntax
display qos policy interface [ { type number }[ inbound | outbound ]
View
All views
Parameter
interface - type : Interface type.
number: Interface number.
Description
Using the display qos policy interface command, you can view configuration
information and operating status of the policy on the specified interface, the specified
PVC on specifiedATM interface or on all interfaces and PVC.
Example
[3Com] display qos policy interface Ethernet 0
Interface: Ethernet10
Direction: Outbound
Policy: 3Com
Class: default-class
Matched: 0/0 (Packets/Bytes)
Rule(s): If-match any
3Com Router Command Reference Guide Addendum for V1.2
9

Behavior(s):
Default Queue:
Flow Based Fair Queueing
Max number of hashed queues 256
Matched: 0/0 (Packets/Bytes)
Enqueued: 0/0 (Packets/Bytes)
Discarded: 0/0 (Packets/Bytes)
Discard Method: Tail
Class: 3COM
Matched: 0/0 (Packets/Bytes)
Operator: Logical AND
Rule(s): If-match ip-precedence 5
Behavior(s):
Expedited Forwarding
Bandwidth 8 (Kbps), Burst 1500 (Byte)
Matched: 0/0 (Packets/Bytes)
Enqueued: 0/0 (Packets/Bytes)
Discarded: 0/0 (Packets/Bytes)
Class: AF
Matched: 0/0 (Packets/Bytes)
Operator: Logical AND
Rule(s): If-match ACL 131
If-match ACL 101
If-match inbound interface Ethernet0
Behavior(s):
Traffic Police:
CIR 8000 (bps), CBS 15000 (bit), EBS 0 (bit)
Conform Action: remark mpls exp 3 and pass
Exceed Action: discard
Conformed: 0/0 (Packets/Bytes)
Exceeded: 0/0 (Packets/Bytes)
Assured Forwarding
Bandwidth 14998 (Kbps)
Matched: 0/0 (Packets/Bytes)
Enqueued: 0/0 (Packets/Bytes)
Discarded: 0/0 (Packets/Bytes)
Class: SHAPE
Matched: 0/0 (Packets/Bytes)
Operator: Logical AND
Rule(s): -none-
Behavior(s):
3Com Router Command Reference Guide Addendum for V1.2
10

General Traffic Shaping:
CIR 8000 (Bps), CBS 15000 (Bit), EBS 0 (Bit)
Queue Length: 1024 (Packets)
Queue Size: 0 (Packets)
Pass : 0/0 (Packets/Bytes)
Discard : 0/0 (Packets/Bytes)
Delay : 0/0 (Packets/Bytes)
Interface: Serial0
Direction: Inbound
Policy: test
Class: default-class
Matched: 0/0 (Packets/Bytes)
Rule(s): If-match any
Behavior(s):
-none-
Class: AF
Matched: 0/0 (Packets/Bytes)
Operator: Logical AND
Rule(s): If-match ACL 13
If-match ACL 101
If-match inbound interface Ethernet0
Behavior(s):
Committed Access Rate:
CIR 8000 (Bps), CBS 15000 (Bit), EBS 0 (Bit)
Conform Action: pass
Exceed Action: discard
Conformed: 0/0 (Packets/Bytes)
Exceeded: 0/0 (Packets/Bytes)
1.8 ef
Syntax
ef bandwidth bandwidth [ cbs size ]
undo ef
3Com Router Command Reference Guide Addendum for V1.2
11

View
Policy-class view
Parameter
bandwidth: Bandwidth in kbit/s in the range of 8 to 1000000.
size: Specify the allowed burst size in byte in the range of 32 to 2000000. By default,
it is bandwidth * 25.
Description
Using the ef command, you can configure certain class to perform
expedited-forwarding to send the packets of this class into priority queue and
configure its maximum bandwidth. Using the undo ef command, you can remove the
configuration.
The command can not be used together with queue af, queue-length and wred in
class view.
This command is unavailable for default-class.
For the related command, see qos policy, qos-class.
Example
Configure the packets of this class to enter the priority queue, the maximum
bandwidth as 200kbit/s and the default burst size as 5000 bytes.
[3Com] qos policy 3Com
[3Com-qospolicy-3Com] qos-class database
[3Com-qospolicy-c-3Com database] ef bandwidth 200 cbs 5000
1.9 gts
Syntax
gts cir rate [ cbs size [ ebs size [ queue-length length ] ] ]
undo gts
View
Policy-class view
3Com Router Command Reference Guide Addendum for V1.2
12

Parameter
cir rate: Committed information rate.
cbs size: Burst size in the range of 15000 to 155000000 bits. By default, it is equal to
half of cir rate.
ebs size: Excessive burst size in the range of 0 to 155000000 bits. By default, it is 0.
queue-length length: Queue length in the range of 1 to 1024. By default, it is 50.
Description
Using the gts command, you can configure traffic shaping for a class. Using the undo
gts command, you can delete traffic shaping for a class.
The policy configured with gts can only be applied to the output direction of an
interface.
Applying a policy configured with gts on an interface will cause the previously
configured qos gts command ineffective.
If this command is frequently configured on classes of the same policy, the last
configuration will overwrite the previous ones.
For the related command, see qos policy,qos-class.
Example
Configure GTS for a class with the specific features as follows: the normal traffic is
38400bit/s; the burst traffic twice normal traffic can pass initially; the traffic no larger
than 38400bit/s can be transmitted normally under normal conditions and that larger
than 38400bit/s enters queue buffer lately; the buffer queue length is 100.
[3Com] qos policy 3Com
[3Com-qospolicy-3Com] qos-class database
[3Com-qospolicy-c-3Com database] gts cir 38400 cbs 76800 ebs 0 queue-length
100
1.10 if-match acl
Syntax
if-match [ logic-not ] acl acl-number
undo if-match [ logic-not ] acl acl-number
3Com Router Command Reference Guide Addendum for V1.2
13

View
Class view
Parameter
access-list-number: ACL number.
logic-not: Do not match the class.
Description
Using the if-match acl command, you can define an ACL match rule. Using the undo
if-match acl command, you can delete anACL match rule.
For the related command, see qos class.
Example
Define a class to matchACL101.
[3Com] qos class class1
[3Com-qosclass-class1] if-match acl 101
1.11 if-match any
Syntax
if-match [ logic-not ]any
undo if-match [ logic-not ]any
View
Class view
Parameter
logic-not: Do not match the class.
Description
Using the if-match any command, you can define the match rule for all packets.
Using the undo if-match any command, you can delete the match rule for all
packets.
For the related command, see qos class.
3Com Router Command Reference Guide Addendum for V1.2
14

Example
Define match rule for all packets.
[3Com] qos class class1
[3Com-qosclass-class1] if-match any
1.12 if-match class
Syntax
if-match [ logic-not ]class class-name
undo if-match [ logic-not ]class class-name
View
Class view
Parameter
class-name: Class name.
Description
Using the if-match class command, you can define the match rule for a QoS class.
Using the undo if-match class command, you can delete the match rule for the QoS
class.
This configuration method is the only one to match the traffic with both the match-all
and match-any features.
For example: define classAto fit into the following relations: rule1 & rule2 | rule3
qos class logic-and classB
if-match rule1
if-match rule2
qos class logic-or classA
if-match rule3
if-match classB
For the related command, see qos class.
3Com Router Command Reference Guide Addendum for V1.2
15

Example
Define class2 by invoking class1.
Define match rule for class2. As class1 will be invoked, you should configure class1
first.The match rule for class1 is: IP precedence is 5.
[3Com] qos class class1
[3Com-qosclass-class1] if-match ip-precedence 5
Define class2 packets with the match rule as class1 and destination MAC address as
0050-BA27-BED3.
[3Com] qos class class2
[3Com-qosclass-class2] if-match class class1
[3Com-qosclass-class2] if-match destination-mac 00-50-BA-27-BE-D3
1.13 if-match criteria
Syntax
if-match [logic-not ]criteria
undo if-match [logic-not ]criteria
View
Class view
Parameter
criteria : Match rule of a class, which can be acl, any, class-map, destination-mac,
inbound-interface, ip-precedence, dscp, protocol, source-mac or mpls-exp.
Description
Using the if-match not command, you can define the rule for all packets not
satisfying the specified match rule. Using the undo if-match not command, you can
delete the rule of all packets not satisfying the specified match rule.
For the related command, see qos class.
Example
Define the packets with class match protocol not being IP.
[3Com] qos class class1
[3Com-qosclass-class1] if-match logic-not protocol ip
3Com Router Command Reference Guide Addendum for V1.2
16

1.14 if-match inbound-interface
Syntax
if-match [logic-not ]inbound-interface { type number }
undo if-match [logic-not ]inbound-interface { type number }
View
Class view
Parameter
interface - type : Interface type.
number: Interface number.
Description
Using the if-match inbound-interface command, you can define input interface
match rule of a class. Using the undo if-match inbound-interface command, you
can delete input interface match rule of a class.
When defining a match rule, the specified interface must be existent.
Supported interface types: Ethernet interface, serial interface, Tunnel interface, virtual
template interface, etc.
For the related command, see qos class.
Example
Define the packets with the class match input interface as Ethernet0.
[3Com] qos class class1
[3Com-qosclass-class1] if-match inbound-interface Ethernet 0
1.15 if-match ip-dscp
Syntax
if-match [logic-not ]ip-dscp value [ value ] …
undo if-match [logic-not ]ip-dscp value [ value ] ...
View
Class view
3Com Router Command Reference Guide Addendum for V1.2
17

Parameter
ip-dscp value: DSCP value in the range of 0 to 63.
Description
Using the if-match dscp command, you can define DSCP match rule. Using the
undo if-match dscp command, you can delete DSCP match rule.
You can configure this command for a class for several times. When a command is
configured, the ip-dscp-value will be sorted in the ascending order automatically. Only
when the specified DSCP values are identical with those in the rule (sequence may
be different), can the command be deleted.
Up to 8 DSCP values can be configured by a command. If several DSCPs are
configured with the same value, they will considered as one by default. The relation
between different DSCP values is “OR”.
For the related command, see qos class.
Example
Define the match rule of class1 as matching the packets with the DSCP value as 1, 6
or 9.
[3Com] qos class class1
[3Com-qosclass-class1] if-match ip-dscp 1 6 9
1.16 if-match ip-precedence
Syntax
if-match [logic-not ] ip-precedence value [ value ] …
undo if-match [logic-not ] ip-precedence value [ value ] …
View
Class view
Parameter
ip-precedence value: IP precedence value in the range of 0 to 7.
3Com Router Command Reference Guide Addendum for V1.2
18

Description
Using the if-match ip-precedence command, you can define IP precedence match
rule. Using the undo if-match ip-precedence command, you can delete IP
precedence match rule.
When the command is configured, the ip-precedence-value will be sorted
automatically in ascending order.
Up to 8 precedence values can be specified. If several identical precedence values
are specified, the system regards them as one. The relation between different
precedence values is “OR”.
For the related command, see qos class.
Example
Define the match rule of class1 as matching the packets with the precedence value
as 1 or 6.
[3Com] qos class class1
[3Com-qosclass-class1] if-match ip-precedence 1 6
1.17 if-match mac-address
Syntax
if-match [ logic-not ]{destination-mac |source-mac }mac-address
undo if-match [ logic-not ]{destination-mac |source-mac }mac-address
View
Class view
Parameter
mac-address: MAC address in the format of xx-xx-xx-xx-xx-xx.
Description
Using the if-match {destination-mac | source-mac } command, you can define the
match rule for destination or source address. Using the undo if-match
{destination-mac | source-mac } command, you can delete the match rule for
destination or source address.
The match rule for destination MAC address is effective only for output policies and
Ethernet interfaces.
3Com Router Command Reference Guide Addendum for V1.2
19

The match rule for source MAC address is effective only for input policies and
Ethernet interfaces.
For the related command, see qos class.
Example
Define the match rule of class1 as follows: match the packets with the destination
MAC address as 0050-ba27-bed3.
[3Com] qos class class1
[3Com-qosclass-class1] if-match destination-mac 00-50-ba-27-be-d3
Define the match rule of class2 as follows: match the packets with source MAC
address as 0050-ba27-bed2.
[3Com] qos class class2
[3Com-qosclass-class2] if-match source-mac 00-50-ba-27-be-d2
1.18 if-match protocol
Syntax
if-match [logic-not ] protocol ip
undo if-match [logic-not ] protocol ip
View
None
Parameter
Class view
Description
Using the if-match protocol command, you can define IP match rule. Using the
undo if-match protocol command, you can delete IP match rule.
For the related command, see qos class.
Example
Define the packets whose class match protocol is IP.
[3Com] qos class class1
[3Com-qosclass-class1] if-match protocol ip
3Com Router Command Reference Guide Addendum for V1.2
20