os-cmpi-xen

view schema/dmtf/CIM_ResourcePoolConfigurationService.mof @ 121:4868ace2726b

Add initial consistence checks in test suite for Xen_MemoryPool, Xen_ProcessorPool and Xen_VirtualSystemManagementService.

Signed-off-by: Luke Szymanski <Lukasz.Szymanski@Unisys.com>
author Jim Fehlig <jfehlig@novell.com>
date Fri Jun 08 10:22:05 2007 -0600 (2007-06-08)
parents cd21b7e999f3
children
line source
1 // Copyright (c) 2007 DMTF. All rights reserved.
2 // This document is a DMTF System Virtualization, Partitioning and
3 // Clustering workgroup "Work in Progress" and is subject to change.
4 // This document was released on January 15 2007.
5 // This document must not be used after May 1 2007.
6 // ==================================================================
7 // CIM_ResourcePoolConfigurationService
8 // ==================================================================
9 [Experimental, Version ("2.15.0"), Description (
10 "This service provides for active management of Resource Pools. "
11 "It allows jobs to be started for the creation "
12 "and deletion of ResourcePools as well as addition and "
13 "subtraction of host resources from ResourcePools")]
14 class CIM_ResourcePoolConfigurationService : CIM_Service {
16 [Description (
17 "Starts a job to create a root ResourcePool. The "
18 "ResourcePool will be scoped to the same System "
19 "as this Service. If "
20 "0 is returned, then the task completed successfully and the "
21 "use of ConcreteJob was not required. If the task will take "
22 "some time to complete, a ConcreteJob will be created and "
23 "its reference returned in the output parameter Job. "
24 "The resulting pool will be a root pool with no parent pool."),
25 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "..", "4096",
26 "4097", "4098..32767", "32768..65535" },
27 Values { "Job Completed with No Error", "Not Supported",
28 "Unknown", "Timeout", "Failed", "Invalid Parameter",
29 "In Use", "Incorrect ResourceType for the Pool", "DMTF Reserved",
30 "Method Parameters Checked - Job Started",
31 "Size Not Supported", "Method Reserved", "Vendor Specific" }]
32 uint32 CreateResourcePool (
33 [IN, Description (
34 "A end user relevant name for the pool being created. If "
35 "NULL, then a system supplied default name can be used. "
36 "The value will be stored in the 'ElementName' property "
37 "for the created pool.")]
38 string ElementName,
39 [IN, Description (
40 "Array of zero or more devices that are used "
41 "to create the Pool or modify the source extents. "
42 "All elements in the array must be of the same type.")]
43 CIM_LogicalDevice REF HostResources[],
44 [IN, Description (
45 "The type of resources the created pool"
46 "will manage. If HostResources contains elements, this "
47 "property must mach their type.")]
48 string ResourceType,
49 [IN (false) , OUT, Description (
50 "On success, a reference to the resulting ResourcePool is "
51 "returned. When a Job is returned, this may be NULL, in "
52 "which case, the client must use the Job to find the "
53 "resulting ResourcePool once the Job completes.")]
54 CIM_ResourcePool REF Pool,
55 [IN ( false ), OUT, Description (
56 "Reference to the job (may be null if job completed).")]
57 CIM_ConcreteJob REF Job);
59 [Description (
60 "Start a job to create a sub-pool from a parent pool using "
61 "the specified allocation settings "
62 "If 0 is returned, the function "
63 "completed successfully and no ConcreteJob instance was "
64 "required. If 4096/0x1000 is returned, a ConcreteJob will be "
65 "started to create the sub-pool. The Job's reference will be "
66 "returned in the output parameter Job."),
67 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "..", "4096",
68 "4097", "4098..32767", "32768..65535" },
69 Values { "Job Completed with No Error", "Not Supported",
70 "Unknown", "Timeout", "Failed", "Invalid Parameter",
71 "In Use", "Incorrect ResourceType for the Pool",
72 "Insufficient Resources", "DMTF Reserved",
73 "Method Parameters Checked - Job Started",
74 "Size Not Supported", "Method Reserved", "Vendor Specific" }]
75 uint32 CreateChildResourcePool(
76 [IN, Description (
77 "A end user relevant name for the pool being created. "
78 "If NULL, then a system supplied default name can be "
79 "used. The value will be stored in the 'ElementName' "
80 "property for the created element. ")]
81 string ElementName,
82 [IN ( true ), EmbeddedInstance("CIM_ResourceAllocationSettingData"),
83 Description ("String containing a representation of "
84 "a CIM_SettingData instance that is used "
85 "to specify the settings for the child Pool."),
86 ModelCorrespondence {
87 "CIM_ ResourcePoolConfigurationService.CreateChildResourcePool.ParentPool"}]
88 string settings[],
89 [IN, Description (
90 "The Pool(s) from which to create the new Pool."),
91 ModelCorrespondence {
92 "CIM_ResourcePoolConfigurationService.CreateChildResourcePool.settings"}]
93 CIM_ResourcePool REF ParentPool[],
94 [IN (false), OUT, Description (
95 "A reference to the resulting pool.")]
96 CIM_ResourcePool REF Pool,
97 [IN ( false ), OUT, Description (
98 "Reference to the job (may be null if job completed).")]
99 CIM_ConcreteJob REF Job);
101 [Description (
102 "Start a job to delete a ResourcePool. No allocations may be "
103 "outstanding or the delete will fail with \"In Use.\" If the "
104 "resource pool is a root resource pool, any host resources "
105 "are returned back to the underlying system. If 0 is "
106 "returned, the function completed successfully, and no "
107 "ConcreteJob was required. If 4096/0x1000 is returned, a "
108 "ConcreteJob will be started to delete the ResourcePool. A "
109 "reference to the Job is returned in the Job parameter."),
110 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "..", "4096",
111 "4097..32767", "32768..65535" },
112 Values { "Job Completed with No Error", "Not Supported",
113 "Unknown", "Timeout", "Failed", "Invalid Parameter",
114 "In Use", "Incorrect ResourceType for the Pool", "DMTF Reserved",
115 "Method Parameters Checked - Job Started", "Method Reserved",
116 "Vendor Specific" }]
117 uint32 DeleteResourcePool (
118 [IN, Description (
119 "Reference to the pool to delete.")]
120 CIM_ResourcePool REF Pool,
121 [IN ( false ), OUT, Description (
122 "Reference to the job (may be null if job completed).")]
123 CIM_ConcreteJob REF Job);
125 [Description (
126 "Starts a job to add resources to a ResourcePool. "
127 "If 0 is returned, then the task completed successfully and the "
128 "use of ConcreteJob was not required. If the task will take "
129 "some time to complete, a ConcreteJob will be created and "
130 "its reference returned in the output parameter Job. "
131 "The resulting pool will be a root pool with no parent pool."),
132 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "..", "4096",
133 "4097", "4098..32767", "32768..65535" },
134 Values { "Job Completed with No Error", "Not Supported",
135 "Unknown", "Timeout", "Failed", "Invalid Parameter",
136 "In Use", "Incorrect ResourceType for the Pool", "DMTF Reserved",
137 "Method Parameters Checked - Job Started",
138 "Size Not Supported", "Method Reserved", "Vendor Specific" }]
139 uint32 AddResourcesToResourcePool (
140 [IN, Description (
141 "Array of CIM_LogicalDevice instances to "
142 "add to the Pool.")]
143 CIM_LogicalDevice REF HostResources[],
144 [IN, Description (
145 "The pool to add the resources to.")]
146 CIM_ResourcePool REF Pool,
147 [IN ( false ), OUT, Description (
148 "Reference to the job (may be null if job completed).")]
149 CIM_ConcreteJob REF Job);
151 [Description (
152 "Starts a job to remove resources from a ResourcePool. "
153 "If 0 is returned, then the task completed successfully and the "
154 "use of ConcreteJob was not required. If the task will take "
155 "some time to complete, a ConcreteJob will be created and "
156 "its reference returned in the output parameter Job. "
157 "The resulting pool will be a root pool with no parent pool."),
158 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "..", "4096",
159 "4097", "4098..32767", "32768..65535" },
160 Values { "Job Completed with No Error", "Not Supported",
161 "Unknown", "Timeout", "Failed", "Invalid Parameter",
162 "In Use", "Incorrect ResourceType for the Pool", "DMTF Reserved",
163 "Method Parameters Checked - Job Started",
164 "Size Not Supported", "Method Reserved", "Vendor Specific" }]
165 uint32 RemoveResourcesFromResourcePool (
166 [IN, Description (
167 "Array of CIM_LogicalDevice instances to "
168 "remove from the Pool.")]
169 CIM_LogicalDevice REF HostResources[],
170 [IN, Description (
171 "The pool to remove the resources from.")]
172 CIM_ResourcePool REF Pool,
173 [IN ( false ), OUT, Description (
174 "Reference to the job (may be null if job completed).")]
175 CIM_ConcreteJob REF Job);
177 [Description (
178 "Start a job to change a parent pool using "
179 "the specified allocation settings "
180 "If 0 is returned, the function "
181 "completed successfully and no ConcreteJob instance was "
182 "required. If 4096/0x1000 is returned, a ConcreteJob will be "
183 "started to change the parent pool. The Job's reference will be "
184 "returned in the output parameter Job."),
185 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "..", "4096",
186 "4097", "4098..32767", "32768..65535" },
187 Values { "Job Completed with No Error", "Not Supported",
188 "Unknown", "Timeout", "Failed", "Invalid Parameter",
189 "In Use", "Incorrect ResourceType for the Pool",
190 "Insufficient Resources", "DMTF Reserved",
191 "Method Parameters Checked - Job Started",
192 "Size Not Supported", "Method Reserved", "Vendor Specific" }]
193 uint32 ChangeParentResourcePool (
194 [IN, Description (
195 "Reference to the child pool.")]
196 CIM_ResourcePool REF ChildPool,
197 [IN, Description (
198 "Reference to the parent pool(s).")]
199 CIM_ResourcePool REF ParentPool[],
200 [IN ( true ), EmbeddedInstance("CIM_ResourceAllocationSettingData"),
201 Description ("Optional string containing a representation of "
202 "a CIM_SettingData instance that is used "
203 "to specify the settings for the Parent Pool."),
204 ModelCorrespondence {
205 "CIM_ResourcePoolConfigurationService.ChangeParentResourcePool.settings"}]
206 string Settings[],
207 [IN ( false ), OUT, Description (
208 "Reference to the job (may be null if job completed)."),
209 ModelCorrespondence {
210 "CIM_ResourcePoolConfigurationService.ChangeParentResourcePool.ParentPool"}]
211 CIM_ConcreteJob REF Job);
213 };