Policy Framework Working Group                                 B. Moore
 INTERNET-DRAFT                                               L. Rafalow
 Updates: 3060                                                       IBM
 Category: Standards Track                                    Y. Ramberg
                                                                 Y. Snir
                                                            J. Strassner
                                                           A. Westerinen
                                                           Cisco Systems
                                                               R. Chadha
                                                  Telcordia Technologies
                                                              M. Brunner
                                                                     NEC
                                                                R. Cohen
                                                               Ntear LLC
                                                            J. Strassner
                                                       INTELLLIDEN, Inc.

                   Policy Core Information Model Extensions

                      <draft-ietf-policy-pcim-ext-01.txt>
                       Monday, April 09,

                      <draft-ietf-policy-pcim-ext-02.txt>
                        Friday, July 20, 2001, 11:13 10:53 AM

 Status of this Memo

   This document is an Internet-Draft and is in full conformance with all
   provisions of Section 10 of RFC2026.

   Internet-Drafts are working documents of the Internet Engineering Task
   Force (IETF), its areas, and its working groups.  Note that other groups
   may also distribute working documents as Internet-Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months and
   may be updated, replaced, or obsoleted by other documents at any time.
   It is inappropriate to use Internet-Drafts as reference material or to
   cite them other than as "work in progress."

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html

 Copyright Notice

   Copyright (C) The Internet Society (2001).  All Rights Reserved.

 Abstract

   This document proposes a number of changes to the Policy Core Information
   Model (PCIM, RFC 3060).  These changes include both extensions of PCIM
   into areas that it did not previously cover, and changes to the existing
   PCIM classes and associations.  Both sets of changes are done in a way
   that, to the extent possible, preserves interoperability with
   implementations of the original PCIM model.

   Table of Contents

   1. Introduction......................................................4 Introduction......................................................5
   2. Overview of the Changes...........................................4 Changes...........................................5
      2.1. How to Change an Information Model...........................4 Model...........................5
      2.2. List of Changes to the Model.................................5 Model.................................6
      2.2.1. Changes to PolicyRepository................................5 PolicyRepository................................6
      2.2.2. Additional Associations and Additional Reusable Elements...5 Elements...6
      2.2.3. Priorities and Decision Strategies.........................6
      2.2.4. Policy Roles...............................................6 Roles...............................................7
      2.2.5. CompoundPolicyConditions and CompoundPolicyActions.........7
      2.2.6. Variables and Values.......................................7
      2.2.7. Domain-Level Packet Filtering..............................8
      2.2.8. Device-Level Packet Filtering...........................................7 Filtering..............................8
   3. The Updated Class and Association Class Hierarchies...............7 Hierarchies...............8
   4. Areas of Extension to PCIM.......................................11 PCIM.......................................12
      4.1. Policy Scope................................................12 Scope................................................13
      4.1.1. Levels of Abstraction: Domain- and Device-Level Policies..12 Policies..13
      4.1.2. Administrative and Functional Scopes......................12 Scopes......................13
      4.2. Reusable Policy Elements....................................13 Elements....................................14
      4.3. Policy Sets.................................................14 Sets.................................................15
      4.4. Nested Policy Rules.........................................14 Rules.........................................15
      4.4.1. Usage Rules for Nested Rules..............................14 Rules..............................15
      4.4.2. Motivation................................................15
      4.4.3. Usage Example.............................................16 Motivation................................................16
      4.5. Priorities and Decision Strategies..........................18 Strategies..........................17
      4.5.1. Structuring Decision Strategies...........................19 Strategies...........................18
      4.5.2. Side Effects..............................................20 Effects..............................................19
      4.5.3. Multiple PolicySet Trees For a Resource...................20
      4.5.4. Deterministic Decisions...................................21
      4.6. Policy Roles................................................21
      4.6.1. Comparison of Roles in PCIM with Roles in snmpconf........21 snmpconf........22
      4.6.2. Addition of PolicyRoleCollection to PCIMe.................22
      4.6.3. Roles for PolicyGroups....................................23
      4.7. Compound Policy Conditions and Compound Policy Actions......24 Actions......25
      4.7.1. Compound Policy Conditions................................25
      4.7.2. Compound Policy Actions...................................25
      4.8. Variables and Values........................................27 Values........................................26
      4.8.1. Simple Policy Conditions..................................27 Conditions..................................26
      4.8.2. Using Simple Policy Conditions............................28 Conditions............................27
      4.8.3. The Simple Condition Operator.............................29 Operator.............................28
      4.8.4. SimplePolicyActions.......................................31
      4.8.5. Policy Variables..........................................32
      4.8.6. Explicitly Bound Policy Variables.........................33
      4.8.7. Implicitly Bound Policy Variables.........................33 Variables.........................34
      4.8.8. Structure and Usage of Pre-Defined Variables..............34
      4.8.9. Rationale for Modeling Implicit Variables as Classes......35
      4.8.10. Policy Values............................................36
      4.9. Packet Filtering............................................37
      4.9.1. Domain-Level Packet Filters...............................37
      4.9.2. Device-Level Packet Filters...............................39
   5. Class Definitions................................................38 Definitions................................................39
      5.1. The Abstract Class "PolicySet"..............................38 "PolicySet"..............................39
      5.2. Update PCIM's Class "PolicyGroup"...........................39 "PolicyGroup"...........................40
      5.3. Update PCIM's Class "PolicyRule"............................39 "PolicyRule"............................40
      5.4. The Class "SimplePolicyCondition"...........................40 "SimplePolicyCondition"...........................41
      5.5. The Class "CompoundPolicyCondition".........................41 "CompoundPolicyCondition".........................42
      5.6. The Class "CompoundFilterCondition".........................41 "CompoundFilterCondition".........................42
      5.7. The Class "SimplePolicyAction"..............................42 "SimplePolicyAction"..............................43
      5.8. The Class "CompoundPolicyAction"............................42 "CompoundPolicyAction"............................43
      5.9. The Abstract Class "PolicyVariable".........................43 "PolicyVariable".........................45
      5.10. The Class "PolicyExplicitVariable".........................44 "PolicyExplicitVariable".........................45
      5.10.1. The Single-Valued Property "ModelClass"..................44 "ModelClass"..................45
      5.10.2. The Single-Valued Property ModelProperty.................44 ModelProperty.................46
      5.11. The Abstract Class "PolicyImplicitVariable"................44 "PolicyImplicitVariable"................46
      5.11.1. The Multi-Valued Property "ValueTypes"...................45 "ValueTypes"...................46
      5.12. Subclasses of "PolicyImplicitVariable" Specified in PCIMe..45 PCIMe..47
      5.12.1. The Class "PolicySourceIPv4Variable".....................45 "PolicySourceIPv4Variable".....................47
      5.12.2. The Class "PolicySourceIPv6Variable".....................45 "PolicySourceIPv6Variable".....................47
      5.12.3. The Class "PolicyDestinationIPv4Variable"................45 "PolicyDestinationIPv4Variable"................47
      5.12.4. The Class "PolicyDestinationIPv6Variable"................46 "PolicyDestinationIPv6Variable"................47
      5.12.5. The Class "PolicySourcePortVariable".....................46 "PolicySourcePortVariable".....................48
      5.12.6. The Class "PolicyDestinationPortVariable"................46 "PolicyDestinationPortVariable"................48
      5.12.7. The Class "PolicyIPProtocolVariable".....................47 "PolicyIPProtocolVariable".....................49
      5.12.8. The Class "PolicyIPVersionVariable"......................47 "PolicyIPVersionVariable"......................49
      5.12.9. The Class "PolicyIPToSVariable"..........................47 "PolicyIPToSVariable"..........................49
      5.12.10. The Class "PolicyDSCPVariable"..........................47 "PolicyDSCPVariable"..........................49
      5.12.11. The Class "PolicyFlowIdVariable"........................48 "PolicyFlowIdVariable"........................50
      5.12.12. The Class "PolicySourceMACVariable".....................48 "PolicySourceMACVariable".....................50
      5.12.13. The Class "PolicyDestinationMACVariable"................48 "PolicyDestinationMACVariable"................50
      5.12.14. The Class "PolicyVLANVariable"..........................48 "PolicyVLANVariable"..........................50
      5.12.15. The Class "PolicyCoSVariable"...........................49 "PolicyCoSVariable"...........................51
      5.12.16. The Class "PolicyEthertypeVariable".....................49 "PolicyEthertypeVariable".....................51
      5.12.17. The Class "PolicySourceSAPVariable".....................49 "PolicySourceSAPVariable".....................51
      5.12.18. The Class "PolicyDestinationSAPVariable"................49 "PolicyDestinationSAPVariable"................51
      5.12.19. The Class "PolicySNAPVariable"..........................50 "PolicySNAPVariable"..........................52
      5.12.20. The Class "PolicyFlowDirectionVariable".................50 "PolicyFlowDirectionVariable".................52
      5.13. The Abstract Class "PolicyValue"...........................50 "PolicyValue"...........................52
      5.14. Subclasses of "PolicyValue" Specified in PCIMe.............51 PCIMe.............53
      5.14.1. The Class "PolicyIPv4AddrValue"..........................51 "PolicyIPv4AddrValue"..........................53
      5.14.2. The Class "PolicyIPv6AddrValue...........................52 "PolicyIPv6AddrValue...........................54
      5.14.3. The Class "PolicyMACAddrValue"...........................53 "PolicyMACAddrValue"...........................55
      5.14.4. The Class "PolicyStringValue"............................53 "PolicyStringValue"............................55
      5.14.5. The Class "PolicyBitStringValue".........................54 "PolicyBitStringValue".........................56
      5.14.6. The Class "PolicyIntegerValue"...........................55 "PolicyIntegerValue"...........................57
      5.14.7. The Class "PolicyBooleanValue"...........................56 "PolicyBooleanValue"...........................58
      5.15. The Class "PolicyRoleCollection"...........................56 "PolicyRoleCollection"...........................58
      5.15.1. The Single-Valued Property "PolicyRole"..................56 "PolicyRole"..................58
      5.16. The Class "ReusablePolicyContainer"........................56 "ReusablePolicyContainer"........................58
      5.17. Deprecate PCIM's Class "PolicyRepository"..................57 "PolicyRepository"..................59
      5.18. The Abstract Class "FilterEntryBase".......................59
      5.19. The Class "IPHeaderFilter".................................59
      5.19.1. The Property IpVersion...................................60
      5.19.2. The Property SrcAddress..................................60
      5.19.3. The Property SrcMask.....................................60
      5.19.4. The Property DestAddress.................................60
      5.19.5. The Property DestMask....................................61
      5.19.6. The Property ProtocolID..................................61
      5.19.7. The Property SrcPortStart................................61
      5.19.8. The Property SrcPortEnd..................................61
      5.19.9. The Property DestPortStart...............................61
      5.19.10. The Property DestPortEnd................................61
      5.19.11. The Property DSCP.......................................62
      5.19.12. The Property FlowLabel..................................62
      5.20. The Class "8021Filter".....................................62
      5.20.1. The Property SrcMACAddr..................................62
      5.20.2. The Property SrcMACMask..................................63
      5.20.3. The Property DestMACAddr.................................63
      5.20.4. The Property DestMACMask.................................63
      5.20.5. The Property ProtocolID..................................63
      5.20.6. The Property PriorityValue...............................63
      5.20.7. The Property VLANID......................................63
      5.21. The Class FilterList.......................................63
      5.21.1. The Property Direction...................................64
   6. Association and Aggregation Definitions..........................57 Definitions..........................64
      6.1. The Aggregation "PolicySetComponent"........................57 "PolicySetComponent"........................64
      6.2. Deprecate PCIM's Aggregation "PolicyGroupInPolicyGroup".....58 "PolicyGroupInPolicyGroup".....65
      6.3. Deprecate PCIM's Aggregation "PolicyRuleInPolicyGroup"......58 "PolicyRuleInPolicyGroup"......65
      6.4. The Abstract Association "PolicySetInSystem"................58 "PolicySetInSystem"................66
      6.5. Update PCIM's Weak Association "PolicyGroupInSystem"........59 "PolicyGroupInSystem"........66
      6.6. Update PCIM's Weak Association "PolicyRuleInSystem".........60 "PolicyRuleInSystem".........67
      6.7. The Abstract Aggregation "CompoundedPolicyCondition"........60 "PolicyConditionStructure".........67
      6.8. Update PCIM's Aggregation "PolicyConditionInPolicyRule".....60 "PolicyConditionInPolicyRule".....68
      6.9. The Aggregation "PolicyConditionInPolicyCondition"..........61 "PolicyConditionInPolicyCondition"..........68
      6.10. The Abstract Aggregation "CompoundedPolicyAction"..........61 "PolicyActionStructure"...........68
      6.11. Update PCIM's Aggregation "PolicyActionInPolicyRule".......61 "PolicyActionInPolicyRule".......68
      6.12. The Aggregation "PolicyActionInPolicyAction"...............61 "PolicyActionInPolicyAction"...............69
      6.13. The Aggregation "PolicyVariableInSimplePolicyCondition"....62 "PolicyVariableInSimplePolicyCondition"....69
      6.14. The Aggregation "PolicyValueInSimplePolicyCondition".......62 "PolicyValueInSimplePolicyCondition".......70
      6.15. The Aggregation "PolicyVariableInSimplePolicyAction".......63 "PolicyVariableInSimplePolicyAction".......70
      6.16. The Aggregation "PolicyValueInSimplePolicyAction"..........64 "PolicyValueInSimplePolicyAction"..........71
      6.17. The Association "ReusablePolicy"...........................64 "ReusablePolicy"...........................72
      6.18. Deprecate PCIM's "PolicyConditionInPolicyRepository".......65 "PolicyConditionInPolicyRepository".......72
      6.19. Deprecate PCIM's "PolicyActionInPolicyRepository"..........65 "PolicyActionInPolicyRepository"..........72
      6.20. The Association PolicyValueConstraintInVariable............65 ExpectedPolicyValuesForVariable............72
      6.21. The Aggregation "PolicyContainerInPolicyContainer".........66 "PolicyContainerInPolicyContainer".........73
      6.22. Deprecate PCIM's "PolicyRepositoryInPolicyRepository"......66 "PolicyRepositoryInPolicyRepository"......74
      6.23. The Aggregation "ElementInPolicyRoleCollection"............66 "EntriesInFilterList"......................74
      6.23.1. The Reference GroupComponent.............................74
      6.23.2. The Reference PartComponent..............................74
      6.23.3. The Property EntrySequence...............................75
      6.24. The Aggregation "ElementInPolicyRoleCollection"............75
      6.25. The Weak Association "PolicyRoleCollectionInSystem"........67 "PolicyRoleCollectionInSystem"........75
   7. Intellectual Property............................................67 Property............................................76
   8. Acknowledgements.................................................68 Acknowledgements.................................................76
   9. Security Considerations..........................................68 Considerations..........................................76
   10. References......................................................68 References......................................................77
   11. Authors' Addresses..............................................69 Addresses..............................................78
   12. Full Copyright Statement........................................70 Statement........................................79
   13. Appendix A: Open Issues.........................................71 Closed Issues.......................................80

 1. Introduction

   This document (PCIM Extensions, abbreviated here to PCIMe) proposes a
   number of changes to the Policy Core Information Model (PCIM, RFC 3060
   [3]).  These changes include both extensions of PCIM into areas that it
   did not previously cover, and changes to the existing PCIM classes and
   associations.  Both sets of changes are done in a way that, to the extent
   possible, preserves interoperability with implementations of the original
   PCIM model.

   EDITOR'S NOTE: In its -01 release, this document is still at a
   preliminary stage of development.  Elements may be added and/or elements
   may be removed prior to the document's advancement to Proposed Standard.

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in RFC 2119, reference [1].

 2. Overview of the Changes

 2.1. How to Change an Information Model

   The Policy Core Information Model is closely aligned with the DMTF's CIM
   Core Policy model.  Since there is no separately documented set of rules
   for specifying IETF information models such as PCIM, it is reasonable to
   look to the CIM specifications for guidance on how to modify and extend
   the model.  Among the CIM rules for changing an information model are the
   following.  Note that everything said here about "classes" applies to
   association classes (including aggregations) as well as to non-
   association classes.

     o   Properties may be added to existing classes.
     o   Classes, and individual properties, may be marked as DEPRECATED.
         If there is a replacement feature for the deprecated class or
         property, it is identified explicitly.  Otherwise the notation "No
         value" is used.  In this document, the notation "DEPRECATED FOR
         <feature-name>" is used to indicate that a feature has been
         deprecated, and to identify its replacement feature.
     o   Classes may be inserted into the inheritance hierarchy above
         existing classes, and properties from the existing classes may
         then be "pulled up" into the new classes.  The net effect is that
         the existing classes have exactly the same properties they had
         before, but the properties are inherited rather than defined
         explicitly in the classes.
     o   New subclasses may be defined below existing classes.

 2.2. List of Changes to the Model

   The following subsections provide a very brief overview of the changes to
   PCIM being proposed defined in PCIMe.  In several cases, the origin of the change is
   noted, as QPIM [5], ICIM [6], or QDDIM [14].

 2.2.1. Changes to PolicyRepository

   Because of the potential for confusion with the Policy Framework
   component Policy Repository (from the four-box picture: Policy Management
   Tool, Policy Repository, PDP, PEP), "PolicyRepository" is a bad name for
   the PCIM class representing a container of reusable policy elements.
   Thus the class PolicyRepository is being replaced with the class
   ReusablePolicyContainer.  To accomplish this change, it is necessary to
   deprecate the PCIM class PolicyRepository and its three associations, and
   replace them with a new class ReusablePolicyContainer and new
   associations.

   As a separate change, the associations for ReusablePolicyContainer are
   being broadened, to allow a ReusablePolicyContainer to contain any
   reusable policy elements.  In PCIM, the only associations defined for a
   PolicyRepository were for it to contain reusable policy conditions and
   policy actions.

 2.2.2. Additional Associations and Additional Reusable Elements

   The PolicyRuleInPolicyRule and PolicyGroupInPolicyRule aggregations are, have,
   in effect, being been imported from QPIM.  ("In effect" because these two
   aggregations, as well as PCIM'e two aggregations PolicyGroupInPolicyGroup
   and PolicyRuleInPolicyGroup, are all being combined into a single
   aggregation PolicySetComponent.)  These aggregations make it possible to
   define larger "chunks" of reusable policy to place in a
   ReusablePolicyContainer.  These aggregations also introduce new semantics
   representing the contextual implications of having one PolicyRule
   executing within the scope of another PolicyRule.

 2.2.3. Priorities and Decision Strategies

   Drawing from both QPIM and ICIM, the Priority property is being has been
   deprecated in PolicyRule, and placed instead on the aggregation
   PolicySetComponent.  The QPIM rules for resolving relative priorities
   across nested PolicyGroups and PolicyRules are being have been incorporated into
   PCIMe as well.  With the removal of the Priority property from
   PolicyRule, a new modeling dependency is introduced: in introduced.  In order to
   prioritize a PolicyRule PolicyRule/PolicyGroup relative to other PolicyRules,
   PolicyRules/PolicyGroups, the rules elements being prioritized must be
   placed all reside
   in one of three places: in either a common PolicyGroup PolicyGroup, in a common PolicyRule,
   or in a common PolicyRule. System.

   In the absence of any clear, general criterion for detecting policy
   conflicts, the PCIM restriction stating that priorities are relevant only
   in the case of conflicts is being removed.  In its place, a
   PolicyDecisionStrategy property is being has been added to the PolicyGroup and
   PolicyRule classes, to allow the classes.  This property allows policy administrator to select
   one of two behaviors with respect to rule evaluation: either perform the
   actions for all PolicyRules whose conditions evaluate to TRUE, or perform
   the actions only for the highest-priority PolicyRule whose conditions
   evaluate to TRUE.  (This is accomplished by placing the
   PolicyDecisionStrategy property in an abstract class PolicySet, from
   which PolicyGroup and PolicyRule are derived.)  The QPIM rules for
   applying decision strategies to a nested set of PolicyGroups and
   PolicyRules are have also being been imported.

 2.2.4. Policy Roles

   The concept of policy roles is added to PolicyGroups (being present
   already in the PolicyRule class).  This is accomplished via a new
   superclass for both PolicyRules and PolicyGroups - PolicySets. PolicySet.  For nested
   PolicyRules and PolicyGroups, any roles associated with the outer rule or
   group are automatically "inherited" by the nested one.  Additional roles
   may be added at the level of the a nested rule or group.

   It was also observed that there was is no mechanism in PCIM for assigning
   roles to resources.  For example, while it was is possible in PCIM to
   associate a PolicyRule with the role "FrameRelay&&WAN", there was is no way
   to indicate which interfaces matched match this criterion.  A new
   PolicyRoleCollection class is has been defined in PCIMe, representing the
   collection of resources associated with a particular role.  The linkage
   between a PolicyRule or PolicyGroup and a set of resources is then
   represented by an instance of PolicyRoleCollection.  Equivalent values
   should be defined in entries in the PolicyRoles property, inherited by property of PolicyRules and PolicyGroups from
   PolicySet,
   PolicyGroups, and in the PolicyRole property in PolicyRoleCollection.

 2.2.5. CompoundPolicyConditions and CompoundPolicyActions

   The concept of a CompoundPolicyCondition is has also being been imported into
   PCIMe from QPIM, and broadened to include a parallel
   CompoundPolicyAction.  In both cases the idea is to create reusable
   "chunks" of policy that can exist as named elements in a
   ReusablePolicyContainer.  The "Compound" classes and their associations
   incorporate the condition and action semantics that PCIM defined at the
   PolicyRule level: DNF/CNF for conditions, and ordering for actions.

   Compound conditions and actions are defined to work with any component
   conditions and actions.  In other words, while the components may be
   instances, respectively, of SimplePolicyCondition and SimplePolicyAction
   (discussed immediately below), they need not be.

 2.2.6. Variables and Values

   The SimplePolicyCondition / PolicyVariable / PolicyValue structure is
   being has
   been imported into PCIMe from QPIM.  A list of PCIMe-level variables is
   defined, as well as a list of PCIMe-level values.  Other variables and
   values may, if necessary, be defined in submodels of PCIMe.  For example,
   QPIM defines a set of implicit variables corresponding to fields in RSVP
   flows.

   A corresponding SimplePolicyAction / PolicyVariable / PolicyValue
   structure is also defined.  While the semantics of a
   SimplePolicyCondition are "variable matches value", a SimplePolicyAction
   has the semantics "set variable to value".

 2.2.7. Domain-Level Packet Filtering

   For packet filtering specified at the domain level, a set of
   PolicyVariables and PolicyValues are defined, corresponding to the fields
   in an IP packet header plus the most common Layer 2 frame header fields.
   It is expected that domain-level policy conditions that filter on these
   header fields will be expressed in terms of CompoundPolicyConditions
   built up from SimplePolicyConditions that use these variables and values.
   An additional PolicyVariable, PacketDirection, is also defined, to
   indicate whether a packet being filtered is traveling inbound or outbound
   on an interface.

 2.2.8. Device-Level Packet Filtering

   For packet filtering expressed at the device level, including the packet
   classifier filters modeled in QDDIM, these the variables and values discussed
   in Section 2.2.7 need not be used.  Filter classes derived from the CIM
   FilterEntryBase class hierarchy may still be used are available for use in these contexts.

 3. The Updated Class and Association Class Hierarchies

   The following figure shows the class inheritance hierarchy for PCIMe.
   Changes
   These latter classes have two important differences from the PCIM hierarchy are noted domain-level
   classes:

     o   They support specification of filters for all of the fields in a
         particular protocol header in a single object instance.  With the
         domain-level classes, separate instances are needed for each
         header field.
     o   They provide native representations for the filter values, as
         opposed to the string representation used by the domain-level
         classes.

   Device-level filter classes for the IP and 802 MAC headers are defined,
   respectively, in sections 5.19 and 5.20.

 3. The Updated Class and Association Class Hierarchies

   The following figure shows the class inheritance hierarchy for PCIMe.
   Changes from the PCIM hierarchy are noted parenthetically.

   ManagedElement (abstract)
      |
      +--Policy (abstract)
      |  |
      |  +---PolicySet (abstract -- new - 4.3)
      |  |   |
      |  |   +---PolicyGroup (moved - 4.3)
      |  |   |
      |  |   +---PolicyRule (moved - 4.3)
      |  |
      |  +---PolicyCondition (abstract)
      |  |   |
      |  |   +---PolicyTimePeriodCondition
      |  |   |
      |  |   +---VendorPolicyCondition
      |  |   |
      |  |   +---SimplePolicyCondition (new - 4.8.1)
      |  |   |
      |  |   +---CompoundPolicyCondition (new - 4.7.1)
      |  |       |
      |  |       +---CompoundFilterCondition (new - 4.9)
      |  |
      |  +---PolicyAction (abstract)
      |  |   |
      |  |   +---VendorPolicyAction
      |  |   |
      |  |   +---SimplePolicyAction (new - 4.8.4)
      |  |   |
      |  |   +---CompoundPolicyAction (new - 4.7.2)
      |  |
      |  +---PolicyVariable (abstract -- new - 4.8.5)
      |  |   |
      |  |   +---PolicyExplicitVariable (new - 4.8.6)
      |  |   |
      |  |   +---PolicyImplicitVariable (abstract -- new - 4.8.7)
      |  |       |
      |  |       +---(subtree of more specific classes -- new - 5.12)
      |  |
      |  +---PolicyValue (abstract -- new - 4.8.10)
      |      |
      |      +---(subtree of more specific classes -- new - 5.14)
      |
      +--Collection (abstract -- newly referenced)
      |  |
      |  +--PolicyRoleCollection (new - 4.6.2)
   (continued on following page)
   (continued from previous page)
   ManagedElement(abstract)
      |
      +--ManagedSystemElement (abstract)
         |
         +--LogicalElement (abstract)
            |
            +--System (abstract)
            |  |
            |  +--AdminDomain (abstract)
            |     |
            |     +---ReusablePolicyContainer (new - 4.2)
            |     |
            |     +---PolicyRepository (deprecated - 4.2)
            |
            +--FilterEntryBase (abstract -- new - 5.18)
            |  |
            |  +--IPHeaderFilter (new - 5.19)
            |  |
            |  +--8021Filter (new - 5.20)
            |
            +--FilterList (new - 5.21)

   Figure 1.    Class Inheritance Hierarchy for PCIMe
   The following figure shows the association class hierarchy for PCIMe.  As
   before, changes from PCIM are noted parenthetically.

   [unrooted]
      |
      +---PolicyComponent (abstract)
      |   |
      |   +---PolicySetComponent (new - 4.3)
      |   |
      |   +---PolicyGroupInPolicyGroup (deprecated - 4.3)
      |   |
      |   +---PolicyRuleInPolicyGroup (deprecated - 4.3)
      |   |
      |   +---CompoundedPolicyCondition   +---PolicyConditionStructure (abstract -- new - 4.7.1)
      |   |    |
      |   |    +---PolicyConditionInPolicyRule  (moved - 4.7.1)
      |   |    |
      |   |    +---PolicyConditionInPolicyCondition (new - 4.7.1)
      |   |
      |   +---PolicyRuleValidityPeriod
      |   |
      |   +---CompoundedPolicyAction   +---PolicyActionStructure (abstract -- new - 4.7.2)
      |   |    |
      |   |    +---PolicyActionInPolicyRule  (moved - 4.7.2)
      |   |    |
      |   |    +---PolicyActionInPolicyAction (new - 4.7.2)
      |   |
      |   +---PolicyVariableInSimplePolicyCondition (new - 4.8.2)
      |   |
      |   +---PolicyValueInSimplePolicyCondition (new - 4.8.2)
      |   |
      |   +---PolicyVariableInSimplePolicyAction (new - 4.8.4)
      |   |
      |   +---PolicyValueInSimplePolicyAction (new - 4.8.4)

   (continued on following page)
   (continued from previous page)
   [unrooted]
      |
      +---Dependency (abstract)
      |   |
      |   +---PolicyInSystem (abstract)
      |   |   |
      |   |   +---PolicySetInSystem (abstract, new - 4.3)
      |   |   |   |
      |   |   |   +---PolicyGroupInSystem
      |   |   |   |
      |   |   |   +---PolicyRuleInSystem
      |   |   |
      |   |   +---ReusablePolicy (new - 4.2)
      |   |   |
      |   |   +---PolicyConditionInPolicyRepository (deprecated - 4.2)
      |   |   |
      |   |   +---PolicyActionInPolicyRepository (deprecated - 4.2)
      |   |
      |   +---PolicyValueConstraintInVariable   +---ExpectedPolicyValuesForVariable (new - 4.8)
      |   |
      |   +---PolicyRoleCollectionInSystem (new - 4.6.2)
      |
      +---Component (abstract)
      |   |
      |   +---SystemComponent
      |   |   |
      |   |   +---PolicyContainerInPolicyContainer (new - 4.2)
      |   |   |
      |   |   +---PolicyRepositoryInPolicyRepository (deprecated - 4.2)
      |   |
      |   +---EntriesInFilterList (new - 6.23)
      |
      +---MemberOfCollection (newly referenced)
          |
          +--- ElementInPolicyRoleCollection (new - 4.6.2)

   Figure 2.    Association Class Inheritance Hierarchy for PCIMe

   In addition to these changes that show up at the class and association
   class level, there are other changes from PCIM involving individual class
   properties.  In some cases new properties are introduced into existing
   classes, and in other cases existing properties are deprecated (without
   deprecating the classes that contain them).

 4. Areas of Extension to PCIM

   The following subsections describe each of the areas for which PCIM
   extensions are being defined.

 4.1. Policy Scope

   Policy scopes may be thought of in two dimensions: 1) the level of
   abstraction of the policy specification and 2) the applicability of
   policies to a set of managed resources.

 4.1.1. Levels of Abstraction: Domain- and Device-Level Policies

   Policies vary in level of abstraction, from the business-level expression
   of service level agreements (SLAs) to the specification of a set of rules
   that apply to devices in a network.  Those latter policies can,
   themselves, be classified into at least two groups: those policies
   consumed by a Policy Decision Point (PDP) that specify the rules for an
   administrative and functional domain, and those policies consumed by a
   Policy Enforcement Point (PEP) that specify the device-specific rules for
   a functional domain.  The higher-level rules consumed by a PDP, called
   domain-level policies, may have late binding variables unspecified, or
   specified by a classification, whereas the device-level rules are likely
   to have fewer unresolved bindings.

   There is a relationship between these levels of policy specification that
   is out of scope for this standards effort, but that is necessary in the
   development and deployment of a usable policy-based configuration system.
   An SLA-level policy transformation to the domain-level policy may be
   thought of as analogous to a visual builder that takes human input and
   develops a programmatic rule specification.  The relationship between the
   domain-level policy and the device-level policy may be thought of as
   analogous to that of a compiler and linkage editor that translates the
   rules into specific instructions that can be executed on a specific type
   of platform.

   The policy core information model

   PCIM and PCIMe may be used to specify rules at any and all of these
   levels of abstraction.  However, at different levels of abstraction,
   different mechanisms may be more or less appropriate.

 4.1.2. Administrative and Functional Scopes

   Administrative scopes for policy are represented in PCIM and in these
   extensions to PCIM as System subclass instances.  Typically, a domain-
   level policy would be scoped by an AdminDomain instance (or by a
   hierarchy of AdminDomain instances) whereas a device-level policy might
   be scoped by a System instance that represents the PEP (e.g., an instance
   of ComputerSystem, see CIM [4]).  In addition to collecting policies into
   an administrative domain, these System classes may also aggregate the
   resources to which the policies apply.

   Functional scopes (sometimes referred to as functional domains) are
   generally defined by the derivation submodels derived from the policy framework PCIM and PCIMe, and
   correspond to the service or services to which the policies apply.  So,
   for example, Quality of Service may be thought of as a functional scope scope,
   or Diffserv and Intserv may each be thought of as functional scopes,
   these scopes.
   These scoping decisions are made represented by the derivation structure of the framework submodels
   derived from PCIM and PCIMe, and may be reflected in the number and types
   of PEP policy client(s),
   services services, and the interaction between policies.
   Policies in different functional scopes are organized in into disjoint sets
   of policy rules.  Different functional domains may share the use of some roles, some
   conditions, and even some actions.  The rules from different functional
   domains may even be enforced at the same managed resource resource, but for the
   purposes of policy evaluation they are separate.  See section 4.5 4.5.3 for
   more information.

   The functional scopes MAY be reflected in administrative scopes.  That
   is, deployments of policy may have different administrative scopes for
   different functional scopes, but there is no requirement to do so.

 4.2. Reusable Policy Elements

   In PCIM, a distinction was drawn between reusable PolicyConditions and
   PolicyActions and rule-specific ones.  The PolicyRepository class was
   also defined, to serve as a container for these reusable elements.  The
   name "PolicyRepository" has proven to be an unfortunate choice for the
   class that serves as a container for reusable policy elements.  This term
   is already used in documents like the Policy Framework, to denote the
   location from which the PEP retrieves all policy specifications, and into
   which the Policy Management Tool places all policy specifications.
   Consequently, the PolicyRepository class is being deprecated, in favor of
   a new class ReusablePolicyContainer.

   When a class is deprecated, any associations that refer to it must also
   be deprecated.  So replacements are needed for the two associations
   PolicyConditionInPolicyRepository and PolicyActionInPolicyRepository, as
   well as for the aggregation PolicyRepositoryInPolicyRepository.  In
   addition to renaming the PolicyRepository class to
   ReusablePolicyContainer, however, PCIMe is also broadening the types of
   policy elements that can be reusable.  Consequently, rather than
   providing one-for-one replacements for the two associations, a single
   higher-level association ReusablePolicy is defined.  This new association
   allows any policy element (that is, an instance of any subclass of the
   abstract class Policy) to be placed in a ReusablePolicyContainer.

   Summarizing, the following changes in Sections 5 and 6 are the result of
   this item:

     o The class ReusablePolicyContainer is defined.
     o PCIM's PolicyRepository class is deprecated.
     o The association ReusablePolicy is defined.
     o PCIM's PolicyConditionInPolicyRepository association is deprecated.
     o PCIM's PolicyActionInPolicyRepository association is deprecated.
     o The aggregation PolicyContainerInPolicyContainer is defined.
     o PCIM's PolicyRepositoryInPolicyRepository aggregation is deprecated.

 4.3. Policy Sets

   A "policy" can be thought of as a coherent set of rules to administer,
   manage, and control access to network resources (PolTerm, ("Policy Terminology",
   reference [12]).  The structuring of these coherent sets of rules into
   subsets is enhanced in this document.  In section Section 4.4, we discuss the new
   options for the nesting of policy rules.

   A new abstract class, PolicySet, is introduced to provide an abstraction
   for a set of rules.  It is derived from Policy, and it is inserted into
   the inheritance hierarchy above both PolicyGroup and PolicyRule.  This
   reflects the additional structure structural flexibility and semantic capability of
   both subclasses.

   Two properties are defined in PolicySet: PolicyDecisionStrategy and
   PolicyRoles.  The PolicyDecisionStrategy property is added to included in
   PolicySet to define the evaluation relationship between among the rules in the
   policy set.  See section Section 4.5 for more information.  The PolicyRoles
   property is added to included in PolicySet to name characterize the
   retrieval sets. resources to which
   the PolicySet applies.  See section Section 4.6 for more information.

   Along with the definition of the PolicySet class, a new concrete
   aggregation class is defined that will also be discussed in the following
   sections.  PolicySetComponent is defined as a subclass of
   PolicyComponent; it provides the containment relationship for a PolicySet
   in a PolicySet.  PolicySetComponent replaces the two PCIM aggregations
   PolicyGroupInPolicyGroup and PolicyRuleInPolicyGroup, so these two
   aggregations are deprecated.

   The PolicySet

   A PolicySet's relationship to an AdminDomain or other administrative
   scoping system (e.g., (for example, a ComputerSystem) is defined in represented by the
   PolicySetInSystem abstract association.  This new association is derived
   from PolicyInSystem, and the PolicyGroupInSystem and PolicyRuleInSystem
   associations are now derived from PolicySetInSystem instead of directly
   from PolicyInSystem.  The PolicySetInSystem.Priority property is
   discussed in section 4.5. Section 4.5.3.

 4.4. Nested Policy Rules

   As previously discussed, policy is described by a set of policy rules
   that may be grouped into subsets.   In this section we introduce the
   notion of nested rules, or the ability to define rules within rules.
   Nested rules are also called sub-rules, and we use both terms in this
   document interchangeably.  The aggregation PolicySetComponent is used to
   represent the nesting of a policy rule in another policy rule.

 4.4.1. Usage Rules for Nested Rules

   The relationship between rules and sub-rules is defined as follows:

     o   The parent rule's condition clause is a pre-condition condition for evaluation
         of all nested rules. rules; that is, the conditions of the parent are
         logically ANDed to the conditions of the sub-rules. If the parent
         rule's condition clause evaluates to FALSE, all sub-rules SHALL MAY be
         skipped and
         their condition clauses SHALL NOT be evaluated. since they also evaluate to FALSE.
     o   If the parent rule's condition evaluates to TRUE, the set of sub-
         rules SHALL BE executed evaluated according to the decision strategy and
         priorities as discussed in Section 4.5.
     o   If the parent rule's condition evaluates to TRUE, the parent
         rule's set of actions is executed BEFORE execution of the sub-
         rulesÆ actions.  The parent rule's actions are not to be confused
         with default actions.  A default action is one that is to be
         executed only if none of the more specific sub-rules are executed.
         If a default action needs to be specified, it needs to be defined
         as an action that is part of a catchall sub-rule associated with
         the parent rule.  The association linking the default action(s) in
         this special sub-rule should have the lowest priority relative to
         all other sub-rule associations:

                if precondition parent-condition then parent rule's action
                      if condA then actA
                      if condB then ActB
                      if True then default action

         Default actions have meaning

         Such a default action functions as a default when FirstMatching
         decision strategies are in effect (see section 4.5).  If
         AllMatching applies, the "default" action is always performed.

    o    Policy rules have an implicit a context in which they are executed.
         For example, The rule
         engine evaluates and applies the policy rules in the context of a
         the managed resource(s) that are identified by the policy rule could be all packets
         running on roles
         (or by an interface or set of interfaces on which the rule is
         applied.  Similarly, a parent rule provides a explicit association).  Submodels MAY add additional
         context to all of
         its sub-rules.  The policy rules based on rule structure; any such
         additional context of the sub-rules is defined by the restriction of
         the context semantics of the parent rule to the set action
         classes of cases that match the
         parent rule's condition clause. submodel.

 4.4.2. Motivation

   The motivation for introducing nested rules includes enhancing the
   definition of Policy, defining and reusing context hierarchies,
   optimizing how a rule is evaluated, and providing finer-grained control
   over condition evaluation.

   Rule nesting enhances Policy readability, expressiveness and reusability.
   The ability to nest policy rules and form sub-rules is important for
   manageability and scalability, as it enables complex policy rules to be
   constructed from multiple simpler policy rules.  These enhancements ease
   the policy management tools' task, allowing policy rules to be expressed
   in a way closer to how humans think.

   Sub-rules enable the policy designer to define a hierarchy of rules.
   This hierarchy has the property that sub-rules can be scoped by their
   parent rules.  This scoping, or context of evaluation and execution, is a
   powerful tool in enabling the policy designer to obtain the fine-grained
   control needed to appropriately manage resources for certain
   applications.  The example in the following section demonstrates that
   expressing relative bandwidth allocation rules can be done naturally
   using a hierarchical

   Although rule structure.

   Rule nesting can be used to optimize suggest optimizations in the way
   policy rules are evaluated
   and executed. Once the parent rule's condition clause is evaluated to
   FALSE, all sub-rules are skipped, optimizing the number of lookups
   required. Note that this is evaluated, as discussed in section 4.5.2 "Side Effects,"
   nesting does not the prime reason for rule nesting, but
   rather a side benefit. specify nor does it require any particular order of
   evaluation of conditions.  Optimization of rule execution evaluation can be done in
   the PDP or in the PEP by dedicated code.  This is similar to the relation
   between a high level programming language like C and machine code.  An
   optimizer can create a more efficient machine code than any optimization
   done by the programmer within the source code.  Nevertheless, if the PEP
   or PDP does not do optimization, the administrator writing the policy can
   optimize may
   be able to influence the evaluation of the policy rules for execution
   using rule nesting.

   Evaluation of some conditions does not require simple examination of a
   field within a packet.  For example, condition evaluation may require a
   PDP (or a PEP) to access an external database (e.g., a directory), query
   an external PDP (e.g., Kerberos) or possibly investigate a state within
   the network (e.g., issue an SNMP query).  These non-local condition
   evaluations should be minimized, as they cause delay in rule evaluation,
   load the network and other resources, and may have undesirable side
   effects.

   Nested rules are

   Nested rules are not designed for policy repository retrieval
   optimization.  It is assumed that all rules and groups that are assigned
   to a role are retrieved by the PDP or PEP from the policy repository and
   enforced.  Optimizing the number of rules retrieved should be done by
   clever selection of roles.

 4.4.3. Usage Example

   This section provides a usage example that aims

 4.5. Priorities and Decision Strategies

   A "decision strategy" is used to clarify specify the motivation evaluation method for the definition of rule nesting
   policies in a PolicySet.  Two decision strategies are defined:
   "FirstMatching" and "AllMatching."  The FirstMatching strategy is used to
   cause the use evaluation of the relative context.
   Consider the following example, where rules in a set of rules is used to specify such that the minimal bandwidth allocations on an interface.  The policy reads:

         On any interface only actions
   enforced on which these rules apply, guarantee at least
         30% a given examination of the interface bandwidth to UDP flows, and at least 40% of PolicySet are those for the interface bandwidth to TCP flows.

   When formatted in first
   rule (that is, the condition and action rule structure, with the policy
   reads:

     If (IP protocol is UDP) THEN (guarantee 30% of available BW) (1)
     If (IP protocol is TCP) THEN (guarantee 40% of available BW) (2)

   Now, let's add some sub-rules to further differentiate how bandwidth
   should be allocated highest priority) that has its
   conditions evaluate to specific UDP and TCP applications (indentation
   indicates rule nesting):

     If (IP protocol is UDP) THEN (guarantee 30% of available BW) (1)
           If (protocol is TFTP) (guarantee 10% of available BW)     (1a)
           If (protocol is NFS) THEN (guarantee 40% of available BW) (1b)
     If (IP protocol is TCP) THEN (guarantee 40% of available BW) (2)
           If (protocol is HTTP) THEN guarantee 20% of available BW) (2a)
           If (protocol TRUE.  The AllMatching strategy is FTP) THEN (guarantee 30% used to cause
   the evaluation of available BW) (2b)

   The UDP sub-rules specify that TFTP should be allocated 10% all rules in a set; for all of the
   bandwidth allocated rules whose
   conditions evaluate to UDP while NFS should be allocated 40% of TRUE, the UDP
   portion.  For TCP flows, HTTP should be allocated 20% of actions are enforced.  Implementations
   MUST support the TCP
   bandwidth while FTP should be allocated 30%.

   The context of each of FirstMatching decision strategy; implementations MAY
   support the two high-level rules (those marked (1) AllMatching decision strategy.

   As previously discussed, the PolicySet subclasses are PolicyGroup and (2)
   above) is all flows running on an interface.  The two sub-rules
   PolicyRule: either subclass may contain PolicySets of either subclass.
   Loops, including the
   UDP rule, marked (1a) and (1b) above specify degenerate case of a more granular context: PolicySet that contains itself,
   are not allowed when PolicySets contain other PolicySets.  The
   containment relationship is specified using the PolicySetComponent
   aggregation.

   The relative priority within UDP flows, TFTP should be allocated 10% a PolicySet is established by the Priority
   property of the bandwidth while NFS
   should be allocated 40%. PolicySetComponent aggregation of the contained
   PolicyGroup and PolicyRule instances.  The context use of these sub-rules PCIM's
   PolicyRule.Priority property is therefore UDP
   flows only.  Similar functionality applies for the hierarchy deprecated in favor of rules
   treating TCP flows.

   A context hierarchy enhances reusability. this new property.
   The rules that divide
   bandwidth between TFTP and NFS can be re-used and associated to rules
   that allocate different percentages separation of the bandwidth for different
   interfaces (or even for priority property from the same interface, but under different
   conditions) for UDP.

   This set rule has two advantages.
   First, it generalizes the concept of rules priority, so that it can be implemented using a hierarchical scheduler.
   Classifiers map TFTP packets to one queue, NFS packets to a second queue used for
   both groups and rules.  Second, it places the rest of UDP packets to priority on the third queue.  The first (UDP)
   scheduler assigns weights to each queue according to
   relationship between the guaranteed
   bandwidth percentages defined in sub-rules (1a) parent policy set and (1b).

   The second scheduler similarly assigns weights to 3 other queues
   according to the guaranteed bandwidth percentages defined in sub-rules
   (2a) and (2b). subordinate policy
   group or rule.  The UDP scheduler places packets into a UDP output queue.
   The TCP scheduler places packets on a TCP output queue.  The rest of the
   traffic is placed on a third queue. A scheduler extracts packets from
   each assignment of these three queues for transmission.  The UDP queue is assigned a
   30% weight according to rule (1), while priority value then becomes much
   easier, in that the TCP queue value is assigned a 40%
   weight according used only in relationship to rule (2).

   This example shows how rule nesting helps other
   priorities in specifying policy without the need to describe same set.

   Together, the mechanisms (queues PolicySet.PolicyDecisionStrategy and schedulers) used to
   implement it.  The rule specification allows
   PolicySetComponent.Priority determine the policy administrator to
   express processing for the policies he or she wants to enforce on rules
   contained in a PolicySet.  As before, the domain, and allows larger priority value
   represents the PDP or higher priority.  Unlike the PEP to map these policies to its mechanisms.  This is an
   example of a mapping between a rule based policy information model and earlier definition,
   PolicySetComponent.Priority MUST have a
   data path model [QDDIM].

 4.5. Priorities and Decision Strategies

   A "decision strategy" is used to specify the evaluation method unique value when compared with
   others defined for the
   policies in a same aggregating PolicySet.  Two decision strategies are defined:
   "FirstMatching" and "AllMatching."  The FirstMatching strategy is used to
   cause  Thus, the evaluation
   of the rules in within a set such that the only actions
   enforced on is deterministically specified.

   For a given examination of the PolicySet are those for FirstMatching decision strategy, the first rule (that is, the rule one
   with the highest priority) in the set that has its
   conditions evaluate evaluates to TRUE.  The AllMatching strategy True, is used to cause the evaluation of all rules in a set; only
   rule whose actions are enforced for a particular evaluation pass through
   the PolicySet.

   For an AllMatching decision strategy, all of the matching rules whose
   conditions evaluate to TRUE, the actions are
   enforced.  Implementations
   MUST support  The relative priority of the FirstMatching decision strategy; implementations MAY
   support rules is used to determine the AllMatching decision strategy.

   As previously discussed,
   order in which the PolicySet subclasses actions are PolicyGroup and
   PolicyRule: either subclass may contain PolicySets of either subclass.
   Loops, including to be executed by the degenerate case enforcement point:
   the actions of a PolicySet that contains itself,
   are not allowed when PolicySets contain other PolicySets.  The
   containment relationship is specified using the PolicySetComponent
   aggregation.

   The relative higher priority within a PolicySet is established by rules are executed first.    Since the Priority
   property
   actions of higher priority rules are executed first, lower priority rules
   that also match may get the PolicySetComponent aggregation of contained PolicyGroup "last word," and thus produce a counter-
   intuitive result.  So, for example, if two rules both evaluate to True,
   and PolicyRule instances.  The use of PCIM's PolicyRule.Priority property
   is deprecated in favor of this new property.  The separation of the higher priority property from the rule has two advantages.  First, it
   generalizes sets the concept of priority, so it can be used for both groups DSCP to 3 and rules; and, second, it places the lower priority on the relationship
   between
   rule sets the parent policy set and DSCP to 4, the subordinate policy group or rule.
   The assignment action of a the lower priority value, then, becomes much easier rule will be
   executed later and, therefore, will "win," in that this example, setting the
   value is used only in relationship
   DSCP to other priorities in 4.  Thus, conflicts between rules are resolved by this execution
   order.

   An implementation of the same set.

   Together, the PolicySet.PolicyDecisionStrategy and
   PolicySetComponent.Priority determine the processing for the rules
   contained in a PolicySet.  As before, the larger priority value
   represents the higher priority.  Unlike the earlier definition,
   PolicySetComponent.Priority MUST have a unique value when compared with
   others defined for the aggregating PolicySet.  Thus, the evaluation of
   rules within a set is deterministically specified.

   For a FirstMatching decision strategy, the first rule (i.e., the one with
   the highest priority) in the set that evaluates to True, is the only rule
   whose actions are enforced for a particular evaluation pass through the
   PolicySet.

   For an AllMatching decision strategy, all of the matching rules are
   enforced.  The relative priority of the rules is used to determine the
   order in which the actions are to be executed by the enforcement point:
   the actions of the higher priority rules are executed first.    Since the
   actions of higher priority rules are executed first, lower priority rules
   that also match may get the "last word," and thus produce a counter-
   intuitive result.  So, for example, if two rules both evaluate to True,
   and the higher priority rule sets the DSCP to 3 and the lower priority
   rule sets the DSCP to 4, the action of the lower priority rule will be
   executed later and, therefore, will "win," in this example, setting the
   DSCP to 4.  Thus, conflicts between rules are resolved by this execution
   order.

   An implementation of the rule engine need not provide rule engine need not provide the action
   sequencing but the actions MUST be sequenced by the PEP or PDP on its
   behalf.  So, for example, the rule engine may provide an ordered list of
   actions to be executed by the PEP and any required serialization is then
   provided by the service configured by the rule engine.  See section 4.5.2
   for a discussion of side effects.

 4.5.1. Structuring Decision Strategies

   When policy sets are nested, as shown in Figure 3, 3. , the decision
   strategies may be nested arbitrarily.  In this example, the relative
   priorities for the nested rules, high to low, are 1A, 1B1, 1X2, 1B3, 1C,
   1C1, 1X2 and 1C3.  (Note that PolicyRule 1X2 is included in both
   PolicyGroup 1B and PolicyRule 1C, but with different priorities.)  Of
   course, which rules are enforced is also dependent on which rules, if
   any, match.

   PolicyGroup 1: FirstMatching
     |
     +-- Pri=6 -- PolicyRule 1A
     |
     +-- Pri=5 -- PolicyGroup 1B: AllMatching
     |              |
     |              +-- Pri=5 -- PolicyGroup 1B1: AllMatching
     |              |              |
     |              |              +---- etc.
     |              |
     |              +-- Pri=4 -- PolicyRule 1X2
     |              |
     |              +-- Pri=3 -- PolicyRule 1B3: FirstMatching
     |                             |
     |                             +---- etc.
     |
     +-- Pri=4 -- PolicyRule 1C: FirstMatching
                    |
                    +-- Pri=4 -- PolicyRule 1C1
                    |
                    +-- Pri=3 -- PolicyRule 1X2
                    |
                    +-- Pri=2 -- PolicyRule 1C3

   Figure 3.    Nested PolicySets with Different Decision Strategies

     o   Because PolicyGroup 1 has a FirstMatching decision strategy, if
         the conditions of PolicyRule 1A match, its actions are enforced
         and the evaluation stops.

     o   If it does not match, PolicyGroup 1B is evaluated using an
         AllMatching strategy.  Since PolicyGroup 1B1 also has an
         AllMatching strategy all of the rules and groups of rules
         contained in PolicyGroup 1B1 are evaluated and enforced as
         appropriate. PolicyRule 1X2 and PolicyRule 1B3 are also evaluated
         and enforced as appropriate.  If any of the sub-rules in the
         subtrees of PolicyGroup 1B evaluate to True, then PolicyRule 1C is
         not evaluated because the FirstMatching strategy of PolicyGroup 1
         has been satisfied.

     o   If neither PolicyRule 1A nor PolicyGroup 1B yield a match, then
         PolicyRule 1C is evaluated.  Since it is first matching, rules
         1C1, 1X2, and 1C3 are evaluated until the first match, if any.

 4.5.2. Side Effects

   Although evaluation of conditions is sometimes discussed as an ordered
   set of operations, the rule engine need not be implemented as a
   procedural language interpreter. Any side effects of condition evaluation
   or the execution of actions MUST NOT affect the result of the evaluation
   of other conditions evaluated by the rule engine in the same evaluation
   pass.  That is, an implementation of a rule engine MAY evaluate all
   conditions in any order before applying the priority and determining
   which actions are to be executed.

   So, regardless of how a rule engine is implemented, it MUST NOT include
   any side effects of condition evaluation in the evaluation of conditions
   for either of the decision strategies.  For both the AllMatching decision
   strategy and for the nesting of rules within rules (either directly or
   indirectly) where the actions of more than one rule may be enforced, any
   side effects of the enforcement of actions MUST NOT be included in
   condition evaluation on the same evaluation pass.

 4.5.3. Multiple PolicySet Trees For a Resource

   As shown in the example in Figure 3, 3. , PolicySet trees are defined by the
   PolicySet subclass instances and the PolicySetComponent aggregation
   instances between them.  Each PolicySet tree has a defined set of
   decision strategies and evaluation priorities.  In section 4.6 we discuss
   some improvements in the use of PolicyRoles that cause the parent
   PolicySet.PolicyRoles to be applied to all contained PolicySet instances.
   However, a given resource may still have multiple, disjoint PolicySet
   trees that are collected from different roles and role combinations.
   Note that these
   These top-level PolicySet instances (called "unrooted") may
   only are called "unrooted".

   A PolicySet instance is defined to be unrooted in the context of a given context.
   particular managed element; the relationship to the managed element is
   usually established by the policy roles of the PolicySet instance and of
   the managed element (see 4.6 "Policy Roles").  A PolicySet instance is
   unrooted in that context if and only if there is no PolicySetComponent
   association to a parent PolicySet that is also related to the same
   managed element.  Figure 4. shows an example where instance A has role A,
   instance B has role B and so on.  In this example, in the context of
   interface X, B, and C are unrooted and, because roles are inherited,
   instances D, E, and F are all rooted.

            +---+                      +-----------+
            | A |                      |  I/F  X   |
            +---+                      | has roles |
             / \                       |   B & C   |
            /   \                      +-----------+
        +---+   +---+
        | B |   | C |
        +---+   +---+
         / \       \
        /   \       \
    +---+   +---+  +---+
    | D |   | E |  | F |
    +---+   +---+  +---+

   Figure 4.    Unrooted PolicySet Instances

  For those cases where there are multiple unrooted PolicySet instances
  that apply to the same managed resource (i.e., not in a common
  PolicySetComponent tree), the decision strategy among these disjoint
  PolicySet instances is the FirstMatching strategy.  The priority used
  with this FirstMatching strategy is defined in the PolicySetInSystem
  association.

   The FirstMatching strategy is used among all PolicySet instances that
   apply to a given resource for a given functional domain.  So, for
   example, the PolicySet instances that are used for QOS policy and the
   instances that are used for IKE policy, although they are disjoint, are
   not joined in a FirstMatching decision strategy.  Instead, they are
   evaluated independently of one another.

 4.5.4. Deterministic Decisions

   As previously discussed, PolicySetComponent.Priority values MUST be
   unique within a containing PolicySet and PolicySetInSystem.Priority
   values MUST be unique for an associated System. Each PolicySet, then, has
   a deterministic behavior based upon the decision strategy and uniquely
   defined priority.

   There are certainly cases where rules need not have a unique priority
   value (i.e., where evaluation and execution priority is not important).
   However, it is believed that the flexibility gained by this capability is
   not sufficiently beneficial to justify the possible variations in
   implementation behavior and the resulting confusion that might occur.

 4.6. Policy Roles

   A policy role is defined in [12] as "an administratively specified
   characteristic of a managed element (for example, an interface).  It is a
   selector for policy rules and PRovisioning Classes (PRCs), to determine
   the applicability of the rule/PRC to a particular managed element."
   In PCIMe, PolicyRoles is defined as a property of PolicySet, which is
   inherited by both PolicyRules and PolicyGroups.  In this draft, we also
   add PolicyRole as the identifying name of a collection of resources
   (PolicyRoleCollection), where each element in the collection has the
   specified role characteristic.

 4.6.1. Comparison of Roles in PCIM with Roles in snmpconf

   In the Configuration Management with SNMP (snmpconf) working group's
   Policy Based Management MIB [13], policy rules are of the form

     if <policyFilter> then <policyAction>

   where <policyFilter> is a set of conditions that are used to determine
   whether or not the policy applies to an object instance. The policy
   filter can perform comparison operations on SNMP variables already
   defined in MIBS (e.g., "ifType == ethernet").

   The policy management MIB defined in [13] defines a Role table that
   enables one to associate Roles with elements, where roles have the same
   semantics as in PCIM. Then, since the policyFilter in a policy allows one
   to define conditions based on the comparison of the values of SNMP
   variables, one can filter elements based on their roles as defined in the
   Role group.

   This approach differs from that adopted in PCIM in the following ways.
   First, in PCIM, a set of role(s) is associated with a policy rule as the
   values of the PolicyRoles property of a policy rule.  The semantics of
   role(s) are then expected to be implemented by the PDP (i.e. policies are
   applied to the elements with the appropriate roles).  In [draft-ietf-
   snmpconf-pm-04], [13], however,
   no special processing is required for realizing the semantics of roles;
   roles are treated just as any other SNMP variables and comparisons of
   role values can be included in the policy filter of a policy rule.

   Secondly, in PCIM, there is no formally defined way of associating a role
   with an object instance, whereas in [13] this is done via the use of the
   Role tables (pmRoleESTable and pmRoleSETable). The Role tables associate
   Role values with elements.

 4.6.2. Addition of PolicyRoleCollection to PCIMe

   In order to remedy the latter shortcoming in PCIM (i.e. the (the lack of a way of
   associating a role with an object instance), we define PCIMe has a new class
   PolicyRoleCollection that subclasses derived from the CIM Collection class.  Resources
   that share a common role belong to are aggregated by a PolicyRoleCollection
   instance.  Membership in this collection is indicated using
   instance, via the
   aggregation ElementInPolicyRoleCollection. ElementInPolicyRoleCollection aggregation.  The resource's role is
   specified in the PolicyRole property of the aggregating
   PolicyRoleCollection class. instance.

   A PolicyRoleCollection always exists in the context of a system.  As was
   done in PCIM for PolicyRules and PolicyGroups, this is captured by an association, PolicyRoleCollectionInSystem.
   PolicyRoleCollectionInSystem, captures this relationship.  Remember that
   in PCIM, a CIM, System is a base class for describing network devices and
   administrative domains.

   When associating

   The association between a PolicyRoleCollection with and a System, this system should be
   done consistently
   consistent with the system associations that scopes scope the policy rules/groups that
   are applied to the resources in that collection.  A  Specifically, a
   PolicyRoleCollection is should be associated with the same system System as the
   applicable PolicyRules and/or PolicyGroups, or to a System higher in the
   tree formed by the SystemComponent association.  When a PEP belongs to
   multiple Systems (i.e., AdminDomains), and scoping by a single domain is
   impractical, two alternatives exist.  One is to arbitrarily limit domain
   membership to one System/AdminDomain.  The other option is to define a
   more global AdminDomain that simply includes the others, and/or that
   spans the business or enterprise.

   As an example, suppose that there are 20 traffic trunks in a network, and
   that an administrator would like to assign three of them to provide
   "gold" service.  Also, the administrator has defined several policy rules
   which specify how the "gold" service is delivered.  For these rules, the
   PolicyRoles property (inherited from PolicySet) is set to "Gold Service".

   In order to associate three traffic trunks with "gold" service, an
   instance of the PolicyRoleCollection class is created and its PolicyRole
   property is also set to "Gold Service".  Following this, the
   administrator associates three traffic trunks with the new instance of
   PolicyRoleCollection via the ElementInPolicyRoleCollection aggregation.
   This enables a PDP to determine that the "Gold Service" policy rules
   apply to the three aggregated traffic trunks.

   Note that roles are used to optimize policy retrieval.  It is not
   mandatory to implement roles or, if they have been implemented, to group
   elements in a PolicyRoleCollection.  However, if roles are used, then
   either the collection approach should be implemented, or elements should
   be capable of reporting their "pre-programmed" roles (as is done in
   COPS).

 4.6.3. Roles for PolicyGroups

   In PCIM, role(s) are only associated with policy rules.  However, it may
   be desirable to associate role(s) with groups of policy rules.  For
   example, a network administrator may want to define a group of rules that
   apply only to Ethernet interfaces.  A policy group can be defined with a
   role-combination="Ethernet", and all the relevant policy rules can be
   placed in this policy group.  (Note that in PCIMe, role(s) are made
   available to PolicyGroups as well as to PolicyRules by moving PCIM's
   PolicyRoles property up from PolicyRule to the new abstract class
   PolicySet.  The property is then inherited by both PolicyGroup and
   PolicyRule.)  Then every policy rule in this policy group implicitly
   inherits this role-combination from the containing policy group.  A
   similar implicit inheritance applies to nested policy groups.

   Note that there

   There is no explicit copying of role(s) from container to contained
   entity.  Obviously, this implicit inheritance of role(s) leads to the
   possibility of defining inconsistent role(s) (as explained in the example
   below); the handling of such inconsistencies is beyond the scope of
   PCIMe.

   As an example, suppose that there is a PolicyGroup PG1 that contains
   three PolicyRules, PR1, PR2, and PR3.  Assume that PG1 has the roles
   "Ethernet" and "Fast".  Also, assume that the contained policy rules have
   the role(s) shown below:

   +------------------------------+
   | PolicyGroup PG1              |
   | PolicyRoles = Ethernet, Fast |
   +------------------------------+
              |
              |        +------------------------+
              |        | PolicyRule PR1         |
              |--------| PolicyRoles = Ethernet |
              |        +------------------------+
              |
              |        +--------------------------+
              |        | PolicyRule PR2           |
              |--------| PolicyRoles = <undefined>|
              |        +--------------------------+
              |
              |        +------------------------+
              |        | PolicyRule PR3         |
              |--------| PolicyRoles = Slow     |
                       +------------------------+

   Figure 4. 5.    Inheritance of Roles

   In this example, the PolicyRoles property value for PR1 is consistent
   with the value in PG1, and in fact, did not need to be redefined.  The
   value of PolicyRoles for PR2 is undefined.  Its roles are implicitly
   inherited from PG1. Lastly, the value of PolicyRoles for PR3 is "Slow".
   This appears to be in conflict with the role, "Fast," defined in PG1.
   However, whether these roles are actually in conflict is not clear.  In
   one scenario, the policy administrator may have wanted only "Fast"-
   "Ethernet" rules in the policy group.  In another scenario, the
   administrator may be indicating that PR3 applies to all "Ethernet"
   interfaces regardless of whether they are "Fast" or "Slow."  Only in the
   former scenario (only "Fast"-"Ethernet" rules in the policy group) is
   there a role conflict.

   Note that it is possible to override implicitly inherited roles via
   appropriate conditions on a PolicyRule.  For example, suppose that PR3
   above had defined the following conditions:

     (interface is not "Fast") and (interface is "Slow")
   This results in unambiguous semantics for PR3.

 4.7. Compound Policy Conditions and Compound Policy Actions

   Compound policy conditions and compound policy actions are introduced to
   provide additional reusable "chunks" of policy.

 4.7.1. Compound Policy Conditions

   A CompoundPolicyCondition is a PolicyCondition representing a Boolean
   combination of simpler conditions.  The conditions being combined may be
   SimplePolicyConditions (discussed below in section 4.7), but the utility
   of reusable combinations of policy conditions is not necessarily limited
   to the case where the component conditions are simple ones.

   The PCIM extensions to introduce compound policy conditions are
   relatively straightforward.  Since the purpose of the extension is to
   apply the DNF / CNF logic from PCIM's PolicyConditionInPolicyRule
   aggregation to a compound condition that aggregates simpler conditions,
   the following changes are required:

      o Create a new aggregation PolicyConditionInPolicyCondition, with the
        same GroupNumber and ConditionNegated properties as
        PolicyConditionInPolicyRule.  The cleanest way to do this is to
        move the properties up to a new abstract aggregation superclass
        CompoundedPolicyCondition,
        PolicyConditionStructure, from which the existing aggregation
        PolicyConditionInPolicyRule and a new aggregation
        PolicyConditionInPolicyCondition are derived.  For now there is no
        need to re-document the properties themselves, since they are
        already documented in PCIM as part of the definition of the
        PolicyConditionInPolicyRule aggregation.
      o It is also necessary to define a concrete subclass
        CompoundPolicyCondition of PolicyCondition, to introduce the
        ConditionListType property.  This property has the same function,
        and works in exactly the same way, as the corresponding property
        currently defined in PCIM for the PolicyRule class.

   The class and property definitions for representing compound policy
   conditions are below, in Section 5.

 4.7.2. Compound Policy Actions

   A compound action is a convenient construct to represent a sequence of
   actions to be applied as a single atomic action within a policy rule.  In
   many cases, actions are related to each other and should be looked upon
   as sub-actions of one "logical" action.  An example of such a logical
   action is "shape & mark" (i.e., shape a certain stream to a set of
   predefined bandwidth characteristics and then mark these packets with a
   certain DSCP value).  This logical action is actually composed of two
   different QoS actions, which should be performed in a well-defined order
   and as a complete set.

   The CompoundPolicyAction construct allows one to create a logical
   relationship between a number of actions, and to define the activation
   logic associated with this logical action.

   The CompoundPolicyAction construct allows the reusability of these
   complex actions, by storing them in a ReusablePolicyContainer and reusing
   them in different policy rules.  Note that a compound action may also be
   aggregated by another compound action.

   As was the case with CompoundPolicyCondition, the PCIM extensions to
   introduce compound policy actions are relatively straightforward.  This
   time the goal is to apply the property ActionOrder from PCIM's
   PolicyActionInPolicyRule aggregation to a compound action that aggregates
   simpler actions.  The following changes are required:

      o Create a new aggregation PolicyActionInPolicyAction, with the same
        ActionOrder property as PolicyActionInPolicyRule.  The cleanest way
        to do this is to move the property up to a new abstract aggregation
        superclass CompoundedPolicyAction, PolicyActionStructure, from which the existing
        aggregation PolicyActionInPolicyRule and a new aggregation
        PolicyActionInPolicyAction are derived.  For now there is no need
        to re-document the ActionOrder property itself, since it is already
        documented in PCIM as part of the definition of the
        PolicyActionInPolicyRule aggregation.
      o It is also necessary to define a concrete subclass
        CompoundPolicyAction of PolicyAction, to introduce the
        SequencedActions property.  This property has the same function,
        and works in exactly the same way, as the corresponding property
        currently defined in PCIM for the PolicyRule class.
      o Finally, a new property ExecutionStrategy is needed for both the
        PCIM class PolicyRule and the new class CompoundPolicyAction.  This
        property allows the policy administrator to specify how the PEP
        should behave in the case where there are multiple actions
        aggregated by a PolicyRule or by a CompoundPolicyAction.

   The class and property definitions for representing compound policy
   actions are below, in Section 5.

   Compound actions allow the definition of logically complex policy rules

 4.8. Variables and action behavior.  The following example illustrates two advantages of
   using compound actions.

   A QoS policy domain may include a rule that defines the following
   behavior:

     If (CONDITION) Then Do:
       "Shape traffic to <X> and Set DSCP to EF (high priority traffic);
        if canÆt shape than Set DSCP to BE (best effort)."

   This rule can be realized by defining two CompoundPolicyAction instances,
   A and B.  Two sub-actions are grouped into CompoundPolicyAction A:

        Shape traffic to <X>
        Mark to EF (DSCP).

   The ExecutionStrategy property of CompoundPolicyAction A would be defined
   as "Mandatory Do all".  This means that if shaping or marking cannot both
   be done, then nothing should be done.

   A second action, CompoundPolicyAction B, would hold the Mark to BE sub-
   action.

   CompoundPolicyAction A and CompoundPolicyAction B would be aggregated
   into the policy rule using the PolicyActionInPolicyRule aggregation.  The
   CompoundPolicyAction A will be ordered for execution before the
   CompoundPolicyAction B.  The PolicyRule's ExecutionStrategy property
   would be set to "Do until success".  In this way, CompoundPolicyAction A
   will be enforced on all PEPs that support shaping, while
   CompoundPolicyAction B will be enforced otherwise.

 4.8. Variables and Values Values

   The following subsections introduce several related concepts, including
   PolicyVariables and PolicyValues (and their numerous subclasses),
   SimplePolicyConditions, and SimplePolicyActions.

 4.8.1. Simple Policy Conditions

   The SimplePolicyCondition class models elementary Boolean conditional expressions of
   the form: "If (<variable> "(<variable> MATCH <value>)".  The "If"
   clause and the "MATCH" are implied in the formal notation.  The relationship 'MATCH', which
   is always 'MATCH' and implicit in the model, is interpreted based on the variable and the
   value.  Section 4.8.3 explains the semantics of the operator and
   how to extend them. 'MATCH' operator.
   Arbitrarily complex Boolean expressions can be formed by chaining
   together any number of simple conditions using relational operators.

   Individual simple conditions can be negated as well.  Arbitrarily complex
   Boolean expressions are modeled by the class CompoundPolicyCondition
   (described in section Section 4.7.1).

   For example, the expression "If SourcePort "SourcePort == 80" can be modeled by a simple
   condition.  In this example, 'SourcePort' is a variable, '==' is the
   relational operator denoting the equality relationship (which is
   generalized by PCIMe to a "match" "MATCH" relationship), and '80' is an integer
   value.  The complete interpretation of a simple condition depends on the
   binding of the variable.  Section 4.8.5 describes variables and their
   binding rules.

   The SimplePolicyCondition class refines the basic structure of the
   PolicyCondition class defined in PCIM by using the pair <variable> and
   <value> (<variable>,
   <value>) to form the condition.  Note that the operator between the
   variable and the value is always implied in PCIMe: it is not a part of
   the formal notation.

   The variable specifies the attribute of an object that should be matched
   when evaluating the condition.  For example, for a QoS derivation, model, this object
   could represent the flow that is being conditioned.  A set of predefined
   variables that cover network attributes that are commonly used for filtering is
   introduced here in PCIMe PCIMe, to encourage interoperability.  This list covers
   layer 3 IP attributes such as IP network addresses, protocols and ports,
   as well as a set of layer 2 attributes (e.g., MAC addresses).

   The PCIMe defines a single operator, "match", as explained in section
   4.8.3.

   The bound variable is matched against a value to produce the Boolean
   result.  For example, in the condition "If the "The source IP address of the flow
   belongs to the 10.1.x.x subnet", a source IP address variable is matched
   against a 10.1.x.x subnet value.  The operator specifies the type
   of relation between the variable and the value evaluated in the
   condition.

 4.8.2. Using Simple Policy Conditions

   Simple conditions can be used in policy rules directly, or as building
   blocks for creating compound policy conditions.

   Simple condition composition MUST enforce the following data-type
   conformance rule: The ValueTypes property of the variable must be
   compatible with the type of the value class used.  The simplest (and
   friendliest, from a user point-of-view) way to do this is to equate the
   type of the value class with the name of the class.  By ensuring that the
   ValueTypes property of the variable matches the name of the value class
   used, we know that the variable and value instance values are compatible
   with each other.

   Composing a simple condition requires that an instance of the class
   SimplePolicyCondition be created, and that instances of the variable and
   value classes that it uses also exist.  Note that the variable and/or
   value instances may already exist as reusable objects in an appropriate
   ReusablePolicyContainer.

   Two aggregations are used in order to create the pair <variable>,
   <value>. (<variable>,
   <value>).  The aggregation PolicyVariableInSimplePolicyCondition relates
   a SimplePolicyCondition to a single variable instance.  Similarly, the
   aggregation PolicyValueInSimplePolicyCondition relates a
   SimplePolicyCondition to a single value instance.  Both aggregations are
   defined in this document.

   Figure 5 6. depicts a SimplePolicyCondition with its associated variable
   and value.  Also shown are two PolicyValue instances that identify the
   values that the variable can assume.

                              +-----------------------+
                              | SimplePolicyCondition |
                              +-----------------------+
                                    *         @
                                    *         @
              +------------------+  *         @  +---------------+
              | (PolicyVariable) |***         @@@| (PolicyValue) |
              +------------------+               +---------------+
                 #            #
                 #    ooo     #
                 #            #
   +---------------+        +---------------+
   | (PolicyValue) |  ooo   | (PolicyValue) |
   +---------------+        +---------------+

   Aggregation Legend:
     ****  PolicyVariableInSimplePolicyCondition
     @@@@  PolicyValueInSimplePolicyCondition
     ####  PolicyValueConstraintInVariable  ExpectedPolicyValuesForVariable

   Figure 5. 6.    SimplePolicyCondition

   Note:  The class names in parenthesis denote subclasses.  The named classes
   named in the figure are abstract abstract, and cannot, therefore, thus cannot themselves be
   instantiated.

 4.8.3. The Simple Condition Operator

   A simple condition models an elementary Boolean expression conditional
   clause of the form "If variable
   "variable MATCHes value".  However, the formal notation of the
   SimplePolicyCondition, together with its associations, models only a
   pair, {variable, value}. (<variable>, <value>).  The "If" term and the "MATCH" 'MATCH' operator are is not directly
   modeled -- they are it is implied.  The  Furthermore, this implied MATCH 'MATCH' operator
   carries an overloaded semantics.

   For example, in the simple condition "If DestinationPort "DestinationPort MATCH '80'" '80'", the
   interpretation of the MATCH 'MATCH' operator is equality (the 'equal'
   operator).  Clearly, a different interpretation is needed in the
   following cases:

     o   "If DestinationPort   "DestinationPort MATCH {'80', '8080'}"  -- operator is 'IS SET
         MEMBER'

     o   "If DestinationPort   "DestinationPort MATCH {'1 to 255'}" -- operator is 'IN INTEGER
         RANGE'

     o   "If SourceIPAddress   "SourceIPAddress MATCH 'MyCompany.com'" -- operator is 'IP ADDRESS
         AS RESOLVED BY DNS'

   The examples above illustrate the implicit, context dependant context-dependant nature of
   the interpretation of the MATCH 'MATCH' operator.  The interpretation depends on the actual variable
   and value instances in the simple condition.  The interpretation is
   always derived from the bound variable and the value instance associated
   with the simple condition.  Text accompanying the value class and
   implicit variable definition is used for interpreting the semantics of
   the MATCH 'MATCH' relationship.  In the following list, we define generic
   (type-independent) matching.

   PolicyValues may be multi-fielded, where each field may contain a range
   of values.  The same equally holds for PolicyVariables.  Basically, we
   have to deal with single values (singleton), ranges ([lower bound ..
   upper bound]), and sets (a,b,c).  So independent of the variable and
   value type, the following set of generic matching rules for the MATCH 'MATCH'
   operator are defined.

     o   singleton matches singleton -> the matching rule is defined in the
         type

     o   singleton matches range [lower bound .. upper bound] -> the
         matching evaluates to true, if the singleton matches the lower
         bound or the upper bound or a value in between

     o   singleton matches set -> the matching evaluates to true, if the
         value of the singleton matches one of the components in the set,
         where a component may be a singleton or range again

     o   ranges [A..B] matches singleton -> is true if A matches B matches
         singleton

     o   range [A..B] matches range [X..Y] -> the matching evaluates to
         true, if all values of the range [A..B] are also in the range
         [X..Y].  For instance, [3..5] match [1..6] evaluates to true,
         whereas [3..5] match [4..6] evaluates to false.

     o   range [A..B] matches set (a,b,c, ...) -> the matching evaluates to
         true, if all values in the range [A..B] are part of the set.  For
         instance, range [2..3] match set ([1..2],3) evaluates to true, as
         well as range [2..3] match set (2,3), and range [2..3] match set
         ([1..2],[3..5]).

     o   set (a,b,c, ...) match singleton -> is true if a match b match c
         match ... match singleton
     o   set match range -> the matching evaluates to true, if all values
         in the set are part of the range.  For example, set (2,3) match
         range [1..4] evaluates to true.

     o   set (a,b,c,...) match set (x,y,z,...) -> the matching evaluates to
         true, if all values in the set (a,b,c,...) are part of the set
         (x,y,z,...).  For example, set (1,2,3) match set (1,2,3,4)
         evaluates to true.  Set (1,2,3) match set (1,2) evaluates to
         false.

   Variables may contain various types (section XXX). 5.11.1).  When not stated
   otherwise, the type of the value bound to the variable at condition
   evaluation time and the value type of the PolicyValue instance need to be
   of the same type.  If they differ differ, then the condition evaluates to FALSE.

   Matching rules for value type specific matching see below.

   The PolicyValueConstraintInVariable ExpectedPolicyValuesForVariable association specifies additional
   constraints on the possible an expected set
   of values and value types that can be matched with a variable within a simple condition.
   Using this association, a source or destination port can be constrained limited to be matched against
   integer values in
   the range 0-65535.  A 0-200, a source or destination IP address can be constrained limited to be matched against a
   specified list of IPv4 address values, etc.  In order

                           +-----------------------+
                           | SimplePolicyCondition |
                           +-----------------------+
                               *               @
                               *               @
                               *               @
    +-----------------------------------+   +--------------------------+
    | Name=SmallSourcePorts             |   | Name=Port300             |
    | Class=PolicySourcePortVariable    |   | Class=PolicyIntegerValue |
    | ValueTypes=[PolicyIntegerVariable]|   | IntegerList = [300]      |
    +-----------------------------------+   +--------------------------+
                 #
                 #
                 #
    +-------------------------+
    |Name=SmallPortsValues    |
    |Class=PolicyIntegerValue |
    |IntegerList=[1..200]     |
    +-------------------------+

   Aggregation Legend:
     ****  PolicyVariableInSimplePolicyCondition
     @@@@  PolicyValueInSimplePolicyCondition
     ####  ExpectedPolicyValuesForVariable

   Figure 7.    An Invalid SimplePolicyCondition

   The ability to check whether a value X can be used with a
   variable A constrained by value Y, the following conformance test should
   be made.  If all events for which express these limitations appears in the model to support
   validation of a SimplePolicyCondition (A match X)
   evaluates prior to TRUE also evaluate its deployment to TRUE an
   enforcement point.  A Policy Management Tool, for example SHOULD NOT
   accept the SimplePolicyCondition (A
   match Y), than X conforms to shown in Figure 7.  If, however, a
   policy rule containing this condition does appear at an enforcement
   point, the constraint Y.  If multiple expected values Y1,
   Y2, ..., Yn constrain a variable, then play no role in the conformance test involves
   checking against determination of whether
   the condition (A match Y1) OR (A match Y2) OR ... OR (A
   match Yn). evaluates to True or False.  Thus in this example, the
   SimplePolicyCondition evaluates to True if the source port for the packet
   under consideration is 300, and it evaluates to False otherwise.

 4.8.4. SimplePolicyActions

   The SimplePolicyAction class models the elementary set operation. "SET
   <variable> TO <value>".  The set operator MUST overwrite an old value of
   the variable.

   For example,  In the action  "set DSCP case where the variable to EF" can be modeled by a simple
   action.  In this example, 'DSCP' updated is an implicit variable referring to multi-
   valued, the
   IP only update operation defined is a complete replacement of
   all previous values with a new set.  In other words, there are no Add or
   Remove [to/from the set of values] operations defined for
   SimplePolicyActions.

   For example, the action  "set DSCP to EF" can be modeled by a simple
   action.  In this example, 'DSCP' is an implicit variable referring to the
   IP packet header DSCP field.  'EF' is an integer or bit string value (6
   bits).  The complete interpretation of a simple action depends on the
   binding of the variable.  Section [4.8.4] describes variables and their
   binding rules for conditions.

   The SimplePolicyAction class refines the basic structure of the
   PolicyAction class defined in PCIM, by specifying the contents of the
   action using the <variable> <value> (<variable>, <value>) pair to form the action.  The
   variable specifies the attribute of an object that has passed the
   condition by evaluating to true.  This means the binding of the variable
   is delayed until the condition evaluates to true for one or more objects. object. The value of the object's  this
   attribute is set to the value specified in <value>.  Selection of the
   object is a function of the type of variable involved.  See Sections
   4.8.6 and 4.8.7, respectively, for details on object selection for
   explicitly bound and implicitly bound policy variables.

   SimplePolicyActions can be used in policy rules directly, or as building
   blocks for creating CompoundPolicyActions.

   The set operation is only valid if the list of types of the variable
   (ValueTypes property of PolicyImplicitVariable) includes the specified
   type of the value.  Conversion of values from one representation into
   another is not defined.  E.g.,  For example, a variable of IPv4Address type may
   not be set to a string containing a DNS name.  Conversions are part of an
   implementation-specific mapping of the model.

   As was the case with SimplePolicyConditions, the role of expected values
   for the variables that appear in SimplePolicyActions is for validation,
   prior to the time when an action is executed.  Expected values play no
   role in action execution.

   Composing a simple action requires that an instance of the class
   SimplePolicyAction be created, and that instances of the variable and
   value classes that it uses also exist.  Note that the variable and/or
   value instances may already exist as reusable objects in an appropriate
   ReusablePolicyContainer.

   Two aggregations are used in order to create the pair <variable> <value>. (<variable>,
   <value>).  The aggregation PolicyVariableInSimplePolicyAction relates a
   SimplePolicyAction to a single variable instance.  Similarly, the
   aggregation PolicyValueInSimplePolicyAction relates a SimplePolicyAction
   to a single value instance.  Both aggregations are defined in this
   document.

   Figure 6 8. depicts a SimplePolicyAction with its associated variable and
   value.

                                 +-----------------------+
                                 | SimplePolicyAction    |
                                 |                       |
                                 +-----------------------+
                                       *         @
                                       *         @
                 +------------------+  *         @  +---------------+
                 | (PolicyVariable) |***         @@@| (PolicyValue) |
                 +------------------+               +---------------+
                    #            #
                    #    ooo     #
                    #            #
      +---------------+        +---------------+
      | (PolicyValue) |  ooo   | (PolicyValue) |
      +---------------+        +---------------+

      Aggregation Legend:
        ****  PolicyVariableInSimplePolicyAction
        @@@@  PolicyValueInSimplePolicyAction
        ####  PolicyValueConstraintInVariable  ExpectedPolicyValuesForVariable

   Figure 6. 8.    SimplePolicyAction

 4.8.5. Policy Variables

   A variable generically represents information that changes (or "varies"),
   and that is set or evaluated by software.  In policy, conditions and
   actions can abstract information as "policy variables" to be evaluated in
   logical expressions, or set by actions.

   PCIMe defines two types of PolicyVariables, a PolicyImplicitVariable PolicyImplicitVariables and
   a PolicyExplicitVariable.
   PolicyExplicitVariables.  The semantic difference between these classes
   is based on modeling context.  Explicit variables are bound to exact
   model constructs, while implicit variables are defined and evaluated
   outside of a model, in a more subjective context. model.  For example, one can imagine a PolicyCondition
   testing for whether a CIM ManagedSystemElement's Status property set to has the
   value "Error."  The Status property is an explicitly defined
   PolicyVariable (i.e., it is defined in the context of the CIM Schema Schema, and
   evaluated in the context of a specific instance).  On the other hand,
   network packets are not explicitly modeled or instantiated, since there
   is no perceived value (at this time) in managing at the packet level.
   Therefore, a PolicyCondition can make no explicit reference to a model
   construct that represents a network packet's source address.  In this
   case, an implicit PolicyVariable is defined defined, to allow evaluation or
   modification of a packet's source address.

 4.8.6. Explicitly Bound Policy Variables

   Explicitly bound policy variables indicate the class and property names
   of the model construct to be evaluated or set.  The CIM Schema defines
   and constrains "appropriate" values for the variable (i.e., model
   property) using data types and other information such as class/property
   qualifiers.

   A PolicyExplicitVariable is "explicit" because its model semantics are
   exactly defined.  It is NOT explicit due to an exact binding to a
   particular object. object instance.  If PolicyExplicitVariable is only PolicyExplicitVariables were tied to
   instances (either via association associations or by a an object identification
   property in the class itself), then we are would be forcing element-specific
   rules.  On the other hand, if we only specify the object's model context
   (class and property name), but leave the binding to the policy framework
   (for example, using policy roles), then greater flexibility results for
   either general or element-specific rules.

   For example, an element-specific rule is obtained by a condition
   (variable/operator/value triplet)
   ((<variable>, <value>) pair) that defines, for example, defines CIM LogicalDevice
   DeviceID="12345".  Alternately, if a PolicyRule's PolicyRoles is "edge
   device" and your the condition (variable/operator/value
   triplet) ((<variable>, <value>) pair) is Status="Error",
   then a general rule results for all edge devices in error.

   Refer to Section 5.10 for the formal definition of the class
   PolicyExplicitVariable.

 4.8.7. Implicitly Bound Policy Variables

   Implicitly bound policy variables define

   Currently, the data type and semantics of only binding for a
   variable.  This determines how the variable PolicyExplicitVariable defined in PCIMe
   is bound to a value in a
   condition clause.  Further instructions are provided for specifying data
   type and/or value constraints for implicitly bound variables.

   Implicitly bound variables can be interpreted by different sub-models to
   mean different things, depending on the particular context in which they
   are used.  For example, an implicitly bound variable named "SourceIP" may
   be interpreted instances selected by a QoS policy information model roles.  For each such instance, a
   SimplePolicyCondition that aggregates the PolicyExplicitVariable
   evaluates to denote True if and only if ALL of the source
   address field in following are true:

     o   The instance selected is of the IP header class identified by the variable's
         ModelClass property, or of a packet if a device is configured to
   select certain packets for particular treatment. subclass of this class.
     o   The same variable may
   be bound to instance selected has the sender address delivered property identified by a RSVP PATH message for a
   decision the
         variable's ModelProperty property.
     o   The value of this property in the instance matches the value
         specified in the PolicyValue aggregated by the condition.

   In all other cases, the SimplePolicyCondition evaluates to False.

   For the case where a policy server.  It is incumbent upon SimplePolicyAction aggregates a
   PolicyExplicitVariable, the particular domain-
   specific information model indicated property in the selected instance
   is set to provide full and unambiguous interpretation
   details (binding rules, type and the value constraints) for represented by the implicitly
   bound variables it uses.

   PCIMe introduces an abstract class, PolicyImplicitVariable, to model
   implicitly bound variables.  This class is derived from PolicyValue that the abstract
   class PolicyVariable
   SimplePolicyAction also defined in PCIMe.  Each aggregates.  However, if the selected instance is
   not of the implicitly bound
   variables introduced by PCIMe (and those that are introduced class identified by domain-
   specific sub-models) MUST be derived from the PolicyImplicitVariable
   class.  The rationale for using variable's ModelClass property, or of
   a subclass of this mechanism for modeling class, then the action is explained
   below in Section 4.8.9.

   A domain-specific policy information model that extends PCIMe may define
   additional implicitly bound variables not performed.  In this case
   the SimplePolicyAction is not treated either by deriving them directly
   from as a successfully executed
   action (for the class PolicyImplicitVariable, execution strategy Do Until Success) or by further refining an existing
   variable class such as SourcePort.  When refining a class such failed
   action (for the execution strategy Do Until Failure).  Instead, the
   remaining actions for the policy rule, if any, are executed as
   SourcePort, existing binding rules, type or value constraints may if this
   SimplePolicyAction were not present at all in the list of actions
   aggregated by the rule.

   Explicit variables would be
   narrowed.

 4.8.8. Structure and Usage more powerful if they could reach beyond the
   instances selected by policy roles, to related instances.  However, to
   represent a policy rule involving such variables in any kind of Pre-Defined Variables

   A class derived from PolicyImplicitVariable general
   way requires something that starts to model resemble very much a particular
   implicitly bound variable SHOULD complete
   policy language.  Clearly such a language is outside the scope of PCIMe,
   although it might be constructed so that its name depicts the meaning subject of a future draft.

   By restricting much of the variable. generality, it would be possible for explicit
   variables in PCIMe to reach slightly beyond a selected instance.  For
   example, if a class defined selected instance were related to model the
   source port exactly one instance of
   another class via a TCP/UDP flow SHOULD be named 'SourcePort'.

   PCIMe defines one particular association class, and one general-purpose mechanism that
   together characterize each if the goal of the implicitly bound variables that it
   introduces:

     1.  The PolicyValueConstraintInVariable association defines the
   policy rule were both to test a property of this related instance and to
   set a property of
         value classes that could same instance, then it would be matched possible to this variable.

     2.  The list of constraints on the values that the PolicyVariable can
         hold (i.e., values that the variable must match) are defined by
   represent the appropriate properties condition and action of an associated PolicyValue class.

   In the example presented above, rule using
   PolicyExplicitVariables.  Rather than handling this one specific case
   with explicit variables, though, it was decided to lump them with the
   more general case, and deal with them if and when a PolicyImplicitVariable represents policy language is
   defined.

   Refer to Section 5.10 for the
   SourcePort of incoming traffic.  The ValueTypes property of an instance formal definition of this class will hold the class name PolicyIntegerValue.  This by
   itself constrains
   PolicyExplicitVariable.

 4.8.7. Implicitly Bound Policy Variables

   Implicitly bound policy variables define the data type and semantics of a
   variable.  This determines how the SourcePort instance to be an
   integer.  However, we can further constrain the particular values that
   the SourcePort variable can hold by entering valid ranges is bound to a value in a
   condition or an action.  Further instructions are provided for specifying
   data type and/or value constraints for implicitly bound variables.

   PCIMe introduces an abstract class, PolicyImplicitVariable, to model
   implicitly bound variables.  This class is derived from the
   IntegerList property of the PolicyIntegerValue instance (0 - 65535 abstract
   class PolicyVariable also defined in
   this document).

   The combination of the VariableName and the
   PolicyValueConstraintInVariable association provide a consistent and
   extensible set PCIMe.  Each of metadata that define the semantics of implicitly bound
   variables introduced by PCIMe (and those that are used to form policy conditions.  Since the
   PolicyValueConstraintInVariable association points to another class, any
   of the properties in the PolicyValue class can introduced by domain-
   specific sub-models) MUST be used to constrain
   values that derived from the PolicyImplicitVariable can hold. For example:

     o   The ValueTypes property can be used to ensure that only proper
         classes are used in the expression.  For example, the SourcePort
         variable will not be allowed to ever be of type
         PolicyIPv4AddrValue, since source ports have different semantics
         than IP addresses and may not be matched.  However, integer value
         types are allowed as the property ValueTypes holds the string
         "PolicyIntegerValue", which is the class name for integer values.

     o   The PolicyValueConstraintInVariable association also ensures that
         variable-specific semantics are enforced (e.g., the SourcePort
         variable may include a constraint association to a value object
         defining a specific integer range that should be matched).

 4.8.9. Rationale for Modeling Implicit Variables as Classes

 An implicitly bound variable can be modeled in one of several ways,
 including a single class with an enumerator for each individual implicitly
 bound variable and an abstract class extended for each individual variable.
   class.  The reasons rationale for using a class inheritance this mechanism for specifying
 individual implicitly bound variables are these:

     1.  It modeling is easy to extend. explained
   below in Section 4.8.9.

   A domain-specific information model can
         easily extend the PolicyImplicitVariable class or its subclasses
         to define domain-specific and context-specific variables.  For
         example, a domain-specific QoS policy information model that extends PCIMe may
         introduce an define
   additional implicitly bound variable class to model applications variables either by deriving a qosApplicationVariable class them directly
   from the
         PolicyImplicitVariable abstract class.

     2.  Introduction of a single structural class for implicitly bound
         variables would have to include PolicyImplicitVariable, or by further refining an enumerator property that
         contains all possible individual implicitly bound variables.  This
         means that existing
   variable class such as SourcePort.  When refining a domain-specific information model wishing class such as
   SourcePort, existing binding rules, type or value constraints may be
   narrowed.

 4.8.8. Structure and Usage of Pre-Defined Variables

   A class derived from PolicyImplicitVariable to
         introduce an model a particular
   implicitly bound variable must extend SHOULD be constructed so that its name depicts
   the enumerator
         itself.  This results in multiple definitions meaning of the same class,
         differing in the values available in variable.  For example, a class defined to model the enumerator class.  One
         definition,
   source port of a TCP/UDP flow SHOULD have 'SourcePort' in this document, would include its name.

   PCIMe defines one association and one general-purpose mechanism that
   together characterize each of the common implicitly bound variables' names, while a second definition, in the domain-
         specific information model document, may include additional values
         ('qosApplicationVariable' in variables that it
   introduces:

     1.  The ExpectedPolicyValuesForVariable association defines the example above).  It wouldnÆt even set of
         value classes that could be obvious matched to this variable.

     2.  The list of constraints on the application developer values that multiple class
         definitions existed.  It would be harder still for the application
         developer to actually find PolicyVariable can
         hold (i.e., values that the correct class to use.

     3.  In addition, variable must match) are defined by
         the appropriate properties of an enumerator-based definition would require each
         additional value to be registered with IANA to ascertain adherence
         to standards. This would make associated PolicyValue class.

   In the process cumbersome.

     4.  A possible argument against the inheritance mechanism would cite example presented above, a PolicyImplicitVariable represents the fact that this approach results in
   SourcePort of incoming traffic.  The ValueTypes property of an explosion instance
   of this class
         definitions compared to an enumerator class, which only introduces
         a single class.  While, will hold the class name PolicyIntegerValue.  This by itself, this is not a strike against
   itself constrains the approach, it may be argued that data models implemented, which
         are mapped type of the SourcePort instance to this information model, may be more difficult to
         optimize for applications.  This argument is rejected on an
   integer.  However, we can further constrain the
         grounds particular values that application optimization is
   the SourcePort variable can hold by entering valid ranges in the
   IntegerList property of lesser value for an
         information model than clarity the PolicyIntegerValue instance (0 - 65535 in
   this document).

   The combination of the VariableName and ease the
   ExpectedPolicyValuesForVariable association provide a consistent and
   extensible set of extension.  In
         addition, it is hard to claim metadata that define the inheritance model places an
         absolute burden on semantics of variables that
   are used to form policy conditions.  Since the optimization.  For example, a data model
         may still use enumeration
   ExpectedPolicyValuesForVariable association points to denote instances a PolicyValue
   instance, any of pre-defined
         variables and claim PCIMe compliance, as long as the data moel values expressible in the PolicyValue class can be mapped correctly
   used to constrain values that the definitions specified PolicyImplicitVariable can hold. For
   example:

     o   The ValueTypes property can be used to ensure that only proper
         classes are used in this document.
         Furthermore, the very nature of implicitly bound variables is expression.  For example, the SourcePort
         variable will not be allowed to ever be interpreted in context.  This means that unless an additional
         variable is required by a sub-model (in of type
         PolicyIPv4AddrValue, since source ports have different semantics
         than IP addresses and may not be matched.  However, integer value
         types are allowed as the property ValueTypes holds the string
         "PolicyIntegerValue", which case both approaches
         result in some overhead), there's an upper limit on is the class
         explosion.  After all, once properly documented, no need exists name for integer values.

     o   The ExpectedPolicyValuesForVariable association also ensures that
         variable-specific semantics are enforced (e.g., the SourcePort
         variable may include a sub-model constraint association to add a class definition.  The implementation
         needs only to cite and use the PCIMe variable, but impose the
         documented context-dependent semantics.

 4.8.10. Policy Values

   The abstract class PolicyValue is used for modeling values and constants
   used in policy conditions.  Different value types are derived from this
   class, to represent the various attributes required.  Extensions of the
   abstract class PolicyValue, defined in this document, provide object
         defining a list of
   values for representing basic network attributes.  Values can specific integer range that should be used to
   represent constants matched).

 4.8.9. Rationale for Modeling Implicit Variables as named values.  Named values Classes

   An implicitly bound variable can be kept modeled in a
   reusable policy container to be reused by multiple conditions.  Examples
   of constants include well-known ports, well-known protocols, server
   addresses, and other similar concepts.

   The PolicyValue subclasses define three basic types one of values: scalars,
   ranges and sets.  For example, a well-known port number could be defined
   using the PolicyIntegerValue class, defining several ways,
   including a single value (80 for
   HTTP), a range (80-88), or a set (80, 82, 8080) of ports, respectively.
   For details, please see the class definition with an enumerator for each value type in
   Section 5.12 of this document.

   PCIMe defines the following subclasses of the individual
   implicitly bound variable and an abstract class PolicyValue:

   Classes extended for general use:

     - PolicyStringValue,
     - PolicyIntegerValue,
     - PolicyBitStringValue
     - PolicyBooleanValue.

   Classes each
   individual variable.  The reasons for layer 3 Network values:

     - PolicyIPv4AddrValue,
     - PolicyIPv6AddrValue.

   Classes using a class inheritance mechanism
   for layer 2 Network values:

     - PolicyMACAddrValue.

   For details, please see specifying individual implicitly bound variables are these:

     1.  It is easy to extend.  A domain-specific information model can
         easily extend the PolicyImplicitVariable class definition section or its subclasses
         to define domain-specific and context-specific variables.  For
         example, a domain-specific QoS policy information model may
         introduce an implicitly bound variable class to model applications
         by deriving a qosApplicationVariable class from the
         PolicyImplicitVariable abstract class.

     2.  Introduction of each a single structural class for implicitly bound
         variables would have to include an enumerator property that
         contains all possible individual implicitly bound variables.  This
         means that a domain-specific information model wishing to
         introduce an implicitly bound variable must extend the enumerator
         itself.  This results in
   Section 5.14 multiple definitions of this document.

 4.9. Packet Filtering

   In addition to filling the same class,
         differing in the holes values available in the overall Policy infrastructure,
   PCIMe proposes enumerator class.  One
         definition, in this document, would include the common implicitly
         bound variables' names, while a single mechanism for expressing packet filters second definition, in policy
   conditions.  This is being done the domain-
         specific information model document, may include additional values
         ('qosApplicationVariable' in response to concerns that the example above).  It wouldnÆt even though
         be obvious to the initial "wave" of submodels derived from PCIM were all filtering on
   IP packets, each was doing it in a slightly different way.  PCIMe
   proposes a common way application developer that multiple class
         definitions existed.  It would be harder still for the application
         developer to express IP packet filters.  The following figure
   illustrates how packet-filtering conditions are expressed in PCIMe.

                    +---------------------------------+
                    | CompoundFilterCondition         |
                    |   - IsMirrored   boolean        |
                    |   - ConditionListType (DNF|CNF) |
                    +---------------------------------+
                     +               +               +
                     +               +               +
                     +               +               +
                 SimplePC        SimplePC        SimplePC
                 *      @        *      @        *      @
                 *      @        *      @        *      @
                 *      @        *      @        *      @
     FlowDirection    "In"     SrcIP  <addr1>  DstIP  <addr2>

   Aggregation Legend:
     ++++  PolicyConditionInPolicyCondition
     ****  PolicyVariableInSimplePolicyCondition
     @@@@  PolicyValueInSimplePolicyCondition

   Figure 7.    Packet Filtering in Policy Conditions actually find the correct class to use.

     3.  In Figure 7, addition, an enumerator-based definition would require each SimplePolicyCondition represents a single field
         additional value to be
   filtered on: Source IP address, Destination IP address, Source port, etc.
   An additional SimplePolicyCondition indicates registered with IANA to ascertain adherence
         to standards. This would make the direction that a packet
   is traveling on an interface: inbound or outbound.  Because of process cumbersome.

     4.  A possible argument against the
   FlowDirection condition, care must be taken inheritance mechanism would cite
         the fact that this approach results in aggregating a set an explosion of
   SimplePolicyConditions into class
         definitions compared to an enumerator class, which only introduces
         a CompoundFilterCondition.  Otherwise, the
   resulting CompoundPolicyCondition may match all inbound packets, or all
   outbound packets, when single class.  While, by itself, this is probably not what was intended.

   Individual SimplePolicyConditions a strike against
         the approach, it may be negated when they are aggregated
   by a CompoundFilterCondition.

   CompoundFilterCondition argued that data models derived from this
         information model may be more difficult to optimize for
         applications.  This argument is a subclass of CompoundPolicyCondition.  It
   introduces one additional property, rejected on the Boolean property IsMirrored.  The
   purpose grounds that
         application optimization is of this property lesser value for an information
         model than clarity and ease of extension.  In addition, it is hard
         to allow a single CompoundFilterCondition to
   match packets traveling in both directions claim that the inheritance model places an absolute burden on
         the optimization.  For example, a higher-level connection
   such data model may still use
         enumeration to denote instances of pre-defined variables and claim
         PCIMe compliance, as a TCP session.  When long as the data model can be mapped
         correctly to the definitions specified in this property document.

 4.8.10. Policy Values

   The abstract class PolicyValue is TRUE, additional packets
   match a filter, beyond those that would ordinarily match it.  An example
   will illustrate how this property works.

   Suppose we have a CompoundFilterCondition that aggregates the following
   three filters, which used for modeling values and constants
   used in policy conditions.  Different value types are ANDed together:

     o   FlowDirection = "In"
     o   Source IP = 9.1.1.1
     o   Source Port = 80

   Regardless of whether IsMirrored is TRUE or FALSE, inbound packets will
   match derived from this CompoundFilterCondition if their Source IP address = 9.1.1.1
   and their Source port = 80.  If IsMirrored is TRUE, however, an outbound
   packet will also match
   class, to represent the CompoundFilterCondition if its Destination IP
   address = 9.1.1.1 and its Destination port = 80.

   IsMirrored "flips" various attributes required.  Extensions of the following Source/Destination packet header fields:

     o   FlowDirection "In" / FlowDirection "Out"
     o   Source IP address / Destination IP address
     o   Source port / Destination port
     o   Source MAC address / Destination MAC address
     o   Source [layer-2] SAP / Destination [layer-2] SAP.

 5. Class Definitions

   The following definitions supplement those in PCIM itself.  PCIM
   definitions that are not DEPRECATED here are still current parts of the
   overall Policy Core Information Model.

 5.1. The Abstract Class "PolicySet"

   PolicySet is an
   abstract class that may group policies into PolicyValue, defined in this document, provide a structured
   set list of policies.

     NAME             PolicySet
     DESCRIPTION      An abstract class that represents
   values for basic network attributes.  Values can be used to represent
   constants as named values.  Named values can be kept in a set reusable policy
   container to be reused by multiple conditions.  Examples of policies
                      that form a coherent set. constants
   include well-known ports, well-known protocols, server addresses, and
   other similar concepts.

   The set PolicyValue subclasses define three basic types of contained
                      policies has a common decision strategy values: scalars,
   ranges and sets.  For example, a common
                      set of policy roles.  Subclasses include PolicyGroup
                      and PolicyRule.
     DERIVED FROM     Policy
     ABSTRACT         TRUE
     PROPERTIES       PolicyDecisionStrategy
                      PolicyRoles
   The PolicyDecisionStrategy property specifies well-known port number could be defined
   using the evaluation method PolicyIntegerValue class, defining a single value (80 for
   policy groups and rules contained within
   HTTP), a range (80-88), or a set (80, 82, 8080) of ports, respectively.
   For details, please see the policy set.

     NAME             PolicyDecisionStrategy
     DESCRIPTION      The evaluation method used class definition for policies contained each value type in
                      the PolicySet.  FirstMatching enforces the actions
   Section 5.14 of this document.

   PCIMe defines the first rule that evaluates to TRUE; AllMatching
                      enforces the actions of all rules that evaluate to
                      TRUE.
     SYNTAX           uint16
     VALUES           1 [FirstMatching], 2 [AllMatching]
     DEFAULT VALUE    1 [FirstMatching]

   The definition following subclasses of PolicyRoles is unchanged from PCIM.  It is, however,
   moved from the abstract class Policy up to PolicyValue:

   Classes for general use:

     - PolicyStringValue,
     - PolicyIntegerValue,
     - PolicyBitStringValue
     - PolicyBooleanValue.

   Classes for layer 3 Network values:

     - PolicyIPv4AddrValue,
     - PolicyIPv6AddrValue.

   Classes for layer 2 Network values:

     - PolicyMACAddrValue.

   For details, please see the superclass PolicySet.

 5.2. Update PCIM's Class "PolicyGroup"

   The PolicyGroup class is modified to be derived from PolicySet.

     NAME             PolicyGroup
     DESCRIPTION      A container definition section of each class in
   Section 5.14 of this document.

 4.9. Packet Filtering

   PCIMe contains two mechanisms for a set representing packet filters.  The more
   general of related PolicyRules these, termed here the domain-level model, expresses packet
   filters in terms of policy variables and
                      PolicyGroups.
     DERIVED FROM     PolicySet
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.3. Update PCIM's Class "PolicyRule" policy values.  The PolicyRule class is modified to be derived from PolicySet, and to
   deprecate other
   mechanism, termed here the use of Priority device-level model, expresses packet filters
   in a way that maps more directly to the rule.  PolicyRoles is now inherited
   from packet fields to which the parent class PolicySet.  Finally, a new property
   ExecutionStrategy
   filters are being applied.  While it is introduced, paralleling the property possible to map between these two
   representations of packet filters, no mapping is provided in PCIMe
   itself.

 4.9.1. Domain-Level Packet Filters

   In addition to filling in the same
   name holes in the class CompoundPolicyAction.

     NAME             PolicyRule
     DESCRIPTION      The central class overall Policy infrastructure,
   PCIMe proposes a single mechanism for expressing domain-level packet
   filters in policy conditions.  This is being done in response to concerns
   that even though the initial "wave" of submodels derived from PCIM were
   all filtering on IP packets, each was doing it in a slightly different
   way.  PCIMe proposes a common way to express IP packet filters.  The
   following figure illustrates how packet-filtering conditions are
   expressed in PCIMe.

                    +---------------------------------+
                    | CompoundFilterCondition         |
                    |   - IsMirrored   boolean        |
                    |   - ConditionListType (DNF|CNF) |
                    +---------------------------------+
                     +               +               +
                     +               +               +
                     +               +               +
                 SimplePC        SimplePC        SimplePC
                 *      @        *      @        *      @
                 *      @        *      @        *      @
                 *      @        *      @        *      @
     FlowDirection    "In"     SrcIP  <addr1>  DstIP  <addr2>

   Aggregation Legend:
     ++++  PolicyConditionInPolicyCondition
     ****  PolicyVariableInSimplePolicyCondition
     @@@@  PolicyValueInSimplePolicyCondition

   Figure 9.    Packet Filtering in Policy Conditions

   In Figure 9. , each SimplePolicyCondition represents a single field to be
   filtered on: Source IP address, Destination IP address, Source port, etc.
   An additional SimplePolicyCondition indicates the direction that a packet
   is traveling on an interface: inbound or outbound.  Because of the
   FlowDirection condition, care must be taken in aggregating a set of
   SimplePolicyConditions into a CompoundFilterCondition.  Otherwise, the
   resulting CompoundPolicyCondition may match all inbound packets, or all
   outbound packets, when this is probably not what was intended.

   Individual SimplePolicyConditions may be negated when they are aggregated
   by a CompoundFilterCondition.

   CompoundFilterCondition is a subclass of CompoundPolicyCondition.  It
   introduces one additional property, the Boolean property IsMirrored.  The
   purpose of this property is to allow a single CompoundFilterCondition to
   match packets traveling in both directions on a higher-level connection
   such as a TCP session.  When this property is TRUE, additional packets
   match a filter, beyond those that would ordinarily match it.  An example
   will illustrate how this property works.

   Suppose we have a CompoundFilterCondition that aggregates the following
   three filters, which are ANDed together:

     o   FlowDirection = "In"
     o   Source IP = 9.1.1.1
     o   Source Port = 80

   Regardless of whether IsMirrored is TRUE or FALSE, inbound packets will
   match this CompoundFilterCondition if their Source IP address = 9.1.1.1
   and their Source port = 80.  If IsMirrored is TRUE, however, an outbound
   packet will also match the CompoundFilterCondition if its Destination IP
   address = 9.1.1.1 and its Destination port = 80.

   IsMirrored "flips" the following Source/Destination packet header fields:

     o   FlowDirection "In" / FlowDirection "Out"
     o   Source IP address / Destination IP address
     o   Source port / Destination port
     o   Source MAC address / Destination MAC address
     o   Source [layer-2] SAP / Destination [layer-2] SAP.

 4.9.2. Device-Level Packet Filters

   At the device level, packet header filters are represented by two
   subclasses of the abstract class FilterEntryBase: IPHeaderFilter and
   8021Filter.  Submodels of PCIMe may define other subclasses of
   FilterEntryBase in addition to these two; ICIM [6], for example, defines
   subclasses for IPsec-specific filters.

   Instances of the subclasses of FilterEntryBase are not used directly as
   filters.  They are always aggregated into a FilterList, by the
   aggregation EntriesInFilterList.  For PCIMe and its submodels, the
   EntrySequence property in this aggregation always takes its default value
   '0', indicating that the aggregated filter entries are ANDed together.

   The FilterList class includes an enumeration property Direction,
   representing the direction of the traffic flow to which the FilterList is
   to be applied.  The value Mirrored(4) for Direction represents exactly
   the same thing as the IsMirrored boolean does in CompoundFilterCondition.
   See Section 4.9.1 for details.

 5. Class Definitions

   The following definitions supplement those in PCIM itself.  PCIM
   definitions that are not DEPRECATED here are still current parts of the
   overall Policy Core Information Model.

 5.1. The Abstract Class "PolicySet"

   PolicySet is an abstract class that may group policies into a structured
   set of policies.

     NAME             PolicySet
     DESCRIPTION      An abstract class that represents a set of policies
                      that form a coherent set.  The set of contained
                      policies has a common decision strategy and a common
                      set of policy roles.  Subclasses include PolicyGroup
                      and PolicyRule.
     DERIVED FROM     Policy
     ABSTRACT         TRUE
     PROPERTIES       PolicyDecisionStrategy
                      PolicyRoles

   The PolicyDecisionStrategy property specifies the evaluation method for
   policy groups and rules contained within the policy set.

     NAME             PolicyDecisionStrategy
     DESCRIPTION      The evaluation method used for policies contained in
                      the PolicySet.  FirstMatching enforces the actions of
                      the first rule that evaluates to TRUE; AllMatching
                      enforces the actions of all rules that evaluate to
                      TRUE.
     SYNTAX           uint16
     VALUES           1 [FirstMatching], 2 [AllMatching]
     DEFAULT VALUE    1 [FirstMatching]

   The definition of PolicyRoles is unchanged from PCIM.  It is, however,
   moved from the class Policy up to the superclass PolicySet.

 5.2. Update PCIM's Class "PolicyGroup"

   The PolicyGroup class is moved, so that it is now derived from PolicySet.

     NAME             PolicyGroup
     DESCRIPTION      A container for a set of related PolicyRules and
                      PolicyGroups.
     DERIVED FROM     PolicySet
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.3. Update PCIM's Class "PolicyRule"

   The PolicyRule class is moved, so that it is now derived from PolicySet.
   The Priority property is also deprecated in PolicyRule, and PolicyRoles
   is now inherited from the parent class PolicySet.  Finally, a new
   property ExecutionStrategy is introduced, paralleling the property of the
   same name in the class CompoundPolicyAction.

     NAME             PolicyRule
     DESCRIPTION      The central class for representing the "If Condition
                      then Action" semantics associated with "If Condition
                      then Action" semantics associated with a policy rule.
     DERIVED FROM     PolicySet
     ABSTRACT         FALSE
     PROPERTIES       Enabled
                      ConditionListType
                      RuleUsage
                      Priority DEPRECATED FOR PolicySetComponent.Priority
                                    AND FOR PolicySetInSystem.Priority
                      Mandatory
                      SequencedActions
                      ExecutionStrategy
   The property ExecutionStrategy defines the execution strategy to be used
   upon the sequenced actions aggregated by this PolicyRule. (An equivalent
   ExecutionStrategy property is also defined for the CompoundPolicyAction
   class, to provide the same indication for the sequenced actions
   aggregated by a CompoundPolicyAction.)  This draft defines three
   execution strategies:

     Do Until Success û execute actions according to predefined order, until
                        successful execution of a single action.
     Do All -           execute ALL actions which are part of the modeled
                        set, according to their predefined order. Continue
                        doing this, even if one or more of the actions
                        fails.
     Do Until Failure - execute actions according to predefined order, until
                        the first failure in execution of a single sub-
                        action.

   The property definition is as follows:

     NAME             ExecutionStrategy
     DESCRIPTION      An enumeration indicating how to interpret the action
                      ordering for the actions aggregated by this
                      PolicyRule.
     SYNTAX           uint16 (ENUM, {1=Do Until Success, 2=Do All, 3=Do
                      Until Failure} )
     DEFAULT VALUE    Do All (2)

 5.4. The Class "SimplePolicyCondition"

   A simple policy condition is composed of an ordered triplet:

     <Variable>  MATCH  <Value>

   No formal modeling of the MATCH operator is provided.  The 'match'
   relationship is implied.  Such simple conditions are evaluated by
   answering the question:

     Does <variable> match <value>?

   The 'match' relationship is to be interpreted by analyzing the variable
   and value instances associated with the simple condition.

   Simple conditions are building blocks for more complex Boolean
   Conditions, modeled by the CompoundPolicyCondition class.

   The SimplePolicyCondition class is derived from the PolicyCondition class
   defined in PCIM.

   A variable and a value must be associated with a simple condition to make
   it a meaningful condition, using, respectively, the aggregations
   PolicyVariableInSimplePolicyCondition and
   PolicyValueInSimplePolicyCondition.

   The class definition is as follows:

     NAME             SimplePolicyCondition
     DERIVED FROM     PolicyCondition
     ABSTRACT         False
     PROPERTIES       (none)

 5.5. The Class "CompoundPolicyCondition"

   This class represents a compound policy condition, formed by aggregation
   of simpler policy conditions.

     NAME             CompoundPolicyCondition
     DESCRIPTION      A subclass of PolicyCondition that introduces the
                      ConditionListType property, used for assigning DNF /
                      CNF semantics to subordinate policy conditions.
     DERIVED FROM     PolicyCondition
     ABSTRACT         FALSE
     PROPERTIES       ConditionListType

   The ConditionListType property is used to specify whether the list of
   policy conditions associated with this compound policy condition is in
   disjunctive normal form (DNF) or conjunctive normal form (CNF).  If this
   property is not present, the list type defaults to DNF.  The property
   definition is as follows:

     NAME             ConditionListType
     DESCRIPTION      Indicates whether the list of policy conditions
                      associated with this policy rule is in disjunctive
                      normal form (DNF) or conjunctive normal form (CNF).
     SYNTAX           uint16
     VALUES           DNF(1), CNF(2)
     DEFAULT VALUE    DNF(1)

 5.6. The Class "CompoundFilterCondition"

   This subclass of CompoundPolicyCondition introduces one additional
   property, the boolean IsMirrored.  This property turns on or off the
   "flipping" of corresponding source and destination fields in a filter
   specification.

     NAME             CompoundFilterCondition
     DESCRIPTION      A subclass of CompoundPolicyCondition that introduces
                      the IsMirrored property.
     DERIVED FROM     CompoundPolicyCondition
     ABSTRACT         FALSE
     PROPERTIES       IsMirrored

   The IsMirrored property indicates whether packets that "mirror" a
   compound filter condition should be treated as matching the filter.  The
   property definition is as follows:

     NAME             IsMirrored
     DESCRIPTION      Indicates whether packets that mirror the specified
                      filter are to be treated as matching the filter.
     SYNTAX           boolean
     DEFAULT VALUE    FALSE

 5.7. The Class "SimplePolicyAction"

   The SimplePolicyAction class models the elementary set operation. "SET
   <variable> TO <value>".  The set operator MUST overwrite an old value of
   the variable.

   Two aggregations are used in order to create the pair <variable> <value>.
   The aggregation PolicyVariableInSimplePolicyAction relates a policy rule.
   SimplePolicyAction to a single variable instance.  Similarly, the
   aggregation PolicyValueInSimplePolicyAction relates a SimplePolicyAction
   to a single value instance.  Both aggregations are defined in this
   document.

     NAME             SimplePolicyAction
     DESCRIPTION      A subclass of PolicyAction that introduces the notion
                      of "SET variable TO value".
     DERIVED FROM     PolicySet     PolicyAction
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.8. The Class "CompoundPolicyAction"

   The CompoundPolicyAction class is used to represent an expression
   consisting of an ordered sequence of action terms.  Each action term is
   represented as a subclass of the PolicyAction class, defined in [PCIM].
   Compound actions are constructed by associating dependent action terms
   together using the PolicyActionInPolicyAction aggregation.

   The class definition is as follows:

     NAME             CompoundPolicyAction
     DESCRIPTION      A class for representing sequenced action terms.  Each
                      action term is defined to be a subclass of the
                      PolicyAction class.
     DERIVED FROM     PolicyAction
     ABSTRACT         FALSE
     PROPERTIES       Enabled
                      ConditionListType
                      RuleUsage
                      Priority DEPRECATED FOR PolicySetComponent.Priority
                                    AND FOR PolicySetInSystem.Priority
                      Mandatory       SequencedActions
                      ExecutionStrategy

   This is a concrete class, and is therefore directly instantiable.

   The Property SequencedActions is identical to the SequencedActions
   property defined in PCIM for the class PolicyRule.

   The property ExecutionStrategy defines the execution strategy to be used
   upon the sequenced actions aggregated by associated with this PolicyRule. compound action. (An
   equivalent ExecutionStrategy property is also defined for the CompoundPolicyAction PolicyRule
   class, to provide the same indication for the sequenced actions
   aggregated by
   associated with a CompoundPolicyAction.) PolicyRule.)  This draft defines three execution
   strategies:

     Do Until Success û execute actions according to predefined order, until
                        successful execution of a single action. sub-action.
     Do All -           execute ALL actions which are part of the modeled
                        set, according to their predefined order. Continue
                        doing this, even if one or more of the actions sub-actions
                        fails.
     Do Until Failure - execute actions according to predefined order, until
                        the first failure in execution of a single sub-
                        action.

   The property definition is as follows:

     NAME             ExecutionStrategy
     DESCRIPTION      An enumeration indicating how to interpret the action
                      ordering for the actions aggregated by this
                      PolicyRule.
     SYNTAX           uint16 (ENUM, {1=Do Until Success, 2=Do All, 3=Do
                      Until Failure} )
     DEFAULT VALUE    Do All (2)

 5.4. The Class "SimplePolicyCondition"

   A simple policy condition is composed of an ordered triplet:

     <Variable>  MATCH  <Value>

   No formal modeling of the MATCH operator is provided.  The 'match'
   relationship is implied.  Such simple conditions are evaluated by
   answering the question:

     Does <variable> match <value>?

   The 'match' relationship is to be interpreted by analyzing the variable
   and value instances associated with the simple condition.

   Simple conditions are building blocks for more complex Boolean
   Conditions, modeled by the CompoundPolicyCondition class.

   The SimplePolicyCondition class is derived from the PolicyCondition class
   defined in PCIM.

   A variable and a value must be associated with a simple condition to make
   it a meaningful condition, using, respectively, the aggregations
   PolicyVariableInSimplePolicyCondition and
   PolicyValueInSimplePolicyCondition.

   The class definition is as follows:

     NAME             SimplePolicyCondition
     DERIVED FROM     PolicyCondition
     ABSTRACT         False
     PROPERTIES       (none)

 5.5. The Class "CompoundPolicyCondition"

   This class represents a compound policy condition, formed by aggregation
   of simpler policy conditions.

     NAME             CompoundPolicyCondition
     DESCRIPTION      A subclass of PolicyCondition that introduces the
                      ConditionListType property, used for assigning DNF /
                      CNF semantics to subordinate policy conditions.
     DERIVED FROM     PolicyCondition
     ABSTRACT         FALSE
     PROPERTIES       ConditionListType

   The ConditionListType property is used actions according to specify whether predefined order, until
                        the list of
   policy conditions associated with this compound policy condition is first failure in
   disjunctive normal form (DNF) execution of a single sub-
                        action.

   Since a CompoundPolicyAction may itself be aggregated either by a
   PolicyRule or conjunctive normal form (CNF). by another CompoundPolicyAction, its success or failure
   will be an input to the aggregating entity's execution strategy.
   Consequently, the following rules are specified, for determining whether
   a CompoundPolicyAction succeeds or fails:

     If this
   property is not present, the list type defaults to DNF.  The property
   definition CompoundPolicyAction's ExecutionStrategy is as follows:

     NAME             ConditionListType
     DESCRIPTION      Indicates whether Do Until Success,
     then
        o If one component action succeeds, then the list of policy conditions
                      associated with this policy rule CompoundPolicyAction
           succeeds.
        o If all component actions fail, then the CompoundPolicyAction
           fails.

     If the CompoundPolicyAction's ExecutionStrategy is in disjunctive
                      normal form (DNF) or conjunctive normal form (CNF).
     SYNTAX           uint16
     VALUES           DNF(1), CNF(2)
     DEFAULT VALUE    DNF(1)

 5.6. The Class "CompoundFilterCondition"

   This subclass of CompoundPolicyCondition introduces Do All, then
        o If all component actions succeed, then the CompoundPolicyAction
           succeeds.
        o If at least one additional
   property, component action fails, then the boolean IsMirrored.  This property turns on or off
           CompoundPolicyAction fails.

     If the
   "flipping" of corresponding source and destination fields in a filter
   specification.

     NAME             CompoundFilterCondition
     DESCRIPTION      A subclass of CompoundPolicyCondition that introduces CompoundPolicyAction's ExecutionStrategy is Do Until Failure,
     then
        o If all component actions succeed, then the IsMirrored property.
     DERIVED FROM     CompoundPolicyCondition
     ABSTRACT         FALSE
     PROPERTIES       IsMirrored

   The IsMirrored property indicates whether packets that "mirror" a
   compound filter condition should be treated as matching CompoundPolicyAction
           succeeds.
        o If at least one component action fails, then the filter.
           CompoundPolicyAction fails.

   The
   property definition of the ExecutionStrategy property is as follows:

     NAME             IsMirrored             ExecutionStrategy
     DESCRIPTION      Indicates whether packets that mirror the specified
                      filter are      An enumeration indicating how to be treated as matching interpret the filter. action
                      ordering for the actions aggregated by this
                      CompoundPolicyAction.
     SYNTAX           boolean           uint16 (ENUM, {1=Do Until Success, 2=Do All, 3=Do
                      Until Failure} )
     DEFAULT VALUE    FALSE

 5.7.    Do All (2)
 5.9. The Abstract Class "SimplePolicyAction" "PolicyVariable"

   Variables are used for building individual conditions.  The SimplePolicyAction class models variable
   specifies the elementary set operation. "SET
   <variable> TO <value>".  The set operator MUST overwrite an old value property of a flow or an event that should be matched when
   evaluating the variable.

   Two aggregations are used in order to create the pair <variable> <value>.
   The aggregation PolicyVariableInSimplePolicyAction relates condition.  However, not every combination of a
   SimplePolicyAction to variable
   and a single value creates a meaningful condition. For example, a source IP
   address variable instance.  Similarly, the
   aggregation PolicyValueInSimplePolicyAction relates can not be matched against a SimplePolicyAction
   to value that specifies a single port
   number.  A given variable selects the set of matchable value instance.  Both aggregations are defined in this
   document.

     NAME             SimplePolicyAction
     DESCRIPTION types.

   A subclass variable can have constraints that limit the set of PolicyAction values within a
   particular value type that introduces can be matched against it in a condition.  For
   example, a source-port variable limits the notion set of "SET values to represent
   integers to the range of 0-65535.  Integers outside this range cannot be
   matched to the source-port variable, even though they are of the correct
   data type.  Constraints for a given variable TO value".
     DERIVED FROM     PolicyAction
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.8. The Class "CompoundPolicyAction" are indicated through the
   ExpectedPolicyValuesForVariable association.

   The CompoundPolicyAction class PolicyVariable is used to represent an expression
   consisting of an ordered sequence of action terms.  Each action term is
   represented abstract class.  Implicit and explicit context
   variable classes are defined as a subclass sub classes of the PolicyAction class, PolicyVariable class.
   A set of implicit variables is defined in [PCIM].
   Compound actions are constructed by associating dependent action terms
   together using the PolicyActionInPolicyAction aggregation. this document as well.

   The class definition is as follows:

     NAME             CompoundPolicyAction
     DESCRIPTION      A class for representing sequenced action terms.  Each
                      action term is defined to be a subclass of the
                      PolicyAction class.             PolicyVariable
     DERIVED FROM     PolicyAction     Policy
     ABSTRACT         FALSE         TRUE
     PROPERTIES       SequencedActions
                      ExecutionStrategy

   This is a concrete class, and is therefore directly instantiable.       (none)

 5.10. The Property SequencedActions is identical to the SequencedActions
   property Class "PolicyExplicitVariable"

   Explicitly defined in PCIM for policy variables are evaluated within the class PolicyRule.

   The property ExecutionStrategy defines context of
   the execution strategy to be used
   upon CIM Schema and its modeling constructs.  The PolicyExplicitVariable
   class indicates the sequenced actions associated with this compound action. (An
   equivalent ExecutionStrategy exact model property is also defined for the PolicyRule
   class, to provide the same indication be evaluated or manipulated.
   See Section 4.8.6 for the sequenced actions
   associated with a PolicyRule.)  This draft defines three execution
   strategies:

     Do Until Success û execute actions according to predefined order, until
                        successful execution of a single sub-action.
     Do All -           execute ALL actions which are part complete discussion of what happens when the modeled
                        set, according to their predefined order. Continue
                        doing this, even if one or more
   values of the sub-actions
                        fails.
     Do Until Failure - execute actions according to predefined order, until ModelClass and ModelProperty properties in an instance of
   this class do not correspond to the first failure in execution characteristics of the model
   construct being evaluated or updated.

   The class definition is as follows:

     NAME             PolicyExplicitVariable
     DERIVED FROM     PolicyVariable
     ABSTRACT         False
     PROPERTIES       ModelClass, ModelProperty

 5.10.1. The Single-Valued Property "ModelClass"

   This property is a single sub-
                        action. string specifying the class name whose property is
   evaluated or set as a PolicyVariable.

   The property definition is defined as follows:

     NAME             ExecutionStrategy
     DESCRIPTION      An enumeration indicating how to interpret             ModelClass
     SYNTAX           String

 5.10.2. The Single-Valued Property ModelProperty

   This property is a string specifying the action
                      ordering for property name, within the actions aggregated by this
                      CompoundPolicyAction.
   ModelClass, which is evaluated or set as a PolicyVariable.  The property
   is defined as follows:

     NAME             ModelProperty
     SYNTAX           uint16 (ENUM, {1=Do Until Success, 2=Do All, 3=Do
                      Until Failure} )
     DEFAULT VALUE    Do All (2)

 5.9.           String

 5.11. The Abstract Class "PolicyVariable"

   Variables "PolicyImplicitVariable"

   Implicitly defined policy variables are used for building individual conditions.  The variable
   specifies evaluated outside of the property context
   of a flow or an event that should be matched when
   evaluating the condition.  However, not every combination CIM Schema and its modeling constructs.  Subclasses specify the
   data type and semantics of a variable the PolicyVariables.

   Interpretation and evaluation of a value creates a meaningful condition. PolicyImplicitVariable can vary,
   depending on the particular context in which it is used.  For example, a
   "SourceIP" address may denote the source IP address variable can not be matched against a value that specifies a port
   number.  A given variable selects field of an IP packet
   header, or the sender address delivered by an RSVP PATH message.

   The class definition is as follows:

     NAME             PolicyImplicitVariable
     DERIVED FROM     PolicyVariable
     ABSTRACT         True
     PROPERTIES       ValueTypes[ ]

 5.11.1. The Multi-Valued Property "ValueTypes"

   This property is a set of matchable value types.

   A variable can have constraints that limit the set strings specifying an unordered list of values within a
   particular value type
   possible value/data types that can be matched against it used in a condition.  For
   example, a source-port variable limits the set simple conditions and
   actions, with this variable.  The value types are specified by their
   class names (subclasses of values PolicyValue such as PolicyStringValue).  The
   list of class names enables an application to represent
   integers search on a specific name,
   as well as to ensure that the range data type of 0-65535.  Integers outside this range cannot be
   matched to the source-port variable, even though they are variable is of the correct
   data
   type.  Constraints

   The list of default ValueTypes for a given variable are indicated through the
   PolicyValueConstraintInVariable association. each subclass of
   PolicyImplicitVariable is specified within that variable's definition.

   The PolicyVariable property is an abstract class.  Implicit and explicit context
   variable classes are defined as sub classes follows:

     NAME             ValueTypes
     SYNTAX           String
 5.12. Subclasses of the PolicyVariable class.
   A set "PolicyImplicitVariable" Specified in PCIMe

   The following subclasses of implicit variables is PolicyImplicitVariable are defined in this document as well. PCIMe.

 5.12.1. The class definition is Class "PolicySourceIPv4Variable"

     NAME             PolicySourceIPv4Variable
     DESCRIPTION      The source IPv4 address. of the outermost IP packet
                      header.  "Outermost" here refers to the IP packet as follows:
                      it flows on the wire, before any headers have been
                      stripped from it.

                      ALLOWED VALUE TYPES:
                        - PolicyIPv4AddrValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.2. The Class "PolicySourceIPv6Variable"

     NAME             PolicyVariable             PolicySourceIPv6Variable
     DESCRIPTION      The source IPv6 address of the outermost IP packet
                      header.  "Outermost" here refers to the IP packet as
                      it flows on the wire, before any headers have been
                      stripped from it.

                      ALLOWED VALUE TYPES:
                        - PolicyIPv6AddrValue

     DERIVED FROM     Policy     PolicyImplicitVariable
     ABSTRACT         TRUE         FALSE
     PROPERTIES       (none)
 5.10.

 5.12.3. The Class "PolicyExplicitVariable"

   Explicitly defined policy variables are evaluated within the context of
   the CIM Schema and its modeling constructs. "PolicyDestinationIPv4Variable"

     NAME             PolicyDestinationIPv4Variable
     DESCRIPTION      The PolicyExplicitVariable
   class indicates destination IPv4 address of the exact model property outermost IP
                      packet header.  "Outermost" here refers to be evaluated or manipulated.

   The class definition is the IP
                      packet as follows:

     NAME             PolicyExplicitVariable it flows on the wire, before any headers
                      have been stripped from it.

                      ALLOWED VALUE TYPES:
                        - PolicyIPv4AddrValue

     DERIVED FROM     PolicyVariable     PolicyImplicitVariable
     ABSTRACT         False         FALSE
     PROPERTIES       ModelClass, ModelProperty

 5.10.1. The Single-Valued Property "ModelClass"

   This property is a string specifying the class name whose property is
   evaluated or set as a PolicyVariable.       (none)

 5.12.4. The property is defined as
   follows: Class "PolicyDestinationIPv6Variable"

     NAME             ModelClass
     SYNTAX           String

 5.10.2.             PolicyDestinationIPv6Variable
     DESCRIPTION      The Single-Valued Property ModelProperty

   This property is a string specifying destination IPv6 address of the property name, within outermost IP
                      packet header.  "Outermost" here refers to the
   ModelClass, which is evaluated or set as a PolicyVariable.  The property
   is defined IP
                      packet as follows:

     NAME             ModelProperty
     SYNTAX           String

 5.11. it flows on the wire, before any headers
                      have been stripped from it.

                      ALLOWED VALUE TYPES:
                        - PolicyIPv6AddrValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.5. The Abstract Class "PolicyImplicitVariable"

   Implicitly defined policy variables "PolicySourcePortVariable"

     NAME             PolicySourcePortVariable
     DESCRIPTION      Ports are evaluated outside of the context
   of the CIM Schema and its modeling constructs.  Subclasses specify the
   data type and semantics of defined as the PolicyVariables.

   Interpretation and evaluation of abstraction that transport
                      protocols use to distinguish among multiple
                      destinations within a PolicyImplicitVariable can vary,
   depending on the particular context in which it given host computer.  For TCP
                      and UDP flows, the PolicySourcePortVariable is used.  For example, a
   "SourceIP" address may denote
                      logically bound to the source address port field of an IP packet
   header, the
                      outermost UDP or TCP packet header.  "Outermost" here
                      refers to the sender address delivered by an RSVP PATH message.

   The class definition is IP packet as follows:

     NAME             PolicyImplicitVariable it flows on the wire,
                      before any headers have been stripped from it.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue (0..65535)

     DERIVED FROM     PolicyVariable     PolicyImplicitVariable
     ABSTRACT         True         FALSE
     PROPERTIES       ValueTypes[ ]
 5.11.1. The Multi-Valued Property "ValueTypes"

   This property is a set of strings specifying an unordered list of
   possible value/data types that can be used in simple conditions and
   actions, with this variable.       (none)

 5.12.6. The value types Class "PolicyDestinationPortVariable"

     NAME             PolicyDestinationPortVariable
     DESCRIPTION      Ports are specified by their
   class names (subclasses of PolicyValue such defined as PolicyStringValue).  The
   list of class names enables an application the abstraction that transport
                      protocols use to search on distinguish among multiple
                      destinations within a specific name,
   as well as given host computer.  For TCP
                      and UDP flows, the PolicyDestinationPortVariable is
                      logically bound to ensure that the data type destination port field of the variable is of
                      outermost UDP or TCP packet header.  "Outermost" here
                      refers to the correct
   type. IP packet as it flows on the wire,
                      before any headers have been stripped from it.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue (0..65535)

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)
 5.12.7. The Class "PolicyIPProtocolVariable"

     NAME             PolicyIPProtocolVariable
     DESCRIPTION      The IP protocol number.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.8. The Class "PolicyIPVersionVariable"

     NAME             PolicyIPVersionVariable
     DESCRIPTION      The IP version number.  The well-known values are 4
                      and 6.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.9. The list of default ValueTypes for each subclass of Class "PolicyIPToSVariable"

     NAME             PolicyIPToSVariable
     DESCRIPTION      The IP TOS octet.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue (0..7)
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable is specified within that variable's definition.
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.10. The property is defined as follows: Class "PolicyDSCPVariable"

     NAME             ValueTypes
     SYNTAX           String

 5.12. Subclasses of "PolicyImplicitVariable" Specified in PCIMe             PolicyDSCPVariable
     DESCRIPTION      The following subclasses of 6 bit Differentiated Service Code Point.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue (0..63)
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable are defined in PCIMe.

 5.12.1.
     ABSTRACT         FALSE
     PROPERTIES       (none)
 5.12.11. The Class "PolicySourceIPv4Variable" "PolicyFlowIdVariable"

     NAME             PolicySourceIPv4Variable             PolicyFlowIdVariable
     DESCRIPTION      The source IPv4 address. flow identifer of the outermost IP IPv6 packet
                      header.  "Outermost" here refers to the IP packet as
                      it flows on the wire, before any headers have been
                      stripped from it.

                      ALLOWED VALUE TYPES:
                        - PolicyIPv4AddrValue PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.2.

 5.12.12. The Class "PolicySourceIPv6Variable" "PolicySourceMACVariable"

     NAME             PolicySourceIPv6Variable             PolicySourceMACVariable
     DESCRIPTION      The source IPv6 address of the outermost IP packet
                      header. MAC address.

                      ALLOWED VALUE TYPES:
                        - PolicyIPv6AddrValue PolicyMACAddrValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.3.

 5.12.13. The Class "PolicyDestinationIPv4Variable" "PolicyDestinationMACVariable"

     NAME             PolicyDestinationIPv4Variable             PolicyDestinationMACVariable
     DESCRIPTION      The destination IPv4 address MAC address.

                      ALLOWED VALUE TYPES:
                        - PolicyMACAddrValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.14. The Class "PolicyVLANVariable"

     NAME             PolicyVLANVariable
     DESCRIPTION      The virtual Bridged Local Area Network Identifier, a
                      12-bit field as defined in the IEEE 802.1q standard.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.15. The Class "PolicyCoSVariable"

     NAME             PolicyCoSVariable
     DESCRIPTION      Class of Service, a 3-bit field, used in the outermost IP
                      packet header. layer 2
                      header to select the forwarding treatment.  Bound to
                      the IEEE 802.1q user-priority field.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.16. The Class "PolicyEthertypeVariable"

     NAME             PolicyEthertypeVariable
     DESCRIPTION      The Ethertype protocol number of Ethernet frames.

                      ALLOWED VALUE TYPES:
                        - PolicyIPv4AddrValue PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.4.

 5.12.17. The Class "PolicyDestinationIPv6Variable" "PolicySourceSAPVariable"

     NAME             PolicyDestinationIPv6Variable             PolicySourceSAPVariable
     DESCRIPTION      The destination IPv6 address Source Service Access Point (SAP) number of the outermost IP
                      packet
                      IEEE 802.2 LLC header.

                      ALLOWED VALUE TYPES:
                        - PolicyIPv6AddrValue PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.5.

 5.12.18. The Class "PolicySourcePortVariable" "PolicyDestinationSAPVariable"

     NAME             PolicySourcePortVariable             PolicyDestinationSAPVariable
     DESCRIPTION      Ports are defined as the abstraction that transport
                      protocols use to distinguish among multiple
                      destinations within a given host computer.  For TCP
                      and UDP flows, the PolicySourcePortVariable is
                      logically bound to the source port field      The Destination Service Access Point (SAP) number of
                      the
                      outermost UDP or TCP packet IEEE 802.2 LLC header.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue (0..65535)
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.6.

 5.12.19. The Class "PolicyDestinationPortVariable" "PolicySNAPVariable"

     NAME             PolicyDestinationPortVariable             PolicySNAPVariable
     DESCRIPTION      Ports are defined as the abstraction that transport
                      protocols use to distinguish among multiple
                      destinations within      The protocol number over a given host computer.  For TCP
                      and UDP flows, the PolicyDestinationPortVariable is
                      logically bound to the destination port field of the
                      outermost UDP or TCP packet header. Sub-Network Access Protocol
                      (SNAP) SAP encapsulation.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue (0..65535)
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.7.

 5.12.20. The Class "PolicyIPProtocolVariable" "PolicyFlowDirectionVariable"

     NAME             PolicyIPProtocolVariable             PolicyFlowDirectionVariable
     DESCRIPTION      The IP protocol number. direction of a flow relative to a network element.
                      Direction may be "IN" and/or "OUT".

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue PolicyStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.8.

   To match on both inbound and outbound flows, the associated
   PolicyStringValue object has two entries in its StringList property: "IN"
   and "OUT".

 5.13. The Abstract Class "PolicyIPVersionVariable"

     NAME             PolicyIPVersionVariable
     DESCRIPTION      The IP version number.  The well-known values "PolicyValue"

   This is an abstract class that serves as the base class for all
   subclasses that are 4 used to define value objects in the PCIMe.  It is
   used for defining values and 6.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue constants used in policy conditions.  The
   class definition is as follows:

     NAME             PolicyValue
     DERIVED FROM     PolicyImplicitVariable     Policy
     ABSTRACT         FALSE         True
     PROPERTIES       (none)

 5.12.9.
 5.14. Subclasses of "PolicyValue" Specified in PCIMe

   The following subsections contain the PolicyValue subclasses defined in
   PCIMe.  Additional subclasses may be defined in models derived from
   PCIMe.

 5.14.1. The Class "PolicyIPToSVariable"

     NAME             PolicyIPToSVariable
     DESCRIPTION "PolicyIPv4AddrValue"

   This class is used to provide a list of IPv4Addresses, hostnames and
   address range values to be matched against in a policy condition.  The IP TOS octet.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue (0..7)
                        - PolicyBitStringValue
   class definition is as follows:

     NAME             PolicyIPv4AddrValue
     DERIVED FROM     PolicyImplicitVariable     PolicyValue
     ABSTRACT         FALSE         False
     PROPERTIES       (none)

 5.12.10.       IPv4AddrList[ ]

   The Class "PolicyDSCPVariable"

     NAME             PolicyDSCPVariable
     DESCRIPTION IPv4AddrList property provides an unordered list of strings, each
   specifying a single IPv4 address, a hostname, or a range of IPv4
   addresses, according to the ABNF definition [8] of an IPv4 address, as
   specified below:

       IPv4address = 1*3DIGIT "." 1*3DIGIT "." 1*3DIGIT "." 1*3DIGIT
       IPv4prefix  = IPv4address "/" 1*2DIGIT
       IPv4range = IPv4address"-"IPv4address
       IPv4maskedaddress = IPv4address","IPv4address
       Hostname (as defined in [9])

   In the above definition, each string entry is either:

     1.  A single IPv4address in dot notation, as defined above.  Example:
         121.1.1.2

     2.  An IPv4prefix address range, as defined above, specified by an
         address and a prefix length, separated by "/".  Example:
         2.3.128.0/15

     3.  An IPv4range address range defined above, specified by a starting
         address in dot notation and an ending address in dot notation,
         separated by "-".  The range includes all addresses between the
         range's starting and ending addresses, including these two
         addresses.  Example: 1.1.22.1-1.1.22.5

     4.  An IPv4maskedaddress address range, as defined above, specified by
         an address and mask.  The 6 bit Differentiated Service Code Point.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue (0..63)
                        - PolicyBitStringValue
     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.11. address and mask are represented in dot
         notation, separated by a comma ",".  The Class "PolicyFlowIdVariable"

     NAME             PolicyFlowIdVariable
     DESCRIPTION masked address appears
         before the comma, and the mask appears after the comma.  Example:
         2.3.128.0,255.255.248.0.

     5.  A single Hostname.  The flow identifer Hostname format follows the guidelines and
         restrictions specified in [9].  Example: www.bigcompany.com.

   Conditions matching IPv4AddrValues evaluate to true according to the
   generic matching rules.  Additionally, a hostname is matched against
   another valid IPv4address representation by resolving the hostname into
   an IPv4 address first, and then comparing the addresses afterwards.
   Matching hostnames against each other is done using a string comparison
   of the outermost IPv6 packet
                      header.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.12. The Class "PolicySourceMACVariable"

     NAME             PolicySourceMACVariable
     DESCRIPTION      The source MAC address.

                      ALLOWED VALUE TYPES:
                        - PolicyMACAddrValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.13. two names.

   The Class "PolicyDestinationMACVariable" property definition is as follows:

     NAME             PolicyDestinationMACVariable
     DESCRIPTION      The destination MAC address.

                      ALLOWED VALUE TYPES:
                        - PolicyMACAddrValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.14.             IPv4AddrList
     SYNTAX           String
     FORMAT           IPv4address | IPv4prefix | IPv4range |
                      IPv4maskedaddress | hostname

 5.14.2. The Class "PolicyVLANVariable"

     NAME             PolicyVLANVariable
     DESCRIPTION      The virtual Bridged Local Area Network Identifier, "PolicyIPv6AddrValue

   This class is used to define a
                      12-bit field list of IPv6 addresses, hostnames, and
   address range values. The class definition is as defined in the IEEE 802.1q standard.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue follows:

     NAME             PolicyIPv6AddrValue
     DERIVED FROM     PolicyImplicitVariable     PolicyValue
     ABSTRACT         FALSE         False
     PROPERTIES       (none)

 5.12.15.       IPv6AddrList[ ]

   The Class "PolicyCoSVariable"

     NAME             PolicyCoSVariable
     DESCRIPTION      Class property IPv6AddrList provides an unordered list of Service, strings, each
   specifying an IPv6 address, a 3-bit field, used in the layer 2
                      header to select the forwarding treatment.  Bound to hostname, or a range of IPv6 addresses.
   IPv6 address format definition uses the IEEE 802.1q user-priority field.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.16. The Class "PolicyEthertypeVariable"

     NAME             PolicyEthertypeVariable
     DESCRIPTION standard address format defined
   in [10].  The Ethertype protocol number of Ethernet frames.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.17. ABNF definition [8] as specified in [10] is:

       IPv6address = hexpart [ ":" IPv4address ]
       IPv4address = 1*3DIGIT "." 1*3DIGIT "." 1*3DIGIT "." 1*3DIGIT
       IPv6prefix  = hexpart "/" 1*2DIGIT
       hexpart = hexseq | hexseq "::" [ hexseq ] | "::" [ hexseq ]
       hexseq  = hex4 *( ":" hex4)
       hex4    = 1*4HEXDIG
       IPv6range = IPv6address"-"IPv6address
       IPv6maskedaddress = IPv6address","IPv6address
       Hostname (as defines in [NAMES])

   Each string entry is either:

     1.  A single IPv6address as defined above.

     2.  A single Hostname.  Hostname format follows guidelines and
         restrictions specified in [9].

     3.  An IPv6range address range, specified by a starting address in dot
         notation and an ending address in dot notation, separated by "-".
         The Class "PolicySourceSAPVariable"

     NAME             PolicySourceSAPVariable
     DESCRIPTION range includes all addresses between the range's starting and
         ending addresses, including these two addresses.

     4.  An IPv4maskedaddress address range defined above specified by an
         address and mask. The Source Service Access Point (SAP) number address and mask are represented in dot
         notation separated by a comma ",".

     5.  A single IPv6prefix as defined above.

   Conditions matching IPv6AddrValues evaluate to true according to the
   generic matching rules.  Additionally, a hostname is matched against
   another valid IPv6address representation by resolving the hostname into
   an IPv6 address first, and then comparing the addresses afterwards.
   Matching hostnames against each other is done using a string comparison
   of the
                      IEEE 802.2 LLC header.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.18. two names.

 5.14.3. The Class "PolicyDestinationSAPVariable"

     NAME             PolicyDestinationSAPVariable
     DESCRIPTION      The Destination Service Access Point (SAP) number "PolicyMACAddrValue"

   This class is used to define a list of
                      the IEEE 802.2 LLC header.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.12.19. MAC addresses and MAC address
   range values.  The Class "PolicySNAPVariable" class definition is as follows:

     NAME             PolicySNAPVariable
     DESCRIPTION      The protocol number over a Sub-Network Access Protocol
                      (SNAP) SAP encapsulation.

                      ALLOWED VALUE TYPES:
                        - PolicyIntegerValue
                        - PolicyBitStringValue             PolicyMACAddrValue
     DERIVED FROM     PolicyImplicitVariable     PolicyValue
     ABSTRACT         FALSE         False
     PROPERTIES       (none)

 5.12.20. The Class "PolicyFlowDirectionVariable"

     NAME             PolicyFlowDirectionVariable
     DESCRIPTION       MACAddrList[ ]

   The direction property MACAddrList provides an unordered list of strings, each
   specifying a flow relative to MAC address or a network element.
                      Direction may be "IN" and/or "OUT".

                      ALLOWED VALUE TYPES:
                        - PolicyStringValue

     DERIVED FROM     PolicyImplicitVariable
     ABSTRACT         FALSE
     PROPERTIES       (none)

   To match on both inbound range of MAC addresses.  The 802 MAC
   address canonical format is used. The ABNF definition [8] is:

       MACaddress  = 1*4HEXDIG ":" 1*4HEXDIG ":" 1*4HEXDIG
       MACmaskedaddress = MACaddress","MACaddress

   Each string entry is either:

     1.  A single MAC address. Example: 0000:00A5:0000

     2.  A MACmaskedaddress address range defined specified by an address
         and outbound flows, mask.  The mask specifies the associated
   PolicyStringValue object has two entries relevant bits in its StringList property: "IN"
   and "OUT".

 5.13. the address.
         Example: 0000:00A5:0000,FFFF:FFFF:0000 defines a range of MAC
         addresses in which the first four octets are equal to 0000:00A5.

   The Abstract Class "PolicyValue"

   This property definition is an abstract class that serves as the base follows:

     NAME             MACAddrList
     SYNTAX           String
     FORMAT           MACaddress | MACmaskedaddress

 5.14.4. The Class "PolicyStringValue"

   This class for all
   subclasses that are is used to define represent a single string value, or a set of string
   values.  Each value objects in the PCIMe.  It is
   used for defining values and constants used in policy conditions. can have wildcards. The class definition is as
   follows:

     NAME             PolicyValue             PolicyStringValue
     DERIVED FROM     Policy     PolicyValue
     ABSTRACT         True         False
     PROPERTIES       (none)
 5.14. Subclasses       StringList[ ]

   The property StringList provides an unordered list of "PolicyValue" Specified in PCIMe strings, each
   representing a single string with wildcards.  The following subsections contain asterisk character "*"
   is used as a wildcard, and represents an arbitrary substring replacement.
   For example, the PolicyValue subclasses value "abc*def" matches the string "abcxyzdef", and the
   value "abc*def*" matches the string "abcxxxdefyyyzzz".  The syntax
   definition is identical to the substring assertion syntax defined in
   PCIMe.  Additional subclasses may
   [11].  If the asterisk character is required as part of the string value
   itself, it MUST be defined quoted as described in models derived from
   PCIMe.

 5.14.1. section 4.3 of [11].

   The property definition is as follows:

     NAME                 StringList
     SYNTAX               String

 5.14.5. The Class "PolicyIPv4AddrValue" "PolicyBitStringValue"

   This class is used to provide represent a list of IPv4Addresses, hostnames and
   address range values to be matched against in single bit string value, or a policy condition. set of
   bit string values.  The class definition is as follows:

     NAME             PolicyIPv4AddrValue             PolicyBitStringValue
     DERIVED FROM     PolicyValue
     ABSTRACT         False
     PROPERTIES       IPv4AddrList[       BitStringList[ ]

   The IPv4AddrList property BitStringList provides an unordered list of strings, each
   specifying
   representing a single IPv4 address, a hostname, bit string or a range set of IPv4
   addresses, according to bit strings.  The number of
   bits specified SHOULD equal the ABNF number of bits of the expected variable.
   For example, for a one-octet variable, 8 bits should be specified.  If
   the variable does not have a fixed length, the bit string should be
   matched against the variable's most significant bit string.  The formal
   definition [8] of an IPv4 address, as
   specified below:

       IPv4address = 1*3DIGIT "." 1*3DIGIT "." 1*3DIGIT "." 1*3DIGIT
       IPv4prefix a bit string is:

       binary-digit = IPv4address "/" 1*2DIGIT
       IPv4range "0" / "1"
       bitString = IPv4address"-"IPv4address
       IPv4maskedaddress 1*binary-digit
       maskedBitString = IPv4address","IPv4address
       Hostname (as defined in [9])

   In the above definition, each bitString","bitString

   Each string entry is either:

     1.  A single IPv4address in dot notation, as defined above. bit string. Example:
         121.1.1.2 00111010

     2.  An IPv4prefix address range, as defined above,  A range of bit strings specified by using a bit string and a bit
         mask.  The bit string and mask fields have the same number of bits
         specified.  The mask bit string specifies the significant bits in
         the bit string value.  For example, 110110, 100110 and 110111
         would match the maskedBitString 100110,101110 but 100100 would
         not.

   The property definition is as follows:

     NAME             BitStringList
     SYNTAX           String
     FORMAT           bitString | maskedBitString

 5.14.6. The Class "PolicyIntegerValue"

   This class provides a list of integer and integer range values.  Integers
   of arbitrary sizes can be represented.  The class definition is as
   follows:

     NAME             PolicyIntegerValue
     DERIVED FROM     PolicyValue
     ABSTRACT         False
     PROPERTIES       IntegerList[ ]

   The property IntegerList provides an
         address unordered list of integers and a prefix length, separated by "/".  Example:
         2.3.128.0/15

     3.
   integer range values, represented as strings.  The format of this
   property takes one of the following forms:

     1.  An IPv4range address integer value.

     2.  A range defined above, of integers. The range is specified by a starting
         address in dot notation integer
         and an ending address in dot notation, integer, separated by "-". '..'.  The starting integer
         MUST be less than or equal to the ending integer.  The range
         includes all addresses integers between the
         range's starting and ending addresses, integers,
         including these two
         addresses.  Example: 1.1.22.1-1.1.22.5

     4.  An IPv4maskedaddress address range, as defined above, specified by
         an address and mask.  The address and mask are represented in dot
         notation, separated by integers.

   To represent a comma ",".  The masked address appears
         before the comma, and the mask appears after range of integers that is not bounded, the comma.  Example:
         2.3.128.0,255.255.248.0.

     5.  A single Hostname.  The Hostname format follows reserved words
   -INFINITY and/or INFINITY can be used in place of the guidelines starting and
         restrictions specified in [9].  Example: www.bigcompany.com.

   Conditions matching IPv4AddrValues evaluate to true according ending
   integers.  In addition to the
   generic matching rules.  Additionally, a hostname is matched against
   another valid IPv4address representation by resolving the hostname into
   an IPv4 address first, ordinary integer matches, INFINITY matches
   INFINITY and then comparing -INFINITY matches -INFINITY.

   The ABNF definition [8] is:

     integer = [-]1*DIGIT | "INFINITY" | "-INFINITY"
     integerrange = integer".."integer

   Using ranges, the addresses afterwards.
   Matching hostnames against each other operators greater-than, greater-than-or-equal-to, less-
   than, and less-than-or-equal-to can be expressed.  For example, "X is-
   greater-than 5" (where X is done using a string comparison an integer) can be translated to "X matches
   6-INFINITY".  This enables the match condition semantics of the two names. operator
   for the SimplePolicyCondition class to be kept simple (i.e., just the
   value "match").

   The property definition is as follows:

     NAME             IPv4AddrList             IntegerList
     SYNTAX           String
     FORMAT           IPv4address | IPv4prefix | IPv4range |
                      IPv4maskedaddress           integer | hostname

 5.14.2. integerrange
 5.14.7. The Class "PolicyIPv6AddrValue "PolicyBooleanValue"

   This class is used to define represent a list of IPv6 addresses, hostnames, and
   address range values. Boolean (TRUE/FALSE) value.  The class
   definition is as follows:

     NAME             PolicyIPv6AddrValue             PolicyBooleanValue
     DERIVED FROM     PolicyValue
     ABSTRACT         False
     PROPERTIES       IPv6AddrList[ ]       BooleanValue

   The property IPv6AddrList provides an unordered list definition is as follows:

     NAME             BooleanValue
     SYNTAX           boolean

 5.15. The Class "PolicyRoleCollection"

   This class represents a collection of strings, each
   specifying an IPv6 address, managed elements that share a hostname, or
   common role. The PolicyRoleCollection always exists in the context of a range
   system, specified using the PolicyRoleCollectionInSystem association.
   The value of IPv6 addresses.
   IPv6 address format definition uses the standard address format defined PolicyRole property in [10].  The ABNF definition [8] as specified this class specifies the role,
   and can be matched with the value(s) in [10] is:

       IPv6address = hexpart [ ":" IPv4address ]
       IPv4address = 1*3DIGIT "." 1*3DIGIT "." 1*3DIGIT "." 1*3DIGIT
       IPv6prefix  = hexpart "/" 1*2DIGIT
       hexpart = hexseq | hexseq "::" [ hexseq ] | "::" [ hexseq ]
       hexseq  = hex4 *( ":" hex4)
       hex4    = 1*4HEXDIG
       IPv6range = IPv6address"-"IPv6address
       IPv6maskedaddress = IPv6address","IPv6address
       Hostname (as defines the PolicyRoles array in [NAMES])

   Each string entry
   PolicyRules and PolicyGroups.  ManagedElements that share the role
   defined in this collection are aggregated into the collection via the
   association ElementInPolicyRoleCollection.

     NAME             PolicyRoleCollection
     DESCRIPTION      A subclass of the CIM Collection class used to group
                      together managed elements that share a role.
     DERIVED FROM     Collection
     ABSTRACT         FALSE
     PROPERTIES       PolicyRole

 5.15.1. The Single-Valued Property "PolicyRole"

   This property represents the role associated with a PolicyRoleCollection.
   The property definition is either:

     1.  A single IPv6address as defined above.

     2. follows:

     NAME             PolicyRole
     DESCRIPTION      A single Hostname.  Hostname format follows guidelines and
         restrictions specified in [9].

     3.  An IPv6range address range, specified by string representing the role associated with a starting address in dot
         notation and
                      PolicyRoleCollection.
     SYNTAX           string

 5.16. The Class "ReusablePolicyContainer"

   The new class ReusablePolicyContainer is defined as follows:

     NAME             ReusablePolicyContainer
     DESCRIPTION      A class representing an ending address administratively defined
                      container for reusable policy-related information.
                      This class does not introduce any additional
                      properties beyond those in dot notation, separated by "-". its superclass AdminDomain.

                      It does, however, participate in a number of unique
                      associations.
     DERIVED FROM     AdminDomain
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.17. Deprecate PCIM's Class "PolicyRepository"

   The range includes all addresses between class definition of PolicyRepository (from PCIM) is updated as
   follows, with an indication that the range's starting and
         ending addresses, including these two addresses.

     4.  An IPv4maskedaddress address range defined above specified by class has been deprecated.  Note
   that when an
         address and mask. The address and mask are represented element of the model is deprecated, its replacement element
   is identified explicitly.

     NAME             PolicyRepository
     DEPRECATED FOR   ReusablePolicyContainer
     DESCRIPTION      A class representing an administratively defined
                      container for reusable policy-related information.
                      This class does not introduce any additional
                      properties beyond those in its superclass AdminDomain.
                      It does, however, participate in dot
         notation separated by a comma ",".

     5.  A single IPv6prefix number of unique
                      associations.
     DERIVED FROM     AdminDomain
     ABSTRACT         FALSE
     PROPERTIES       (none)

 5.18. The Abstract Class "FilterEntryBase"

   FilterEntryBase is the abstract base class from which all filter entry
   classes are derived.  It serves as defined above.

   Conditions matching IPv6AddrValues evaluate to true according to the
   generic matching rules.  Additionally, a hostname is matched against
   another valid IPv6address representation by resolving endpoint for the hostname
   EntriesInFilterList aggregation, which groups filter entries into
   an IPv6 address first, filter
   lists.  Its properties include CIM naming attributes and then comparing an IsNegated
   boolean property (to easily "NOT" the addresses afterwards.
   Matching hostnames against each other is done using a string comparison match information specified in an
   instance of the two names.

 5.14.3. The Class "PolicyMACAddrValue"

   This class is used to define a list one of MAC addresses and MAC address
   range values. its subclasses).

   The class definition is as follows:

          NAME             PolicyMACAddrValue                FilterEntryBase
          DESCRIPTION         An abstract class representing a single
                              filter that is aggregated into a
                              FilterList via the aggregation
                              EntriesInFilterList.
          DERIVED FROM     PolicyValue
     ABSTRACT         False        LogicalElement
          TYPE                Abstract
          PROPERTIES       MACAddrList[ ]          IsNegated

 5.19. The property MACAddrList provides Class "IPHeaderFilter"

   This concrete class makes it possible to represent an unordered list of strings, each
   specifying entire IP header
   filter in a MAC address single object.  A property IpVersion identifies whether the
   IP addresses in an instance are IPv4 or a range of MAC IPv6 addresses.  (Since the
   source and destination IP addresses come from the same packet header,
   they will always be of the same type.)
   The 802 MAC
   address canonical format is used. The ABNF class definition [8] is:

       MACaddress  = 1*4HEXDIG ":" 1*4HEXDIG ":" 1*4HEXDIG
       MACmaskedaddress = MACaddress","MACaddress

   Each string entry is either:

     1.  A single MAC address. Example: 0000:00A5:0000

     2. as follows:

          NAME                IPHeaderFilter
          DESCRIPTION         A MACmaskedaddress address range defined specified by class representing an address
         and mask.  The mask specifies the relevant bits in entire IP
                              header filter, or any subset of one.
          DERIVED FROM        FilterEntryBase
          TYPE                Concrete
          PROPERTIES          IpVersion, SrcAddress, SrcMask,
                              DestAddress, DestMask, ProtocolID,
                              SrcPortStart, SrcPortEnd,
                              DestPortStart, DestPortEnd, DSCP,
                              FlowLabel

 5.19.1. The Property IpVersion

   This property is an 8-bit unsigned integer, identifying the address.
         Example: 0000:00A5:0000,FFFF:FFFF:0000 defines a range version of MAC
   the IP addresses to be filtered on.  IP versions are identified as they
   are in which the first four octets Version field of the IP packet header - IPv4 = 4, IPv6 = 6.
   These two values are equal to 0000:00A5. the only ones defined for this property.

   The value of this property definition is determines the sizes of the OctetStrings in
   the four properties SrcAddress, SrcMask, DestAddress, and DestMask, as
   follows:

     NAME             MACAddrList
     SYNTAX           String
     FORMAT           MACaddress | MACmaskedaddress

 5.14.4.

     o IPv4:  OctetString(SIZE (4))
     o IPv6:  OctetString(SIZE (16|20)), depending on whether a scope
       identifier is present

 5.19.2. The Class "PolicyStringValue" Property SrcAddress

   This class property is used to represent a single string value, or an OctetString, of a set size determined by the value of string
   values.  Each the
   IpVersion property, representing a source IP address.  This value can have wildcards. The class definition is as
   follows:

     NAME             PolicyStringValue
     DERIVED FROM     PolicyValue
     ABSTRACT         False
     PROPERTIES       StringList[ ]
   compared to the source address in the IP header, subject to the mask
   represented in the SrcMask property.

 5.19.3. The Property SrcMask

   This property StringList provides is an unordered list OctetString, of strings, each a size determined by the value of the
   IpVersion property, representing a single string mask to be used in comparing the
   source address in the IP header with wildcards. the value represented in the
   SrcAddress property.

 5.19.4. The asterisk character "*" Property DestAddress

   This property is used as a wildcard, and represents an arbitrary substring replacement.
   For example, OctetString, of a size determined by the value "abc*def" matches the string "abcxyzdef", and of the
   IpVersion property, representing a destination IP address.  This value "abc*def*" matches is
   compared to the string "abcxxxdefyyyzzz". destination address in the IP header, subject to the mask
   represented in the DestMask property.

 5.19.5. The syntax
   definition Property DestMask

   This property is identical an OctetString, of a size determined by the value of the
   IpVersion property, representing a mask to be used in comparing the substring assertion syntax defined
   destination address in
   [11].  If the asterisk character is required as part of IP header with the string value
   itself, it MUST be quoted as described represented in section 4.3 of [11]. the
   DestAddress property.

 5.19.6. The Property ProtocolID

   This property definition is as follows:

     NAME                 StringList
     SYNTAX               String

 5.14.5. The Class "PolicyBitStringValue" an 8-bit unsigned integer, representing an IP protocol
   type.  This class value is used compared to represent a single bit string value, or a set of
   bit string values.  The class definition is as follows:

     NAME             PolicyBitStringValue
     DERIVED FROM     PolicyValue
     ABSTRACT         False
     PROPERTIES       BitStringList[ ] the Protocol field in the IP header.

 5.19.7. The Property SrcPortStart

   This property BitStringList provides an unordered list of strings, each
   representing is a single bit string or 16-bit unsigned integer, representing the lower end of
   a set range of bit strings. UDP or TCP source ports.  The number of
   bits specified SHOULD equal the number of bits upper end of the expected variable.
   For example, for a one-octet variable, 8 bits should be specified.  If
   the variable does not have a fixed length, range is
   represented by the bit string should SrcPortEnd property.  The value of SrcPortStart MUST
   be
   matched against no greater than the variable's most significant bit string.  The formal
   definition value of a bit string is:

       binary-digit = "0" / "1"
       bitString = 1*binary-digit
       maskedBitString = bitString","bitString

   Each string entry is either:

     1. SrcPortEnd.  A single bit string. Example: 00111010

     2. port is indicated
   by equal values for SrcPortStart and SrcPortEnd.

   A source port filter is evaluated by testing whether the source port
   identified in the IP header falls within the range of bit strings specified using values between
   SrcPortStart and SrcPortEnd, including these two end points.

 5.19.8. The Property SrcPortEnd

   This property is a bit string and 16-bit unsigned integer, representing the upper end of
   a bit
         mask. range of UDP or TCP source ports.  The bit string and mask fields have the same number lower end of bits
         specified. the range is
   represented by the SrcPortStart property.  The mask bit string specifies value of SrcPortEnd MUST
   be no less than the significant bits value of SrcPortStart.  A single port is indicated by
   equal values for SrcPortStart and SrcPortEnd.

   A source port filter is evaluated by testing whether the source port
   identified in the bit string value.  For example, 110110, 100110 and 110111
         would match IP header falls within the maskedBitString 100110,101110 but 100100 would
         not. range of values between
   SrcPortStart and SrcPortEnd, including these two end points.

 5.19.9. The Property DestPortStart

   This property definition is as follows:

     NAME             BitStringList
     SYNTAX           String
     FORMAT           bitString | maskedBitString

 5.14.6. The Class "PolicyIntegerValue"

   This class provides a list 16-bit unsigned integer, representing the lower end of integer and integer
   a range values.  Integers of arbitrary sizes can be represented.  The class definition is as
   follows:

     NAME             PolicyIntegerValue
     DERIVED FROM     PolicyValue
     ABSTRACT         False
     PROPERTIES       IntegerList[ ] UDP or TCP destination ports.  The property IntegerList provides an unordered list upper end of integers and
   integer the range values, is
   represented as strings. by the DestPortEnd property.  The format of this
   property takes one value of DestPortStart MUST
   be no greater than the following forms:

     1.  An integer value.

     2. value of DestPortEnd.  A single port is indicated
   by equal values for DestPortStart and DestPortEnd.

   A destination port filter is evaluated by testing whether the destination
   port identified in the IP header falls within the range of integers. values between
   DestPortStart and DestPortEnd, including these two end points.

 5.19.10. The range Property DestPortEnd

   This property is specified by a starting integer
         and an ending 16-bit unsigned integer, separated representing the upper end of
   a range of UDP or TCP destination ports.  The lower end of the range is
   represented by '..'. the DestPortStart property.  The starting integer value of DestPortEnd MUST
   be no less than or the value of DestPortStart.  A single port is indicated
   by equal to values for DestPortStart and DestPortEnd.

   A destination port filter is evaluated by testing whether the destination
   port identified in the IP header falls within the ending integer.  The range
         includes all integers of values between the starting
   DestPortStart and ending integers, DestPortEnd, including these two integers.

   To represent end points.

 5.19.11. The Property DSCP

   The property DSCP is defined as a uint8, restricted to the range of integers that 0..63.
   Since DSCPs are defined as discrete code points, with no inherent
   structure, there is not bounded, the reserved words
   -INFINITY and/or INFINITY can be used in place no semantically significant relationship between
   different DSCPs.  Consequently, there is no provision for specifying a
   range of the starting and ending
   integers.  In addition to ordinary integer matches, INFINITY matches
   INFINITY and -INFINITY matches -INFINITY. DSCPs in this property.

 5.19.12. The ABNF definition [8] is:

     integer = [-]1*DIGIT | "INFINITY" | "-INFINITY"
     integerrange = integer".."integer

   Using ranges, Property FlowLabel

   The 20-bit Flow Label field in the operators greater-than, greater-than-or-equal-to, less-
   than, and less-than-or-equal-to can be expressed.  For example, "X is-
   greater-than 5" (where X is an integer) can IPv6 header may be translated used by a source to "X matches
   6-INFINITY".
   label sequences of packets for which it requests special handling by IPv6
   devices, such as non-default quality of service or 'real-time' service.
   This enables the match condition semantics property is an octet string of size 3 (that is, 24 bits), in which
   the operator
   for 20-bit Flow Label appears in the SimplePolicyCondition class to be kept simple (i.e., just rightmost 20 bits, padded on the
   value "match").

   The property definition is as follows:

     NAME             IntegerList
     SYNTAX           String
     FORMAT           integer | integerrange
 5.14.7.
   left with b'0000'.

 5.20. The Class "PolicyBooleanValue" "8021Filter"

   This concrete class is used allows 802.1.source and destination MAC addresses, as
   well as the 802.1 protocol ID, priority, and VLAN identifier fields, to represent
   be expressed in a Boolean (TRUE/FALSE) value. single object

   The class definition is as follows:

      NAME             PolicyBooleanValue                8021Filter
      DESCRIPTION         A class that allows 802.1 source
                          and destination MAC address and
                          protocol ID, priority, and VLAN
                          identifier filters to be
                          expressed in a single object.
      DERIVED FROM     PolicyValue
     ABSTRACT         False        FilterEntryBase
      TYPE                Concrete
      PROPERTIES       BooleanValue          SrcMACAddr, SrcMACMask, DestMACAddr,
                          DestMACMask, ProtocolID, PriorityValue,
                          VLANID

 5.20.1. The Property SrcMACAddr

   This property definition is as follows:

     NAME             BooleanValue
     SYNTAX           boolean

 5.15. an OctetString of size 6, representing a 48-bit source
   MAC address in canonical format.  This value is compared to the
   SourceAddress field in the MAC header, subject to the mask represented in
   the SrcMACMask property.

 5.20.2. The Class "PolicyRoleCollection" Property SrcMACMask

   This class represents a collection property is an OctetString of managed elements that share size 6, representing a
   common role. 48-bit mask to
   be used in comparing the SourceAddress field in the MAC header with the
   value represented in the SrcMACAddr property.

 5.20.3. The PolicyRoleCollection always exists Property DestMACAddr

   This property is an OctetString of size 6, representing a 48-bit
   destination MAC address in canonical format.  This value is compared to
   the DestinationAddress field in the context MAC header, subject to the mask
   represented in the DestMACMask property.

 5.20.4. The Property DestMACMask

   This property is an OctetString of size 6, representing a
   system, specified using 48-bit mask to
   be used in comparing the PolicyRoleCollectionInSystem association. DestinationAddress field in the MAC header with
   the value represented in the DestMACAddr property.

 5.20.5. The Property ProtocolID

   This property is a 16-bit unsigned integer, representing an Ethernet
   protocol type.  This value of is compared to the PolicyRole Ethernet Type field in the
   802.3 MAC header.

 5.20.6. The Property PriorityValue

   This property is an 8-bit unsigned integer, representing an 802.1Q
   priority.  This value is compared to the Priority field in the 802.1Q
   header.  Since the 802.1Q Priority field consists of 3 bits, the values
   for this class specifies property are limited to the role,
   and can be matched with range 0..7.

 5.20.7. The Property VLANID

   This property is a 32-bit unsigned integer, representing an 802.1Q VLAN
   Identifier.  This value is compared to the value(s) VLAN ID field in the PolicyRoles array in
   PolicyRules and PolicyGroups.  ManagedElements that share 802.1Q
   header.  Since the role
   defined in 802.1Q VLAN ID field consists of 12 bits, the values
   for this collection property are aggregated into the collection via limited to the
   association ElementInPolicyRoleCollection.

     NAME             PolicyRoleCollection
     DESCRIPTION      A subclass range 0..4095.

 5.21. The Class FilterList

   This is a concrete class that aggregates instances of (subclasses of)
   FilterEntryBase via the CIM Collection class used aggregation EntriesInFilterList.  It is possible
   to group
                      together managed elements that share aggregate different types of filters into a role.
     DERIVED FROM     Collection
     ABSTRACT         FALSE
     PROPERTIES       PolicyRole

 5.15.1. single FilterList - for
   example, packet header filters (represented by the IPHeaderFilter class)
   and security filters (represented by subclasses of FilterEntryBase
   defined by IPsec).

   The Single-Valued Property "PolicyRole"

   This aggregation property represents EntriesInFilterList.EntrySequence serves to
   order the role associated with filter entries in a PolicyRoleCollection.
   The property definition FilterList.  This is necessary when
   algorithms such as follows:

     NAME             PolicyRole
     DESCRIPTION      A string representing "Match First" are used to identify traffic based on an
   aggregated set of FilterEntries.  In modeling QoS classifiers, however,
   this property is always set to 0, to indicate that the role associated with aggregated filter
   entries are ANDed together to form a
                      PolicyRoleCollection.
     SYNTAX           string

 5.16. The Class "ReusablePolicyContainer" selector for a class of traffic.

   The new class ReusablePolicyContainer definition is defined as follows:

          NAME             ReusablePolicyContainer                FilterList
          DESCRIPTION         A concrete class representing an administratively defined
                      container for reusable policy-related information.
                      This class does not introduce any additional
                      properties beyond those in its superclass AdminDomain.

                      It does, however, participate in a number
                              the aggregation of unique
                      associations. multiple filters.
          DERIVED FROM     AdminDomain
     ABSTRACT         FALSE        LogicalElement
          TYPE                Concrete
          PROPERTIES       (none)

 5.17. Deprecate PCIM's Class "PolicyRepository"          Direction

 5.21.1. The class definition Property Direction

   This property is a 16-bit unsigned integer enumeration, representing the
   direction of PolicyRepository (from PCIM) the traffic flow to which the FilterList is to be applied.
   Defined enumeration values are

     o  NotApplicable(0)
     o  Input(1)
     o  Output(2)
     o  Both(3) - This value is updated as
   follows, with an indication used to indicate that the class has been deprecated.  Note
   that when an element direction is
        immaterial, e.g., to filter on a source subnet regardless of
        whether the model is deprecated, its replacement element flow is identified explicitly.

     NAME             PolicyRepository
     DEPRECATED FOR   ReusablePolicyContainer
     DESCRIPTION      A class representing an administratively defined
                      container for reusable policy-related information. inbound or outbound
     o  Mirrored(4) - This class does not introduce any additional
                      properties beyond those value is also applicable to both inbound and
        outbound flow processing, but it indicates that the filter criteria
        are applied asymmetrically to traffic in its superclass AdminDomain.
                      It does, however, participate both directions and, thus,
        specifies the reversal of source and destination criteria (as
        opposed to the equality of these criteria as indicated by "Both").
        The match conditions in the aggregated FilterEntryBase subclass
        instances are defined from the perspective of outbound flows and
        applied to inbound flows as well by reversing the source and
        destination criteria.  So, for example, consider a number FilterList with
        3 filter entries indicating destination port = 80, and source and
        destination addresses of unique
                      associations.
     DERIVED FROM     AdminDomain
     ABSTRACT         FALSE
     PROPERTIES       (none) a and b, respectively.  Then, for the
        outbound direction, the filter entries match as specified and the
        'mirror' (for the inbound direction) matches on source port = 80
        and source and destination addresses of b and a, respectively.

 6. Association and Aggregation Definitions

   The following definitions supplement those in PCIM itself.  PCIM
   definitions that are not DEPRECATED here are still current parts of the
   overall Policy Core Information Model.

 6.1. The Aggregation "PolicySetComponent"

   PolicySetComponent is a new aggregation class that collects instances of
   PolicySet subclasses (PolicyGroups and PolicyRules) into coherent sets of
   policies.

     NAME             PolicySetComponent
     DESCRIPTION      A concrete class representing the components of a
                      policy set that have the same decision strategy, and
                      are prioritized within the set.
     DERIVED FROM     PolicyComponent
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref PolicySet[0..n]]
                      PartComponent[ref PolicySet[0..n]]
                      Priority

   The definition of the Priority property is unchanged from its previous
   definition in [PCIM].

     NAME             Priority
     DESCRIPTION      A non-negative integer for prioritizing this PolicySet
                      component relative to other components of the same
                      PolicySet.  A larger value indicates a higher
                      priority.
     SYNTAX           uint16
     DEFAULT VALUE    0

 6.2. Deprecate PCIM's Aggregation "PolicyGroupInPolicyGroup"

 The new aggregation PolicySetComponent is used directly to represent
 aggregation of PolicyGroups by a higher-level PolicyGroup.  Thus the
 aggregation PolicyGroupInPolicyGroup is no longer needed, and can be
 deprecated.

     NAME             PolicyGroupInPolicyGroup
     DEPRECATED FOR   PolicySetComponent
     DESCRIPTION      A class representing the aggregation of PolicyGroups
                      by a higher-level PolicyGroup.
     DERIVED FROM     PolicyComponent
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref PolicyGroup[0..n]]
                      PartComponent[ref PolicyGroup[0..n]]

 6.3. Deprecate PCIM's Aggregation "PolicyRuleInPolicyGroup"

   The new aggregation PolicySetComponent is used directly to represent
   aggregation of PolicyRules by a PolicyGroup.  Thus the aggregation
   PolicyRuleInPolicyGroup is no longer needed, and can be deprecated.

     NAME             PolicyRuleInPolicyGroup
     DEPRECATED FOR   PolicySetComponent
     DESCRIPTION      A class representing the aggregation of PolicyRules by
                      a PolicyGroup.
     DERIVED FROM     PolicyComponent
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref PolicyGroup[0..n]]
                      PartComponent[ref PolicyRule[0..n]]
 6.4. The Abstract Association "PolicySetInSystem"

   PolicySetInSystem is a new association that defines a relationship
   between a System and a PolicySet used in the administrative scope of that
   system (e.g., AdminDomain, ComputerSystem).  The Priority property is
   used to assign a relative priority to a PolicySet within the
   administrative scope in contexts where it is not a component of another
   PolicySet.

     NAME             PolicySetInSystem
     DESCRIPTION      An abstract class representing the relationship
                      between a System and a PolicySet that is used in the
                      administrative scope of the System.
     DERIVED FROM     PolicyInSystem
     ABSTRACT         TRUE
     PROPERTIES       Antecedent[ref System[0..1]]
                      Dependent [ref PolicySet[0..n]]
                      Priority

   The Priority property is used to specify the relative priority of the
   referenced PolicySet when there are more than one PolicySet instances
   applied to a managed resource that are not PolicySetComponents and,
   therefore, have no other relative priority defined.

     NAME             Priority
     DESCRIPTION      A non-negative integer for prioritizing the referenced
                      PolicySet among other PolicySet instances that are not
                      components of a common PolicySet.  A larger value
                      indicates a higher priority.
     SYNTAX           uint16
     DEFAULT VALUE    0

 6.5. Update PCIM's Weak Association "PolicyGroupInSystem"

   Regardless of whether it a component of another PolicySet, a PolicyGroup
   is itself defined within the scope of a System.  This association links a
   PolicyGroup to the System in whose scope the PolicyGroup is defined. It
   is a subclass of the abstract PolicySetInSystem association. The class
   definition for the association is as follows:

     NAME             PolicyGroupInSystem
     DESCRIPTION      A class representing the fact that a PolicyGroup is
                      defined within the scope of a System.
     DERIVED FROM     PolicySetInSystem
     ABSTRACT         FALSE
     PROPERTIES       Antecedent[ref System[1..1]]
                      Dependent     [ref PolicyGroup[weak]]
   The Reference "Antecedent" is inherited from PolicySetInSystem, and
   overridden to restrict its cardinality to [1..1]. It serves as an object
   reference to a System that provides a scope for one or more PolicyGroups.
   Since this is a weak association, the cardinality for this object
   reference is always 1, that is, a PolicyGroup is always defined within
   the scope of exactly one System.

   The Reference "Dependent" is inherited from PolicySetInSystem, and
   overridden to become an object reference to a PolicyGroup defined within
   the scope of a System. Note that for any single instance of the
   association class PolicyGroupInSystem, this property (like all reference
   properties) is single-valued. The [0..n] cardinality indicates that a
   given System may have 0, 1, or more than one PolicyGroups defined within
   its scope.

 6.6. Update PCIM's Weak Association "PolicyRuleInSystem"

   Regardless of whether it a component of another PolicySet, a PolicyRule
   is itself defined within the scope of a System.  This association links a
   PolicyRule to the System in whose scope the PolicyRule is defined. It is
   a subclass of the abstract PolicySetInSystem association. The class
   definition for the association is as follows:

     NAME             PolicyRuleInSystem
     DESCRIPTION      A class representing the fact that a PolicyRule is
                      defined within the scope of a System.
     DERIVED FROM     PolicySetInSystem
     ABSTRACT         FALSE
     PROPERTIES       Antecedent[ref System[1..1]]
                      Dependent[ref PolicyRule[weak]]

   The Reference "Antecedent" is inherited from PolicySetInSystem, and
   overridden to restrict its cardinality to [1..1]. It serves as an object
   reference to a System that provides a scope for one or more PolicyRules.
   Since this is a weak association, the cardinality for this object
   reference is always 1, that is, a PolicyRule is always defined within the
   scope of exactly one System.

   The Reference "Dependent" is inherited from PolicySetInSystem, and
   overridden to become an object reference to a PolicyRule defined within
   the scope of a System. Note that for any single instance of the
   association class PolicyRuleInSystem, this property (like all Reference
   properties) is single-valued. The [0..n] cardinality indicates that a
   given System may have 0, 1, or more than one PolicyRules defined within
   its scope.

 6.7. The Abstract Aggregation "CompoundedPolicyCondition" "PolicyConditionStructure"

     NAME             CompoundedPolicyCondition             PolicyConditionStructure
     DESCRIPTION      A class representing the aggregation of
                      PolicyConditions by an aggregating instance.
     DERIVED FROM     PolicyComponent
     ABSTRACT         TRUE
     PROPERTIES       PartComponent[ref PolicyCondition[0..n]]
                      GroupNumber
                      ConditionNegated

 6.8. Update PCIM's Aggregation "PolicyConditionInPolicyRule"

   The PCIM aggregation "PolicyConditionInPolicyRule" is updated, to make it
   a subclass of the new abstract aggregation CompoundedPolicyCondition. PolicyConditionStructure.  The
   properties GroupNumber and ConditionNegated are now inherited, rather
   than specified explicitly as they were in PCIM.

     NAME             PolicyConditionInPolicyRule
     DESCRIPTION      A class representing the aggregation of
                      PolicyConditions by a PolicyRule.
     DERIVED FROM     CompoundedPolicyCondition     PolicyConditionStructure
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref PolicyRule[0..n]]

 6.9. The Aggregation "PolicyConditionInPolicyCondition"

   A second subclass of CompoundedPolicyCondition PolicyConditionStructure is defined, representing
   the compounding of policy conditions into a higher-level policy
   condition.

     NAME             PolicyConditionInPolicyCondition
     DESCRIPTION      A class representing the aggregation of
                      PolicyConditions by another PolicyCondition.
     DERIVED FROM     CompoundedPolicyCondition     PolicyConditionStructure
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref CompoundPolicyCondition[0..n]]

 6.10. The Abstract Aggregation "CompoundedPolicyAction" "PolicyActionStructure"

     NAME             CompoundedPolicyAction             PolicyActionStructure
     DESCRIPTION      A class representing the aggregation of PolicyActions
                      by an aggregating instance.
     DERIVED FROM     PolicyComponent
     ABSTRACT         TRUE
     PROPERTIES       PartComponent[ref PolicyAction[0..n]]
                      ActionOrder

   The definition of the ActionOrder property appears in Section 7.8.3 of
   PCIM [3].

 6.11. Update PCIM's Aggregation "PolicyActionInPolicyRule"

   The PCIM aggregation "PolicyActionInPolicyRule" is updated, to make it a
   subclass of the new abstract aggregation CompoundedPolicyAction. PolicyActionStructure.  The
   property ActionOrder is now inherited, rather than specified explicitly
   as it was in PCIM.

     NAME             PolicyActionInPolicyRule
     DESCRIPTION      A class representing the aggregation of PolicyActions
                      by a PolicyRule.
     DERIVED FROM     CompoundedPolicyAction     PolicyActionStructure
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref PolicyRule[0..n]]

 6.12. The Aggregation "PolicyActionInPolicyAction"

   A second subclass of CompoundedPolicyAction PolicyActionStructure is defined, representing the
   compounding of policy actions into a higher-level policy action.

     NAME             PolicyActionInPolicyAction
     DESCRIPTION      A class representing the aggregation of PolicyActions
                      by another PolicyAction.
     DERIVED FROM     CompoundedPolicyAction     PolicyActionStructure
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref CompoundPolicyAction[0..n]]

 6.13. The Aggregation "PolicyVariableInSimplePolicyCondition"

   A simple policy condition is represented as an ordered triplet {variable,
   operator, value}.  This aggregation provides the linkage between a
   SimplePolicyCondition instance and a single PolicyVariable.  The
   aggregation PolicyValueInSimplePolicyCondition links the
   SimplePolicyCondition to a single PolicyValue.  The Operator property of
   SimplePolicyCondition represents the third element of the triplet, the
   operator.

   The class definition for this aggregation is as follows:

     NAME             PolicyVariableInSimplePolicyCondition
     DERIVED FROM     PolicyComponent
     ABSTRACT         False
     PROPERTIES       GroupComponent[ref SimplePolicyCondition[0..n]]
                      PartComponent[ref PolicyVariable[1..1] ]

   The reference property "GroupComponent" is inherited from
   PolicyComponent, and overridden to become an object reference to a
   SimplePolicyCondition that contains exactly one PolicyVariable.  Note
   that for any single instance of the aggregation class
   PolicyVariableInSimplePolicyCondition, this property is single-valued.
   The [0..n] cardinality indicates that there may be 0, 1, or more
   SimplePolicyCondition objects that contain any given policy variable
   object.

   The reference property "PartComponent" is inherited from PolicyComponent,
   and overridden to become an object reference to a PolicyVariable that is
   defined within the scope of a SimplePolicyCondition.  Note that for any
   single instance of the association class
   PolicyVariableInSimplePolicyCondition, this property (like all reference
   properties) is single-valued.  The [1..1] cardinality indicates that a
   SimplePolicyCondition must have exactly one policy variable defined
   within its scope in order to be meaningful.

 6.14. The Aggregation "PolicyValueInSimplePolicyCondition"

   A simple policy condition is represented as an ordered triplet {variable,
   operator, value}.  This aggregation provides the linkage between a
   SimplePolicyCondition instance and a single PolicyValue.  The aggregation
   PolicyVariableInSimplePolicyCondition links the SimplePolicyCondition to
   a single PolicyVariable.  The Operator property of SimplePolicyCondition
   represents the third element of the triplet, the operator.

   The class definition for this aggregation is as follows:

     NAME             PolicyValueInSimplePolicyCondition
     DERIVED FROM     PolicyComponent
     ABSTRACT         False
     PROPERTIES       GroupComponent[ref SimplePolicyCondition[0..n]]
                      PartComponent[ref PolicyValue[1..1] ]

   The reference property "GroupComponent" is inherited from
   PolicyComponent, and overridden to become an object reference to a
   SimplePolicyCondition that contains exactly one PolicyValue.  Note that
   for any single instance of the aggregation class
   PolicyValueInSimplePolicyCondition, this property is single-valued.  The
   [0..n] cardinality indicates that there may be 0, 1, or more
   SimplePolicyCondition objects that contain any given policy value object.

   The reference property "PartComponent" is inherited from PolicyComponent,
   and overridden to become an object reference to a PolicyValue that is
   defined within the scope of a SimplePolicyCondition.  Note that for any
   single instance of the association class
   PolicyValueInSimplePolicyCondition, this property (like all reference
   properties) is single-valued.  The [1..1] cardinality indicates that a
   SimplePolicyCondition must have exactly one policy value defined within
   its scope in order to be meaningful.

 6.15. The Aggregation "PolicyVariableInSimplePolicyAction"

   A simple policy action is represented as a pair {variable, value}. This
   aggregation provides the linkage between a SimplePolicyAction instance
   and a single PolicyVariable.  The aggregation
   PolicyValueInSimplePolicyAction links the SimplePolicyAction to a single
   PolicyValue.

   The class definition for this aggregation is as follows:

     NAME             PolicyVariableInSimplePolicyAction
     DERIVED FROM     PolicyComponent
     ABSTRACT         False
     PROPERTIES       GroupComponent[ref SimplePolicyAction[0..n]]
                      PartComponent[ref PolicyVariable[1..1] ]

   The reference property "GroupComponent" is inherited from
   PolicyComponent, and overridden to become an object reference to a
   SimplePolicyAction that contains exactly one PolicyVariable.  Note that
   for any single instance of the aggregation class
   PolicyVariableInSimplePolicyAction, this property is single-valued.  The
   [0..n] cardinality indicates that there may be 0, 1, or more
   SimplePolicyAction objects that contain any given policy variable object.

   The reference property "PartComponent" is inherited from PolicyComponent,
   and overridden to become an object reference to a PolicyVariable that is
   defined within the scope of a SimplePolicyAction.  Note that for any
   single instance of the association class
   PolicyVariableInSimplePolicyAction, this property (like all reference
   properties) is single-valued.  The [1..1] cardinality indicates that a
   SimplePolicyAction must have exactly one policy variable defined within
   its scope in order to be meaningful.

 6.16. The Aggregation "PolicyValueInSimplePolicyAction"

   A simple policy action is represented as a pair {variable, value}.  This
   aggregation provides the linkage between a SimplePolicyAction instance
   and a single PolicyValue.  The aggregation
   PolicyVariableInSimplePolicyAction links the SimplePolicyAction to a
   single PolicyVariable.

   The class definition for this aggregation is as follows:

     NAME             PolicyValueInSimplePolicyAction
     DERIVED FROM     PolicyComponent
     ABSTRACT         False
     PROPERTIES       GroupComponent[ref SimplePolicyAction[0..n]]
                      PartComponent[ref PolicyValue[1..1] ]

   The reference property "GroupComponent" is inherited from
   PolicyComponent, and overridden to become an object reference to a
   SimplePolicyAction that contains exactly one PolicyValue.  Note that for
   any single instance of the aggregation class
   PolicyValueInSimplePolicyAction, this property is single-valued.  The
   [0..n] cardinality indicates that there may be 0, 1, or more
   SimplePolicyAction objects that contain any given policy value object.

   The reference property "PartComponent" is inherited from PolicyComponent,
   and overridden to become an object reference to a PolicyValue that is
   defined within the scope of a SimplePolicyAction.  Note that for any
   single instance of the association class PolicyValueInSimplePolicyAction,
   this property (like all reference properties) is single-valued.  The
   [1..1] cardinality indicates that a SimplePolicyAction must have exactly
   one policy value defined within its scope in order to be meaningful.

 6.17. The Association "ReusablePolicy"

   The association ReusablePolicy makes it possible to include any subclass
   of the abstract class "Policy" in a ReusablePolicyContainer.

     NAME             ReusablePolicy
     DESCRIPTION      A class representing the inclusion of a reusable
                      policy element in a ReusablePolicyContainer.  Reusable
                      elements may be PolicyGroups, PolicyRules,
                      PolicyConditions, PolicyActions, PolicyVariables,
                      PolicyValues, or instances of any other subclasses of
                      the abstract class Policy.
     DERIVED FROM     PolicyInSystem
     ABSTRACT         FALSE
     PROPERTIES       Antecedent[ref ReusablePolicyContainer[0..1]]

 6.18. Deprecate PCIM's "PolicyConditionInPolicyRepository"

     NAME             PolicyConditionInPolicyRepository
     DEPRECATED FOR   ReusablePolicy
     DESCRIPTION      A class representing the inclusion of a reusable
                      PolicyCondition in a PolicyRepository.
     DERIVED FROM     PolicyInSystem
     ABSTRACT         FALSE
     PROPERTIES       Antecedent[ref PolicyRepository[0..1]]
                      Dependent[ref PolicyCondition[0..n]]

 6.19. Deprecate PCIM's "PolicyActionInPolicyRepository"

     NAME             PolicyActionInPolicyRepository
     DEPRECATED FOR   ReusablePolicy
     DESCRIPTION      A class representing the inclusion of a reusable
                      PolicyAction in a PolicyRepository.
     DERIVED FROM     PolicyInSystem
     ABSTRACT         FALSE
     PROPERTIES       Antecedent[ref PolicyRepository[0..1]]
                      Dependent[ref PolicyAction[0..n]]

 6.20. The Association PolicyValueConstraintInVariable ExpectedPolicyValuesForVariable

   This association links a PolicyValue object to a PolicyVariable object,
   modeling specific value constraints. the set of expected values for that PolicyVariable.  Using this
   association, a variable (instance) may be constrained to be bound-to/assigned bound-
   to/assigned only a set of allowed values.  For example, modeling an
   enumerated source port variable, one creates an instance of the
   PolicySourcePortVariable class and associates it with it the set of values
   (integers) representing the allowed enumeration, using appropriate number
   of instances of the
   PolicyValueConstraintInVariable ExpectedPolicyValuesForVariable association.

   Note that a single variable instance may be constrained by any number of
   values
   values, and a single value may be used to constrain any number of
   variables.  These relationships are manifested by the n-to-m cardinality
   of the association. association.

   The purpose of this association is to support validation of simple policy
   conditions and simple policy actions, prior to their deployment to an
   enforcement point.  This association, and the PolicyValue object that it
   refers to, plays no role when a PDP or a PEP is evaluating a simple
   policy condition, or executing a simple policy action.  See Section 4.8.3
   for more details on this point.

   The class definition for the association is as follows:

     NAME             PolicyValueConstraintInVariable             ExpectedPolicyValuesForVariable
     DESCRIPTION      A class representing the association of a constraints
                      object set of
                      expected values to a variable object.
     DERIVED FROM     Dependency
     ABSTRACT         FALSE
     PROPERTIES       Antecedent [ref PolicyVariable[0..n]]
                      Dependent [ref PolicyValue [0..n]]

   The reference property Antecedent is inherited from Dependency.  Its type
   and cardinality are overridden to provide the semantics of a variable
   optionally having value constraints.  The [0..n] cardinality indicates
   that any number of variables may be constrained by a given value.

   The reference property "Dependent" is inherited from Dependency, and
   overridden to become an object reference to a PolicyValue that is used to
   constrain representing
   the values that a particular PolicyVariable can have.  The [0..n]
   cardinality indicates that a given policy variable may have 0, 1 or more
   than one PolicyValues defined to model the constraints on the set(s) of values that the
   policy variable can take.

 6.21. The Aggregation "PolicyContainerInPolicyContainer"

   The aggregation PolicyContainerInPolicyContainer provides for nesting of
   one ReusablePolicyContainer inside another one.

     NAME             PolicyContainerInPolicyContainer
     DESCRIPTION      A class representing the aggregation of
                      ReusablePolicyContainers by a higher-level
                      ReusablePolicyContainer.
     DERIVED FROM     SystemComponent
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref ReusablePolicyContainer [0..n]]
                      PartComponent[ref ReusablePolicyContainer [0..n]]
 6.22. Deprecate PCIM's "PolicyRepositoryInPolicyRepository"

     NAME             PolicyRepositoryInPolicyRepository
     DEPRECATED FOR   PolicyContainerInPolicyContainer
     DESCRIPTION      A class representing the aggregation of
                      PolicyRepositories by
                      PolicyRepositories by a higher-level PolicyRepository.
     DERIVED FROM     SystemComponent
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref PolicyRepository[0..n]]
                      PartComponent[ref PolicyRepository[0..n]]

 6.23. The Aggregation "EntriesInFilterList"

   This aggregation is a specialization of the Component aggregation; it is
   used to define a set of filter entries (subclasses of FilterEntryBase)
   that are aggregated by a FilterList.

   The cardinalities of the aggregation itself are 0..1 on the FilterList
   end, and 0..n on the FilterEntryBase end.  Thus in the general case, a
   filter entry can exist without being aggregated into any FilterList.
   However, the only way a filter entry can figure in the PCIMe model is by
   being aggregated into a FilterList by this aggregation.

   The class definition for the aggregation is as follows:

          NAME              EntriesInFilterList
          DESCRIPTION       An aggregation used to define a set of
                            filter entries (subclasses of
                            FilterEntryBase) that are aggregated by
                            a particular FilterList.
          DERIVED FROM      Component
          ABSTRACT          False
          PROPERTIES        GroupComponent[ref
                               FilterList[0..1]],
                            PartComponent[ref
                               FilterEntryBase[0..n],
                            EntrySequence

 6.23.1. The Reference GroupComponent

   This property is overridden in this aggregation to represent an object
   reference to a FilterList object (instead of to the more generic
   ManagedSystemElement object defined in its superclass).  It also
   restricts the cardinality of the aggregate to 0..1 (instead of the more
   generic 0-or-more), representing the fact that a filter entry always
   exists within the context of at most one FilterList.

 6.23.2. The Reference PartComponent

   This property is overridden in this aggregation to represent an object
   reference to a FilterEntryBase object (instead of to the more generic
   ManagedSystemElement object defined in its superclass).  This object
   represents a higher-level PolicyRepository.
     DERIVED FROM     SystemComponent
     ABSTRACT         FALSE
     PROPERTIES       GroupComponent[ref PolicyRepository[0..n]]
                      PartComponent[ref PolicyRepository[0..n]]

 6.23. single filter entry, which may be aggregated with other
   filter entries to form the FilterList.

 6.23.3. The Property EntrySequence

   An unsigned 16-bit integer indicating the order of the filter entry
   relative to all others in the FilterList.  The default value '0'
   indicates that order is not significant, because the entries in this
   FilterList are ANDed together.

 6.24. The Aggregation "ElementInPolicyRoleCollection"

   The following aggregation is used to associate ManagedElements with a
   PolicyRoleCollection object that represents a role played by these
   ManagedElements.

     NAME             ElementInPolicyRoleCollection
     DESCRIPTION      A class representing the inclusion of a ManagedElement
                      in a collection, specified as having a given role.
                      All the managed elements in the collection share the
                      same role.
     DERIVED FROM     MemberOfCollection
     ABSTRACT         FALSE
     PROPERTIES       Collection[ref PolicyRoleCollection [0..n]]
                      Member[ref ManagedElement [0..n]]

 6.24.

 6.25. The Weak Association "PolicyRoleCollectionInSystem"

   A PolicyRoleCollection is defined within the scope of a System.  This
   association links a PolicyRoleCollection to the System in whose scope it
   is defined.

   When associating a PolicyRoleCollection with a System, this should be
   done consistently with the system that scopes the policy rules/groups
   that are applied to the resources in that collection.  A
   PolicyRoleCollection is associated with the same system as the applicable
   PolicyRules and/or PolicyGroups, or to a System higher in the tree formed
   by the SystemComponent association.

   The class definition for the association is as follows:

     NAME             PolicyRoleCollectionInSystem
     DESCRIPTION      A class representing the fact that a
                      PolicyRoleCollection is defined within the scope of a
                      System.
     DERIVED FROM     Dependency
     ABSTRACT         FALSE
     PROPERTIES       Antecedent[ref System[1..1]]
                      Dependent[ref PolicyRoleCollection[weak]]

   The reference property Antecedent is inherited from Dependency, and
   overridden to restrict its cardinality to [1..1].  It serves as an object
   reference to a System that provides a scope for one or more
   PolicyRoleCollections.  Since this is a weak association, the cardinality
   for this object reference is always 1, that is, a PolicyRoleCollection is
   always defined within the scope of exactly one System.

   The reference property Dependent is inherited from Dependency, and
   overridden to become an object reference to a PolicyRoleCollection
   defined within the scope of a System.  Note that for any single instance
   of the association class PolicyRoleCollectionInSystem, this property
   (like all Reference properties) is single-valued.  The [0..n] cardinality
   indicates that a given System may have 0, 1, or more than one
   PolicyRoleCollections defined within its scope.

 7. Intellectual Property

   The IETF takes no position regarding the validity or scope of any
   intellectual property or other rights that might be claimed to pertain to
   the implementation or use of the technology described in this document or
   the extent to which any license under such rights might or might not be
   available; neither does it represent that it has made any effort to
   identify any such rights.  Information on the IETF's procedures with
   respect to rights in standards-track and standards-related documentation
   can be found in BCP-11.

   Copies of claims of rights made available for publication and any
   assurances of licenses to be made available, or the result of an attempt
   made to obtain a general license or permission for the use of such
   proprietary rights by implementers or users of this specification can be
   obtained from the IETF Secretariat.

   The IETF invites any interested party to bring to its attention any
   copyrights, patents or patent applications, or other proprietary rights
   which may cover technology that may be required to practice this
   standard.  Please address the information to the IETF Executive Director.

 8. Acknowledgements

   The starting point for this document was PCIM itself [3], and the first
   three submodels derived from it [5], [6], [7].  The authors of these
   documents created the extensions to PCIM, and asked the questions about
   PCIM, that are reflected in PCIMe.

 9. Security Considerations

   The Policy Core Information Model (PCIM) [3] describes the general
   security considerations related to the general core policy model.  The
   extensions defined in this document do not introduce any additional
   considerations related to security.

 10. References

 [1]  Bradner, S., "Key words for use in RFCs to Indicate Requirement
      Levels", BCP 14, RFC 2119, March 1997.

 [2]  Hovey, R., and S. Bradner, "The Organizations Involved in the IETF
      Standards Process", BCP 11, RFC 2028, October 1996.

 [3]  Strassner, J., and E. Ellesson, B. Moore, A. Westerinen, "Policy Core
      Information Model -- Version 1 Specification", RFC 3060, February
      2001.

 [4]  Distributed Management Task Force, Inc., "DMTF Technologies: CIM
      Standards û CIM Schema: Version 2.5", available via links on the
      following DMTF web page: http://www.dmtf.org/spec/cim_schema_v25.html. at
      http://www.dmtf.org/standards/cim_schema_v25.php.

 [5]  Snir, Y., and Y. Ramberg, J. Strassner, R. Cohen, "Policy Framework QoS
      Information Model", work in progress, draft-ietf-policy-qos-info-
      model-02.txt, November 2000.
      model-04.txt, July 2001.

 [6]  Jason, J., and L. Rafalow, E. Vyncke, "IPsec Configuration Policy
      Model", work in progress, draft-ietf-ipsp-config-policy-model-02.txt,
      March draft-ietf-ipsp-config-policy-model-03.txt,
      July 2001.

 [7]  Chadha, R., and M. Brunner, M. Yoshida, J. Quittek, G. Mykoniatis, A.
      Poylisher, R. Vaidyanathan, A. Kind, F. Reichmeyer, "Policy Framework
      MPLS Information Model for QoS and TE", work in progress, draft-
      chadha-policy-mpls-te-01.txt, December 2000.

 [8]  Crocker, D., and P. Overell, "Augmented BNF for Syntax Specifications:
      ABNF", RFC 2234, November 1997.

 [9]  P. Mockapetris, "DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION",
      RFC1035, RFC
      1035, November 1987.

 [10] R. Hinden, S. Deering, "IP Version 6 Addressing Architecture",
      RFC2373, RFC
      2373, July 1998.

 [11] M. Wahl, A. Coulbeck, "Lightweight Directory Access Protocol (v3):
      Attribute Syntax Definitions", RFC 2252.

 [12] A. Westerinen, et al., "Policy Terminology", <draft-ietf-policy-
      terminology-01.txt>, November 2000. "Terminology for Policy-Based Management",
      <draft-ietf-policy-terminology-04.txt>, July 2001.

 [13] S. Waldbusser, and J. Saperia, T. Hongal, "Policy Based Management
      MIB", <draft-ietf-snmpconf-pm-04.txt>, November 2000. <draft-ietf-snmpconf-pm-06.txt>, June 2001.

 [14] B. Moore, and D. Durham, J. Halpern, J. Strassner, A. Westerinen, W.
      Weiss, "Information Model for Describing Network Device QoS Datapath
      Mechanisms", <draft-ietf-policy-qos-device-info-model-05.txt>, July
      2001.

 11. Authors' Addresses

   Bob Moore
       IBM Corporation, BRQA/502
       4205 S. Miami Blvd.
       Research Triangle Park, NC 27709
       Phone:   +1 919-254-4436
       Fax:     +1 919-254-6243
       E-mail:  remoore@us.ibm.com

   Lee Rafalow
       IBM Corporation, BRQA/502
       4205 S. Miami Blvd.
       Research Triangle Park, NC 27709
       Phone:   +1 919-254-4455
       Fax:     +1 919-254-6243
       E-mail:  rafalow@us.ibm.com

   Yoram Ramberg
       Cisco Systems
       4 Maskit Street
       Herzliya Pituach, Israel  46766
       Phone:  +972-9-970-0081
       Fax:    +972-9-970-0219
       E-mail:  yramberg@cisco.com

   Yoram Snir
       Cisco Systems
       4 Maskit Street
       Herzliya Pituach, Israel  46766
       Phone:  +972-9-970-0085
       Fax:    +972-9-970-0366
       E-mail:  ysnir@cisco.com

   John Strassner
       Cisco Systems
       Building 20
       725 Alder Drive
       Milpitas, CA  95035
       Phone:  +1-408-527-1069
       Fax:    +1-408-527-2477
       E-mail:  johns@cisco.com

   Andrea Westerinen
       Cisco Systems
       Building 20
       725 Alder Drive
       Milpitas, CA  95035
       Phone:  +1-408-853-8294
       Fax:    +1-408-527-6351
       E-mail:  andreaw@cisco.com

   Ritu Chadha
       Telcordia Technologies
       MCC 1J-218R
       445 South Street
       Morristown NJ 07960.
       Phone:  +1-973-829-4869
       Fax:    +1-973-829-5889
       E-mail: chadha@research.telcordia.com
   Marcus Brunner
       NEC Europe Ltd.
       C&C Research Laboratories
       Adenauerplatz 6
       D-69115 Heidelberg, Germany
       Phone: +49 (0)6221 9051129
       Fax:   +49 (0)6221 9051155
       E-mail: brunner@ccrle.nec.de

   Ron Cohen
       Ntear LLC
       Phone:
       Fax:
       E-mail:  ronc@ntear.com

   John Strassner
       INTELLIDEN, Inc.
       90 South Cascade Avenue
       Colorado Springs, CO  80903
       Phone:   +1-719-785-0648
       E-mail:   john.strassner@intelliden.com

 12. Full Copyright Statement

   Copyright (C) The Internet Society (2001).  All Rights Reserved.

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it or
   assist in its implementation may be prepared, copied, published and
   distributed, in whole or in part, without restriction of any kind,
   provided that the above copyright notice and this paragraph are included
   on all such copies and derivative works.  However, this document itself
   may not be modified in any way, such as by removing the copyright notice
   or references to the Internet Society or other Internet organizations,
   except as needed for the purpose of developing Internet standards in
   which case the procedures for copyrights defined in the Internet
   Standards process must be followed, or as required to translate it into
   languages other than English.

   The limited permissions granted above are perpetual and will not be
   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an "AS
   IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK
   FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT
   LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT
   INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR
   FITNESS FOR A PARTICULAR PURPOSE.

 13. Appendix A: Open Closed Issues

   EDITOR'S NOTE: The PCIMe authors do not all agree with everything included in following list captures the -00
   draft of major technical issues
   that were resolved during the document.  Input is solicited course of progressing PCIMe from initial
   draft to Proposed Standard.  This appendix will be removed for submission
   to the working group as RFC Editor (unless there is a
   whole on consensus to preserve it in the following open issues:
   RFC), but it should be archived somewhere.

     1.  Unrestricted use of DNF/CNF for CompoundPolicyConditions.
         Alternative: for the conditions aggregated by a
         CompoundPolicyCondition, allow only ANDing, with negation of
         individual conditions.  Note that this is sufficient to build
         multi-field packet filters from single-field
         SimplePolicyConditions.

         RESOLUTION: The same DNF/CNF capabilities present for aggregating
         PolicyConditions into a PolicyRule have been retained for
         aggregating PolicyConditions into a CompoundPolicyCondition.

     2.  For a PolicyVariable in a SimplePolicyCondition, restrict the set
         of possible values both via associated PolicyValue objects (tied
         in with the PolicyValueConstraintInVariable ExpectedPolicyValuesForVariable association) and via
         the ValueTypes property in the PolicyVariable class.  Alternative:
         restrict values only via associated PolicyValue objects.

         RESOLUTION: PCIMe continues to allow both mechanisms for
         restricting the values of a PolicyVariable.

     3.  Transactional semantics, including rollback, for the
         ExecutionStrategy property in PolicyRule and in
         CompoundPolicyAction.  Alternative: have only 'Do until success'
         and 'Do all'.

         RESOLUTION: No transactional semantics for action execution.  The
         value 'Mandatory Do All(1)' has been removed from the two
         ExecutionStrategy properties.

     4.  Stating that CompoundFilterConditions are the preferred way to do
         packet filtering in a PolicyCondition.  Alternative:  make
         CompoundFilterConditions and FilterEntries available to submodels,
         with no stated (or implied) preference.

         RESOLUTION: Recommendations for use of CompoundFilterConditions
         and FilterEntries are retained, but they have been recast
         slightly.  CompoundFilterConditions are now positioned as the
         recommended approach for domain-level models.  FilterEntries are
         the recommended approach for device-level models.

     5.  Prohibiting equal values for Priority within a PolicySet.
         Alternative: allow equal values, with resulting indeterminacy in
         PEP behavior.

         RESOLUTION: PCIMe will continue to prohibit equal Priority values.

     6.  Modeling a SimplePolicyAction with just a related PolicyVariable
         and PolicyValue -- the "set" or "apply" operation is implicit.
         Alternative: include an Operation property in SimplePolicyAction,
         similar to the Operation property in SimplePolicyCondition.

         RESOLUTION: This issue has been resolved by a change in the
         opposite direction.  The operations are now implicit for BOTH
         SimplePolicyCondition and SimplePolicyAction.  See Sections 4.8.3
         and 4.8.4, respectively, for discussions of
         SimplePolicyCondition's implicit MATCH operator and
         SimplePolicyAction's implicit SET operator.

     7.  Representation of PolicyValues: should values like IPv4 addresses
         be represented only as strings (as in LDAP), or natively (e.g., an
         IPv4 address would be a four-octet field) with mappings to other
         representations such as strings?

         RESOLUTION: Mappings have been eliminated.  Each value type has a
         single representation specified for it.

     8.  The nesting of rules and groups within rules introduces
         significant change and complexity in the model.  This nesting
         introduces program state (procedural language) into the model
         (heretofore a declarative model) as well as implicit hierarchical
         contexts on which the rules operate.  These require a much more
         sophisticated rule-evaluation engine than in the past.

         Alternative: Maintain the declarative model, by prohibiting
         program state in rule evaluation (i.e., no rules within rules).

         RESOLUTION: Nesting of rules and groups within rules has been
         retained, but with a significant new limitation: actions
         associated with a rule do not have side effects that would impact
         condition evaluation for subsequent rules.  "Subsequent rules"
         here includes both rules nested within the rule whose actions are
         under discussion, and rules at the same nesting level as this rule
         that are evaluated after it.  Note that it has been a feature of
         PCIM (RFC 3060) all along that condition evaluation has no side
         effects that would influence condition evaluation for subsequent
         rules.

         There is also one modeling detail associated with nesting that has
         been changed.  Rather than having separate aggregations
         (PolicyGroupInPolicyGroup, etc.) for each of the four nesting
         varieties, the single aggregation PolicySetComponent is now used
         as a concrete aggregation class.

      9. Need to specify a join algorithm for disjoint rule sets.

         RESOLUTION: PCIMe now states that for different functional domains
         (e.g., QoS and IKE), there is no join algorithm.  Each domain, in
         effect, has its own rule engine, which operates independently of
         the other domains' engine(s).  Within a functional domain,
         disjoint PolicySets are joined by the Priority property in the
         PolicySetInSystem association.  In this case the decision strategy
         is specified to be FirstMatching.

      10.  Clarify PolicyImplicitVariables.

         RESOLUTION: Each subclass of PolicyImplicitVariable will identify
         the exact source of the variable data.  For example, there will be
         a subclass of PolicyImplicitVariable that specifically identifies
         the IPv4 source address in the outermost packet header.  IPv4 and
         IPv6 addresses will require separate subclasses of
         PolicyImplicitVariable.  We understand the downside of this
         approach: a potential explosion in the number of subclasses of
         PolicyImplicitVariable.

         ALTERNATIVE: At this time the authors are still discussing an
         alternative approach, in which variable types would be represented
         by enumerated values rather than by separate subclasses of
         PolicyImplicitVariable.  This approach can greatly reduce the
         number of classes in the model, but it introduces an IANA
         dependency for managing the enumerated values.

      11.  Clarify PolicyExplicitVariables.

         NON-RESOLUTION:

         NON-RESOLUTION (in PCIMe-01): This issue is still not resolved at
         all.  The authors continue to believe that we need the capability
         of indicating that a condition should compare against (or an
         action should set) a particular property in a particular object
         instance.  But we do not believe that the current mechanism of
         specifying a target object class and property name is sufficient.
         For the next version of PCIMe, we need to either find a way to
         make this work in general; or find a way to make it work in some
         cases, and then describe clearly what these cases are; or remove
         PolicyExplicitVariables from PCIMe entirely.

         RESOLUTION (in PCIMe-02): From the list of choices above, we took
         the path of making explicit variables work in a specific case, and
         indicating clearly that they work only in this case.  See section
         4.8.6