1 marek 1.1 // Copyright (c) 2005 DMTF.  All rights reserved.
 2              [Version ( "2.8.0" ), 
 3               UMLPackagePath ( "CIM::Policy" ), 
 4               Description ( 
 5                  "PolicyRoleCollection is used to represent a collection of "
 6                  "ManagedElements that share a common policy role, and the "
 7                  "PolicySets that CAN BE applied to those elements. (Note that "
 8                  "the PolicySets that are CURRENTLY applied are indicated via "
 9                  "instances of the association, PolicySetAppliesToElement.) The "
10                  "PolicyRoleCollection always exists in the context of a System, "
11                  "specified using the PolicyRoleCollectionInSystem aggregation. "
12                  "The value of the PolicyRole property in this class specifies "
13                  "the role. It is defined as a free-form string. ManagedElements "
14                  "that share the role defined in this collection are aggregated "
15                  "into the Collection via the ElementInPolicyRoleCollection "
16                  "association." )]
17           class CIM_PolicyRoleCollection : CIM_SystemSpecificCollection {
18           
19                 [Required, Description ( 
20                     "The PolicyRole name for the PolicySets and other "
21                     "ManagedElements that are identified and aggregated by "
22 marek 1.1           "the Collection. Note that the aggregated PolicySets "
23                     "define the rules and groups of rules that may be applied "
24                     "to the associated ManagedElements. \n"
25                     "\n"
26                     "Although not officially designated as \'role "
27                     "combinations\', multiple roles may be specified using "
28                     "the form: \n"
29                     "<RoleName>[&&<RoleName>]* \n"
30                     "where the individual role names appear in alphabetical "
31                     "order (according to the collating sequence for UCS-2). "
32                     "Implementations may treat PolicyRole values that are "
33                     "specified as \'role combinations\' as simple strings." )]
34              string PolicyRole;
35           
36           
37                 [Description ( 
38                     "Activates/applies the PolicySets aggregated into this "
39                     "Collection to the specified ManagedElement. The "
40                     "ManagedElement MUST be a member of the Collection, "
41                     "associated via ElementInPolicyRoleCollection. The result "
42                     "of this method, if it is successfully executed, is that "
43 marek 1.1           "the aggregated PolicySets are deployed and enforced for "
44                     "the Element. This is reflected by the instantiation of "
45                     "the PolicySetAppliesToElement association between the "
46                     "named Element and each PolicySet." ), 
47                  ValueMap { "0", "1", "2", "3", "4", "..", "0x8000.." }, 
48                  Values { "Success", "Not Supported", "Unknown", "Timeout", 
49                     "Failed", "DMTF Reserved", "Vendor Specific" }]
50              uint32 ActivatePolicySet(
51                    [IN, Description ( 
52                        "The ManagedElement to which the aggregated "
53                        "PolicySets of this Collection are applied." )]
54                 CIM_ManagedElement REF Element);
55           
56                 [Description ( 
57                     "Deactivates the aggregated PolicySets for the specified "
58                     "ManagedElement. The result of this method, if it is "
59                     "successfully executed, is that the aggregated PolicySets "
60                     "are NOT enforced for the Element. This is reflected by "
61                     "the removal of the PolicySetAppliesToElement association "
62                     "between the named Element and each PolicySet. If a "
63                     "PolicySet is not currently enforced for the "
64 marek 1.1           "ManagedElement, then this method has no effect for that "
65                     "Set." ), 
66                  ValueMap { "0", "1", "2", "3", "4", "..", "0x8000..0xFFFF" }, 
67                  Values { "Success", "Not Supported", "Unknown", "Timeout", 
68                     "Failed", "DMTF Reserved", "Vendor Specific" }]
69              uint32 DeactivatePolicySet(
70                    [IN, Description ( 
71                        "The ManagedElement to which the aggregated "
72                        "PolicySets of this Collection MUST NOT apply." )]
73                 CIM_ManagedElement REF Element);
74           
75           };