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