1 marek 1.1 // Copyright (c) 2005 DMTF.  All rights reserved.
 2           // <change cr="SysDevCR00722.000" type ="change">Update of
 3           // descriptions based on Tech Edit review.</
 4           // <change cr="SysDevCR00726.001" type ="add">Clarify ElementEffects
 5           // description</
 6           // <change cr="ArchCR00066.004" type="add">Add UmlPackagePath
 7           // qualifier values to CIM Schema.</change>
 8           // <change cr="CIMCoreCR00864" type="add">Update description of 
 9           // "Manages" value of property ElementAffects .</change>
10           // ==================================================================
11           //  CIM_ServiceAffectsElement
12           // ==================================================================
13              [Association, Version ( "2.14.0" ), 
14               UMLPackagePath ( "CIM::Core::Service" ), 
15               Description ( 
16                  "ServiceAffectsElement represents an association between a "
17                  "Service and the ManagedElements that might be affected by its "
18                  "execution. Instantiating this association indicates that "
19                  "running the service may change, manage, provide functionality "
20                  "for,or pose some burden on the ManagedElement. This burden "
21                  "might affect performance, throughput, availability, and so on." )]
22 marek 1.1 class CIM_ServiceAffectsElement {
23           
24                 [Key, Description ( 
25                     "The Managed Element that is affected by the Service." )]
26              CIM_ManagedElement REF AffectedElement;
27           
28                 [Key, Description ( 
29                     "The Service that is affecting the ManagedElement." )]
30              CIM_Service REF AffectingElement;
31           
32                 [Description ( 
33                     "An enumeration that describes the effect on the "
34                     "ManagedElement. This array corresponds to the "
35                     "OtherElementEffectsDescriptions array, where the latter "
36                     "provides details that are related to the high-level "
37                     "effects enumerated by this property. Additional detail "
38                     "is required if the ElementEffects array contains the "
39                     "value 1 (Other). The values are defined as follows: \n"
40                     "- Exclusive Use (2): No other Service may have this "
41                     "association to the element. \n"
42                     "- Performance Impact (3): Deprecated in favor of "
43 marek 1.1           "\"Consumes\", \"Enhances Performance\", or \"Degrades "
44                     "Performance\". Execution of the Service may enhance or "
45                     "degrade the performance of the element. This may be as a "
46                     "side-effect of execution or as an intended consequence "
47                     "of methods provided by the Service. \n"
48                     "- Element Integrity (4): Deprecated in favor of "
49                     "\"Consumes\", \"Enhances Integrity\", or \"Degrades "
50                     "Integrity\". Execution of the Service may enhance or "
51                     "degrade the integrity of the element. This may be as a "
52                     "side-effect of execution or as an intended consequence "
53                     "of methods provided by the Service. \n"
54                     "- Manages (5): The Service manages the element. \n"
55                     "- Consumes (6): Execution of the Service consumes some "
56                     "or all of the associated element as a consequence of "
57                     "running the Service. For example, the Service may "
58                     "consume CPU cycles, which may affect performance, or "
59                     "Storage which may affect both performance and integrity. "
60                     "(For instance, the lack of free storage can degrade "
61                     "integrity by reducing the ability to save state. ) "
62                     "\"Consumes\" may be used alone or in conjunction with "
63                     "other values, in particular, \"Degrades Performance\" "
64 marek 1.1           "and \"Degrades Integrity\". \n"
65                     "\"Manages\" and not \"Consumes\" should be used to "
66                     "reflect allocation services that may be provided by a "
67                     "Service. \n"
68                     "- Enhances Integrity (7): The Service may enhance "
69                     "integrity of the associated element. \n"
70                     "- Degrades Integrity (8): The Service may degrade "
71                     "integrity of the associated element. \n"
72                     "- Enhances Performance (9): The Service may enhance "
73                     "performance of the associated element. \n"
74                     "- Degrades Performance (10): The Service may degrade "
75                     "performance of the associated element." ), 
76                  ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", 
77                     "10", "..", "0x8000..0xFFFF" }, 
78                  Values { "Unknown", "Other", "Exclusive Use", 
79                     "Performance Impact", "Element Integrity", "Manages", 
80                     "Consumes", "Enhances Integrity", "Degrades Integrity", 
81                     "Enhances Performance", "Degrades Performance", 
82                     "DMTF Reserved", "Vendor Reserved" }, 
83                  ArrayType ( "Indexed" ), 
84                  ModelCorrespondence { 
85 marek 1.1           "CIM_ServiceAffectsElement.OtherElementEffectsDescriptions" }]
86              uint16 ElementEffects[];
87           
88                 [Description ( 
89                     "Provides details for the effect at the corresponding "
90                     "array position in ElementEffects. This information is "
91                     "required if ElementEffects contains the value 1 (Other)." ), 
92                  ArrayType ( "Indexed" ), 
93                  ModelCorrespondence { 
94                     "CIM_ServiceAffectsElement.ElementEffects" }]
95              string OtherElementEffectsDescriptions[];
96           
97           
98           };