PROPERTIES qpRSVPWarnOnly, qpRSVPMaxSessions
8.5.1. The Property qpRSVPWarnOnly
This property is applicable when fulfilling ("admitting") an RSVP
request would violate the policer (traffic profile) limits or when
the maximum number session would be exceeded (or both).
When this property is set to TRUE, the RSVP request is admitted in
spite of the violation, but an RSVP error message carrying a warning
is sent to the originator (sender or receiver). When set to FALSE,
the request would be denied and an error message would be sent back
to the originator. So the meaning of the qpWarnOnly flag is: Based
on property’s value (TRUE or FALSE), determine whether to admit but
warn the originator that the request is in violation or to deny the
request altogether (and send back an error).
Specifically, a PATHERR (in response to a Path message) or a RESVERR
(in response of a RESV message) will be sent. This follows the COPS
for RSVP send error flag in the Decision Flags object. This property
is defined as follows:
NAME qpRSVPWarnOnly
SYNTAX Boolean
Default FALSE
VALUE The value TRUE means that the request should be admitted
AND an RSVP warning message should be sent to the
originator. The value of FALSE means that the request
should be not admitted and an appropriate error message
should be sent back to the originator of the request.
8.5.2. The Property qpRSVPMaxSessions
This attribute is used to limit the total number of RSVP requests
admitted for the specified class of traffic. For this property to be
meaningful, the qpAdmissionScope property must be set to class. The
definition of this property is as follows:
NAME qpRSVPMaxSessions
SYNTAX Integer
VALUE Must be greater than 0.
8.6. The Class QoSPolicyPHBAction
This class is a base class that is used to define the per-hop
behavior that is to be assigned to behavior aggregates. It defines a
common property, qpMaxPacketSize, for use by its subclasses
(QoSPolicyBandwidthAction and QoSPolicyCongestionControlAction). The
class definition is as follows:
NAME QoSPolicyPHBAction
DESCRIPTION This action controls the Per-Hop-Behavior provided to
behavior aggregates.
DERIVED FROM PolicyAction (defined in [PCIM])
ABSTRACT TRUE
PROPERTIES qpMaxPacketSize
8.6.1. The Property qpMaxPacketSize
This property specifies the maximum packet size in bytes, of packets
in the designated flow. This attribute is used in translation of
QPIM attributes to QoS mechanisms used within a PEP. For example,
queue length may be measured in bytes, while the minimum number of
packets that should be kept in a PEP is defined within QPIM in number
of packets. This property is defined as follows:
NAME qpMaxPacketSize
SYNTAX Integer
Value Must be greater than 0
8.7. The Class QoSPolicyBandwidthAction
This class is used to control the bandwidth, delay, and forwarding
behavior of a PHB. Its class definition is as follows:
NAME QoSPolicyBandwidthAction
DESCRIPTION This action controls the bandwidth, delay, and
forwarding characteristics of the PHB.
DERIVED FROM QoSPolicyPBHAction (defined in this document)
ABSTRACT FALSE
PROPERTIES qpForwardingPriority, qpBandwidthUnits,
qpMinBandwdith, qpMaxBandwidth, qpMaxDelay,
qpMaxJitter, qpFairness
8.7.1. The Property qpForwardingPriority
This property defines the forwarding priority for this set of flows.
A non-zero value indicates that preemptive forwarding is required.
Higher values represent higher forwarding priority. This property is
defined as follows:
NAME qpForwardingPriority
SYNTAX Integer
VALUE Must be non-negative. The value 0 means that preemptive
forwarding is not required. A positive value indicates
the priority that is to be assigned for this (set of)
flow(s). Larger values represent higher priorities.
8.7.2. The Property qpBandwidthUnits
This property defines the units that the properties qpMinBandwidth
and qpMaxBandwidth have. Bandwidth can either be defined in bits/sec
or as a percentage of the available bandwidth or scheduler resources.
This property is defined as follows:
NAME qpBandwidthUnits
SYNTAX Integer
VALUE Two values are possible. The value of 0 is used to
specify units of bits/sec, while the value of 1 is used
to specify units as a percentage of the available
bandwidth. If this property indicates that the bandwidth
units are percentages, then each of the bandwidth
properties expresses a whole-number percentage, and hence
its maximum value is 100.
8.7.3. The Property qpMinBandwidth
This property defines the minimum bandwidth that should be reserved
for this class of traffic. Both relative (i.e., a percentage of the
bandwidth) and absolute (i.e., bits/second) values can be specified
according to the value of the qpBandwidthUnits property. This
property is defined as follows:
NAME qpMinBandwidth
SYNTAX Integer
VALUE The value must be greater than 0. If the property
qpMaxBandwidth is defined, then the value of
qpMinBandwidth must be less than or equal to the value of
qpMaxBandwidth.
8.7.4. The Property qpMaxBandwidth
This property defines the maximum bandwidth that should be allocated
to this class of traffic. Both relative (i.e., a percentage of the
bandwidth)and absolute (i.e., bits/second) values can be specified
according to the value of the qpBandwidthUnits property. This
property is defined as follows:
NAME qpMaxBandwidth
SYNTAX Integer
VALUE The value must be greater than 0. If the property
qpMaxBandwidth is defined, then the value of
qpMinBandwidth must be less than or equal to the value of
qpMaxBandwidth.
8.7.5. The Property qpMaxDelay
This property defines the maximal per-hop delay that traffic of this
class should experience while being forwarded through this hop. The
maximum delay is measured in microseconds. This property is defined
as follows:
NAME qpMaxDelay
SYNTAX Integer (microseconds)
VALUE The value must be greater than 0.
8.7.6. The Property qpMaxJitter
This property defines the maximal per-hop delay variance that traffic
of this class should experience while being forwarded through this
hop. The maximum jitter is measured in microseconds. This property
is defined as follows:
NAME qpMaxJitter
SYNTAX Integer (microseconds)
VALUE The value must be greater than 0.
8.7.7. The Property qpFairness
This property defines whether fair queuing is required for this class
of traffic. This property is defined as follows:
NAME qpFairness
SYNTAX Boolean
VALUE The value of FALSE means that fair queuing is not
required for this class of traffic, while the value of
TRUE means that fair queuing is required for this class
of traffic.
8.8. The Class QoSPolicyCongestionControlAction
This class is used to control the characteristics of the congestion
control algorithm being used. The class definition is as follows:
NAME QoSPolicyCongestionControlAction
DESCRIPTION This action control congestion control characteristics
of the PHB.
DERIVED FROM QoSPolicyPBHAction (defined in this document)
ABSTRACT FALSE
PROPERTIES qpQueueSizeUnits, qpQueueSize, qpDropMethod,
qpDropThresholdUnits, qpDropMinThresholdValue,
qpDropMaxThresholdValue
8.8.1. The property qpQueueSizeUnits
This property specifies the units in which the qpQueueSize attribute
is measured. The queue size is measured either in number of packets
or in units of time. The time interval specifies the time needed to
transmit all packets within the queue if the link speed is dedicated
entirely to transmission of packets within this queue. The property
definition is:
NAME qpQueueSizeUnits
SYNTAX Integer
VALUE This property can have two values. If the value is set
to 0, then the unit of measurement is number of packets.
If the value is set to 1, then the unit of measurement is
milliseconds.
8.8.2. The Property qpQueueSize
This property specifies the maximum queue size in packets or in
milliseconds, depending on the value of the qpQueueSizeUnits (0
specifies packets, and 1 specifies milliseconds). This property is
defined as follows:
NAME qpQueueSize
SYNTAX Integer
VALUE This value must be greater than 0.
8.8.3. The Property qpDropMethod
This property specifies the congestion control drop algorithm that
should be used for this type of traffic. This property is defined as
follows:
NAME qpDropMethod
SYNTAX Integer
VALUES Three values are currently defined. The value 0
specifies a random drop algorithm, the value 1 specifies
a tail drop algorithm, and the value 2 specifies a head
drop algorithm.
8.8.4. The Property qpDropThresholdUnits
This property specifies the units in which the two properties
qpDropMinThresholdValue and qpDropMaxThresholdValue are measured.
Thresholds can be measured either in packets or as a percentage of
the available queue sizes. This property is defined as follows:
NAME qpDropThresholdUnits
SYNTAX Integer
VALUES Three values are defined. The value 0 defines the units
as number of packets, the value 1 defines the units as a
percentage of the queue size and the value 2 defines the
units in milliseconds. If this property indicates that
the threshold units are percentages, then each of the
threshold properties expresses a whole-number percentage,
and hence its maximum value is 100.
8.8.5. The Property qpDropMinThresholdValue
This property specifies the minimum number of queuing and buffer
resources that should be reserved for this class of flows. The
threshold can be specified as either relative (i.e., a percentage) or
absolute (i.e., number of packets or millisecond) value according to
the value of the qpDropThresholdUnits property. If this property
specifies a value of 5 packets, then enough buffer and queuing
resources should be reserved to hold 5 packets before running the
specified congestion control drop algorithm. This property is
defined as follows:
NAME qpDropMinThresholdValue
SYNTAX Integer
VALUE This value must be greater than or equal to 0. If the
property qpDropMaxThresholdValue is defined, then the
value of the qpDropMinThresholdValue property must be
less than or equal to the value of the
qpDropMaxThresholdValue property.
8.8.6. The Property qpDropMaxThresholdValue
This property specifies the maximum number of queuing and buffer
resources that should be reserved for this class of flows. The
threshold can be specified as either relative (i.e., a percentage) or
absolute (i.e., number of packets or milliseconds) value according to
the value of the qpDropThresholdUnits property. Congestion Control
droppers should not keep more packets than the value specified in
this property. Note, however, that some droppers may calculate queue
occupancy averages, and therefore the actual maximum queue resources
should be larger. This property is defined as follows:
NAME qpDropMaxThresholdValue
SYNTAX Integer
VALUE This value must be greater than or equal to 0. If the
property qpDropMinThresholdValue is defined, then the
value of the qpDropMinThresholdValue property must be
less than or equal to the value of the
qpDropMaxThresholdValue property.
8.9. Class QoSPolicyTrfcProf
This is an abstract base class that models a traffic profile.
Traffic profiles specify the maximum rate parameters used within
admission decisions. The association
QoSPolicyTrfcProfInAdmissionAction binds the admission decision to
the traffic profile. The class definition is as follows:
NAME QoSPolicyTrfcProf
DERIVED FROM Policy (defined in [PCIM])
ABSTRACT TRUE
PROPERTIES None
8.10. Class QoSPolicyTokenBucketTrfcProf
This class models a two- or three-level Token Bucket traffic profile.
Additional profiles can be modeled by cascading multiple instances of
this class (e.g., by connecting the output of one instance to the
input of another instance). This traffic profile carries the policer
or shaper rate values to be enforced on a flow or a set of flows.
The class definition is as follows:
NAME QoSPolicyTokenBucketTrfcProf
DERIVED FROM QoSPolicyTrfcProf (defined in this document)
ABSTRACT FALSE
PROPERTIES qpTBRate, qpTBNormalBurst, qpTBExcessBurst
8.10.1. The Property qpTBRate
This is a non-negative integer that defines the token rate in
kilobits per second. A rate of zero means that all packets will be
out of profile. This property is defined as follows:
NAME qpTBRate
SYNTAX Integer
VALUE This value must be greater than to 0
8.10.2. The Property qpTBNormalBurst
This property is an integer that defines the normal size of a burst
measured in bytes. This property is defined as follows:
NAME qpTBNormalBurst
SYNTAX Integer
VALUE This value must be greater than to 0
8.10.3. The Property qpTBExcessBurst
This property is an integer that defines the excess burst size
measured in bytes. This property is defined as follows:
NAME qpTBExcessBurst
SYNTAX Integer
VALUE This value must be greater than or equal to
qpTBNormalBurst
8.11. Class QoSPolicyIntServTrfcProf
This class represents an IntServ traffic profile. Values of IntServ
traffic profiles are compared against Traffic specification (TSPEC)
and QoS Reservation (FLOWSPEC) requests carried in RSVP requests.
The class definition is as follows:
NAME QoSPolicyIntServTrfcProf
DERIVED FROM QoSPolicyTrfcProf (defined in this document)
ABSTRACT FALSE
PROPERTIES qpISTokenRate, qpISPeakRate, qpISBucketSize,
qpISResvRate, qpISResvSlack, qpISMinPolicedUnit,
qpISMaxPktSize
8.11.1. The Property qpISTokenRate
This property is a non-negative integer that defines the token rate
parameter, measured in kilobits per second. This property is defined
as follows:
NAME qpISTokenRate
SYNTAX Integer
VALUE This value must be greater than or equal to 0
8.11.2. The Property qpISPeakRate
This property is a non-negative integer that defines the peak rate
parameter, measured in kilobits per second. This property is defined
as follows:
NAME qpISPeakRate
SYNTAX Integer
VALUE This value must be greater than or equal to 0
8.11.3. The Property qpISBucketSize
This property is a non-negative integer that defines the token bucket
size parameter, measured in bytes. This property is defined as
follows:
NAME qpISBucketSize
SYNTAX Integer
VALUE This value must be greater than or equal to 0
8.11.4. The Property qpISResvRate
This property is a non-negative integer that defines the reservation
rate (R-Spec) in the RSVP guaranteed service reservation. It is
measured in kilobits per second. This property is defined as
follows:
NAME qpISResvRate
SYNTAX Integer
VALUE This value must be greater than or equal to 0
8.11.5. The Property qpISResvSlack
This property is a non-negative integer that defines the RSVP slack
term in the RSVP guaranteed service reservation. It is measured in
microseconds. This property is defined as follows:
NAME qpISResvSlack
SYNTAX Integer
VALUE This value must be greater than or equal to 0
8.11.6. The Property qpISMinPolicedUnit
This property is a non-negative integer that defines the minimum RSVP
policed unit, measured in bytes. This property is defined as
follows:
NAME qpISMinPolicedUnit
SYNTAX Integer
VALUE This value must be greater than or equal to 0
8.11.7. The Property qpISMaxPktSize
This property is a positive integer that defines the maximum allowed
packet size for RSVP messages, measured in bytes. This property is
defined as follows:
NAME qpISMaxPktSize
SYNTAX Integer
VALUE This value must be a positive integer, denoting the
number of bytes in the largest payload packet of an RSVP
signaled flow or class.
8.12. The Class QoSPolicyAttributeValue
This class can be used for representing an indirection in variable
and value references either in a simple condition ("<x> match <y>")
or a simple action ("<x> = <y>"). In both cases, <x> and <y> are
known as the variable and the value of either the condition or
action. The value of the properties qpAttributeName and
qpAttributeValueList are used to substitute <x> and <y> in the
condition or action respectively.
The substitution is done as follows: The value of the property
qpAttributeName is used to substitute <x> and the value of the
property qpAttributeValueList is used to substitute <y>.
Once the substitution is done, the condition can be evaluated and the
action can be performed.
For example, suppose we want to define a condition over a user name
of the form "user == ’Smith’", using the QoSPolicyRSVPUserVariable
class. The user information in the RSVP message provides a DN. The
DN points to a user objects holding many attributes. If the relevant
attribute is "last name", we would use the QoSPolicyAttributeValue
class with qpAttributeName = "Last Name", qpAttributeValueList =
{"Smith"}.
The class definition is as follows:
NAME QoSPolicyAttributeValue
DERIVED FROM PolicyValue (defined in [PCIMe])
ABSTRACT FALSE
PROPERTIES qpAttributeName, qpAttributeValueList
8.12.1. The Property qpAttributeName
This property carries the name of the attribute that is to be used to
substitute <x> in a simple condition or simple condition of the forms
"<x> match <y>" or "<x> = <y>" respectively. This property is
defined as follows:
NAME qpAttributeName
SYNTAX String
8.12.2. The Property qpAttributeValueList
This property carries a list of values that is to be used to
substitute <y> in a simple condition or simple action of the forms
"<x> match <y>" or "<x> = <y>" respectively.
This property is defined as follows:
NAME qpAttributeValueList
SYNTAX String
8.13. The Class "QoSPolicyRSVPVariable"
This is an abstract class that serves as the base class for all
implicit variables that have to do with RSVP conditioning. The class
definition is as follows:
NAME QoSPolicyRSVPVariable
DESCRIPTION An abstract base class used to build other classes
that specify different attributes of an RSVP request
DERIVED FROM PolicyImplicitVariable (defined in [PCIMe])
ABSTRACT TRUE
PROPERTIES None
8.14. The Class "QoSPolicyRSVPSourceIPv4Variable"
This is a concrete class that contains the source IPv4 address of the
RSVP signaled flow, as defined in the RSVP PATH SENDER_TEMPLATE and
RSVP RESV FILTER_SPEC [RSVP] objects. The class definition is as
follows:
NAME QoSPolicyRSVPSourceIPv4Variable
DESCRIPTION The source IPv4 address of the RSVP signaled flow, as
defined in the RSVP PATH SENDER_TEMPLATE and RSVP RESV
FILTER_SPEC [RSVP] objects.
ALLOWED VALUE TYPES: PolicyIPv4AddrValue
DERIVED FROM QoSPolicyRSVPVariable (defined in this document)
ABSTRACT FALSE
PROPERTIES None
8.15. The Class "QoSPolicyRSVPDestinationIPv4Variable"
This is a concrete class that contains the destination IPv4 address
of the RSVP signaled flow, as defined in the RSVP PATH
SENDER_TEMPLATE and RSVP RESV FILTER_SPEC [RSVP] objects. The class
definition is as follows:
NAME QoSPolicyRSVPDestinationIPv4Variable
DESCRIPTION The destination IPv4 address of the RSVP signaled
flow, as defined in the RSVP PATH and RESV SESSION
[RSVP] objects.
ALLOWED VALUE TYPES: PolicyIPv4AddrValue
DERIVED FROM QoSPolicyRSVPVariable (defined in this document)
ABSTRACT FALSE
PROPERTIES None
8.16. The Class "QoSPolicyRSVPSourceIPv6Variable"
This is a concrete class that contains the source IPv6 address of the
RSVP signaled flow, as defined in the RSVP PATH SENDER_TEMPLATE and
RSVP RESV FILTER_SPEC [RSVP] objects. The class definition is as
follows:
NAME QoSPolicyRSVPSourceIPv6Variable
DESCRIPTION The source IPv6 address of the RSVP signaled flow, as
defined in the RSVP PATH SENDER_TEMPLATE and RSVP RESV
FILTER_SPEC [RSVP] objects.
ALLOWED VALUE TYPES: PolicyIPv6AddrValue
DERIVED FROM QoSPolicyRSVPVariable (defined in this document)
ABSTRACT FALSE
PROPERTIES None
8.17. The Class "QoSPolicyRSVPDestinationIPv6Variable"
This is a concrete class that contains the destination IPv6 address
of the RSVP signaled flow, as defined in the RSVP PATH
SENDER_TEMPLATE and RSVP RESV FILTER_SPEC [RSVP] objects. The class
definition is as follows:
NAME QoSPolicyRSVPDestinationIPv6Variable