1 karl  1.1.2.2 // 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 karl  1.1.2.2           "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 karl  1.1.2.2           "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 karl  1.1.2.2           "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               };